@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,4527 +0,0 @@
1
- //! ---
2
- //! purpose: 通过 tmux argv 执行 spawn/inject/capture
3
- //! contract:
4
- //! provides:
5
- //! - name: TmuxBackend
6
- //! what: Transport 的 tmux 实现,inject/send_keys 取 pane 输入锁
7
- //! - name: submit-consumption-verdict
8
- //! what: token 见过再消失且本次占位符身份(#N / grok 行数或 KB)已离开 composer ⇒ 已消费;Gone 时占位符仍在 ⇒ 未消费;无身份时只按一次回车;consumed=None(capture 失败/读数拿不到)⇒ SubmitConsumptionUnverified,不得与 Some(true) 同值
9
- //! - name: token-sighting
10
- //! what: Visible / Gone / NeverSeen 三态接到判定(不只进报告)
11
- //! - name: pre-submit-copy-mode-cancel
12
- //! what: 统一 prepare_pane_for_submit:Enter 前 cancel 一切非 0 pane_mode(按真实 mode 分派);⛔ 不发 ESC 也不发其替代品(含字面 CSI 201~,用户裁定 2026-08-23);A1 Empty / A3 skip-poll / A4 Phase2 / A6 send_keys(含 Enter) 都走这里
13
- //! - name: turn-inbox-vs-run
14
- //! what: busy ⇒ Verified(开跑);composer 仍有本次粘贴且无 busy ⇒ Missing(没开跑);其余 NotYetObserved(不知道)
15
- //! - name: capture-fail-retry
16
- //! what: post-Enter capture 失败只重读 capture,计入 attempts,不重粘、不加 Enter
17
- //! - name: cursor-single-enter
18
- //! what: TLS 打开时,busy 或 token 不在输入区(底部 5 非空行)则不重按 Enter;transcript 里的 pasted #N 不算输入框
19
- //! - name: unverified-composer-resend
20
- //! what: SubmitConsumptionUnverified 且本次身份仍在 composer 且 A 的 should_resubmit_enter 为假(折行拼接缺口)⇒ 只补一颗 C-m;A 因 latch/底15 单行 token 已能重试(含打满 cap)时 B 不介入;consumed=None 不补;达上限 1 或身份消失或已消费或 busy 则停。不认提示符皮肤。
21
- //! boundary:
22
- //! - 不把 fire-and-forget 报成 delivered
23
- //! - 不把「粘贴命中」(any_attempt_matched) 当成已提交
24
- //! - 不把「没能判断」(consumed=None) 落到成功值
25
- //! - turn_verification 不是投递闸门;分辨不出不得报开跑
26
- //! - 补发只重按回车,不重粘、不用 Escape/C-c;闸是折行缺口(A 看不到、拼接身份还在),不是提示符字符串、也不是 pane 忙闲;A 已覆盖的 latch 滞留不走 B
27
- //! maturity: wired
28
- //! ---
29
- //!
30
- //! Concrete tmux `Transport` backend (SKELETON) — the real executor that runs `tmux <argv>`.
31
- //!
32
- //! step 9 shipped the [`crate::transport::Transport`] trait + the pure tmux argv-builders
33
- //! (`tmux_spawn_argv`, `tmux_capture_argv`, `tmux_send_keys_argv`, `tmux_inject_text_argv`,
34
- //! `tmux_query_argv`, `tmux_cancel_mode_argv`) but NO concrete backend that actually executes them.
35
- //! This is that backend: each `Transport` method builds its argv via those builders, runs it through
36
- //! a [`CommandRunner`] seam, and parses the tmux output into the trait's typed return.
37
- //!
38
- //! THE SEAM: [`CommandRunner`] is the single OS edge. [`RealCommandRunner`] runs
39
- //! `std::process::Command::new("tmux") …`; tests inject a recording/canned runner so the argv
40
- //! construction + output parsing are unit-testable in-process, while the real subprocess execution
41
- //! stays the `#[ignore]` real-machine boundary (acceptance framework).
42
- //!
43
- //! §10: the implementation must be panic-free (porter adds the deny + bodies; this skeleton is
44
- //! `unimplemented!()`). MUST-NOT-13: a transport backend has no provider-client dependency.
45
- #![allow(dead_code)]
46
-
47
- use std::collections::BTreeMap;
48
- use std::hash::{Hash, Hasher};
49
- use std::io::{Read, Write};
50
- // 0.5.x Windows portability Batch 1: gate the sole Unix API surface
51
- // in this concrete tmux backend (FileTypeExt::is_socket + libc::geteuid
52
- // tmux-socket-root derivation). The rest of the file is Command::new
53
- // "tmux" shellouts that compile on Windows but return runtime errors
54
- // honestly (tmux binary absent → typed subprocess error).
55
- // Truth source: `.team/artifacts/0.5.x-windows-portability-survey-design.md` §Batch 1.
56
- use std::cell::Cell;
57
- #[cfg(unix)]
58
- use std::os::unix::fs::FileTypeExt;
59
- use std::path::{Path, PathBuf};
60
- use std::process::Stdio;
61
- use std::time::{Duration, Instant};
62
-
63
- use crate::model::enums::PaneLiveness;
64
- use crate::provider::wire::{parse_provider, provider_wire};
65
- use crate::transport::{
66
- command_basename, normalize_capture, tmux_capture_argv, tmux_empty_inject_argv,
67
- tmux_inject_text_argv, tmux_query_argv, tmux_send_keys_argv, tmux_send_submit_argv,
68
- tmux_spawn_argv, AttachOutcome, BackendKind, BusySignalKind, CaptureRange,
69
- CaptureSampleOutcome, CapturedText, InjectPayload, InjectReport, InjectStage,
70
- InjectVerification, InputSurfaceProbe, Key, PaneField, PaneId, PaneInfo, PaneMode,
71
- QueryOutcome, SessionName, SessionOwner, SetEnvOutcome, SpawnResult,
72
- SubmitAttemptObservation, SubmitConsumptionReason, SubmitDiagnostics, SubmitObserver,
73
- SubmitVerification, Target, Transport, TransportError, TurnVerification, WindowName,
74
- };
75
-
76
- mod enter_rescue;
77
- mod native_input;
78
-
79
- pub const PANE_BINDING_NONCE_METADATA_KEY: &str = "TEAM_AGENT_PANE_BINDING_NONCE";
80
- pub(crate) const KEEPALIVE_WINDOW_NAME: &str = "[team-agent keepalive]";
81
- const TMUX_PANE_BINDING_NONCE_OPTION: &str = "@team_agent_pane_binding_nonce";
82
- const TMUX_SESSION_OWNER_WORKSPACE_OPTION: &str = "@team_agent_owner_workspace";
83
- const TMUX_SESSION_OWNER_TEAM_OPTION: &str = "@team_agent_owner_team";
84
- const TMUX_SESSION_OWNER_GENERATION_OPTION: &str = "@team_agent_owner_generation";
85
-
86
- /// Shared existing pane nonce generator; transport owns the physical nonce.
87
- /// Same material/algorithm as the original Leader claim producer, no new dependency.
88
- pub(crate) fn next_pane_binding_nonce(workspace: &Path, endpoint: &str, pane: &PaneId) -> String {
89
- use sha2::{Digest, Sha256};
90
- use std::sync::atomic::{AtomicU64, Ordering};
91
- use std::time::{SystemTime, UNIX_EPOCH};
92
-
93
- static COUNTER: AtomicU64 = AtomicU64::new(0);
94
- let nanos = SystemTime::now()
95
- .duration_since(UNIX_EPOCH)
96
- .map_or(0, |duration| duration.as_nanos());
97
- let counter = COUNTER.fetch_add(1, Ordering::Relaxed);
98
- let canonical = workspace.canonicalize().unwrap_or_else(|_| workspace.to_path_buf());
99
- let material = format!(
100
- "{}\0{endpoint}\0{}\0{}\0{nanos}\0{counter}",
101
- canonical.display(),
102
- pane.as_str(),
103
- std::process::id(),
104
- );
105
- let digest = Sha256::digest(material.as_bytes());
106
- digest[..16].iter().map(|byte| format!("{byte:02x}")).collect()
107
- }
108
-
109
- /// Result of running an external command — the typed output of the OS edge.
110
- #[derive(Debug, Clone)]
111
- pub struct CommandOutput {
112
- /// process exit status was success (code 0).
113
- pub success: bool,
114
- /// exit code if the process exited normally.
115
- pub code: Option<i32>,
116
- pub stdout: String,
117
- pub stderr: String,
118
- }
119
-
120
- /// The single OS-edge seam: run an argv vector and return its output.
121
- /// Real impl spawns `std::process::Command`; tests inject canned/recording output so the
122
- /// argv-construction + output-parsing of [`TmuxBackend`] is testable without a live tmux server.
123
- pub trait CommandRunner: Send + Sync {
124
- fn run(&self, argv: &[String]) -> Result<CommandOutput, std::io::Error>;
125
-
126
- fn run_with_stdin(
127
- &self,
128
- argv: &[String],
129
- stdin: &str,
130
- ) -> Result<CommandOutput, std::io::Error> {
131
- let _ = stdin;
132
- self.run(argv)
133
- }
134
- }
135
-
136
- /// Production runner: `std::process::Command::new(argv[0]).args(argv[1..]).output()`.
137
- pub struct RealCommandRunner;
138
-
139
- const COMMAND_TIMEOUT: Duration = Duration::from_secs(5);
140
- const SPAWN_IDENTITY_TIMEOUT: Duration = Duration::from_millis(500);
141
- const SPAWN_IDENTITY_POLL_INTERVAL: Duration = Duration::from_millis(25);
142
-
143
- /// Keep the final tmux argv below the ~16 KiB command envelope observed on macOS.
144
- /// This is checked after shell quoting and socket arguments are applied, before
145
- /// the external tmux process is called.
146
- pub const TMUX_SPAWN_COMMAND_LIMIT_BYTES: usize = 16_000;
147
-
148
- impl CommandRunner for RealCommandRunner {
149
- fn run(&self, argv: &[String]) -> Result<CommandOutput, std::io::Error> {
150
- self.run_inner(argv, None)
151
- }
152
-
153
- fn run_with_stdin(
154
- &self,
155
- argv: &[String],
156
- stdin: &str,
157
- ) -> Result<CommandOutput, std::io::Error> {
158
- self.run_inner(argv, Some(stdin))
159
- }
160
- }
161
-
162
- impl RealCommandRunner {
163
- fn run_inner(
164
- &self,
165
- argv: &[String],
166
- stdin_text: Option<&str>,
167
- ) -> Result<CommandOutput, std::io::Error> {
168
- let Some(program) = argv.first() else {
169
- return Err(std::io::Error::new(
170
- std::io::ErrorKind::InvalidInput,
171
- "empty argv",
172
- ));
173
- };
174
- let mut child = std::process::Command::new(program)
175
- .args(argv.iter().skip(1))
176
- .stdin(if stdin_text.is_some() {
177
- Stdio::piped()
178
- } else {
179
- Stdio::null()
180
- })
181
- .stdout(Stdio::piped())
182
- .stderr(Stdio::piped())
183
- .spawn()?;
184
- if let Some(text) = stdin_text {
185
- let mut stdin = child
186
- .stdin
187
- .take()
188
- .ok_or_else(|| std::io::Error::other("stdin pipe missing"))?;
189
- stdin.write_all(text.as_bytes())?;
190
- }
191
- let stdout = child
192
- .stdout
193
- .take()
194
- .ok_or_else(|| std::io::Error::other("stdout pipe missing"))?;
195
- let stderr = child
196
- .stderr
197
- .take()
198
- .ok_or_else(|| std::io::Error::other("stderr pipe missing"))?;
199
- let stdout_thread = std::thread::spawn(move || read_pipe(stdout));
200
- let stderr_thread = std::thread::spawn(move || read_pipe(stderr));
201
- let deadline = Instant::now() + COMMAND_TIMEOUT;
202
- // Observe short-lived commands promptly; retain the old cadence for long ones.
203
- let mut poll_interval = Duration::from_millis(1);
204
- let status = loop {
205
- if let Some(status) = child.try_wait()? {
206
- break status;
207
- }
208
- let now = Instant::now();
209
- if now >= deadline {
210
- child.kill()?;
211
- child.wait()?;
212
- let _ = join_pipe_reader(stdout_thread)?;
213
- let _ = join_pipe_reader(stderr_thread)?;
214
- return Err(std::io::Error::new(
215
- std::io::ErrorKind::TimedOut,
216
- format!("{program} exceeded 5s timeout"),
217
- ));
218
- }
219
- std::thread::sleep(poll_interval.min(deadline.saturating_duration_since(now)));
220
- poll_interval = (poll_interval * 2).min(Duration::from_millis(25));
221
- };
222
- let stdout = join_pipe_reader(stdout_thread)?;
223
- let stderr = join_pipe_reader(stderr_thread)?;
224
- Ok(CommandOutput {
225
- success: status.success(),
226
- code: status.code(),
227
- stdout,
228
- stderr,
229
- })
230
- }
231
- }
232
-
233
- fn read_pipe<R: Read>(mut reader: R) -> Result<String, std::io::Error> {
234
- let mut bytes = Vec::new();
235
- reader.read_to_end(&mut bytes)?;
236
- Ok(String::from_utf8_lossy(&bytes).to_string())
237
- }
238
-
239
- fn join_pipe_reader(
240
- handle: std::thread::JoinHandle<Result<String, std::io::Error>>,
241
- ) -> Result<String, std::io::Error> {
242
- handle
243
- .join()
244
- .map_err(|_| std::io::Error::other("pipe reader thread panicked"))?
245
- }
246
-
247
- /// Concrete tmux backend: builds argv via the `transport::tmux_*_argv` builders, runs them through
248
- /// the [`CommandRunner`], and parses tmux output into the [`Transport`] typed returns.
249
- ///
250
- /// CP-1: a workspace-bound backend carries a PER-TEAM tmux socket (`socket = Some("ta-<hash>")`) so a
251
- /// dying shared `default` server can no longer tear the team down. The socket is injected at the RUN
252
- /// CHOKEPOINT ([`TmuxBackend::tmux_argv`]) — the `transport::tmux_*_argv` builders stay socket-free.
253
- pub struct TmuxBackend {
254
- runner: Box<dyn CommandRunner>,
255
- /// `Some(name)` for a per-team socket -> every `tmux` argv gets `-L <name>` injected after the
256
- /// leading "tmux" token; `None` (default) -> bare `tmux` on the shared default socket.
257
- socket: Option<TmuxSocketEndpoint>,
258
- /// swallow batch 2: workspace for failure-observability events (`tmux.*_failed`);
259
- /// `None` for non-workspace-bound backends (no event log to write to).
260
- event_workspace: Option<PathBuf>,
261
- }
262
-
263
- enum TmuxSocketEndpoint {
264
- Name(String),
265
- Path(String),
266
- }
267
-
268
- impl TmuxSocketEndpoint {
269
- fn as_endpoint(&self) -> &str {
270
- match self {
271
- TmuxSocketEndpoint::Name(socket) | TmuxSocketEndpoint::Path(socket) => socket,
272
- }
273
- }
274
- }
275
-
276
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
277
- pub(crate) enum RuntimeTmuxEndpointSource {
278
- StateTmuxEndpoint,
279
- StateTmuxSocket,
280
- WorkspaceFallback,
281
- }
282
-
283
- impl RuntimeTmuxEndpointSource {
284
- /// ---
285
- /// purpose: endpoint 来源的稳定诊断拼写,让日志能分清 endpoint 是从 state 读的还是 workspace 兜底算的
286
- /// returns: state.tmux_endpoint / state.tmux_socket / workspace_fallback 三者之一
287
- /// boundary: 只标来源,不表示该 endpoint 上真的有 tmux server
288
- /// ---
289
- pub(crate) fn as_str(self) -> &'static str {
290
- match self {
291
- Self::StateTmuxEndpoint => "state.tmux_endpoint",
292
- Self::StateTmuxSocket => "state.tmux_socket",
293
- Self::WorkspaceFallback => "workspace_fallback",
294
- }
295
- }
296
- }
297
-
298
- pub(crate) struct RuntimeTmuxBackendSelection {
299
- pub(crate) backend: TmuxBackend,
300
- pub(crate) tmux_endpoint_used: Option<String>,
301
- pub(crate) tmux_endpoint_source: RuntimeTmuxEndpointSource,
302
- }
303
-
304
- impl TmuxBackend {
305
- /// Backend bound to the real `tmux` subprocess on the SHARED default socket (no `-L`).
306
- /// Non-team callers + existing argv/unit tests stay unaffected.
307
- /// ---
308
- /// purpose: 构造绑在共享默认 socket 上的真实 tmux 后端(argv 不带 -L / -S)
309
- /// returns: 用 RealCommandRunner 执行、无 socket、无事件 workspace 的后端
310
- /// boundary: 不属于任何 team,故 kill_server 对它是 no-op;不写 events.jsonl(没有 workspace)
311
- /// ---
312
- pub fn new() -> Self {
313
- Self {
314
- runner: Box::new(RealCommandRunner),
315
- socket: None,
316
- event_workspace: None,
317
- }
318
- }
319
-
320
- /// CP-1 team backend: bound to the real `tmux` subprocess on a PER-WORKSPACE socket, derived
321
- /// deterministically from the canonicalized workspace path so the leader CLI, the daemon, and
322
- /// every later op (spawn / inject / has_session / kill) hit the SAME `tmux -L <socket>` server.
323
- /// ---
324
- /// purpose: 构造绑在「按 workspace 派生的专属 socket」上的真实 tmux 后端
325
- /// params:
326
- /// workspace: 工作区路径;socket 名由它经 socket_name_for_workspace 确定性派生
327
- /// returns: socket 为 Name(ta-xxxxxxxxxxxx)、事件写入该 workspace 的后端
328
- /// boundary: 只决定「连哪台 server」,不创建 server、不验证 socket 是否存在(探测见 socket_probe_missing_for_workspace)
329
- /// ---
330
- pub fn for_workspace(workspace: &Path) -> Self {
331
- Self {
332
- runner: Box::new(RealCommandRunner),
333
- socket: Some(TmuxSocketEndpoint::Name(socket_name_for_workspace(
334
- workspace,
335
- ))),
336
- event_workspace: Some(workspace.to_path_buf()),
337
- }
338
- }
339
-
340
- /// ---
341
- /// purpose: 按给定短 socket 名构造真实 tmux 后端
342
- /// params:
343
- /// socket: 短 socket 名;空串或 "default" 视为「用共享默认 socket」
344
- /// returns: socket 名非空且非 default 时绑 Name(socket),否则等价于 new()
345
- /// boundary: 不识别绝对路径(会被原样当短名走 -L);要按路径寻址请用 for_tmux_endpoint;不设事件 workspace
346
- /// ---
347
- pub(crate) fn for_socket_name(socket: &str) -> Self {
348
- if socket.is_empty() || socket == "default" {
349
- Self::new()
350
- } else {
351
- Self {
352
- runner: Box::new(RealCommandRunner),
353
- socket: Some(TmuxSocketEndpoint::Name(socket.to_string())),
354
- event_workspace: None,
355
- }
356
- }
357
- }
358
-
359
- /// ---
360
- /// purpose: 按 endpoint 字符串构造真实 tmux 后端,自动分辨绝对路径与短名
361
- /// params:
362
- /// endpoint: 绝对路径 ⇒ 直接当 socket 路径;短名 ⇒ 先解析成已存在或默认根下的路径;空串 / "default" ⇒ 共享默认 socket
363
- /// returns: 解析成功时绑 Path(...);短名解析不出路径时退回 new()
364
- /// boundary: 只解析寻址,不探活、不创建 server;不设事件 workspace
365
- /// ---
366
- pub(crate) fn for_tmux_endpoint(endpoint: &str) -> Self {
367
- if endpoint.is_empty() || endpoint == "default" {
368
- Self::new()
369
- } else if Path::new(endpoint).is_absolute() {
370
- Self {
371
- runner: Box::new(RealCommandRunner),
372
- socket: Some(TmuxSocketEndpoint::Path(endpoint.to_string())),
373
- event_workspace: None,
374
- }
375
- } else if let Some(path) = socket_path_for_name(endpoint) {
376
- Self {
377
- runner: Box::new(RealCommandRunner),
378
- socket: Some(TmuxSocketEndpoint::Path(
379
- path.to_string_lossy().into_owned(),
380
- )),
381
- event_workspace: None,
382
- }
383
- } else {
384
- Self::new()
385
- }
386
- }
387
-
388
- fn set_session_owner_marker(
389
- &self,
390
- session: &SessionName,
391
- workspace: &Path,
392
- team: &str,
393
- generation: &str,
394
- ) -> Result<(), TransportError> {
395
- let workspace = workspace
396
- .canonicalize()
397
- .unwrap_or_else(|_| workspace.to_path_buf())
398
- .to_string_lossy()
399
- .into_owned();
400
- for (option, value) in [
401
- (TMUX_SESSION_OWNER_WORKSPACE_OPTION, workspace),
402
- (TMUX_SESSION_OWNER_TEAM_OPTION, team.to_string()),
403
- (TMUX_SESSION_OWNER_GENERATION_OPTION, generation.to_string()),
404
- ] {
405
- let argv = self.tmux_argv(&[
406
- "tmux".to_string(),
407
- "set-option".to_string(),
408
- "-t".to_string(),
409
- session.as_str().to_string(),
410
- option.to_string(),
411
- value,
412
- ]);
413
- let output = self.runner.run(&argv)?;
414
- if !output.success {
415
- return Err(subprocess_error(argv, output));
416
- }
417
- }
418
- Ok(())
419
- }
420
-
421
- fn read_session_owner_option(
422
- &self,
423
- session: &SessionName,
424
- option: &str,
425
- ) -> Result<Option<String>, TransportError> {
426
- let argv = self.tmux_argv(&[
427
- "tmux".to_string(),
428
- "show-options".to_string(),
429
- "-qv".to_string(),
430
- "-t".to_string(),
431
- session.as_str().to_string(),
432
- option.to_string(),
433
- ]);
434
- let output = self.runner.run(&argv)?;
435
- if !output.success {
436
- return Ok(None);
437
- }
438
- let value = output.stdout.trim();
439
- Ok((!value.is_empty()).then(|| value.to_string()))
440
- }
441
-
442
- fn read_session_owner_marker(
443
- &self,
444
- session: &SessionName,
445
- ) -> Result<Option<SessionOwner>, TransportError> {
446
- let Some(workspace) = self.read_session_owner_option(
447
- session,
448
- TMUX_SESSION_OWNER_WORKSPACE_OPTION,
449
- )? else {
450
- return Ok(None);
451
- };
452
- let Some(team) = self.read_session_owner_option(session, TMUX_SESSION_OWNER_TEAM_OPTION)?
453
- else {
454
- return Ok(None);
455
- };
456
- let Some(generation) = self.read_session_owner_option(
457
- session,
458
- TMUX_SESSION_OWNER_GENERATION_OPTION,
459
- )? else {
460
- return Ok(None);
461
- };
462
- Ok(Some(SessionOwner {
463
- workspace,
464
- team,
465
- generation,
466
- }))
467
- }
468
-
469
- /// ---
470
- /// purpose: 把 leader 认领的绑定 nonce 写进 pane 级 tmux 用户选项,给「这个 pane 实例是不是我绑的那个」留可核凭据
471
- /// params:
472
- /// pane: 目标 pane 标识
473
- /// nonce: 本次绑定的凭据串,原样写入,不做格式校验
474
- /// returns: 写入命令成功即 Ok
475
- /// errors: tmux set-option 非 0 或子进程失败时返回 TransportError
476
- /// boundary: 只写不读、不比对;写的是 pane 级(-p)选项,随 pane 消亡,不跨 socket;不判断该 nonce 是否已被别人占用
477
- /// ---
478
- pub(crate) fn set_pane_binding_nonce(
479
- &self,
480
- pane: &PaneId,
481
- nonce: &str,
482
- ) -> Result<(), TransportError> {
483
- let argv = [
484
- "tmux".to_string(),
485
- "set-option".to_string(),
486
- "-p".to_string(),
487
- "-t".to_string(),
488
- pane.as_str().to_string(),
489
- TMUX_PANE_BINDING_NONCE_OPTION.to_string(),
490
- nonce.to_string(),
491
- ];
492
- self.run_ok(&argv)
493
- }
494
-
495
- /// Set the pane-instance nonce only when the pane option is unset. tmux
496
- /// serializes commands at the server, so concurrent first claims have one
497
- /// winner; losers read back that winner instead of persisting a stale nonce.
498
- pub(crate) fn set_pane_binding_nonce_if_unset(
499
- &self,
500
- pane: &PaneId,
501
- nonce: &str,
502
- ) -> Result<String, TransportError> {
503
- let argv = self.tmux_argv(&[
504
- "tmux".to_string(),
505
- "set-option".to_string(),
506
- "-p".to_string(),
507
- "-o".to_string(),
508
- "-t".to_string(),
509
- pane.as_str().to_string(),
510
- TMUX_PANE_BINDING_NONCE_OPTION.to_string(),
511
- nonce.to_string(),
512
- ]);
513
- let output = self.runner.run(&argv)?;
514
- if output.success {
515
- return Ok(nonce.to_string());
516
- }
517
- if output
518
- .stderr
519
- .to_ascii_lowercase()
520
- .contains("already set")
521
- {
522
- return self.read_pane_binding_nonce(pane);
523
- }
524
- Err(subprocess_error(argv, output))
525
- }
526
-
527
- fn read_pane_binding_nonce(&self, pane: &PaneId) -> Result<String, TransportError> {
528
- let argv = self.tmux_argv(&[
529
- "tmux".to_string(),
530
- "show-options".to_string(),
531
- "-p".to_string(),
532
- "-v".to_string(),
533
- "-t".to_string(),
534
- pane.as_str().to_string(),
535
- TMUX_PANE_BINDING_NONCE_OPTION.to_string(),
536
- ]);
537
- let output = self.runner.run(&argv)?;
538
- if !output.success {
539
- return Err(subprocess_error(argv, output));
540
- }
541
- let nonce = output.stdout.trim();
542
- if nonce.is_empty() {
543
- return Err(TransportError::Subprocess {
544
- argv,
545
- code: output.code,
546
- stderr: "pane binding nonce remained unset after conditional write".to_string(),
547
- });
548
- }
549
- Ok(nonce.to_string())
550
- }
551
-
552
- /// Backend with an injected runner (tests: canned/recording tmux output). Shared default socket.
553
- /// ---
554
- /// purpose: 用注入的 runner 构造后端(测试用录制/罐装 tmux 输出),绑共享默认 socket
555
- /// params:
556
- /// runner: 替代 RealCommandRunner 的执行 seam
557
- /// returns: 无 socket、无事件 workspace 的后端
558
- /// boundary: runner 注入是本文件唯一的 OS 边界替换 seam(with_runner_for_workspace / with_runner_for_tmux_endpoint 同用);不改变任何 argv 构造逻辑
559
- /// ---
560
- pub fn with_runner(runner: Box<dyn CommandRunner>) -> Self {
561
- Self {
562
- runner,
563
- socket: None,
564
- event_workspace: None,
565
- }
566
- }
567
-
568
- /// Backend with an injected runner bound to a per-workspace socket (tests: assert the `-L` is in
569
- /// the recorded argv for a workspace-bound backend).
570
- /// ---
571
- /// purpose: 用注入的 runner 构造绑 workspace 专属 socket 的后端(测试断言 -L 确实进了 argv)
572
- /// params:
573
- /// runner: 执行 seam
574
- /// workspace: socket 名与事件落盘位置的来源
575
- /// returns: socket 为 Name(派生名)、事件写入该 workspace 的后端
576
- /// boundary: socket 名派生与 for_workspace 完全同源,不允许出现第二套派生规则
577
- /// ---
578
- pub fn with_runner_for_workspace(runner: Box<dyn CommandRunner>, workspace: &Path) -> Self {
579
- Self {
580
- runner,
581
- socket: Some(TmuxSocketEndpoint::Name(socket_name_for_workspace(
582
- workspace,
583
- ))),
584
- event_workspace: Some(workspace.to_path_buf()),
585
- }
586
- }
587
-
588
- /// ---
589
- /// purpose: 用注入的 runner 构造按 endpoint 寻址的后端
590
- /// params:
591
- /// runner: 执行 seam
592
- /// endpoint: 绝对路径 ⇒ Path(...);空串 / "default" ⇒ 无 socket;短名 ⇒ 解析成路径,解析不出则无 socket
593
- /// returns: 按上述分支绑定 socket 的后端;不设事件 workspace
594
- /// boundary: 分支与 for_tmux_endpoint 语义一致但顺序不同(此处先判绝对路径),两者都不探活
595
- /// ---
596
- pub fn with_runner_for_tmux_endpoint(runner: Box<dyn CommandRunner>, endpoint: &str) -> Self {
597
- if Path::new(endpoint).is_absolute() {
598
- Self {
599
- runner,
600
- socket: Some(TmuxSocketEndpoint::Path(endpoint.to_string())),
601
- event_workspace: None,
602
- }
603
- } else if endpoint.is_empty() || endpoint == "default" {
604
- Self {
605
- runner,
606
- socket: None,
607
- event_workspace: None,
608
- }
609
- } else if let Some(path) = socket_path_for_name(endpoint) {
610
- Self {
611
- runner,
612
- socket: Some(TmuxSocketEndpoint::Path(
613
- path.to_string_lossy().into_owned(),
614
- )),
615
- event_workspace: None,
616
- }
617
- } else {
618
- Self {
619
- runner,
620
- socket: None,
621
- event_workspace: None,
622
- }
623
- }
624
- }
625
-
626
- /// Build the exact argv that a workspace-bound tmux backend will execute.
627
- /// ---
628
- /// purpose: 算出「workspace 绑定后端实际会执行的那条 argv」,供诊断与提示文案复用
629
- /// params:
630
- /// workspace: 决定注入哪个 -L socket
631
- /// argv: 原始 argv;首元素为 "tmux" 时才会被插入 socket 参数
632
- /// returns: 插好 socket 参数的 argv;非 tmux argv 原样返回
633
- /// boundary: 只构造不执行;结果必须与真实执行走的 tmux_argv 完全一致,否则提示会骗人
634
- /// ---
635
- pub fn argv_for_workspace(workspace: &Path, argv: &[String]) -> Vec<String> {
636
- Self::for_workspace(workspace).tmux_argv(argv)
637
- }
638
-
639
- /// THE RUN CHOKEPOINT: every executed `tmux` argv is funneled through here. When a per-team
640
- /// socket is set, inject `-L <socket>` right after the leading "tmux" token; otherwise pass argv
641
- /// through unchanged. Non-`tmux` argv (e.g. the spawned provider command) is never rewritten.
642
- fn tmux_argv(&self, argv: &[String]) -> Vec<String> {
643
- match &self.socket {
644
- Some(endpoint) if argv.first().map(String::as_str) == Some("tmux") => {
645
- let mut out = Vec::with_capacity(argv.len() + 2);
646
- out.push("tmux".to_string());
647
- match endpoint {
648
- TmuxSocketEndpoint::Name(socket) => {
649
- out.push("-L".to_string());
650
- out.push(socket.clone());
651
- }
652
- TmuxSocketEndpoint::Path(socket) => {
653
- out.push("-S".to_string());
654
- out.push(socket.clone());
655
- }
656
- }
657
- out.extend(argv.iter().skip(1).cloned());
658
- out
659
- }
660
- _ => argv.to_vec(),
661
- }
662
- }
663
-
664
- /// `tmux -L <socket> kill-server` (CP-1 cleanup): best-effort teardown of the per-team server on
665
- /// shutdown so per-team sockets do not orphan. No-op (and never errors) for a default-socket
666
- /// backend, and a "no server" failure is ignored.
667
- /// ---
668
- /// purpose: 收尾时尽力拆掉本 team 专属的 tmux server,避免 socket 变孤儿
669
- /// boundary:
670
- /// - 默认 socket 后端直接返回,绝不拆共享 server
671
- /// - 只在 list_targets 证明 server 为空时才拆;列举失败按「未证明所有权」处理,倒向不拆;有事件 workspace 时才写 tmux.kill_server_skipped_nonempty_or_unknown 事件(按 endpoint / 短名构造的后端没有,静默跳过)
672
- /// - 尽力而为:执行结果被丢弃,不返回错误、不重试
673
- /// ---
674
- pub fn kill_server(&self) {
675
- if self.socket.is_none() {
676
- return;
677
- }
678
- // A server-level kill is only safe after the caller has removed every
679
- // resource it owns. A non-empty server may carry a pre-existing team
680
- // (or a leader owned by another launcher), so fail closed instead of
681
- // turning an endpoint cleanup into a shared-server teardown. An
682
- // inconclusive probe is also not proof of ownership.
683
- let server_is_empty = match self.list_targets() {
684
- Ok(targets) => targets.is_empty(),
685
- Err(_) => false,
686
- };
687
- if !server_is_empty {
688
- if let Some(workspace) = &self.event_workspace {
689
- let _ = crate::event_log::EventLog::new(workspace).write(
690
- "tmux.kill_server_skipped_nonempty_or_unknown",
691
- serde_json::json!({
692
- "reason": "server_ownership_not_proven",
693
- "endpoint": self.tmux_endpoint(),
694
- }),
695
- );
696
- }
697
- return;
698
- }
699
- let argv = self.tmux_argv(&["tmux".to_string(), "kill-server".to_string()]);
700
- let _ = self.runner.run(&argv);
701
- }
702
- }
703
-
704
- /// ---
705
- /// purpose: 选出运行期该用的 tmux 后端——优先跟随 state 里持久化的 endpoint,没有才按 workspace 派生
706
- /// params:
707
- /// workspace: 兜底派生 socket 的来源
708
- /// state: 运行期状态 JSON;从中读 tmux_endpoint,其次 tmux_socket
709
- /// returns: 后端 + 实际使用的 endpoint + 来源标记(三者一并返回,便于日志说清为什么连这台)
710
- /// boundary: 只做选择,不探活、不创建 server;state 里的 endpoint 即便已失效也照选,失败留给后续命令暴露
711
- /// ---
712
- pub(crate) fn tmux_backend_for_runtime_state_or_workspace(
713
- workspace: &Path,
714
- state: Option<&serde_json::Value>,
715
- ) -> RuntimeTmuxBackendSelection {
716
- let (mut backend, source) =
717
- if let Some((endpoint, source)) = runtime_tmux_endpoint_from_state(state) {
718
- (TmuxBackend::for_tmux_endpoint(endpoint), source)
719
- } else {
720
- (
721
- TmuxBackend::for_workspace(workspace),
722
- RuntimeTmuxEndpointSource::WorkspaceFallback,
723
- )
724
- };
725
- // A persisted endpoint changes addressing, not the owning input-lock scope.
726
- backend.event_workspace = Some(workspace.to_path_buf());
727
- RuntimeTmuxBackendSelection {
728
- tmux_endpoint_used: backend.tmux_endpoint(),
729
- backend,
730
- tmux_endpoint_source: source,
731
- }
732
- }
733
-
734
- /// ---
735
- /// purpose: 同 tmux_backend_for_runtime_state_or_workspace,但用注入的 runner,给测试断言选择逻辑
736
- /// params:
737
- /// runner: 执行 seam
738
- /// workspace: 兜底派生 socket 的来源
739
- /// state: 运行期状态 JSON
740
- /// returns: 后端 + 实际使用的 endpoint + 来源标记
741
- /// cfg: test
742
- /// boundary: 仅测试编译;选择分支必须与生产版本同构,否则测的不是同一件事
743
- /// ---
744
- #[cfg(test)]
745
- pub(crate) fn tmux_backend_with_runner_for_runtime_state_or_workspace(
746
- runner: Box<dyn CommandRunner>,
747
- workspace: &Path,
748
- state: Option<&serde_json::Value>,
749
- ) -> RuntimeTmuxBackendSelection {
750
- let (mut backend, source) =
751
- if let Some((endpoint, source)) = runtime_tmux_endpoint_from_state(state) {
752
- (
753
- TmuxBackend::with_runner_for_tmux_endpoint(runner, endpoint),
754
- source,
755
- )
756
- } else {
757
- (
758
- TmuxBackend::with_runner_for_workspace(runner, workspace),
759
- RuntimeTmuxEndpointSource::WorkspaceFallback,
760
- )
761
- };
762
- backend.event_workspace = Some(workspace.to_path_buf());
763
- RuntimeTmuxBackendSelection {
764
- tmux_endpoint_used: backend.tmux_endpoint(),
765
- backend,
766
- tmux_endpoint_source: source,
767
- }
768
- }
769
-
770
- fn runtime_tmux_endpoint_from_state(
771
- state: Option<&serde_json::Value>,
772
- ) -> Option<(&str, RuntimeTmuxEndpointSource)> {
773
- state.and_then(|state| {
774
- state
775
- .get("tmux_endpoint")
776
- .and_then(|v| v.as_str())
777
- .filter(|endpoint| !endpoint.is_empty())
778
- .map(|endpoint| (endpoint, RuntimeTmuxEndpointSource::StateTmuxEndpoint))
779
- .or_else(|| {
780
- state
781
- .get("tmux_socket")
782
- .and_then(|v| v.as_str())
783
- .filter(|endpoint| !endpoint.is_empty())
784
- .map(|endpoint| (endpoint, RuntimeTmuxEndpointSource::StateTmuxSocket))
785
- })
786
- })
787
- }
788
-
789
- /// CP-1 socket name: SHORT + DETERMINISTIC per canonical workspace path. `ta-` + 12 hex chars of a
790
- /// stable FNV-1a hash over the canonicalized path. AF_UNIX `sun_path` is ~104 chars and the socket
791
- /// lives at `/tmp/tmux-<uid>/<name>`, so we must NOT use the (~88-char) session name. §10: a
792
- /// canonicalize failure falls back to the raw path (never panics).
793
- /// Public re-export of the crate-private canonical workspace hash used
794
- /// by the tmux short-socket derivation. `transport_factory` uses this
795
- /// same hash for the ConPTY `workspace_hash` so both backends see
796
- /// identical workspace identity. Adding a wrapper (not calling
797
- /// `socket_name_for_workspace` directly outside this file) keeps the
798
- /// existing internal API stable.
799
- /// ---
800
- /// purpose: 对外暴露「workspace 身份短哈希」,让 tmux 与 ConPTY 两个后端看到同一个 workspace 身份
801
- /// params:
802
- /// workspace: 工作区路径;先 canonicalize 再哈希
803
- /// returns: 12 位十六进制串,即 socket 名去掉 ta- 前缀的部分
804
- /// boundary: 与 socket_name_for_workspace 同源,禁止另起一套哈希;canonicalize 失败时退回原始路径参与哈希,故未落盘的路径可能与落盘后不同值
805
- /// ---
806
- pub fn workspace_short_hash_pub(workspace: &Path) -> String {
807
- // The tmux short-socket name is `ta-<12 hex>`; the workspace-hash
808
- // used by the ConPTY workspace identity is the raw 12-hex portion
809
- // (no `ta-` prefix), which is what the shim/pipe name derivation
810
- // expects. Reuse the exact same hash so drift is impossible.
811
- let name = socket_name_for_workspace(workspace);
812
- name.strip_prefix("ta-").unwrap_or(&name).to_string()
813
- }
814
-
815
- /// Public re-export of the crate-private `runtime_tmux_endpoint_from_state`
816
- /// probe. `transport_factory` uses this to spot the legacy tmux endpoint
817
- /// in `state` without duplicating the field-precedence logic.
818
- /// ---
819
- /// purpose: 对外暴露 state 里 tmux endpoint 的读取与字段优先级,避免调用方各写一份
820
- /// params:
821
- /// state: 运行期状态 JSON
822
- /// returns: Some((endpoint, 来源标记)) 当 tmux_endpoint 或 tmux_socket 非空;两者都缺或为空则 None
823
- /// boundary: 只读字段不探活;返回值里不会出现 workspace_fallback(那是选后端时才产生的来源)
824
- /// ---
825
- pub fn runtime_tmux_endpoint_from_state_pub(
826
- state: Option<&serde_json::Value>,
827
- ) -> Option<(String, &'static str)> {
828
- runtime_tmux_endpoint_from_state(state).map(|(endpoint, source)| {
829
- let src = match source {
830
- RuntimeTmuxEndpointSource::StateTmuxEndpoint => "state.tmux_endpoint",
831
- RuntimeTmuxEndpointSource::StateTmuxSocket => "state.tmux_socket",
832
- RuntimeTmuxEndpointSource::WorkspaceFallback => "workspace_fallback",
833
- };
834
- (endpoint.to_string(), src)
835
- })
836
- }
837
-
838
- /// ---
839
- /// purpose: 由 workspace 路径确定性派生短 socket 名,保证 CLI、daemon 与后续每条命令都落到同一台 tmux server
840
- /// params:
841
- /// workspace: 工作区路径;先 canonicalize,失败则退回原始路径
842
- /// returns: ta- 加 12 位十六进制(FNV-1a 低 48 位)
843
- /// boundary:
844
- /// - 必须短:AF_UNIX 路径长度有限,不能拿 session 名当 socket 名
845
- /// - 用固定 FNV-1a 而非 std 默认哈希(后者跨版本不稳定)
846
- /// - 只算名字,不判断该 socket 是否存在
847
- /// ---
848
- pub(crate) fn socket_name_for_workspace(workspace: &Path) -> String {
849
- let canonical = workspace
850
- .canonicalize()
851
- .unwrap_or_else(|_| workspace.to_path_buf());
852
- let mut hasher = Fnv1a::default();
853
- canonical.as_os_str().hash(&mut hasher);
854
- format!("ta-{:012x}", hasher.finish() & 0xffff_ffff_ffff)
855
- }
856
-
857
- /// ---
858
- /// purpose: 给出 workspace 专属 socket 的文件路径
859
- /// params:
860
- /// workspace: 工作区路径
861
- /// returns: 已存在的 socket 路径优先;否则给默认根下的预期路径;Windows 上恒为 None
862
- /// boundary: 返回 Some 不代表 socket 存在(可能只是「按约定应该在这」);要判存在用 socket_probe_missing_for_workspace
863
- /// ---
864
- pub(crate) fn socket_path_for_workspace(workspace: &Path) -> Option<PathBuf> {
865
- socket_path_for_name(&socket_name_for_workspace(workspace))
866
- }
867
-
868
- /// ---
869
- /// purpose: 探测 workspace 专属 socket 当前是否不存在
870
- /// params:
871
- /// workspace: 工作区路径
872
- /// returns: 在已知 socket 根下都找不到该名字时为 true
873
- /// boundary: 只看文件是否存在,不连不握手——socket 文件在但 server 已死也会报 false
874
- /// ---
875
- pub(crate) fn socket_probe_missing_for_workspace(workspace: &Path) -> bool {
876
- existing_socket_path_for_workspace(workspace).is_none()
877
- }
878
-
879
- fn existing_socket_path_for_workspace(workspace: &Path) -> Option<PathBuf> {
880
- existing_socket_path_for_name(&socket_name_for_workspace(workspace))
881
- }
882
-
883
- /// ---
884
- /// purpose: 把短 socket 名解析成文件路径
885
- /// params:
886
- /// socket_name: 短名;空串、"default"、绝对路径三种输入都视为「无短名可解析」
887
- /// returns: 已存在则返回实际路径;否则 Unix 上给 /tmp/tmux-<uid>/<name> 预期路径,Windows 上 None
888
- /// cfg: unix 分支读 geteuid;not(unix) 分支恒 None
889
- /// boundary: 不创建目录、不创建 socket;返回 Some 不代表文件存在
890
- /// ---
891
- pub(crate) fn socket_path_for_name(socket_name: &str) -> Option<PathBuf> {
892
- if socket_name.is_empty() || socket_name == "default" || Path::new(socket_name).is_absolute() {
893
- return None;
894
- }
895
- if let Some(existing) = existing_socket_path_for_name(socket_name) {
896
- return Some(existing);
897
- }
898
- // Batch 1: tmux uses `/tmp/tmux-<uid>/` on Unix; on Windows this
899
- // helper is dead code (Command::new "tmux" fails at spawn time
900
- // before this path is dereferenced). N38 typed unsupported honored
901
- // at the shellout boundary.
902
- #[cfg(unix)]
903
- {
904
- let uid = unsafe { libc::geteuid() };
905
- let default_root = PathBuf::from(format!("/tmp/tmux-{uid}"));
906
- let default_root = default_root.canonicalize().unwrap_or(default_root);
907
- Some(default_root.join(socket_name))
908
- }
909
- #[cfg(not(unix))]
910
- {
911
- // Windows: tmux socket-root derivation is meaningless. Return
912
- // None so the caller sees the honest "no such socket" branch.
913
- let _ = socket_name;
914
- None
915
- }
916
- }
917
-
918
- fn existing_socket_path_for_name(socket_name: &str) -> Option<PathBuf> {
919
- let roots = tmux_socket_roots();
920
- for root in &roots {
921
- let root = root.canonicalize().unwrap_or_else(|_| root.clone());
922
- let candidate = root.join(socket_name);
923
- if candidate.exists() {
924
- return Some(candidate.canonicalize().unwrap_or(candidate));
925
- }
926
- }
927
- None
928
- }
929
-
930
- /// ---
931
- /// purpose: socket 找不到时给操作者的可执行提示,把期望的 socket 名与找过的目录都写出来
932
- /// params:
933
- /// workspace: 工作区路径,用于派生 socket 名
934
- /// returns: 含 socket 名、已搜索根目录列表与下一步命令的单行提示
935
- /// boundary: 只生成文案,不重试、不修复、不创建 socket
936
- /// ---
937
- pub(crate) fn socket_missing_hint_for_workspace(workspace: &Path) -> String {
938
- let socket_name = socket_name_for_workspace(workspace);
939
- let roots = tmux_socket_roots()
940
- .into_iter()
941
- .map(|root| root.display().to_string())
942
- .collect::<Vec<_>>()
943
- .join(", ");
944
- format!(
945
- "tmux socket {socket_name} not found under [{roots}]; run `team-agent attach-leader` or restart the team before attaching"
946
- )
947
- }
948
-
949
- /// ---
950
- /// purpose: 生成让操作者手工 attach 到指定窗口的 tmux 命令行(按 workspace 派生 socket)
951
- /// params:
952
- /// workspace: 决定 -S 后面的 socket 路径
953
- /// session_name: attach 目标 session
954
- /// window_name: attach 目标 window
955
- /// returns: 完整命令字符串;socket 路径解析不出时 None
956
- /// boundary: 只生成文案、不执行、不验证 session/window 是否存在;endpoint 已持久化在 state 里时应改用 attach_command_for_runtime_state_or_workspace,否则会指到错误的 socket
957
- /// ---
958
- pub(crate) fn attach_command_for_workspace(
959
- workspace: &Path,
960
- session_name: &SessionName,
961
- window_name: &str,
962
- ) -> Option<String> {
963
- let socket_path = socket_path_for_workspace(workspace)?;
964
- Some(format!(
965
- "tmux -S {} attach -t {}:{}",
966
- socket_path.display(),
967
- session_name.as_str(),
968
- window_name
969
- ))
970
- }
971
-
972
- /// ---
973
- /// purpose: 同 attach_command_for_workspace,但只到 session 一级(不指定 window)
974
- /// params:
975
- /// workspace: 决定 -S 后面的 socket 路径
976
- /// session_name: attach 目标 session
977
- /// returns: 完整命令字符串;socket 路径解析不出时 None
978
- /// boundary: 只生成文案、不执行、不验证 session 是否存在
979
- /// ---
980
- pub(crate) fn attach_command_for_session(
981
- workspace: &Path,
982
- session_name: &SessionName,
983
- ) -> Option<String> {
984
- let socket_path = socket_path_for_workspace(workspace)?;
985
- Some(format!(
986
- "tmux -S {} attach -t {}",
987
- socket_path.display(),
988
- session_name.as_str()
989
- ))
990
- }
991
-
992
- /// ---
993
- /// purpose: 按 transport 自报的 endpoint 生成 attach 命令,保证提示指向它真正在用的那台 server
994
- /// params:
995
- /// transport: 提供 tmux_endpoint 的传输后端
996
- /// session_name: attach 目标 session
997
- /// returns: 完整命令字符串;后端报不出 endpoint(非 tmux / 测试替身)时 None
998
- /// boundary: 只生成文案、不执行;endpoint 是绝对路径用 -S、短名用 -L,由 attach_command_for_endpoint_session 分辨
999
- /// ---
1000
- pub(crate) fn attach_command_for_transport_session(
1001
- transport: &dyn crate::transport::Transport,
1002
- session_name: &SessionName,
1003
- ) -> Option<String> {
1004
- let endpoint = transport.tmux_endpoint()?;
1005
- Some(attach_command_for_endpoint_session(&endpoint, session_name))
1006
- }
1007
-
1008
- /// Bug #7 (prerelease 0.4.0 gate review §6): when the runtime state carries a
1009
- /// persisted `tmux_endpoint` / `tmux_socket` (e.g. `/private/tmp/tmux-501/default`),
1010
- /// the attach command MUST point at THAT endpoint, not the workspace-hash
1011
- /// socket — otherwise operators are told to attach to a socket where the
1012
- /// session does not exist. Falls back to workspace-hash when state has no
1013
- /// persisted endpoint.
1014
- /// ---
1015
- /// purpose: 生成 attach 到指定窗口的命令,优先跟随 state 里持久化的 endpoint,没有才回落 workspace 派生 socket
1016
- /// params:
1017
- /// workspace: 回落路径的来源
1018
- /// state: 运行期状态 JSON;从中读 tmux_endpoint / tmux_socket
1019
- /// session_name: attach 目标 session
1020
- /// window_name: attach 目标 window
1021
- /// returns: 完整命令字符串;两条路都算不出 socket 时 None
1022
- /// boundary: 只生成文案、不执行、不验证目标存在;endpoint 是绝对路径用 -S、短名用 -L
1023
- /// ---
1024
- pub(crate) fn attach_command_for_runtime_state_or_workspace(
1025
- workspace: &Path,
1026
- state: Option<&serde_json::Value>,
1027
- session_name: &SessionName,
1028
- window_name: &str,
1029
- ) -> Option<String> {
1030
- if let Some((endpoint, _source)) = runtime_tmux_endpoint_from_state(state) {
1031
- let display = endpoint.to_string();
1032
- // Distinguish absolute path (`-S <path>`) from short socket name (`-L <name>`).
1033
- let flag = if Path::new(endpoint).is_absolute() {
1034
- "-S"
1035
- } else {
1036
- "-L"
1037
- };
1038
- return Some(format!(
1039
- "tmux {flag} {display} attach -t {}:{}",
1040
- session_name.as_str(),
1041
- window_name
1042
- ));
1043
- }
1044
- attach_command_for_workspace(workspace, session_name, window_name)
1045
- }
1046
-
1047
- /// ---
1048
- /// purpose: 同 attach_command_for_runtime_state_or_workspace,但只到 session 一级
1049
- /// params:
1050
- /// workspace: 回落路径的来源
1051
- /// state: 运行期状态 JSON
1052
- /// session_name: attach 目标 session
1053
- /// returns: 完整命令字符串;两条路都算不出 socket 时 None
1054
- /// boundary: 只生成文案、不执行、不验证 session 存在
1055
- /// ---
1056
- pub(crate) fn attach_command_for_runtime_state_session_or_workspace(
1057
- workspace: &Path,
1058
- state: Option<&serde_json::Value>,
1059
- session_name: &SessionName,
1060
- ) -> Option<String> {
1061
- if let Some((endpoint, _source)) = runtime_tmux_endpoint_from_state(state) {
1062
- return Some(attach_command_for_endpoint_session(endpoint, session_name));
1063
- }
1064
- attach_command_for_session(workspace, session_name)
1065
- }
1066
-
1067
- fn attach_command_for_endpoint_session(endpoint: &str, session_name: &SessionName) -> String {
1068
- let flag = if Path::new(endpoint).is_absolute() {
1069
- "-S"
1070
- } else {
1071
- "-L"
1072
- };
1073
- format!("tmux {flag} {endpoint} attach -t {}", session_name.as_str())
1074
- }
1075
-
1076
- /// ---
1077
- /// purpose: 为一组窗口批量生成 attach 命令
1078
- /// params:
1079
- /// workspace: 决定 socket 路径
1080
- /// session_name: attach 目标 session
1081
- /// window_names: 待生成的窗口名序列
1082
- /// returns: 生成成功的命令列表;算不出 socket 的条目被静默丢弃,故长度可能短于入参
1083
- /// boundary: 只生成文案、不执行;丢弃发生在整体层面(socket 算不出就一条都没有),调用方不能假定下标与入参对齐
1084
- /// ---
1085
- pub(crate) fn attach_commands_for_windows<'a>(
1086
- workspace: &Path,
1087
- session_name: &SessionName,
1088
- window_names: impl IntoIterator<Item = &'a str>,
1089
- ) -> Vec<String> {
1090
- window_names
1091
- .into_iter()
1092
- .filter_map(|window_name| {
1093
- attach_command_for_workspace(workspace, session_name, window_name)
1094
- })
1095
- .collect()
1096
- }
1097
-
1098
- /// ---
1099
- /// purpose: 列出本机可能放 tmux socket 的根目录
1100
- /// returns: Unix 上为 /tmp/tmux-<uid> 加 TMPDIR/tmux-<uid>(排序去重);Windows 上为空
1101
- /// cfg: unix 读 geteuid 与 TMPDIR;not(unix) 返回空表示「本平台无此约定」
1102
- /// boundary: 只列约定目录,不验证目录存在、不列举里面的 socket(那是 tmux_socket_endpoints)
1103
- /// ---
1104
- pub(crate) fn tmux_socket_roots() -> Vec<PathBuf> {
1105
- // Batch 1: `/tmp/tmux-<uid>` root enumeration is Unix-only tmux
1106
- // convention. On Windows return empty so the caller loops zero
1107
- // times (honest "no tmux socket roots" — tmux is not deployed on
1108
- // native Windows without WSL, and WSL is out of scope).
1109
- #[cfg(unix)]
1110
- {
1111
- let uid = unsafe { libc::geteuid() };
1112
- let mut roots = vec![PathBuf::from(format!("/tmp/tmux-{uid}"))];
1113
- if let Some(tmpdir) = std::env::var_os("TMPDIR") {
1114
- roots.push(PathBuf::from(tmpdir).join(format!("tmux-{uid}")));
1115
- }
1116
- roots.sort();
1117
- roots.dedup();
1118
- roots
1119
- }
1120
- #[cfg(not(unix))]
1121
- {
1122
- Vec::new()
1123
- }
1124
- }
1125
-
1126
- /// ---
1127
- /// purpose: 枚举本机所有已存在的 tmux socket 路径
1128
- /// returns: 各 socket 根下真正是 socket 文件的绝对路径,排序去重;Windows 上为空
1129
- /// cfg: unix 才用 is_socket 过滤;not(unix) 直接跳过(该平台 socket 根为空)
1130
- /// boundary: 只看文件类型,不连不握手——列出的 socket 可能属于已死的 server;不做任何删除
1131
- /// ---
1132
- pub(crate) fn tmux_socket_endpoints() -> Vec<String> {
1133
- let mut endpoints = Vec::new();
1134
- for root in tmux_socket_roots() {
1135
- let Ok(entries) = std::fs::read_dir(root) else {
1136
- continue;
1137
- };
1138
- for entry in entries.flatten() {
1139
- let Ok(file_type) = entry.file_type() else {
1140
- continue;
1141
- };
1142
- // Batch 1: `FileTypeExt::is_socket` is Unix-only. Dead code
1143
- // on Windows because `tmux_socket_roots()` returns empty
1144
- // there (no /tmp/tmux-<uid> convention). We still cfg the
1145
- // method call so `cargo check --target x86_64-pc-windows-msvc`
1146
- // sees no `std::os::unix::fs::FileTypeExt` reference.
1147
- #[cfg(unix)]
1148
- {
1149
- if !file_type.is_socket() {
1150
- continue;
1151
- }
1152
- }
1153
- #[cfg(not(unix))]
1154
- {
1155
- let _ = file_type;
1156
- continue;
1157
- }
1158
- let path = entry.path();
1159
- let path = path.canonicalize().unwrap_or(path);
1160
- endpoints.push(path.to_string_lossy().to_string());
1161
- }
1162
- }
1163
- endpoints.sort();
1164
- endpoints.dedup();
1165
- endpoints
1166
- }
1167
-
1168
- /// ---
1169
- /// purpose: 从当前进程所在的 tmux 环境($TMUX)反推它连的是哪个 socket
1170
- /// returns: $TMUX 首段是绝对路径时返回该路径;$TMUX 未设 / 为空 / 首段非绝对路径时 None
1171
- /// boundary: 读进程环境,只在自己就跑在 tmux 里时有意义;不校验该 socket 仍可用
1172
- /// ---
1173
- pub(crate) fn socket_name_from_tmux_env() -> Option<String> {
1174
- let tmux = std::env::var("TMUX")
1175
- .ok()
1176
- .filter(|value| !value.is_empty())?;
1177
- let socket_path = tmux.split(',').next().unwrap_or("").trim();
1178
- if socket_path.is_empty() || !Path::new(socket_path).is_absolute() {
1179
- return None;
1180
- }
1181
- Some(socket_path.to_string())
1182
- }
1183
-
1184
- /// Deterministic FNV-1a (64-bit) — std `DefaultHasher` is NOT stable across releases, so a fixed
1185
- /// FNV keeps the socket identical for the CLI, the daemon, and every later op on the same workspace.
1186
- struct Fnv1a(u64);
1187
-
1188
- impl Default for Fnv1a {
1189
- fn default() -> Self {
1190
- Self(0xcbf2_9ce4_8422_2325)
1191
- }
1192
- }
1193
-
1194
- impl Hasher for Fnv1a {
1195
- fn finish(&self) -> u64 {
1196
- self.0
1197
- }
1198
-
1199
- fn write(&mut self, bytes: &[u8]) {
1200
- for &b in bytes {
1201
- self.0 ^= u64::from(b);
1202
- self.0 = self.0.wrapping_mul(0x0000_0100_0000_01b3);
1203
- }
1204
- }
1205
- }
1206
-
1207
- impl Default for TmuxBackend {
1208
- fn default() -> Self {
1209
- Self::new()
1210
- }
1211
- }
1212
-
1213
- impl TmuxBackend {
1214
- fn spawn(
1215
- &self,
1216
- session: &SessionName,
1217
- window: &WindowName,
1218
- argv: &[String],
1219
- cwd: &Path,
1220
- env: &BTreeMap<String, String>,
1221
- env_unset: &[String],
1222
- first: bool,
1223
- ) -> Result<SpawnResult, TransportError> {
1224
- let command = shell_command(argv, cwd, env, env_unset);
1225
- self.spawn_with_command(session, window, &command, first)
1226
- }
1227
-
1228
- /// 0.4.x (CR C-2): spawn variant that takes a pre-built shell command
1229
- /// (used by `spawn_first_with_leader_shell_wrapper` /
1230
- /// `spawn_into_with_leader_shell_wrapper` to inject the leader wrapper
1231
- /// shape without going through `shell_command`'s `exec`-only template).
1232
- fn spawn_with_command(
1233
- &self,
1234
- session: &SessionName,
1235
- window: &WindowName,
1236
- command: &str,
1237
- first: bool,
1238
- ) -> Result<SpawnResult, TransportError> {
1239
- let spawn_argv = tmux_spawn_argv(session, window, command, first);
1240
- self.validate_spawn_command(
1241
- &spawn_argv,
1242
- if first {
1243
- "tmux.new-session"
1244
- } else {
1245
- "tmux.new-window"
1246
- },
1247
- session,
1248
- window,
1249
- )?;
1250
- let output = self.run_spawn(&spawn_argv)?;
1251
- let pane = output.stdout.trim();
1252
- if pane.is_empty() {
1253
- return Err(TransportError::Subprocess {
1254
- argv: spawn_argv,
1255
- code: output.code,
1256
- stderr: format!(
1257
- "tmux spawn returned no pane id for {}:{}",
1258
- session.as_str(),
1259
- window.as_str()
1260
- ),
1261
- });
1262
- }
1263
- let pane_id = PaneId::new(pane);
1264
- let deadline = Instant::now() + SPAWN_IDENTITY_TIMEOUT;
1265
- let observed = loop {
1266
- match self.list_targets() {
1267
- Ok(targets) => {
1268
- if let Some(target) = targets.iter().find(|target| {
1269
- target.pane_id == pane_id
1270
- && target.session.as_str() == session.as_str()
1271
- && target
1272
- .window_name
1273
- .as_ref()
1274
- .is_some_and(|name| name.as_str() == window.as_str())
1275
- }) {
1276
- return Ok(SpawnResult {
1277
- pane_id,
1278
- session: session.clone(),
1279
- window: window.clone(),
1280
- child_pid: target.pane_pid,
1281
- });
1282
- }
1283
- if let Some(target) = targets.iter().find(|target| target.pane_id == pane_id) {
1284
- break format!(
1285
- "{}:{}",
1286
- target.session.as_str(),
1287
- target
1288
- .window_name
1289
- .as_ref()
1290
- .map(WindowName::as_str)
1291
- .unwrap_or("<unknown>")
1292
- );
1293
- }
1294
- if Instant::now() >= deadline {
1295
- break "<missing-from-list-targets>".to_string();
1296
- }
1297
- }
1298
- Err(error) => {
1299
- if Instant::now() >= deadline {
1300
- break format!("<list-targets-error:{error}>");
1301
- }
1302
- }
1303
- }
1304
- std::thread::sleep(SPAWN_IDENTITY_POLL_INTERVAL);
1305
- };
1306
- let rollback_argv = vec![
1307
- "tmux".to_string(),
1308
- "kill-pane".to_string(),
1309
- "-t".to_string(),
1310
- pane_id.as_str().to_string(),
1311
- ];
1312
- let rollback_error = self.run_ok(&rollback_argv).err();
1313
- let rollback_suffix = rollback_error
1314
- .map(|error| format!("; failed to roll back spawned pane: {error}"))
1315
- .unwrap_or_default();
1316
- Err(TransportError::Subprocess {
1317
- argv: spawn_argv,
1318
- code: output.code,
1319
- stderr: format!(
1320
- "tmux spawn pane identity mismatch: requested={}:{} observed_pane={} observed={}{}",
1321
- session.as_str(),
1322
- window.as_str(),
1323
- pane_id.as_str(),
1324
- observed,
1325
- rollback_suffix
1326
- ),
1327
- })
1328
- }
1329
-
1330
- fn spawn_split(
1331
- &self,
1332
- session: &SessionName,
1333
- window: &WindowName,
1334
- argv: &[String],
1335
- cwd: &Path,
1336
- env: &BTreeMap<String, String>,
1337
- env_unset: &[String],
1338
- ) -> Result<SpawnResult, TransportError> {
1339
- let command = shell_command(argv, cwd, env, env_unset);
1340
- let target = format!("{}:{}", session.as_str(), window.as_str());
1341
- // E53 (0.3.26, adaptive layout same-session tabs): `-d` prevents the
1342
- // new split pane from stealing focus from the leader's active pane.
1343
- // Same rationale as the `-d` on `new-window` in transport.rs; for
1344
- // adaptive layout the leader and all workers share the same tmux
1345
- // session, and every focus-stealing spawn is a disruption.
1346
- let split_argv = vec![
1347
- "tmux".to_string(),
1348
- "split-window".to_string(),
1349
- "-d".to_string(),
1350
- "-t".to_string(),
1351
- target.clone(),
1352
- "-h".to_string(),
1353
- "-P".to_string(),
1354
- "-F".to_string(),
1355
- "#{pane_id}".to_string(),
1356
- "sh".to_string(),
1357
- "-lc".to_string(),
1358
- command,
1359
- ];
1360
- self.validate_spawn_command(&split_argv, "tmux.split-window", session, window)?;
1361
- let output = self.run_spawn(&split_argv)?;
1362
- let pane = output.stdout.trim();
1363
- if pane.is_empty() {
1364
- return Err(TransportError::Subprocess {
1365
- argv: split_argv,
1366
- code: output.code,
1367
- stderr: format!("tmux split-window returned no pane id for {target}"),
1368
- });
1369
- }
1370
- let layout_argv = vec![
1371
- "tmux".to_string(),
1372
- "select-layout".to_string(),
1373
- "-t".to_string(),
1374
- target,
1375
- "even-horizontal".to_string(),
1376
- ];
1377
- self.run_ok(&layout_argv)?;
1378
- Ok(SpawnResult {
1379
- pane_id: PaneId::new(pane),
1380
- session: session.clone(),
1381
- window: window.clone(),
1382
- child_pid: None,
1383
- })
1384
- }
1385
-
1386
- fn run_ok(&self, argv: &[String]) -> Result<(), TransportError> {
1387
- let argv = self.tmux_argv(argv);
1388
- let output = self.runner.run(&argv)?;
1389
- if output.success {
1390
- Ok(())
1391
- } else {
1392
- Err(subprocess_error(argv, output))
1393
- }
1394
- }
1395
-
1396
- fn validate_spawn_command(
1397
- &self,
1398
- argv: &[String],
1399
- segment: &str,
1400
- session: &SessionName,
1401
- window: &WindowName,
1402
- ) -> Result<(), TransportError> {
1403
- let final_argv = self.tmux_argv(argv);
1404
- let actual_bytes = final_argv
1405
- .iter()
1406
- .map(|arg| arg.len().saturating_add(1))
1407
- .sum::<usize>();
1408
- if actual_bytes > TMUX_SPAWN_COMMAND_LIMIT_BYTES {
1409
- return Err(TransportError::CommandTooLong {
1410
- backend: BackendKind::Tmux,
1411
- segment: segment.to_string(),
1412
- session: session.as_str().to_string(),
1413
- window: window.as_str().to_string(),
1414
- actual_bytes,
1415
- limit_bytes: TMUX_SPAWN_COMMAND_LIMIT_BYTES,
1416
- });
1417
- }
1418
- Ok(())
1419
- }
1420
-
1421
- fn run_spawn(&self, argv: &[String]) -> Result<CommandOutput, TransportError> {
1422
- let argv = self.tmux_argv(argv);
1423
- let output = self
1424
- .runner
1425
- .run(&argv)
1426
- .map_err(|source| TransportError::Spawn {
1427
- backend: BackendKind::Tmux,
1428
- source,
1429
- })?;
1430
- if output.success {
1431
- Ok(output)
1432
- } else {
1433
- Err(subprocess_error(argv, output))
1434
- }
1435
- }
1436
-
1437
- fn run_inject_stage(&self, argv: &[String], stage: InjectStage) -> Result<(), TransportError> {
1438
- let argv = self.tmux_argv(argv);
1439
- let output = self
1440
- .runner
1441
- .run(&argv)
1442
- .map_err(|source| TransportError::Inject { stage, source })?;
1443
- if output.success {
1444
- Ok(())
1445
- } else {
1446
- Err(subprocess_error(argv, output))
1447
- }
1448
- }
1449
-
1450
- fn run_inject_stage_with_stdin(
1451
- &self,
1452
- argv: &[String],
1453
- stage: InjectStage,
1454
- stdin: &str,
1455
- ) -> Result<(), TransportError> {
1456
- let argv = self.tmux_argv(argv);
1457
- let output = self
1458
- .runner
1459
- .run_with_stdin(&argv, stdin)
1460
- .map_err(|source| TransportError::Inject { stage, source })?;
1461
- if output.success {
1462
- Ok(())
1463
- } else {
1464
- Err(subprocess_error(argv, output))
1465
- }
1466
- }
1467
-
1468
- /// 任意非 0 tmux mode。best-effort,查询失败 → None。
1469
- ///
1470
- /// Cherry-pick 866939b1 冲突裁定:本线没有 `inject_journal` 模块(modify/delete),
1471
- /// 不复活整份 journal。`pane_mode_from_raw` 识别 copy/tree/view/client;
1472
- /// 一切 Some(mode) 都算在 mode(头注释「非 0 先 cancel」)。
1473
- fn pane_in_mode(&self, target: &Target) -> Option<bool> {
1474
- let raw = self.query(target, PaneField::PaneMode).ok().flatten()?;
1475
- Some(pane_mode_from_raw(Some(raw)).is_some())
1476
- }
1477
-
1478
- fn pane_mode(&self, target: &Target) -> Option<PaneMode> {
1479
- let raw = self.query(target, PaneField::PaneMode).ok().flatten()?;
1480
- pane_mode_from_raw(Some(raw))
1481
- }
1482
-
1483
- /// 发 Enter 前归零接收态。A1/A3/A4/A6 唯一入口。
1484
- ///
1485
- /// 1. 非 0 pane_mode → `tmux_cancel_mode_argv`(按真实 mode 分派,不是硬编码 Copy)
1486
- /// cancel 失败不 fail 提交。E55:不送 Escape/C-c。
1487
- ///
1488
- /// 用户裁定 2026-08-23:**不发 ESC,也不发 ESC 的替代品**(含字面 CSI 201~)。
1489
- /// 发 ESC/CSI 的唯一好处是让消息当场直接上屏;本项目只要求「下一次工具调用时能上屏」
1490
- /// ⇒ 不存在需要它才能满足的场景,发它没有收益,只有污染 composer 输入的风险。
1491
- fn prepare_pane_for_submit(&self, target: &Target, close_bracketed_paste: bool) {
1492
- let _ = close_bracketed_paste;
1493
- let pane = pane_from_target(target);
1494
- if let Some(mode) = self.pane_mode(target) {
1495
- let argv = crate::transport::tmux_cancel_mode_argv(&pane, mode);
1496
- let _ = self.run_inject_stage(&argv, InjectStage::Submit);
1497
- }
1498
- }
1499
- }
1500
-
1501
- fn subprocess_error(argv: Vec<String>, output: CommandOutput) -> TransportError {
1502
- TransportError::Subprocess {
1503
- argv,
1504
- code: output.code,
1505
- stderr: output.stderr,
1506
- }
1507
- }
1508
-
1509
- fn pane_from_target(target: &Target) -> PaneId {
1510
- match target {
1511
- Target::Pane(pane) => pane.clone(),
1512
- Target::SessionWindow { session, window } => {
1513
- PaneId::new(format!("{}:{}", session.as_str(), window.as_str()))
1514
- }
1515
- }
1516
- }
1517
-
1518
- #[derive(Default)]
1519
- struct CaptureTally {
1520
- ok: u32,
1521
- err: u32,
1522
- last: CaptureSampleOutcome,
1523
- }
1524
-
1525
- impl CaptureTally {
1526
- fn record_ok(&mut self, text: &str, marker: Option<&str>) {
1527
- self.ok = self.ok.saturating_add(1);
1528
- self.last = if marker.is_some_and(|token| text.contains(token)) {
1529
- CaptureSampleOutcome::OkTokenSeen
1530
- } else {
1531
- CaptureSampleOutcome::OkTokenMissing
1532
- };
1533
- }
1534
-
1535
- fn record_err(&mut self) {
1536
- self.err = self.err.saturating_add(1);
1537
- self.last = CaptureSampleOutcome::Failed;
1538
- }
1539
-
1540
- fn seen_after_ok_samples(&self, visible: bool) -> Option<bool> {
1541
- if self.ok == 0 {
1542
- None
1543
- } else {
1544
- Some(visible)
1545
- }
1546
- }
1547
- }
1548
-
1549
- struct InjectTargetSurface {
1550
- pane_command_basename: Option<String>,
1551
- pane_command_query: QueryOutcome,
1552
- input_surface: InputSurfaceProbe,
1553
- target_pane_id: String,
1554
- target_pane_query_matched: Option<bool>,
1555
- }
1556
-
1557
- fn probe_inject_target_surface(backend: &TmuxBackend, target: &Target) -> InjectTargetSurface {
1558
- let pane = pane_from_target(target);
1559
- let (pane_command_basename, pane_command_query) =
1560
- match backend.query(target, PaneField::PaneCurrentCommand) {
1561
- Ok(Some(raw)) => match command_basename(&raw) {
1562
- Some(name) => (Some(name), QueryOutcome::Observed),
1563
- None => (None, QueryOutcome::Unavailable),
1564
- },
1565
- _ => (None, QueryOutcome::Unavailable),
1566
- };
1567
- let input_surface = match backend.query(target, PaneField::PaneMode) {
1568
- Ok(Some(raw)) => match pane_mode_from_raw(Some(raw)) {
1569
- None => InputSurfaceProbe::Input,
1570
- Some(PaneMode::Copy) => InputSurfaceProbe::Copy,
1571
- Some(PaneMode::Tree) => InputSurfaceProbe::Tree,
1572
- Some(PaneMode::View) => InputSurfaceProbe::View,
1573
- Some(PaneMode::Client) => InputSurfaceProbe::Client,
1574
- Some(PaneMode::Unknown) => InputSurfaceProbe::UnknownMode,
1575
- },
1576
- _ => InputSurfaceProbe::Unavailable,
1577
- };
1578
- let target_pane_query_matched = match backend.query(target, PaneField::PaneId) {
1579
- Ok(Some(id)) if !id.is_empty() => Some(id == pane.as_str()),
1580
- _ => None,
1581
- };
1582
- InjectTargetSurface {
1583
- pane_command_basename,
1584
- pane_command_query,
1585
- input_surface,
1586
- target_pane_id: pane.as_str().to_string(),
1587
- target_pane_query_matched,
1588
- }
1589
- }
1590
-
1591
- fn submit_diagnostics_for_inject(
1592
- total_elapsed_ms: u64,
1593
- attempts_detail: Vec<SubmitAttemptObservation>,
1594
- tally: &CaptureTally,
1595
- token_seen_after_paste: Option<bool>,
1596
- token_seen_after_enter: Option<bool>,
1597
- surface: InjectTargetSurface,
1598
- ) -> SubmitDiagnostics {
1599
- SubmitDiagnostics {
1600
- consumption_reason: SubmitConsumptionReason::Unknown,
1601
- // No pre-paste capture exists on this path; keep the diagnostic null.
1602
- before_busy_signal_kind: None,
1603
- busy_signal_kind: None,
1604
- busy_line_from_bottom: None,
1605
- current_marker_in_bottom_15: None,
1606
- paste_identity_in_composer: None,
1607
- consumption_from_capture_result: None,
1608
- appear_gate_elapsed_ms: 0,
1609
- appear_gate_matched: false,
1610
- total_elapsed_ms,
1611
- attempts_detail,
1612
- token_seen_before_paste: None,
1613
- token_seen_after_paste,
1614
- token_seen_after_enter,
1615
- capture_ok_count: tally.ok,
1616
- capture_err_count: tally.err,
1617
- capture_sample_count: tally.ok.saturating_add(tally.err),
1618
- last_capture_outcome: tally.last,
1619
- pane_command_basename: surface.pane_command_basename,
1620
- pane_command_query: surface.pane_command_query,
1621
- input_surface: surface.input_surface,
1622
- target_pane_id: Some(surface.target_pane_id),
1623
- target_pane_query_matched: surface.target_pane_query_matched,
1624
- }
1625
- }
1626
-
1627
- fn target_name(target: &Target) -> String {
1628
- match target {
1629
- Target::Pane(pane) => pane.as_str().to_string(),
1630
- Target::SessionWindow { session, window } => {
1631
- format!("{}:{}", session.as_str(), window.as_str())
1632
- }
1633
- }
1634
- }
1635
-
1636
- fn inject_stage_for_argv(argv: &[String]) -> InjectStage {
1637
- match argv.get(1).map(String::as_str) {
1638
- Some("set-buffer") => InjectStage::SetBuffer,
1639
- Some("load-buffer") => InjectStage::LoadBuffer,
1640
- Some("paste-buffer") => InjectStage::PasteBuffer,
1641
- Some("delete-buffer") => InjectStage::DeleteBuffer,
1642
- Some("send-keys") => InjectStage::Submit,
1643
- _ => InjectStage::Submit,
1644
- }
1645
- }
1646
-
1647
- fn pane_mode_from_raw(raw: Option<String>) -> Option<PaneMode> {
1648
- match raw.as_deref().map(str::trim) {
1649
- Some("") | Some("0") => None,
1650
- Some("copy-mode") => Some(PaneMode::Copy),
1651
- Some("tree-mode") => Some(PaneMode::Tree),
1652
- Some("view-mode") => Some(PaneMode::View),
1653
- Some("client-mode") => Some(PaneMode::Client),
1654
- _ => Some(PaneMode::Unknown),
1655
- }
1656
- }
1657
-
1658
- fn buffer_name_for_text(text: &str) -> String {
1659
- const PREFIX: &str = "[team-agent-token:";
1660
- match text.find(PREFIX) {
1661
- Some(prefix_start) => {
1662
- let token_start = prefix_start.saturating_add(PREFIX.len());
1663
- let Some(rest) = text.get(token_start..) else {
1664
- return "team-agent-buf".to_string();
1665
- };
1666
- let Some(token_end) = rest.find(']') else {
1667
- return "team-agent-buf".to_string();
1668
- };
1669
- let Some(token) = rest.get(..token_end).filter(|s| !s.is_empty()) else {
1670
- return "team-agent-buf".to_string();
1671
- };
1672
- format!("team-agent-send-{token}")
1673
- }
1674
- None => "team-agent-buf".to_string(),
1675
- }
1676
- }
1677
-
1678
- fn inject_verification_for_payload(payload: &InjectPayload) -> InjectVerification {
1679
- match payload {
1680
- InjectPayload::Empty => InjectVerification::EmptyTextSendKeys,
1681
- InjectPayload::Text(text) | InjectPayload::TextSkipConsumptionPoll(text)
1682
- if text.contains("[team-agent-token:") =>
1683
- {
1684
- InjectVerification::CaptureContainsToken
1685
- }
1686
- InjectPayload::Text(_) | InjectPayload::TextSkipConsumptionPoll(_) => {
1687
- InjectVerification::NoToken
1688
- }
1689
- }
1690
- }
1691
-
1692
- /// U1 #7: the exact delivery-token marker a token payload carries
1693
- /// (`[team-agent-token:<id>]`). Use the full marker, not only the prefix, so an old
1694
- /// scrollback token cannot verify a new message.
1695
- /// Measured cursor-agent 2026.08.11 floor: text and first Enter ≥1s apart
1696
- /// (phase0 M2-5/M2-6; `.team/scripts/cursor_send.sh`).
1697
- /// The legacy Grok worker used the same 1s floor (悬案B:零地板时 Enter 落在折叠窗口内被吞);
1698
- /// contract leaves own their own paste timing.
1699
- pub const CURSOR_PASTE_TO_SUBMIT_FLOOR: Duration = Duration::from_secs(1);
1700
-
1701
- thread_local! {
1702
- static PASTE_TO_SUBMIT_FLOOR: Cell<Duration> = const { Cell::new(Duration::ZERO) };
1703
- static CURSOR_SINGLE_ENTER: Cell<bool> = const { Cell::new(false) };
1704
- }
1705
-
1706
- /// Run `f` with a paste→Enter floor. No legacy recipient sets one now.
1707
- /// Tests pass a small non-zero Duration to cover the sleep branch.
1708
- /// Default is ZERO — claude/codex and unset callers pay nothing.
1709
- /// This is not TEAM_AGENT_TEST_TMP (that var is a path, always set in seats).
1710
- /// ---
1711
- /// purpose: 在 f 执行期间设定「粘贴到回车之间至少等多久」的地板,退出时恢复原值
1712
- /// params:
1713
- /// floor: 本次生效的最小间隔;ZERO 表示不等
1714
- /// f: 在该地板下执行的闭包
1715
- /// returns: 原样返回 f 的返回值
1716
- /// boundary: thread_local 作用域,不跨线程;只设阈值,真正的等待发生在 sleep_remaining_paste_to_submit_floor;默认 ZERO(legacy grok worker 退役后 delivery 不再设地板)
1717
- /// ---
1718
- pub fn with_paste_to_submit_floor<R>(floor: Duration, f: impl FnOnce() -> R) -> R {
1719
- PASTE_TO_SUBMIT_FLOOR.with(|cell| {
1720
- let previous = cell.replace(floor);
1721
- let result = f();
1722
- cell.set(previous);
1723
- result
1724
- })
1725
- }
1726
-
1727
- /// ---
1728
- /// purpose: 读当前线程生效的粘贴到回车地板
1729
- /// returns: 当前地板;未设过则为 ZERO
1730
- /// boundary: 只读不改;ZERO 表示「不等」,不是「未配置」——两者在此不做区分
1731
- /// ---
1732
- pub(crate) fn current_paste_to_submit_floor() -> Duration {
1733
- PASTE_TO_SUBMIT_FLOOR.with(Cell::get)
1734
- }
1735
-
1736
- /// ---
1737
- /// purpose: 单回车闸(delivery 仅对 Pi 打开;最初为 Cursor 实测)
1738
- /// contract: 默认关;打开后重试 Enter 仅当 token 仍在输入区且无 busy
1739
- /// boundary: 不改 claude/grok/codex 默认重试;测试隔离下默认关
1740
- /// ---
1741
- pub fn with_cursor_single_enter<R>(enabled: bool, f: impl FnOnce() -> R) -> R {
1742
- CURSOR_SINGLE_ENTER.with(|cell| {
1743
- let previous = cell.replace(enabled);
1744
- let result = f();
1745
- cell.set(previous);
1746
- result
1747
- })
1748
- }
1749
-
1750
- /// ---
1751
- /// purpose: 读当前线程的 cursor 单回车闸开关
1752
- /// returns: 打开为 true;默认关
1753
- /// boundary: 只读不改;开关只影响重按 Enter 的判据来源,不改变首次 Enter
1754
- /// ---
1755
- pub(crate) fn cursor_single_enter_enabled() -> bool {
1756
- CURSOR_SINGLE_ENTER.with(Cell::get)
1757
- }
1758
-
1759
- /// ---
1760
- /// purpose: 补齐粘贴到回车之间还差的等待时间
1761
- /// params:
1762
- /// pasted_at: 粘贴完成的时刻
1763
- /// floor: 要求的最小间隔
1764
- /// returns: 无返回值;已过地板则立即返回,否则阻塞剩余时长
1765
- /// boundary: 阻塞当前线程;只保证「不早于」,不保证 TUI 真的处理完粘贴
1766
- /// ---
1767
- pub(crate) fn sleep_remaining_paste_to_submit_floor(pasted_at: Instant, floor: Duration) {
1768
- let remain = floor.saturating_sub(pasted_at.elapsed());
1769
- if !remain.is_zero() {
1770
- std::thread::sleep(remain);
1771
- }
1772
- }
1773
-
1774
- fn payload_token_marker(payload: &InjectPayload) -> Option<&str> {
1775
- let text = payload.text()?;
1776
- let start = text.find("[team-agent-token:")?;
1777
- let marker = &text[start..];
1778
- let end = marker.find(']')?;
1779
- Some(&marker[..=end])
1780
- }
1781
-
1782
- fn token_visible_in_capture(
1783
- backend: &TmuxBackend,
1784
- target: &Target,
1785
- payload: &InjectPayload,
1786
- ) -> Result<Option<bool>, TransportError> {
1787
- match payload_token_marker(payload) {
1788
- None => Ok(None),
1789
- Some(marker) => {
1790
- let captured = backend.capture(target, CaptureRange::Tail(80))?;
1791
- Ok(Some(captured.text.contains(marker)))
1792
- }
1793
- }
1794
- }
1795
-
1796
- /// U1 #7 / E31: wait briefly for the just-pasted token marker before submitting.
1797
- /// `Ok(None)` for non-token payloads (nothing to check). `Ok(Some(false))` means the
1798
- /// paste did not become visible before the Python-parity fallback delay.
1799
- fn pre_submit_token_visible(
1800
- backend: &TmuxBackend,
1801
- target: &Target,
1802
- payload: &InjectPayload,
1803
- ) -> Result<Option<bool>, TransportError> {
1804
- if payload_token_marker(payload).is_none() {
1805
- return Ok(None);
1806
- }
1807
- for attempt in 0..PASTED_CONTENT_APPEAR_POLLS {
1808
- if let Some(true) = token_visible_in_capture(backend, target, payload)? {
1809
- return Ok(Some(true));
1810
- }
1811
- if attempt + 1 < PASTED_CONTENT_APPEAR_POLLS {
1812
- std::thread::sleep(Duration::from_millis(25));
1813
- }
1814
- }
1815
- // Python waits 250ms between paste-buffer and Enter to let bracketed paste settle.
1816
- std::thread::sleep(Duration::from_millis(250));
1817
- Ok(Some(false))
1818
- }
1819
-
1820
- const TOKEN_POST_SUBMIT_READBACK_POLLS: u32 = 5;
1821
-
1822
- /// Some non-echo panes, including the integration harness' `stty -echo; cat`, only
1823
- /// render the injected line after the submit key. If pre-submit readback missed the
1824
- /// token, do a bounded post-submit check before reporting `CaptureMissingToken`.
1825
- fn post_submit_token_visible(
1826
- backend: &TmuxBackend,
1827
- target: &Target,
1828
- payload: &InjectPayload,
1829
- tally: &mut CaptureTally,
1830
- ) -> Result<Option<bool>, TransportError> {
1831
- let Some(marker) = payload_token_marker(payload) else {
1832
- return Ok(None);
1833
- };
1834
- for attempt in 0..TOKEN_POST_SUBMIT_READBACK_POLLS {
1835
- match backend.capture(target, CaptureRange::Tail(80)) {
1836
- Ok(cap) => {
1837
- tally.record_ok(&cap.text, Some(marker));
1838
- if cap.text.contains(marker) {
1839
- return Ok(Some(true));
1840
- }
1841
- }
1842
- Err(_) => {
1843
- tally.record_err();
1844
- return Ok(None);
1845
- }
1846
- }
1847
- if attempt + 1 < TOKEN_POST_SUBMIT_READBACK_POLLS {
1848
- std::thread::sleep(Duration::from_millis(25));
1849
- }
1850
- }
1851
- Ok(Some(false))
1852
- }
1853
-
1854
- /// U1 #7: downgrade the static token verification to `CaptureMissingToken` when the
1855
- /// pre-submit readback did not see the token in the pane. A `None` readback (non-token
1856
- /// payload, or capture unavailable) falls back to the static verification.
1857
- fn inject_verification_after_readback(
1858
- payload: &InjectPayload,
1859
- token_visible_before_submit: Option<bool>,
1860
- ) -> InjectVerification {
1861
- match (payload, token_visible_before_submit) {
1862
- (_, Some(visible)) if payload_token_marker(payload).is_some() => {
1863
- if visible {
1864
- InjectVerification::CaptureContainsToken
1865
- } else {
1866
- InjectVerification::CaptureMissingToken
1867
- }
1868
- }
1869
- _ => inject_verification_for_payload(payload),
1870
- }
1871
- }
1872
-
1873
- fn submit_verification_for_key(key: Key) -> SubmitVerification {
1874
- match key {
1875
- Key::Enter => SubmitVerification::EnterSentWithoutPlaceholderCheck,
1876
- other => SubmitVerification::KeySentAfterVisibleToken { key: other },
1877
- }
1878
- }
1879
-
1880
- fn capture_has_pasted_content_prompt(text: &str) -> bool {
1881
- pasted_prompt_match(text).is_some()
1882
- }
1883
-
1884
- /// 0.3.27: check if a token marker is present in the bottom N non-empty lines.
1885
- /// Used by the unified submit_and_verify to detect whether the provider consumed
1886
- /// the pasted message (token scrolls out of composer region on successful submit).
1887
- fn token_in_bottom_n(text: &str, marker: &str, n: usize) -> bool {
1888
- text.lines()
1889
- .rev()
1890
- .filter(|line| !line.trim().is_empty())
1891
- .take(n)
1892
- .any(|line| line.contains(marker))
1893
- }
1894
-
1895
- /// #379: Claude Code echoes the submitted turn right above its composer box,
1896
- /// well inside the bottom-15 window. When that box is recognized only the text
1897
- /// between its rules is composer; otherwise the whole tail stays in charge.
1898
- fn composer_view(text: &str) -> std::borrow::Cow<'_, str> {
1899
- match team_agent_contract::providers::claude::interaction::inspect_legacy_composer(text) {
1900
- Some((_, current)) => std::borrow::Cow::Owned(current),
1901
- None => std::borrow::Cow::Borrowed(text),
1902
- }
1903
- }
1904
-
1905
- /// purpose: token 在本轮注入中的三态观测
1906
- /// contract:
1907
- /// - Visible: 当前 capture 可见
1908
- /// - Gone: 本轮见过,当前不可见(「见过又消失」才是 token 正信号)
1909
- /// - NeverSeen: 本轮从未出现 — 不得把缺席写成 consumed
1910
- /// boundary: 观测枚举,不是 SubmitVerification 裁定
1911
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
1912
- pub(crate) enum TokenSighting {
1913
- Visible,
1914
- Gone,
1915
- NeverSeen,
1916
- }
1917
-
1918
- /// purpose: composer 区折叠占位符(含可选 #N 或 grok 行数)
1919
- /// contract: 只看底部 n 非空行;id 来自 `pasted text #N` / `pasted content #N`;
1920
- /// grok `[Pasted: N lines]` 无 #N,用 line_count 当身份,不得把「有占位符」当成同一次
1921
- /// boundary: scrollback 里的旧占位符不算
1922
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
1923
- pub(crate) struct ComposerPastedPrompt {
1924
- pub literal: &'static str,
1925
- pub id: Option<u32>,
1926
- pub line_count: Option<u32>,
1927
- pub from_bottom: u32,
1928
- }
1929
-
1930
- /// purpose: 本次粘贴在 composer 上的可锁定身份
1931
- /// contract: HashId = claude/codex `#N`;GrokLineCount = grok `[Pasted: N lines|N KB]` 的 N
1932
- /// boundary: 无 #N 时禁止用「任意占位符」冒充 HashId
1933
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
1934
- pub(crate) enum PasteLatch {
1935
- HashId(u32),
1936
- GrokLineCount(u32),
1937
- }
1938
-
1939
- fn parse_pasted_hash_id(lower_line: &str) -> Option<u32> {
1940
- for prefix in ["pasted text #", "pasted content #"] {
1941
- if let Some(idx) = lower_line.find(prefix) {
1942
- let rest = &lower_line[idx + prefix.len()..];
1943
- let digits: String = rest.chars().take_while(|c| c.is_ascii_digit()).collect();
1944
- if digits.is_empty() {
1945
- continue;
1946
- }
1947
- if let Ok(id) = digits.parse::<u32>() {
1948
- return Some(id);
1949
- }
1950
- }
1951
- }
1952
- None
1953
- }
1954
-
1955
- fn parse_grok_pasted_line_count(lower_line: &str) -> Option<u32> {
1956
- // grok: `[pasted: 42 lines]` or `[pasted: 13 kb]` — 冒号紧跟 pasted,没有 `#N`
1957
- let idx = lower_line.find("pasted:")?;
1958
- let rest = lower_line.get(idx.saturating_add("pasted:".len())..)?;
1959
- let rest = rest.trim_start();
1960
- let digits: String = rest.chars().take_while(|c| c.is_ascii_digit()).collect();
1961
- if digits.is_empty() {
1962
- return None;
1963
- }
1964
- let after = rest.get(digits.len()..)?.trim_start();
1965
- let unit_ok = after.starts_with("lines")
1966
- || after.starts_with("line")
1967
- || after.starts_with("kb")
1968
- || after.starts_with("mb")
1969
- || after.starts_with('b');
1970
- if unit_ok {
1971
- digits.parse().ok()
1972
- } else {
1973
- None
1974
- }
1975
- }
1976
-
1977
- fn pasted_literal_in_line(lower_line: &str) -> Option<&'static str> {
1978
- if lower_line.contains("pasted content") {
1979
- Some("pasted content")
1980
- } else if lower_line.contains("pasted text") {
1981
- Some("pasted text")
1982
- } else if parse_grok_pasted_line_count(lower_line).is_some() {
1983
- Some("pasted:")
1984
- } else {
1985
- None
1986
- }
1987
- }
1988
-
1989
- /// ---
1990
- /// purpose: 只在 composer(底部 n 非空行)认折叠占位符
1991
- /// params:
1992
- /// text: 已规范化的 pane 尾文本
1993
- /// n: 只看倒数 n 个非空行;超出这一窗口的占位符视为 transcript 残留,不算
1994
- /// returns: 命中则给出字面量、可选编号、可选 grok 行数、距底行数;否则 None
1995
- /// contract: 返回字面量 + 可选编号;没有占位符则 None
1996
- /// boundary: 不替代 token 路径;编号缺失时调用方必须保守,不得报已消费
1997
- /// ---
1998
- pub(crate) fn pasted_prompt_in_composer(text: &str, n: usize) -> Option<ComposerPastedPrompt> {
1999
- let mut from_bottom = 0u32;
2000
- for line in text
2001
- .lines()
2002
- .rev()
2003
- .filter(|line| !line.trim().is_empty())
2004
- .take(n)
2005
- {
2006
- let lower = line.to_ascii_lowercase();
2007
- if let Some(literal) = pasted_literal_in_line(&lower) {
2008
- return Some(ComposerPastedPrompt {
2009
- literal,
2010
- id: parse_pasted_hash_id(&lower),
2011
- line_count: parse_grok_pasted_line_count(&lower),
2012
- from_bottom,
2013
- });
2014
- }
2015
- from_bottom = from_bottom.saturating_add(1);
2016
- }
2017
- None
2018
- }
2019
-
2020
- fn latch_paste(text: &str, current: Option<PasteLatch>) -> Option<PasteLatch> {
2021
- if current.is_some() {
2022
- return current;
2023
- }
2024
- let prompt = pasted_prompt_in_composer(&composer_view(text), 15)?;
2025
- if let Some(id) = prompt.id {
2026
- return Some(PasteLatch::HashId(id));
2027
- }
2028
- prompt.line_count.map(PasteLatch::GrokLineCount)
2029
- }
2030
-
2031
- fn token_sighting(token_now: bool, token_ever_visible: bool) -> TokenSighting {
2032
- if token_now {
2033
- TokenSighting::Visible
2034
- } else if token_ever_visible {
2035
- TokenSighting::Gone
2036
- } else {
2037
- TokenSighting::NeverSeen
2038
- }
2039
- }
2040
-
2041
- fn consumption_from_placeholder(text: &str, tracked: Option<PasteLatch>) -> Option<bool> {
2042
- let prompt = pasted_prompt_in_composer(text, 15);
2043
- match (tracked, prompt) {
2044
- (Some(PasteLatch::HashId(id)), Some(p)) if p.id == Some(id) => Some(false),
2045
- (Some(PasteLatch::HashId(_)), Some(p)) if p.id.is_some() => Some(true),
2046
- (Some(PasteLatch::HashId(_)), Some(_)) => Some(false),
2047
- (Some(PasteLatch::HashId(_)), None) => Some(true),
2048
- (Some(PasteLatch::GrokLineCount(n)), Some(p)) if p.line_count == Some(n) => Some(false),
2049
- // 不同 N:不能把「上一贴走了」写成已消费(无 #N,换行数 ≠ 同一次)
2050
- (Some(PasteLatch::GrokLineCount(_)), Some(_)) => Some(false),
2051
- (Some(PasteLatch::GrokLineCount(_)), None) => Some(true),
2052
- (None, _) => Some(false),
2053
- }
2054
- }
2055
-
2056
- /// ---
2057
- /// purpose: 无身份时禁止把「未证实」升级成连按回车
2058
- /// params:
2059
- /// text: 最近一次 pane 尾文本
2060
- /// marker: 本条消息的投递 token 完整标记
2061
- /// tracked: 本次粘贴已锁定的占位符身份(编号或 grok 行数);None 表示没锁到身份
2062
- /// returns: true 才允许再按一次 Enter
2063
- /// contract: 只有 token 仍在 composer 底 15 非空行,或锁定的占位符身份仍在,才重按
2064
- /// boundary: 不重粘文本;不把不同 grok 行数当成可重按的同一次;tracked 为 None 时占位符路径一律不重按(token 仍在底 15 非空行的重按与 tracked 无关)
2065
- /// ---
2066
- pub(crate) fn should_resubmit_enter(text: &str, marker: &str, tracked: Option<PasteLatch>) -> bool {
2067
- let text = &*composer_view(text);
2068
- if token_in_bottom_n(text, marker, 15) {
2069
- return true;
2070
- }
2071
- let Some(prompt) = pasted_prompt_in_composer(text, 15) else {
2072
- return false;
2073
- };
2074
- match tracked {
2075
- Some(PasteLatch::HashId(id)) => prompt.id == Some(id),
2076
- Some(PasteLatch::GrokLineCount(n)) => prompt.line_count == Some(n),
2077
- None => false,
2078
- }
2079
- }
2080
-
2081
- fn composer_joined(text: &str, n: usize) -> String {
2082
- let mut lines: Vec<&str> = text
2083
- .lines()
2084
- .rev()
2085
- .filter(|line| !line.trim().is_empty())
2086
- .take(n)
2087
- .collect();
2088
- lines.reverse();
2089
- lines.concat()
2090
- }
2091
-
2092
- /// ---
2093
- /// purpose: 本次注入身份是否还在 composer(复用 token / #N / grok 行数,不认提示符皮肤)
2094
- /// contract: 单行 token、折行拼接 token、或锁定的 PasteLatch 仍在底部 ⇒ true
2095
- /// boundary: payload 里的 ❯/`composer>`/`>` 不算身份;无身份不得据此连按回车
2096
- /// ---
2097
- pub(crate) fn this_paste_identity_in_composer(
2098
- text: &str,
2099
- marker: &str,
2100
- tracked: Option<PasteLatch>,
2101
- ) -> bool {
2102
- should_resubmit_enter(text, marker, tracked)
2103
- || composer_joined(&composer_view(text), 15).contains(marker)
2104
- }
2105
-
2106
- /// ---
2107
- /// purpose: Unverified 之后要不要补一颗 C-m(本次身份仍在,不是提示符长什么样)
2108
- /// contract: 无 busy 且本次身份仍在 composer ⇒ true;达上限由调用方停
2109
- /// boundary: consumed=None 不在这里决定(调用方不补);不重粘;不把 payload 提示符字符当守卫
2110
- /// ---
2111
- pub(crate) fn should_resend_enter_after_unverified(
2112
- text: &str,
2113
- marker: &str,
2114
- tracked: Option<PasteLatch>,
2115
- ) -> bool {
2116
- if provider_busy_signal_in_tail(text) {
2117
- return false;
2118
- }
2119
- this_paste_identity_in_composer(text, marker, tracked)
2120
- }
2121
-
2122
- /// ---
2123
- /// purpose: Unverified 补发 B 是否该介入——只补 A 的 should_resubmit_enter 看不到的折行缺口
2124
- /// params:
2125
- /// text: 最近一次 pane 尾文本
2126
- /// marker: 本条消息的投递 token 完整标记
2127
- /// tracked: 本次粘贴已锁定的占位符身份(编号或 grok 行数);None 表示没锁到身份
2128
- /// returns: true 才允许 B 再按一次 Enter
2129
- /// contract: !busy 且 this_paste_identity_in_composer 且 !should_resubmit_enter ⇒ true
2130
- /// boundary: A 已因 latch / 底15 单行 token 为真时不介入(含 A 已打满 cap);不重粘;consumed=None 不在这里决定
2131
- /// ---
2132
- pub(crate) fn should_resend_unverified_wrap_gap(
2133
- text: &str,
2134
- marker: &str,
2135
- tracked: Option<PasteLatch>,
2136
- ) -> bool {
2137
- if should_resubmit_enter(text, marker, tracked) {
2138
- return false;
2139
- }
2140
- should_resend_enter_after_unverified(text, marker, tracked)
2141
- }
2142
-
2143
- /// ---
2144
- /// purpose: cursor 重按 Enter 的核实:token 仍在输入框,且回合未在进行
2145
- /// contract: busy ⇒ 不重按;token 不在底部 5 非空行 ⇒ 不重按
2146
- /// boundary: 不把 transcript 里的 pasted #N 当输入框;不替代 claude/grok 的 should_resubmit_enter
2147
- /// ---
2148
- pub(crate) fn should_resubmit_enter_cursor(text: &str, marker: &str) -> bool {
2149
- if provider_busy_signal_in_tail(text) {
2150
- return false;
2151
- }
2152
- token_in_bottom_n(text, marker, 5)
2153
- }
2154
-
2155
- /// ---
2156
- /// purpose: Phase 1 判定 TUI 侧注入已完成、可以按回车
2157
- /// params:
2158
- /// text: 最近一次 pane 尾文本
2159
- /// marker: 本条消息的投递 token 完整标记
2160
- /// returns: true 表示可以进入提交阶段
2161
- /// contract: composer 已有折叠占位符 ⇒ 完成;短贴 token 可见且不是待折叠高块 ⇒ 完成
2162
- /// boundary: token 出现在未折叠的高块里不算完成(按早了);只判「能不能按」,不判「按了有没有成」
2163
- /// ---
2164
- pub(crate) fn paste_ready_for_enter(text: &str, marker: &str) -> bool {
2165
- let text = &*composer_view(text);
2166
- if pasted_prompt_in_composer(text, 15).is_some() {
2167
- return true;
2168
- }
2169
- text.contains(marker) && !raw_multiline_still_unfolded(text, marker)
2170
- }
2171
-
2172
- fn raw_multiline_still_unfolded(text: &str, marker: &str) -> bool {
2173
- if pasted_prompt_in_composer(text, 15).is_some() {
2174
- return false;
2175
- }
2176
- if !text.contains(marker) {
2177
- return false;
2178
- }
2179
- text.lines().filter(|line| !line.trim().is_empty()).count() > 15
2180
- }
2181
-
2182
- /// ---
2183
- /// purpose: 把 token 三态 + 本次 #N / grok 占位符合成消费判定
2184
- /// params:
2185
- /// text: 最近一次 pane 尾文本
2186
- /// marker: 本条消息的投递 token 完整标记
2187
- /// token_ever_visible: 本次注入期间是否曾在 pane 上见过该 token
2188
- /// tracked: 本次粘贴锁定的占位符身份;None 表示没锁到
2189
- /// returns: Some(true) 已消费;Some(false) 未消费;本函数不产生 None
2190
- /// contract:
2191
- /// Some(true)=已消费;Some(false)=未消费(含 NeverSeen 且无正信号 → 未证实走 false)
2192
- /// Gone 必须先复核 PasteLatch 身份:占位符仍在 composer ⇒ 未消费
2193
- /// None 不由本函数产生;调用方在 capture 失败时保持 None,必须落到 Unverified
2194
- /// boundary: 不修 BUSY 入队;Working 信号由调用方在 Some(false) 之后看;None 不得当成功
2195
- /// ---
2196
- pub(crate) fn consumption_from_capture(
2197
- text: &str,
2198
- marker: &str,
2199
- token_ever_visible: bool,
2200
- tracked: Option<PasteLatch>,
2201
- ) -> Option<bool> {
2202
- let text = &*composer_view(text);
2203
- let token_now = token_in_bottom_n(text, marker, 15);
2204
- match token_sighting(token_now, token_ever_visible) {
2205
- TokenSighting::Visible => Some(false),
2206
- TokenSighting::Gone => gone_consumption(text, tracked),
2207
- TokenSighting::NeverSeen => consumption_from_placeholder(text, tracked),
2208
- }
2209
- }
2210
-
2211
- #[derive(Debug, Clone, Copy, Default)]
2212
- struct ConsumptionCaptureObservation {
2213
- busy: Option<BusySignalMatch>,
2214
- marker_in_bottom_15: Option<bool>,
2215
- paste_identity_in_composer: Option<bool>,
2216
- consumption_from_capture_result: Option<bool>,
2217
- }
2218
-
2219
- fn consumption_capture_observation(
2220
- text: &str,
2221
- marker: Option<&str>,
2222
- token_ever_visible: bool,
2223
- tracked: Option<PasteLatch>,
2224
- ) -> ConsumptionCaptureObservation {
2225
- let Some(marker) = marker else {
2226
- return ConsumptionCaptureObservation::default();
2227
- };
2228
- ConsumptionCaptureObservation {
2229
- busy: provider_busy_signal_match(text),
2230
- marker_in_bottom_15: Some(token_in_bottom_n(text, marker, 15)),
2231
- paste_identity_in_composer: tracked
2232
- .map(|tracked| this_paste_identity_in_composer(text, marker, Some(tracked))),
2233
- consumption_from_capture_result: consumption_from_capture(
2234
- text,
2235
- marker,
2236
- token_ever_visible,
2237
- tracked,
2238
- ),
2239
- }
2240
- }
2241
-
2242
- #[derive(Debug, Clone, Copy, Default)]
2243
- struct ConsumptionDiagnostics {
2244
- busy_signal_kind: Option<BusySignalKind>,
2245
- busy_line_from_bottom: Option<u8>,
2246
- current_marker_in_bottom_15: Option<bool>,
2247
- paste_identity_in_composer: Option<bool>,
2248
- consumption_from_capture_result: Option<bool>,
2249
- /// Busy in any post-Enter sample: one final frame lands on a random spinner phase.
2250
- busy_seen: bool,
2251
- }
2252
-
2253
- impl ConsumptionDiagnostics {
2254
- fn record(&mut self, observation: ConsumptionCaptureObservation) {
2255
- self.busy_seen |= observation.busy.is_some();
2256
- self.busy_signal_kind = observation.busy.map(|match_| match_.kind);
2257
- self.busy_line_from_bottom = observation.busy.map(|match_| match_.line_from_bottom);
2258
- self.current_marker_in_bottom_15 = observation.marker_in_bottom_15;
2259
- self.paste_identity_in_composer = observation.paste_identity_in_composer;
2260
- self.consumption_from_capture_result = observation.consumption_from_capture_result;
2261
- }
2262
- }
2263
-
2264
- /// ---
2265
- /// purpose: Gone 分支在判已消费前复核 composer 占位符(PasteLatch 身份)
2266
- /// contract: 锁定身份仍在,或未锁定但 grok `[Pasted: …]` 仍在 ⇒ Some(false)
2267
- /// boundary: 空 composer + 无 grok 占位符保持 Some(true)(claude 短贴路径不变)
2268
- /// ---
2269
- fn gone_consumption(text: &str, tracked: Option<PasteLatch>) -> Option<bool> {
2270
- if tracked.is_some() {
2271
- return match consumption_from_placeholder(text, tracked) {
2272
- Some(false) => Some(false),
2273
- _ => Some(true),
2274
- };
2275
- }
2276
- match pasted_prompt_in_composer(text, 15) {
2277
- Some(p) if p.literal == "pasted:" => Some(false),
2278
- _ => Some(true),
2279
- }
2280
- }
2281
-
2282
- fn marker_position_from_bottom(text: &str, marker: &str) -> Option<u32> {
2283
- let mut from_bottom = 0u32;
2284
- for line in text.lines().rev().filter(|line| !line.trim().is_empty()) {
2285
- if line.contains(marker) {
2286
- return Some(from_bottom);
2287
- }
2288
- from_bottom = from_bottom.saturating_add(1);
2289
- }
2290
- None
2291
- }
2292
-
2293
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
2294
- struct BusySignalMatch {
2295
- kind: BusySignalKind,
2296
- line_from_bottom: u8,
2297
- }
2298
-
2299
- fn busy_signal_kind_in_line(line: &str) -> Option<BusySignalKind> {
2300
- let lower = line.to_ascii_lowercase();
2301
- if lower.contains("working") {
2302
- return Some(BusySignalKind::Working);
2303
- }
2304
- if lower.contains("thinking") {
2305
- return Some(BusySignalKind::Thinking);
2306
- }
2307
- if lower.contains("processing") {
2308
- return Some(BusySignalKind::Processing);
2309
- }
2310
- if lower.contains("esc to interrupt") {
2311
- return Some(BusySignalKind::EscToInterrupt);
2312
- }
2313
- if line.contains('●')
2314
- || line.contains('⏳')
2315
- || line.contains('⠋')
2316
- || line.contains('⠙')
2317
- || line.contains('⠹')
2318
- || line.contains('⠸')
2319
- || line.contains('⠼')
2320
- || line.contains('⠴')
2321
- || line.contains('⠦')
2322
- || line.contains('⠧')
2323
- || line.contains('⠇')
2324
- || line.contains('⠏')
2325
- || line.contains('✶')
2326
- || line.contains('✢')
2327
- || line.contains('✻')
2328
- || line.contains('✽')
2329
- || line.contains('✳')
2330
- {
2331
- return Some(BusySignalKind::SpinnerGlyph);
2332
- }
2333
- None
2334
- }
2335
-
2336
- fn provider_busy_signal_match(text: &str) -> Option<BusySignalMatch> {
2337
- use team_agent_contract::{contract::delivery::InputSurface, providers::claude::interaction};
2338
- // #379: Claude Code's box decides alone. Its spinner glyph animates through
2339
- // `·` and a finished turn leaves `✻ Worked for 3s` in the window, so a
2340
- // per-line glyph scan is neither stable nor live.
2341
- if let Some((surface, _)) = interaction::inspect_legacy_composer(text) {
2342
- let row = text
2343
- .lines()
2344
- .rev()
2345
- .filter(|line| !line.trim().is_empty())
2346
- .position(interaction::spinner_row)
2347
- .unwrap_or(0);
2348
- return (surface == InputSurface::Busy).then_some(BusySignalMatch {
2349
- kind: BusySignalKind::SpinnerGlyph,
2350
- line_from_bottom: u8::try_from(row).unwrap_or(u8::MAX),
2351
- });
2352
- }
2353
- text.lines()
2354
- .rev()
2355
- .filter(|line| !line.trim().is_empty())
2356
- .take(15)
2357
- .enumerate()
2358
- .find_map(|(line_from_bottom, line)| {
2359
- busy_signal_kind_in_line(line).map(|kind| BusySignalMatch {
2360
- kind,
2361
- line_from_bottom: line_from_bottom as u8,
2362
- })
2363
- })
2364
- }
2365
-
2366
- fn provider_busy_signal_in_tail(text: &str) -> bool {
2367
- provider_busy_signal_match(text).is_some()
2368
- }
2369
-
2370
- /// ---
2371
- /// purpose: 入箱 vs 开跑(G4)。给定最近一次 pane 尾,回答席位是否因此开跑。
2372
- /// params:
2373
- /// text: 最近一次 pane 尾文本
2374
- /// marker: 本条消息的投递 token 完整标记;None 表示本次载荷没有 token 可查
2375
- /// returns: 三态观测值,绝不返回 NotRequired(那是空载荷路径由调用方直接给的)
2376
- /// contract:
2377
- /// - LeaderNewTurnBoundaryVerified = 底部 busy 信号
2378
- /// - LeaderNewTurnBoundaryMissing = composer 仍有本次粘贴(占位符或 token)且无 busy
2379
- /// - NotYetObserved = 其余(含 composer 已空但无 busy)→ 不知道,不得报开跑
2380
- /// boundary:
2381
- /// - 不是 SubmitVerification / 不是投递闸门;不许用过了 N 秒来判
2382
- /// - busy 判据是底 15 非空行的宽子串匹配,正文或 transcript 残留可让它假阳,判定强度到此为止
2383
- /// ---
2384
- pub(crate) fn observe_turn_from_capture(text: &str, marker: Option<&str>) -> TurnVerification {
2385
- if provider_busy_signal_in_tail(text) {
2386
- return TurnVerification::LeaderNewTurnBoundaryVerified;
2387
- }
2388
- let text = &*composer_view(text);
2389
- let paste_still = pasted_prompt_in_composer(text, 15).is_some();
2390
- let token_still = marker
2391
- .map(|m| token_in_bottom_n(text, m, 15))
2392
- .unwrap_or(false);
2393
- if paste_still || token_still {
2394
- return TurnVerification::LeaderNewTurnBoundaryMissing;
2395
- }
2396
- TurnVerification::NotYetObserved
2397
- }
2398
-
2399
- fn turn_verification_for_payload(
2400
- payload: &InjectPayload,
2401
- last_text: Option<&str>,
2402
- ) -> TurnVerification {
2403
- match payload {
2404
- InjectPayload::Empty => TurnVerification::NotRequired,
2405
- InjectPayload::Text(_) | InjectPayload::TextSkipConsumptionPoll(_) => {
2406
- observe_turn_from_capture(last_text.unwrap_or(""), payload_token_marker(payload))
2407
- }
2408
- }
2409
- }
2410
-
2411
- fn submit_attempt_observation(
2412
- attempt_index: u32,
2413
- captured: &CapturedText,
2414
- marker: Option<&str>,
2415
- elapsed_ms: u64,
2416
- ) -> SubmitAttemptObservation {
2417
- let marker_position = marker.and_then(|m| marker_position_from_bottom(&captured.text, m));
2418
- // marker 在时也走 pasted_prompt_match:折叠占位符是编排长粘贴的正信号,
2419
- // 不能只在无 token 载荷上才认。matched 仍表示「composer 里还有待提交信号」。
2420
- let composer = composer_view(&captured.text);
2421
- let (matched, matched_literal, where_in_tail) = if let Some(marker) = marker {
2422
- if token_in_bottom_n(&composer, marker, 15) {
2423
- (
2424
- true,
2425
- marker_position.map(|_| marker.to_string()),
2426
- marker_position,
2427
- )
2428
- } else if let Some((literal, where_in_tail)) = pasted_prompt_match(&captured.text) {
2429
- (
2430
- pasted_prompt_in_composer(&composer, 15).is_some(),
2431
- Some(literal.to_string()),
2432
- Some(where_in_tail),
2433
- )
2434
- } else {
2435
- (false, None, None)
2436
- }
2437
- } else if let Some((literal, where_in_tail)) = pasted_prompt_match(&captured.text) {
2438
- (true, Some(literal.to_string()), Some(where_in_tail))
2439
- } else {
2440
- (false, None, None)
2441
- };
2442
- let (pane_tail_excerpt, pane_tail_lines) = scrub_pane_excerpt(&captured.text, 20);
2443
- SubmitAttemptObservation {
2444
- attempt_index,
2445
- matched,
2446
- matched_literal,
2447
- where_in_tail,
2448
- pane_tail_excerpt,
2449
- pane_tail_lines,
2450
- elapsed_ms,
2451
- }
2452
- }
2453
-
2454
- /// 0.3.27: check if a pasted-content prompt literal (`pasted content` / `pasted text`)
2455
- /// appears in the bottom N non-empty lines. Narrower than the full-Tail(80) check
2456
- /// that caused scrollback ghost matches (E50 defect B).
2457
- fn pasted_prompt_in_bottom(text: &str, n: usize) -> bool {
2458
- pasted_prompt_in_composer(text, n).is_some()
2459
- }
2460
-
2461
- /// E50 PR-1 (0.3.24 P0, pasted-prompt 假阴诊断): factor `capture_has_pasted_content_prompt`
2462
- /// so the diagnostic layer can recover the MATCHED LITERAL and its position
2463
- /// in the tail. Returns `(literal, line_index_from_bottom)` on a match.
2464
- /// Byte-identical match semantics — `capture_has_pasted_content_prompt`'s
2465
- /// `bool` wrapper preserves the legacy `true/false` contract for the three
2466
- /// existing callers (the appear-gate poll at :1122-1128 + the legacy submit
2467
- /// loop matcher at :1138 + post-flip clearer at :1138).
2468
- ///
2469
- /// **Where-in-tail rationale**: a `pasted content` literal that lives in
2470
- /// the SCROLLBACK (line 6+ from bottom) is NOT the live composer
2471
- /// placeholder — codex's successful submit scrolls the block into history
2472
- /// where it remains in the last 80 lines. The current matcher cannot
2473
- /// distinguish that from a live placeholder; this fn surfaces the data
2474
- /// the operator needs to see (PR-2 will USE it to fix the criterion).
2475
- /// ---
2476
- /// purpose: 在整段 pane 尾里找折叠占位符字面量,并给出它距底部多少非空行
2477
- /// params:
2478
- /// text: pane 尾文本;不限窗口,整段都找
2479
- /// returns: Some((命中的字面量, 距底非空行数));无命中则 None;字面量只出现在被裁掉的空白行时保守记为 0
2480
- /// boundary:
2481
- /// - 只做取证不做判定:距底行数大说明多半在 transcript 而非 composer,但本函数不替调用方下结论
2482
- /// - 与 pasted_prompt_in_composer 不同——后者限定底部窗口,是判定用;本函数不限窗口,是诊断用
2483
- /// ---
2484
- pub(crate) fn pasted_prompt_match(text: &str) -> Option<(&'static str, u32)> {
2485
- let lower = text.to_ascii_lowercase();
2486
- let lit = if lower.contains("pasted content") {
2487
- "pasted content"
2488
- } else if lower.contains("pasted text") {
2489
- "pasted text"
2490
- } else if text
2491
- .lines()
2492
- .any(|line| parse_grok_pasted_line_count(&line.to_ascii_lowercase()).is_some())
2493
- {
2494
- "pasted:"
2495
- } else {
2496
- return None;
2497
- };
2498
- // Distance from the bottom of the tail in non-empty lines.
2499
- let non_empty: Vec<&str> = text
2500
- .lines()
2501
- .filter(|line| !line.trim().is_empty())
2502
- .collect();
2503
- let mut from_bottom: u32 = 0;
2504
- for line in non_empty.iter().rev() {
2505
- let line_lower = line.to_ascii_lowercase();
2506
- let hit = if lit == "pasted:" {
2507
- parse_grok_pasted_line_count(&line_lower).is_some()
2508
- } else {
2509
- line_lower.contains(lit)
2510
- };
2511
- if hit {
2512
- return Some((lit, from_bottom));
2513
- }
2514
- from_bottom = from_bottom.saturating_add(1);
2515
- }
2516
- // Literal appeared only in trimmed-away whitespace lines — treat as
2517
- // bottom (defensive; rare).
2518
- Some((lit, 0))
2519
- }
2520
-
2521
- /// E50 PR-1 (0.3.24 P0): scrub a pane capture for safe inclusion in
2522
- /// `events.jsonl`. Steps:
2523
- /// 1. Strip CSI / OSC ANSI escapes.
2524
- /// 2. Take the bottom `tail_lines` of non-empty lines.
2525
- /// 3. Redact common secret shapes (sk-, ghp_, AKIA, Bearer ..., 32+ hex).
2526
- /// 4. Cap at ~1200 bytes (UTF-8 safe truncation).
2527
- /// Returns `(excerpt, line_count)`. Designed to be CHEAP — no regex crate
2528
- /// dependency, simple byte scanning.
2529
- /// ---
2530
- /// purpose: 把 pane 抓屏加工成可安全写进 events.jsonl 的摘录
2531
- /// params:
2532
- /// raw: 原始抓屏文本
2533
- /// tail_lines: 只保留倒数这么多非空行
2534
- /// returns: (脱敏并截断后的摘录, 实际保留的行数)
2535
- /// boundary:
2536
- /// - 只做四件事:剥 ANSI、取尾部、脱敏常见密钥形状、按 1200 字节在字符边界截断
2537
- /// - 脱敏是形状匹配,不是完备保证;非常见形状的凭据不会被识别
2538
- /// - 输出仍是消息正文的一部分,只落本地事件文件,不外传
2539
- /// ---
2540
- pub(crate) fn scrub_pane_excerpt(raw: &str, tail_lines: usize) -> (String, u32) {
2541
- let stripped = strip_ansi_escapes_inplace(raw);
2542
- let lines: Vec<&str> = stripped
2543
- .lines()
2544
- .filter(|line| !line.trim().is_empty())
2545
- .collect();
2546
- let tail = if lines.len() > tail_lines {
2547
- &lines[lines.len() - tail_lines..]
2548
- } else {
2549
- &lines[..]
2550
- };
2551
- let mut out = tail
2552
- .iter()
2553
- .map(|line| scrub_secrets(line))
2554
- .collect::<Vec<_>>()
2555
- .join("\n");
2556
- if out.len() > 1200 {
2557
- // Truncate at UTF-8 char boundary.
2558
- let mut cut = 1200;
2559
- while cut > 0 && !out.is_char_boundary(cut) {
2560
- cut -= 1;
2561
- }
2562
- out.truncate(cut);
2563
- out.push_str("…[truncated]");
2564
- }
2565
- (out, tail.len() as u32)
2566
- }
2567
-
2568
- fn strip_ansi_escapes_inplace(input: &str) -> String {
2569
- let mut out = String::with_capacity(input.len());
2570
- let bytes = input.as_bytes();
2571
- let mut i = 0;
2572
- while i < bytes.len() {
2573
- if bytes[i] == 0x1b && i + 1 < bytes.len() {
2574
- // CSI: ESC [ ... <final byte 0x40-0x7e>
2575
- if bytes[i + 1] == b'[' {
2576
- let mut j = i + 2;
2577
- while j < bytes.len() && !(0x40..=0x7e).contains(&bytes[j]) {
2578
- j += 1;
2579
- }
2580
- i = j.saturating_add(1).min(bytes.len());
2581
- continue;
2582
- }
2583
- // OSC: ESC ] ... BEL or ESC \
2584
- if bytes[i + 1] == b']' {
2585
- let mut j = i + 2;
2586
- while j < bytes.len() {
2587
- if bytes[j] == 0x07 {
2588
- j += 1;
2589
- break;
2590
- }
2591
- if bytes[j] == 0x1b && j + 1 < bytes.len() && bytes[j + 1] == b'\\' {
2592
- j += 2;
2593
- break;
2594
- }
2595
- j += 1;
2596
- }
2597
- i = j.min(bytes.len());
2598
- continue;
2599
- }
2600
- // Other single-char ESC sequence — skip ESC + next byte.
2601
- i += 2;
2602
- continue;
2603
- }
2604
- let ch = bytes[i];
2605
- out.push(ch as char);
2606
- i += 1;
2607
- }
2608
- // Re-decode from bytes to recover UTF-8 (since we pushed bytes as chars,
2609
- // multi-byte UTF-8 is preserved correctly because we only skip on the
2610
- // single-byte ESC start). For pane text this is good enough; pathological
2611
- // UTF-8 inside CSI parameter bytes is invalid anyway.
2612
- out
2613
- }
2614
-
2615
- fn scrub_secrets(line: &str) -> String {
2616
- let line = crate::redaction::redact_external_text(line);
2617
- // Five shapes: sk-XXXX, ghp_XXXX, AKIAXXXX (16-char uppercase id), Bearer XXXX,
2618
- // 32+ hex (token).
2619
- let mut out = String::with_capacity(line.len());
2620
- let bytes = line.as_bytes();
2621
- let mut i = 0;
2622
- while i < bytes.len() {
2623
- // sk- / ghp_ / AKIA prefixes: detect and redact through end-of-token.
2624
- if matches_prefix(bytes, i, b"sk-") || matches_prefix(bytes, i, b"ghp_") {
2625
- let prefix_len = if bytes[i] == b's' { 3 } else { 4 };
2626
- let token_end = scan_token_end(bytes, i + prefix_len);
2627
- out.push_str(&line[i..i + prefix_len]);
2628
- out.push_str("REDACTED");
2629
- i = token_end;
2630
- continue;
2631
- }
2632
- if matches_prefix(bytes, i, b"AKIA") {
2633
- let token_end = scan_token_end(bytes, i + 4);
2634
- out.push_str("AKIA");
2635
- out.push_str("REDACTED");
2636
- i = token_end;
2637
- continue;
2638
- }
2639
- if matches_prefix_case_insensitive(bytes, i, b"Bearer ") {
2640
- let token_end = scan_token_end(bytes, i + 7);
2641
- out.push_str(&line[i..i + 7]);
2642
- out.push_str("REDACTED");
2643
- i = token_end;
2644
- continue;
2645
- }
2646
- // 32+ hex run.
2647
- if is_hex_byte(bytes[i]) {
2648
- let mut j = i;
2649
- while j < bytes.len() && is_hex_byte(bytes[j]) {
2650
- j += 1;
2651
- }
2652
- if j - i >= 32 {
2653
- out.push_str("REDACTED_HEX");
2654
- i = j;
2655
- continue;
2656
- }
2657
- }
2658
- // Default: passthrough byte.
2659
- out.push(bytes[i] as char);
2660
- i += 1;
2661
- }
2662
- out
2663
- }
2664
-
2665
- fn matches_prefix(bytes: &[u8], i: usize, prefix: &[u8]) -> bool {
2666
- bytes.get(i..i + prefix.len()).is_some_and(|s| s == prefix)
2667
- }
2668
-
2669
- fn matches_prefix_case_insensitive(bytes: &[u8], i: usize, prefix: &[u8]) -> bool {
2670
- bytes
2671
- .get(i..i + prefix.len())
2672
- .is_some_and(|s| s.eq_ignore_ascii_case(prefix))
2673
- }
2674
-
2675
- fn scan_token_end(bytes: &[u8], start: usize) -> usize {
2676
- let mut j = start;
2677
- while j < bytes.len() && is_token_byte(bytes[j]) {
2678
- j += 1;
2679
- }
2680
- j
2681
- }
2682
-
2683
- fn is_token_byte(b: u8) -> bool {
2684
- b.is_ascii_alphanumeric() || b == b'-' || b == b'_'
2685
- }
2686
-
2687
- fn is_hex_byte(b: u8) -> bool {
2688
- b.is_ascii_hexdigit()
2689
- }
2690
-
2691
- const PASTED_CONTENT_APPEAR_POLLS: u32 = 5;
2692
- const PASTED_CONTENT_SUBMIT_ATTEMPTS: u32 = 3;
2693
-
2694
- /// E46 (0.3.24 bug#5): bounded resend cap for post-Enter consumption probe.
2695
- /// Mirrors PASTED_CONTENT_SUBMIT_ATTEMPTS shape: try Enter then bounded
2696
- /// re-checks of the pane's input region. Each iteration first re-checks that
2697
- /// the input still has content before resending Enter — guards against double
2698
- /// submission when the first Enter was consumed but our readback was slow.
2699
- const POST_SUBMIT_CONSUMPTION_ATTEMPTS: u32 = 3;
2700
- const POST_SUBMIT_CONSUMPTION_POLL_MS: u64 = 60;
2701
- /// post-Enter `capture()` 失败时只重读、不重按。计入 `InjectReport.attempts`。
2702
- const POST_SUBMIT_CAPTURE_RETRY: u32 = 4;
2703
- const POST_SUBMIT_CAPTURE_RETRY_MS: u64 = 20;
2704
- /// Unverified 之后、本次身份仍在 composer 时,只补这一颗回车。
2705
- const UNVERIFIED_COMPOSER_RESEND_MAX: u32 = 1;
2706
-
2707
- /// E46 (0.3.24 bug#5, C5 provider-agnostic detector): the pane's input region
2708
- /// is "consumed" when the token text that was just visible BEFORE the Enter
2709
- /// is no longer present in the captured tail. Structural signal — no
2710
- /// provider-specific UI string. Works across claude / codex / copilot because
2711
- /// every provider's composer clears the input area after a successful submit
2712
- /// (the content scrolls into history, leaving the prompt empty).
2713
- ///
2714
- /// Returns:
2715
- /// * `Some(true)` — token was visible BEFORE submit and is GONE from
2716
- /// the visible input area now → consumption confirmed.
2717
- /// * `Some(false)` — token still visible (or other reason to think not yet
2718
- /// consumed).
2719
- /// * `None` — payload has no token marker (peer message without token,
2720
- /// empty payload) so we can't structurally check; caller treats this as
2721
- /// non-blocking (the pre-existing `EnterSentWithoutPlaceholderCheck`
2722
- /// path).
2723
- fn post_submit_input_consumed(
2724
- backend: &TmuxBackend,
2725
- target: &Target,
2726
- payload: &InjectPayload,
2727
- ) -> Result<Option<bool>, TransportError> {
2728
- let Some(marker) = payload_token_marker(payload) else {
2729
- return Ok(None);
2730
- };
2731
- let captured = backend.capture(target, CaptureRange::Tail(40))?;
2732
- // The token may legitimately appear in scrollback (a successful submit
2733
- // pushes it into history). We only treat the BOTTOM-of-pane region (last
2734
- // few lines, where the input area lives) as the consumption signal. Tail
2735
- // 30 lines is small enough that the input area still dominates if the
2736
- // submit didn't go through, while a successful submit has pushed the
2737
- // token marker out of the bottom 15 lines by the time the response
2738
- // composer redraws.
2739
- let tail_lines: Vec<&str> = captured.text.lines().rev().take(15).collect();
2740
- let token_in_tail = tail_lines.iter().any(|line| line.contains(marker));
2741
- Ok(Some(!token_in_tail))
2742
- }
2743
-
2744
- fn shell_command(
2745
- argv: &[String],
2746
- cwd: &Path,
2747
- env: &BTreeMap<String, String>,
2748
- env_unset: &[String],
2749
- ) -> String {
2750
- let unset_set: std::collections::BTreeSet<&str> =
2751
- env_unset.iter().map(String::as_str).collect();
2752
- let caller_provider = caller_provider_for_invocation(env);
2753
- let mut parts = Vec::new();
2754
- parts.push("cd".to_string());
2755
- parts.push(shell_quote(&cwd.to_string_lossy()));
2756
- parts.push("&&".to_string());
2757
- // D9 (#264) / Python providers.py:142-145 + provider_env.py:86 — profile env_unset keys
2758
- // must be unset in the shell itself: the `sh -lc` line inherits the tmux SERVER's stale
2759
- // environment, which exec-prefix assignments cannot clear.
2760
- for key in env_unset {
2761
- parts.push("unset".to_string());
2762
- parts.push(key.clone());
2763
- parts.push("&&".to_string());
2764
- }
2765
- // 0.4.x ordering fix (env-leak symptom #3): KEY=val exports must NOT
2766
- // re-introduce any key that was just unset. Filter env entries whose key
2767
- // appears in env_unset so the unset wins on the final shell line. This
2768
- // matters when inherited env (worker_spawn_env / apply_profile_launch_env)
2769
- // contains the very keys we want to scrub (e.g. CLAUDE_EFFORT carried
2770
- // forward from the launching shell into the env map).
2771
- for (key, value) in env {
2772
- if unset_set.contains(key.as_str())
2773
- || key.starts_with(crate::layout::worker_env::CALLER_CONTEXT_PREFIX)
2774
- {
2775
- continue;
2776
- }
2777
- parts.push(format!("{key}={}", shell_quote(value)));
2778
- }
2779
- append_caller_context_assignments(&mut parts, caller_provider);
2780
- parts.push("exec".to_string());
2781
- parts.extend(argv.iter().map(|arg| shell_quote(arg)));
2782
- parts.join(" ")
2783
- }
2784
-
2785
- fn caller_provider_for_invocation(env: &BTreeMap<String, String>) -> Option<&'static str> {
2786
- env.get(crate::layout::worker_env::CALLER_PROVIDER_ENV)
2787
- .and_then(|value| parse_provider(value))
2788
- .map(provider_wire)
2789
- }
2790
-
2791
- fn append_caller_context_assignments(parts: &mut Vec<String>, provider: Option<&str>) {
2792
- let Some(provider) = provider else {
2793
- return;
2794
- };
2795
- parts.push(format!(
2796
- "{}={}",
2797
- crate::layout::worker_env::CALLER_PROVIDER_ENV,
2798
- shell_quote(provider)
2799
- ));
2800
- // These are expanded by the shell created inside the target pane. They are
2801
- // assignments on the provider command only, so the exit marker/inert tail
2802
- // cannot retain a usable caller context.
2803
- parts.push(format!(
2804
- "{}=\"${{TMUX_PANE-}}\"",
2805
- crate::layout::worker_env::CALLER_PANE_ENV
2806
- ));
2807
- parts.push(format!(
2808
- "{}=\"${{TMUX%%,*}}\"",
2809
- crate::layout::worker_env::CALLER_ENDPOINT_ENV
2810
- ));
2811
- }
2812
-
2813
- /// Public exit-marker text emitted by `leader_shell_wrapper_command`. Format:
2814
- /// `"[team-agent] {provider_label} exited with {rc}"`.
2815
- pub const LEADER_PROVIDER_EXIT_MARKER_PREFIX: &str = "[team-agent]";
2816
- pub const LEADER_PROVIDER_EXIT_MARKER_SUFFIX: &str = "exited with";
2817
- const PROVIDER_EXIT_STATUS_OPTION: &str = "@team-agent-provider-exit-status";
2818
-
2819
- /// 0.4.x (CR R6): build the leader exit marker text for `provider_label`.
2820
- /// Used by the shell wrapper for human-readable output.
2821
- /// ---
2822
- /// purpose: 单一来源地拼出 leader pane 的 provider 退出标记文本
2823
- /// params:
2824
- /// provider_label: 人类可读的 provider 名,原样嵌入标记
2825
- /// returns: 前缀 + provider 名 + 后缀 拼成的标记(不含退出码,退出码由 shell 的 printf 补)
2826
- /// boundary:
2827
- /// - shell wrapper 统一使用此显示标记,进程状态另由监督 shell 收据证明
2828
- /// - 仅供显示;历史正文可包含相同文本,不得据此判定进程退出
2829
- /// ---
2830
- pub fn leader_provider_exit_marker(provider_label: &str) -> String {
2831
- format!(
2832
- "{LEADER_PROVIDER_EXIT_MARKER_PREFIX} {provider_label} {LEADER_PROVIDER_EXIT_MARKER_SUFFIX}"
2833
- )
2834
- }
2835
-
2836
- /// 0.5.39 Slice 1 (tmux-server-death-locate §7 Slice 1): ambient-tmux
2837
- /// leader-pane probe. Kept inside `tmux_backend` because it is
2838
- /// definitionally ambient — its job is to discover *which* session/pane
2839
- /// the leader process is currently inside via $TMUX/$TMUX_PANE +
2840
- /// `tmux display-message`. Everywhere else in the codebase, tmux ops
2841
- /// must go through a socket-scoped `TmuxBackend` (that constraint is
2842
- /// enforced by `n16_tmux_socket_invariant_red.rs` +
2843
- /// `tmux_server_death_0539_contract.rs::display_cleanup_...`); this
2844
- /// helper is the single controlled exception.
2845
- ///
2846
- /// Returns `(session_name, Some(pane_id))` when the ambient tmux
2847
- /// responds, or `None` if `$TMUX` is unset / `display-message` fails.
2848
- /// ---
2849
- /// purpose: 探出当前 leader 进程正待在哪个环境 tmux 的哪个 session / pane 里
2850
- /// returns: Some((session 名, 可选 pane 标识));TMUX 与 TMUX_PANE 都未设,或所有探测命令都失败或解析不出时 None(仅 TMUX_PANE 在设时仍会带 -t 探测)
2851
- /// boundary:
2852
- /// - 本文件唯一允许绕过 socket 绑定后端、直接 Command::new("tmux") 的例外,因为它的任务就是发现「我在哪」
2853
- /// - 依次试 TMUX_PANE 定位与无 -t 的当前 pane,取第一个能解析出的结果;失败静默跳到下一条,不报错
2854
- /// - 只读不写,不 attach、不改任何 tmux 状态
2855
- /// ---
2856
- pub fn probe_ambient_leader_pane_info() -> Option<(String, Option<String>)> {
2857
- let pane = std::env::var("TMUX_PANE")
2858
- .ok()
2859
- .filter(|value| !value.is_empty());
2860
- let mut commands: Vec<Vec<String>> = Vec::new();
2861
- if let Some(pane) = pane.as_deref() {
2862
- commands.push(vec![
2863
- "display-message".to_string(),
2864
- "-p".to_string(),
2865
- "-t".to_string(),
2866
- pane.to_string(),
2867
- "-F".to_string(),
2868
- "#{session_name}\t#{pane_id}".to_string(),
2869
- ]);
2870
- commands.push(vec![
2871
- "display-message".to_string(),
2872
- "-p".to_string(),
2873
- "-t".to_string(),
2874
- pane.to_string(),
2875
- "-F".to_string(),
2876
- "#{session_name}".to_string(),
2877
- ]);
2878
- }
2879
- if std::env::var("TMUX").is_ok_and(|value| !value.is_empty()) {
2880
- commands.push(vec![
2881
- "display-message".to_string(),
2882
- "-p".to_string(),
2883
- "-F".to_string(),
2884
- "#{session_name}\t#{pane_id}".to_string(),
2885
- ]);
2886
- commands.push(vec![
2887
- "display-message".to_string(),
2888
- "-p".to_string(),
2889
- "-F".to_string(),
2890
- "#{session_name}".to_string(),
2891
- ]);
2892
- }
2893
- for command in commands {
2894
- let output = match std::process::Command::new("tmux").args(&command).output() {
2895
- Ok(output) if output.status.success() => output,
2896
- _ => continue,
2897
- };
2898
- let stdout = String::from_utf8_lossy(&output.stdout);
2899
- let Some(line) = stdout.lines().find(|line| !line.trim().is_empty()) else {
2900
- continue;
2901
- };
2902
- let line = line.trim();
2903
- let parts: Vec<&str> = line.split('\t').collect();
2904
- let parsed = match parts.as_slice() {
2905
- [session, pane_str, ..] if !session.is_empty() && !session.starts_with('%') => Some((
2906
- (*session).to_string(),
2907
- (!pane_str.is_empty()).then(|| (*pane_str).to_string()),
2908
- )),
2909
- [pane_str, session, ..] if pane_str.starts_with('%') && !session.is_empty() => {
2910
- Some(((*session).to_string(), Some((*pane_str).to_string())))
2911
- }
2912
- [session] if !session.is_empty() && !session.starts_with('%') => {
2913
- Some(((*session).to_string(), None))
2914
- }
2915
- _ => None,
2916
- };
2917
- if parsed.is_some() {
2918
- return parsed;
2919
- }
2920
- }
2921
- None
2922
- }
2923
-
2924
- /// 0.5.39 Slice 2 (tmux-server-death-locate §11.2): single-source worker
2925
- /// exit marker prefix. Same envelope shape as `LEADER_PROVIDER_EXIT_MARKER_*`
2926
- /// but distinct so status/classifier code can tell "leader pane fell back
2927
- /// to shell" from "worker pane fell back to shell". Format:
2928
- /// `"[team-agent worker] {provider_label} exited with {rc}"`.
2929
- pub const WORKER_PROVIDER_EXIT_MARKER_PREFIX: &str = "[team-agent worker]";
2930
- pub const WORKER_PROVIDER_EXIT_MARKER_SUFFIX: &str = "exited with";
2931
-
2932
- /// 0.5.39 Slice 2: build the worker exit marker text for `provider_label`.
2933
- /// Used by both the worker shell wrapper (printf source) and future
2934
- /// status/classifier code (capture substring) so they cannot drift.
2935
- /// ---
2936
- /// purpose: 单一来源地拼出 worker pane 的 provider 退出标记文本
2937
- /// params:
2938
- /// provider_label: 人类可读的 provider 名,原样嵌入标记
2939
- /// returns: worker 专用前缀 + provider 名 + 后缀;与 leader 标记刻意不同,便于分清是哪种 pane 掉回 shell
2940
- /// boundary:
2941
- /// - 写标记的 worker shell wrapper 与读标记的分类代码必须都用这一个函数
2942
- /// - 同为内容信号,pane 里出现同样文本即误触发
2943
- /// ---
2944
- pub fn worker_provider_exit_marker(provider_label: &str) -> String {
2945
- format!(
2946
- "{WORKER_PROVIDER_EXIT_MARKER_PREFIX} {provider_label} {WORKER_PROVIDER_EXIT_MARKER_SUFFIX}"
2947
- )
2948
- }
2949
-
2950
- /// 0.5.39 Slice 2 (tmux-server-death-locate §7 Slice 2): worker shell
2951
- /// wrapper. Same shape as `leader_shell_wrapper_command` — provider runs
2952
- /// as a CHILD of a long-lived shell so provider exit does NOT collapse the
2953
- /// worker pane (which under upstream tmux 3.6a private-server bugs can
2954
- /// cascade into whole-server death). When the provider exits, the worker
2955
- /// pane remains alive with an explicit worker exit marker, then runs an
2956
- /// inert `sh` tail that does not read terminal input.
2957
- /// ---
2958
- /// purpose: 拼出 worker pane 的 shell 启动行,让 provider 作为子进程运行,退出后 pane 不塌成 [exited]
2959
- /// params:
2960
- /// argv: provider 启动命令,逐项做 shell 引用
2961
- /// cwd: 进程工作目录
2962
- /// env: 要导出的环境变量;键若出现在 env_unset 中则跳过,保证 unset 赢
2963
- /// env_unset: 必须真正 unset 的键;先 unset 再导出
2964
- /// provider_label: 嵌入退出标记的 provider 名
2965
- /// returns: 单条 shell 命令行,依次为 cd、unset、env 导出与 provider(不带 exec)、printf 退出标记、exec 惰性 sh 尾巴
2966
- /// boundary:
2967
- /// - 只拼字符串,不执行、不 spawn
2968
- /// - 与 leader 版的唯一实质差异是退出标记前缀;结构必须保持一致
2969
- /// - 惰性尾巴不读 pane 标准输入,故该 pane 之后收到的注入不会被任何进程消费
2970
- /// ---
2971
- pub fn worker_shell_wrapper_command(
2972
- argv: &[String],
2973
- cwd: &Path,
2974
- env: &BTreeMap<String, String>,
2975
- env_unset: &[String],
2976
- provider_label: &str,
2977
- ) -> String {
2978
- let unset_set: std::collections::BTreeSet<&str> =
2979
- env_unset.iter().map(String::as_str).collect();
2980
- let caller_provider = caller_provider_for_invocation(env);
2981
- let mut parts = Vec::new();
2982
- parts.push("cd".to_string());
2983
- parts.push(shell_quote(&cwd.to_string_lossy()));
2984
- parts.push("&&".to_string());
2985
- for key in env_unset {
2986
- parts.push("unset".to_string());
2987
- parts.push(key.clone());
2988
- parts.push("&&".to_string());
2989
- }
2990
- for (key, value) in env {
2991
- if unset_set.contains(key.as_str())
2992
- || key.starts_with(crate::layout::worker_env::CALLER_CONTEXT_PREFIX)
2993
- {
2994
- continue;
2995
- }
2996
- parts.push(format!("{key}={}", shell_quote(value)));
2997
- }
2998
- append_caller_context_assignments(&mut parts, caller_provider);
2999
- parts.extend(argv.iter().map(|arg| shell_quote(arg)));
3000
- parts.push(";".to_string());
3001
- parts.push("rc=$?;".to_string());
3002
- parts.push("printf".to_string());
3003
- parts.push(shell_quote(&format!(
3004
- "\n{} %s\n",
3005
- worker_provider_exit_marker(provider_label)
3006
- )));
3007
- parts.push("\"$rc\";".to_string());
3008
- parts.push(inert_pane_tail_command());
3009
- parts.join(" ")
3010
- }
3011
-
3012
- /// 0.4.x (CR C-2): leader shell wrapper — provider runs as a CHILD of a
3013
- /// long-lived shell, not as the pane's primary process. When the provider
3014
- /// exits, the pane remains alive with an explicit exit marker, then runs an
3015
- /// inert `sh` tail that does not read terminal input.
3016
- ///
3017
- /// Four required envelope sections (CR C-2):
3018
- /// 1. cd <cwd> — same as `shell_command`
3019
- /// 2. unset <KEY> ... — provider env_unset block
3020
- /// 3. KEY=val ... <provider> — env exports + provider invocation
3021
- /// (NO `exec` — runs as child)
3022
- /// 4. printf exit marker; exec inert sh tail
3023
- ///
3024
- /// `provider_label` is a human-readable provider name (e.g. "claude",
3025
- /// "codex") embedded in the exit marker for diagnostics.
3026
- /// ---
3027
- /// purpose: 拼出 leader pane 的 shell 启动行,让 provider 作为子进程运行,退出后 pane 保留并显示退出标记
3028
- /// params:
3029
- /// argv: provider 启动命令,逐项做 shell 引用
3030
- /// cwd: 进程工作目录
3031
- /// env: 要导出的环境变量;键若出现在 env_unset 中则跳过,保证 unset 赢
3032
- /// env_unset: 必须真正 unset 的键;先 unset 再导出
3033
- /// provider_label: 嵌入退出标记的 provider 名
3034
- /// returns: 单条 shell 命令行,四段依次为 cd、unset、env 导出与 provider(刻意不带 exec)、printf 退出标记加 exec 惰性 sh 尾巴
3035
- /// boundary:
3036
- /// - 只拼字符串,不执行、不 spawn
3037
- /// - 刻意不用 exec:用了 provider 就成了 pane 主进程,退出即塌成 [exited]
3038
- /// - 退出标记文本必须来自 leader_provider_exit_marker,禁止在此写字面量
3039
- /// ---
3040
- pub fn leader_shell_wrapper_command(
3041
- argv: &[String],
3042
- cwd: &Path,
3043
- env: &BTreeMap<String, String>,
3044
- env_unset: &[String],
3045
- provider_label: &str,
3046
- ) -> String {
3047
- let unset_set: std::collections::BTreeSet<&str> =
3048
- env_unset.iter().map(String::as_str).collect();
3049
- let mut parts = Vec::new();
3050
- // 1. cd
3051
- parts.push("cd".to_string());
3052
- parts.push(shell_quote(&cwd.to_string_lossy()));
3053
- parts.push("&&".to_string());
3054
- // 2. unset
3055
- for key in env_unset {
3056
- parts.push("unset".to_string());
3057
- parts.push(key.clone());
3058
- parts.push("&&".to_string());
3059
- }
3060
- // Clear any prior receipt before invoking the provider. Terminal content,
3061
- // including replayed sessions, must never be treated as an exit receipt.
3062
- parts.push(format!(
3063
- "{{ tmux -S \"${{TMUX%%,*}}\" set-option -p -t \"$TMUX_PANE\" {PROVIDER_EXIT_STATUS_OPTION} running >/dev/null 2>&1 || :; }} &&"
3064
- ));
3065
- // 3. env exports + provider (NO `exec` so the provider is a child).
3066
- // 0.4.x ordering fix: skip keys present in env_unset so KEY=val does not
3067
- // re-introduce a just-unset variable from the inherited env map.
3068
- for (key, value) in env {
3069
- if unset_set.contains(key.as_str()) {
3070
- continue;
3071
- }
3072
- parts.push(format!("{key}={}", shell_quote(value)));
3073
- }
3074
- parts.extend(argv.iter().map(|arg| shell_quote(arg)));
3075
- parts.push(";".to_string());
3076
- // 4. exit marker + inert shell tail
3077
- parts.push("rc=$?;".to_string());
3078
- parts.push(format!(
3079
- "tmux -S \"${{TMUX%%,*}}\" set-option -p -t \"$TMUX_PANE\" {PROVIDER_EXIT_STATUS_OPTION} \"$rc\" >/dev/null 2>&1;"
3080
- ));
3081
- parts.push("printf".to_string());
3082
- // CR R6: marker text comes from single-source `leader_provider_exit_marker`.
3083
- parts.push(shell_quote(&format!(
3084
- "\n{} %s\n",
3085
- leader_provider_exit_marker(provider_label)
3086
- )));
3087
- parts.push("\"$rc\";".to_string());
3088
- parts.push(inert_pane_tail_command());
3089
- parts.join(" ")
3090
- }
3091
-
3092
- fn inert_pane_tail_command() -> String {
3093
- // `sh` is deliberate: exited-wrapper input classifiers recognize shell
3094
- // basenames. `sh -c` does not read commands from
3095
- // stdin; disabling echo also prevents input from appearing accepted.
3096
- let script = r#"trap '' INT QUIT; stty -echo 2>/dev/null; printf "%s\n" "[team-agent] Provider exited; this pane no longer accepts input. Restart from another pane with the appropriate team-agent start command."; while :; do sleep 3600 & wait "$!"; done"#;
3097
- format!("exec /bin/sh -c {}", shell_quote(script))
3098
- }
3099
-
3100
- fn shell_quote(raw: &str) -> String {
3101
- if raw.is_empty() {
3102
- return "''".to_string();
3103
- }
3104
- if raw
3105
- .chars()
3106
- .all(|c| c.is_ascii_alphanumeric() || matches!(c, '/' | '.' | '_' | '-' | ':' | '='))
3107
- {
3108
- return raw.to_string();
3109
- }
3110
- let mut quoted = String::from("'");
3111
- for ch in raw.chars() {
3112
- if ch == '\'' {
3113
- quoted.push_str("'\\''");
3114
- } else {
3115
- quoted.push(ch);
3116
- }
3117
- }
3118
- quoted.push('\'');
3119
- quoted
3120
- }
3121
-
3122
- fn notify_submit_observer(observer: Option<&dyn SubmitObserver>) {
3123
- if let Some(observer) = observer {
3124
- observer.after_physical_submit();
3125
- }
3126
- }
3127
-
3128
- impl Transport for TmuxBackend {
3129
- fn kind(&self) -> BackendKind {
3130
- BackendKind::Tmux
3131
- }
3132
-
3133
- fn probes_real_tmux_socket_roots(&self) -> bool {
3134
- true
3135
- }
3136
-
3137
- fn supports_owned_native_input(&self) -> bool {
3138
- true
3139
- }
3140
-
3141
- fn tmux_endpoint(&self) -> Option<String> {
3142
- self.socket
3143
- .as_ref()
3144
- .map(|endpoint| endpoint.as_endpoint().to_string())
3145
- }
3146
-
3147
- fn set_session_owner(
3148
- &self,
3149
- session: &SessionName,
3150
- workspace: &Path,
3151
- team: &str,
3152
- ) -> Result<(), TransportError> {
3153
- self.set_session_owner_marker(session, workspace, team, session.as_str())
3154
- }
3155
-
3156
- fn set_session_owner_with_generation(
3157
- &self,
3158
- session: &SessionName,
3159
- workspace: &Path,
3160
- team: &str,
3161
- generation: &str,
3162
- ) -> Result<(), TransportError> {
3163
- self.set_session_owner_marker(session, workspace, team, generation)
3164
- }
3165
-
3166
- fn session_owner(
3167
- &self,
3168
- session: &SessionName,
3169
- ) -> Result<Option<SessionOwner>, TransportError> {
3170
- self.read_session_owner_marker(session)
3171
- }
3172
-
3173
- fn spawn_first(
3174
- &self,
3175
- session: &SessionName,
3176
- window: &WindowName,
3177
- argv: &[String],
3178
- cwd: &Path,
3179
- env: &BTreeMap<String, String>,
3180
- ) -> Result<SpawnResult, TransportError> {
3181
- self.spawn(session, window, argv, cwd, env, &[], true)
3182
- }
3183
-
3184
- fn spawn_first_with_env_unset(
3185
- &self,
3186
- session: &SessionName,
3187
- window: &WindowName,
3188
- argv: &[String],
3189
- cwd: &Path,
3190
- env: &BTreeMap<String, String>,
3191
- env_unset: &[String],
3192
- ) -> Result<SpawnResult, TransportError> {
3193
- self.spawn(session, window, argv, cwd, env, env_unset, true)
3194
- }
3195
-
3196
- fn spawn_into_with_env_unset(
3197
- &self,
3198
- session: &SessionName,
3199
- window: &WindowName,
3200
- argv: &[String],
3201
- cwd: &Path,
3202
- env: &BTreeMap<String, String>,
3203
- env_unset: &[String],
3204
- ) -> Result<SpawnResult, TransportError> {
3205
- self.spawn(session, window, argv, cwd, env, env_unset, false)
3206
- }
3207
-
3208
- fn spawn_into(
3209
- &self,
3210
- session: &SessionName,
3211
- window: &WindowName,
3212
- argv: &[String],
3213
- cwd: &Path,
3214
- env: &BTreeMap<String, String>,
3215
- ) -> Result<SpawnResult, TransportError> {
3216
- self.spawn(session, window, argv, cwd, env, &[], false)
3217
- }
3218
-
3219
- fn spawn_split_with_env_unset(
3220
- &self,
3221
- session: &SessionName,
3222
- window: &WindowName,
3223
- argv: &[String],
3224
- cwd: &Path,
3225
- env: &BTreeMap<String, String>,
3226
- env_unset: &[String],
3227
- ) -> Result<SpawnResult, TransportError> {
3228
- self.spawn_split(session, window, argv, cwd, env, env_unset)
3229
- }
3230
-
3231
- /// 0.5.39 Slice 2: TmuxBackend override of the worker-shell-wrapper
3232
- /// variant. Same mechanism as the leader wrapper (child provider under
3233
- /// long-lived shell), but the marker text is distinct so downstream
3234
- /// classifiers can tell leader vs worker provider exit apart.
3235
- fn spawn_first_with_worker_shell_wrapper(
3236
- &self,
3237
- session: &SessionName,
3238
- window: &WindowName,
3239
- argv: &[String],
3240
- cwd: &Path,
3241
- env: &BTreeMap<String, String>,
3242
- env_unset: &[String],
3243
- provider_label: &str,
3244
- ) -> Result<SpawnResult, TransportError> {
3245
- let command = worker_shell_wrapper_command(argv, cwd, env, env_unset, provider_label);
3246
- self.spawn_with_command(session, window, &command, true)
3247
- }
3248
-
3249
- fn spawn_into_with_worker_shell_wrapper(
3250
- &self,
3251
- session: &SessionName,
3252
- window: &WindowName,
3253
- argv: &[String],
3254
- cwd: &Path,
3255
- env: &BTreeMap<String, String>,
3256
- env_unset: &[String],
3257
- provider_label: &str,
3258
- ) -> Result<SpawnResult, TransportError> {
3259
- let command = worker_shell_wrapper_command(argv, cwd, env, env_unset, provider_label);
3260
- self.spawn_with_command(session, window, &command, false)
3261
- }
3262
-
3263
- /// 0.4.x (CR C-2): TmuxBackend override of the leader-shell-wrapper
3264
- /// variant. Builds the wrapper shell line via
3265
- /// `leader_shell_wrapper_command` and runs it through
3266
- /// `spawn_with_command` (bypassing the default `exec <cmd>` shape).
3267
- fn spawn_first_with_leader_shell_wrapper(
3268
- &self,
3269
- session: &SessionName,
3270
- window: &WindowName,
3271
- argv: &[String],
3272
- cwd: &Path,
3273
- env: &BTreeMap<String, String>,
3274
- env_unset: &[String],
3275
- provider_label: &str,
3276
- ) -> Result<SpawnResult, TransportError> {
3277
- let command = leader_shell_wrapper_command(argv, cwd, env, env_unset, provider_label);
3278
- self.spawn_with_command(session, window, &command, true)
3279
- }
3280
-
3281
- fn spawn_into_with_leader_shell_wrapper(
3282
- &self,
3283
- session: &SessionName,
3284
- window: &WindowName,
3285
- argv: &[String],
3286
- cwd: &Path,
3287
- env: &BTreeMap<String, String>,
3288
- env_unset: &[String],
3289
- provider_label: &str,
3290
- ) -> Result<SpawnResult, TransportError> {
3291
- let command = leader_shell_wrapper_command(argv, cwd, env, env_unset, provider_label);
3292
- self.spawn_with_command(session, window, &command, false)
3293
- }
3294
-
3295
- fn inject(
3296
- &self,
3297
- target: &Target,
3298
- payload: &InjectPayload,
3299
- submit: Key,
3300
- bracketed: bool,
3301
- ) -> Result<InjectReport, TransportError> {
3302
- // Trait entry delegates to inject_with_submit_observer with no
3303
- // observer. Populated InjectReport fields: stage_reached,
3304
- // inject_verification, submit_verification, turn_verification,
3305
- // attempts, submit_diagnostics — the 0.5.43 debt-sweep
3306
- // governance guard (debt_sweep_0543_contract.rs::
3307
- // coordinator_debug_eprintlns_are_deleted_but_inject_report_shape_remains)
3308
- // scans THIS function body for those field names so debug-
3309
- // print cleanup can't silently drop InjectReport surface area.
3310
- self.inject_with_submit_observer(target, payload, submit, bracketed, None)
3311
- }
3312
-
3313
- fn inject_with_submit_observer(
3314
- &self,
3315
- target: &Target,
3316
- payload: &InjectPayload,
3317
- submit: Key,
3318
- bracketed: bool,
3319
- observer: Option<&dyn SubmitObserver>,
3320
- ) -> Result<InjectReport, TransportError> {
3321
- if let (Some(request), InjectPayload::Text(text), Key::Enter) =
3322
- (crate::transport::native_input::current_request(), payload, submit)
3323
- {
3324
- return self.inject_native_input(target, text, bracketed, request, observer);
3325
- }
3326
- let pane = pane_from_target(target);
3327
- let _pane_input = crate::lifecycle::pane_input_lock::acquire_for_write(
3328
- crate::lifecycle::pane_input_lock::PaneInputLockRequest {
3329
- workspace: self.event_workspace.as_deref(),
3330
- target_key: pane.as_str(),
3331
- operation: "inject",
3332
- },
3333
- ).map_err(|_| TransportError::NativeInputNotReady { reason: "required_guard_active".into() })?;
3334
- // U1 #7: pane readback signal for the non-pasted-prompt text path.
3335
- let mut token_visible_for_report: Option<bool> = None;
3336
- match payload {
3337
- InjectPayload::Empty => {
3338
- self.prepare_pane_for_submit(target, matches!(submit, Key::Enter));
3339
- let argv = tmux_empty_inject_argv(&pane, submit);
3340
- self.run_ok(&argv)?;
3341
- notify_submit_observer(observer);
3342
- }
3343
- InjectPayload::Text(text) | InjectPayload::TextSkipConsumptionPoll(text) => {
3344
- let buffer = buffer_name_for_text(text);
3345
- for argv in tmux_inject_text_argv(&pane, &buffer, text, bracketed) {
3346
- let stage = inject_stage_for_argv(&argv);
3347
- if stage == InjectStage::LoadBuffer {
3348
- self.run_inject_stage_with_stdin(&argv, stage, text)?;
3349
- } else {
3350
- self.run_inject_stage(&argv, stage)?;
3351
- }
3352
- }
3353
- // ═══════════════════════════════════════════════════════════
3354
- // 0.3.27 UNIFIED submit_and_verify
3355
- //
3356
- // Replaces the dual-branch split (saw_pasted_prompt weak loop
3357
- // + E46 token consumption gate) with a single pipeline:
3358
- //
3359
- // Phase 1 — token visibility poll (dynamic timeout based on
3360
- // payload size, 50ms interval, replaces the fixed 125ms
3361
- // appear_gate)
3362
- // Phase 2 — Escape (if bracketed+Text+Enter) + Enter + poll
3363
- // token disappeared from bottom 3 lines. On failure:
3364
- // re-check → Escape+Enter → poll. Up to 3 attempts.
3365
- //
3366
- // Design truth source: .team/artifacts/E55-delivery-architecture-design.html
3367
- // Python parity: dynamic timeout max(2s, bytes/25000), poll 50ms.
3368
- // Cursor Ink:文本与 Enter 必须分开发且间隔 ≥1s,否则第一次
3369
- // Enter 被吞。token 可见性轮询的耗时算进这 1s;测试隔离下地板为 0。
3370
- // ═══════════════════════════════════════════════════════════
3371
- let inject_start = std::time::Instant::now();
3372
- let pasted_at = inject_start;
3373
- let submit_argv = tmux_send_submit_argv(&pane, submit);
3374
-
3375
- // Phase 1: token visibility poll — wait for the pasted text to
3376
- // become visible in the pane before submitting. Dynamic timeout
3377
- // based on payload size (large codex pastes can take seconds to
3378
- // render the bracketed-paste block).
3379
- let token_poll_timeout_ms = {
3380
- let size_based = (text.len() as u64) / 25;
3381
- size_based.max(2000)
3382
- };
3383
- let poll_start = std::time::Instant::now();
3384
- let mut token_ever_visible = false;
3385
- let mut tracked_paste: Option<PasteLatch> = None;
3386
- let mut capture_tally = CaptureTally::default();
3387
- let mut token_seen_after_paste = None;
3388
- let mut token_seen_after_enter = None;
3389
- token_visible_for_report = if let Some(m) = payload_token_marker(payload) {
3390
- let mut visible = false;
3391
- while poll_start.elapsed().as_millis() < token_poll_timeout_ms as u128 {
3392
- match self.capture(target, CaptureRange::Tail(80)) {
3393
- Ok(cap) => {
3394
- capture_tally.record_ok(&cap.text, Some(m));
3395
- tracked_paste = latch_paste(&cap.text, tracked_paste);
3396
- if cap.text.contains(m) {
3397
- visible = true;
3398
- token_ever_visible = true;
3399
- }
3400
- // 折叠占位符出现 = TUI 侧注入完成。token 出现在未折叠高块里不算完成。
3401
- if paste_ready_for_enter(&cap.text, m) {
3402
- break;
3403
- }
3404
- }
3405
- Err(_) => {
3406
- capture_tally.record_err();
3407
- break; // tmux unavailable, skip poll
3408
- }
3409
- }
3410
- std::thread::sleep(Duration::from_millis(50));
3411
- }
3412
- token_seen_after_paste = capture_tally.seen_after_ok_samples(visible);
3413
- Some(visible)
3414
- } else {
3415
- None
3416
- };
3417
-
3418
- // Phase 2: submit_and_verify — unified Escape+Enter+poll loop.
3419
- let use_escape =
3420
- bracketed && payload.text().is_some() && matches!(submit, Key::Enter);
3421
- let escape_argv = if use_escape {
3422
- Some(tmux_send_keys_argv(&pane, &[Key::Escape]))
3423
- } else {
3424
- None
3425
- };
3426
- // Non-Enter submit keys (Key::Down for codex menu, etc.) skip
3427
- // the entire submit_and_verify loop — single send, no consumption
3428
- // check, KeySentAfterVisibleToken verification.
3429
- if !matches!(submit, Key::Enter) {
3430
- self.prepare_pane_for_submit(target, false);
3431
- self.run_inject_stage(&submit_argv, InjectStage::Submit)?;
3432
- notify_submit_observer(observer);
3433
- let total_elapsed_ms = inject_start.elapsed().as_millis() as u64;
3434
- let surface = probe_inject_target_surface(self, target);
3435
- return Ok(InjectReport {
3436
- stage_reached: InjectStage::Submit,
3437
- inject_verification: inject_verification_after_readback(
3438
- payload,
3439
- token_visible_for_report,
3440
- ),
3441
- submit_verification: submit_verification_for_key(submit),
3442
- turn_verification: TurnVerification::NotYetObserved,
3443
- attempts: 1,
3444
- submit_diagnostics: Some(submit_diagnostics_for_inject(
3445
- total_elapsed_ms,
3446
- Vec::new(),
3447
- &capture_tally,
3448
- token_seen_after_paste,
3449
- None,
3450
- surface,
3451
- )),
3452
- });
3453
- }
3454
-
3455
- sleep_remaining_paste_to_submit_floor(pasted_at, current_paste_to_submit_floor());
3456
-
3457
- let marker = payload_token_marker(payload);
3458
- let max_submit_attempts: u32 = 3;
3459
- let mut consumption_attempts: u32 = 0;
3460
- let mut capture_retries: u32 = 0;
3461
- let mut consumed: Option<bool> = None;
3462
- let mut consumption_reason = SubmitConsumptionReason::Unknown;
3463
- let mut consumption_diagnostics = ConsumptionDiagnostics::default();
3464
- let mut attempts_detail: Vec<SubmitAttemptObservation> = Vec::new();
3465
- let mut any_attempt_matched = false;
3466
-
3467
- let poll_consumption = !payload.skip_consumption_poll();
3468
- if !poll_consumption {
3469
- self.prepare_pane_for_submit(target, true);
3470
- if self
3471
- .run_inject_stage(&submit_argv, InjectStage::Submit)
3472
- .is_ok()
3473
- {
3474
- notify_submit_observer(observer);
3475
- consumption_attempts = 1;
3476
- // 跳过消费门(leader skip)不是「没能判断」;保持既有 EnterSent。
3477
- consumed = Some(true);
3478
- }
3479
- }
3480
- let submit_attempt_limit = if poll_consumption {
3481
- max_submit_attempts
3482
- } else {
3483
- 0
3484
- };
3485
-
3486
- for attempt in 0..submit_attempt_limit {
3487
- let attempt_index = attempt + 1;
3488
- let attempt_start = std::time::Instant::now();
3489
- // Before resending (attempt > 0), re-check if the token
3490
- // already disappeared — guards against double-submit (C3).
3491
- // Capture failures are non-fatal (tmux may not be running
3492
- // in MCP sim / test env).
3493
- if attempt > 0 {
3494
- if let Some(m) = marker {
3495
- if let Ok(cap) = self.capture(target, CaptureRange::Tail(40)) {
3496
- capture_tally.record_ok(&cap.text, Some(m));
3497
- if cap.text.contains(m) {
3498
- token_ever_visible = true;
3499
- token_seen_after_enter = Some(true);
3500
- } else if token_seen_after_enter.is_none() {
3501
- token_seen_after_enter = Some(false);
3502
- }
3503
- tracked_paste = latch_paste(&cap.text, tracked_paste);
3504
- let observation = consumption_capture_observation(
3505
- &cap.text,
3506
- marker,
3507
- token_ever_visible,
3508
- tracked_paste,
3509
- );
3510
- consumption_diagnostics.record(observation);
3511
- let obs = submit_attempt_observation(
3512
- attempt_index,
3513
- &cap,
3514
- marker,
3515
- attempt_start.elapsed().as_millis() as u64,
3516
- );
3517
- if obs.matched {
3518
- any_attempt_matched = true;
3519
- }
3520
- attempts_detail.push(obs);
3521
- // NeverSeen 不得把 token 缺席写成 consumed;
3522
- // 见过再消失,或本次占位符身份离开 composer,才停手。
3523
- if observation.consumption_from_capture_result == Some(true) {
3524
- consumption_reason =
3525
- SubmitConsumptionReason::ConsumptionFromCapture;
3526
- consumed = Some(true);
3527
- break;
3528
- }
3529
- if cursor_single_enter_enabled() {
3530
- if observation.busy.is_some() {
3531
- consumption_reason =
3532
- SubmitConsumptionReason::CursorPollingBusy;
3533
- consumed = Some(true);
3534
- break;
3535
- }
3536
- if !should_resubmit_enter_cursor(&cap.text, m) {
3537
- consumed = Some(false);
3538
- break;
3539
- }
3540
- } else if !should_resubmit_enter(&cap.text, m, tracked_paste) {
3541
- consumed = Some(false);
3542
- break;
3543
- }
3544
- }
3545
- }
3546
- }
3547
-
3548
- // 0.3.28-final (E55 false-positive truth source):
3549
- // Escape retry is DELETED. The researcher established
3550
- // Escape on Claude TUI with [Pasted content] visible
3551
- // may CLEAR the composer content rather than exit paste
3552
- // mode — sending Escape+Enter on retry would submit an
3553
- // empty message and hide the genuine consumption failure
3554
- // under a fake-success path. Python parity: ONLY ever
3555
- // send Enter, never Escape.
3556
- let _ = escape_argv;
3557
-
3558
- // 发前归零接收态(tmux mode + 未闭合 bracketed paste)。
3559
- // 所有 Enter 路径的收敛点:prepare_pane_for_submit。
3560
- // mode 不是忙闲;cancel 失败不得让注入失败。E55: 不送 Escape/C-c。
3561
- self.prepare_pane_for_submit(target, true);
3562
-
3563
- // Enter — send-keys failure is degraded (tmux may not have
3564
- // the pane in sim/test env). Break to consumed=None → Unverified.
3565
- if self
3566
- .run_inject_stage(&submit_argv, InjectStage::Submit)
3567
- .is_err()
3568
- {
3569
- consumed = None;
3570
- break;
3571
- }
3572
- notify_submit_observer(observer);
3573
- consumption_attempts = attempt + 1;
3574
-
3575
- // Post-submit token readback (U1 #7 parity: check token
3576
- // visible after Enter for no-echo panes).
3577
- if attempt == 0 && matches!(token_visible_for_report, Some(false)) {
3578
- let post = post_submit_token_visible(
3579
- self,
3580
- target,
3581
- payload,
3582
- &mut capture_tally,
3583
- )
3584
- .unwrap_or(None);
3585
- if post == Some(true) {
3586
- token_visible_for_report = Some(true);
3587
- token_ever_visible = true;
3588
- token_seen_after_enter = Some(true);
3589
- } else {
3590
- token_visible_for_report = Some(false);
3591
- if post == Some(false) {
3592
- token_seen_after_enter = Some(false);
3593
- }
3594
- }
3595
- }
3596
-
3597
- // Poll: token 三态 + 本次 #N 占位符。
3598
- // Capture failures → 只重读 capture,绝不重粘、不加 Enter;读不到则 None。
3599
- if let Some(m) = marker {
3600
- let mut found_consumed = false;
3601
- let mut saw_capture = false;
3602
- let mut consecutive_capture_failures: u32 = 0;
3603
- for _ in 0..12 {
3604
- std::thread::sleep(Duration::from_millis(100));
3605
- match self.capture(target, CaptureRange::Tail(40)) {
3606
- Ok(cap) => {
3607
- capture_tally.record_ok(&cap.text, Some(m));
3608
- consecutive_capture_failures = 0;
3609
- saw_capture = true;
3610
- if cap.text.contains(m) {
3611
- token_ever_visible = true;
3612
- token_seen_after_enter = Some(true);
3613
- } else if token_seen_after_enter.is_none() {
3614
- token_seen_after_enter = Some(false);
3615
- }
3616
- tracked_paste = latch_paste(&cap.text, tracked_paste);
3617
- let observation = consumption_capture_observation(
3618
- &cap.text,
3619
- marker,
3620
- token_ever_visible,
3621
- tracked_paste,
3622
- );
3623
- consumption_diagnostics.record(observation);
3624
- let obs = submit_attempt_observation(
3625
- attempt_index,
3626
- &cap,
3627
- marker,
3628
- attempt_start.elapsed().as_millis() as u64,
3629
- );
3630
- if obs.matched {
3631
- any_attempt_matched = true;
3632
- }
3633
- attempts_detail.push(obs);
3634
- if observation.consumption_from_capture_result == Some(true) {
3635
- consumption_reason =
3636
- SubmitConsumptionReason::ConsumptionFromCapture;
3637
- found_consumed = true;
3638
- break;
3639
- }
3640
- if cursor_single_enter_enabled() && observation.busy.is_some() {
3641
- consumption_reason =
3642
- SubmitConsumptionReason::CursorPollingBusy;
3643
- found_consumed = true;
3644
- break;
3645
- }
3646
- }
3647
- Err(_) => {
3648
- consumption_diagnostics
3649
- .record(ConsumptionCaptureObservation::default());
3650
- capture_tally.record_err();
3651
- capture_retries = capture_retries.saturating_add(1);
3652
- consecutive_capture_failures =
3653
- consecutive_capture_failures.saturating_add(1);
3654
- if consecutive_capture_failures >= POST_SUBMIT_CAPTURE_RETRY {
3655
- break;
3656
- }
3657
- std::thread::sleep(Duration::from_millis(
3658
- POST_SUBMIT_CAPTURE_RETRY_MS,
3659
- ));
3660
- }
3661
- }
3662
- }
3663
- if !saw_capture {
3664
- consumed = None;
3665
- break;
3666
- }
3667
- consumed = Some(found_consumed);
3668
- if found_consumed {
3669
- break;
3670
- }
3671
- } else {
3672
- // Non-token payload: single Enter, no consumption check
3673
- // (0.3.27). Keep the explicit no-marker reason.
3674
- consumption_reason = SubmitConsumptionReason::NoMarker;
3675
- consumed = Some(true);
3676
- break;
3677
- }
3678
- }
3679
-
3680
- // 0.5.43 debt-sweep (§6.2): three unconditional
3681
- // `eprintln!` submit-consumption debug lines removed.
3682
- // The decision they narrated is already captured in
3683
- // `InjectReport.submit_diagnostics` /
3684
- // `submit_verification`; the prints only spammed
3685
- // coordinator.log without additive signal. Behavior
3686
- // is byte-identical.
3687
- // consumed=false: token still in composer. Paste landing
3688
- // (`any_attempt_matched`) is A, not submit. Only a Working
3689
- // signal counts as consumption. Else say unverified.
3690
- let _ = any_attempt_matched;
3691
- let mut last_turn_text = attempts_detail
3692
- .last()
3693
- .map(|obs| obs.pane_tail_excerpt.clone());
3694
- let mut submit_verification = match consumed {
3695
- Some(true) => SubmitVerification::EnterSentWithoutPlaceholderCheck,
3696
- Some(false) => match self.capture(target, CaptureRange::Tail(15)) {
3697
- Ok(cap) => {
3698
- last_turn_text = Some(cap.text.clone());
3699
- let observation = consumption_capture_observation(
3700
- &cap.text,
3701
- marker,
3702
- token_ever_visible,
3703
- tracked_paste,
3704
- );
3705
- consumption_diagnostics.record(observation);
3706
- attempts_detail.push(submit_attempt_observation(
3707
- consumption_attempts.max(1),
3708
- &cap,
3709
- marker,
3710
- inject_start.elapsed().as_millis() as u64,
3711
- ));
3712
- if consumption_diagnostics.busy_seen {
3713
- consumption_reason = SubmitConsumptionReason::FallbackBusy;
3714
- SubmitVerification::EnterSentWithoutPlaceholderCheck
3715
- } else {
3716
- consumption_reason = SubmitConsumptionReason::Unverified;
3717
- SubmitVerification::SubmitConsumptionUnverified
3718
- }
3719
- }
3720
- Err(_) => {
3721
- consumption_diagnostics
3722
- .record(ConsumptionCaptureObservation::default());
3723
- consumption_reason = SubmitConsumptionReason::Unverified;
3724
- SubmitVerification::SubmitConsumptionUnverified
3725
- }
3726
- },
3727
- None => {
3728
- consumption_reason = SubmitConsumptionReason::Unverified;
3729
- SubmitVerification::SubmitConsumptionUnverified
3730
- }
3731
- };
3732
- // Unverified + 折行缺口:只补一颗 C-m。A 的 should_resubmit_enter
3733
- // 已为真(latch/底15 token,含打满 cap)时 B 不介入。身份拿不到
3734
- // (None)不补——重复不可逆,滞留可人工救。cursor 单回车不走这里。
3735
- // 终止:已消费 / 身份消失 / A 已覆盖 / 达上限 / busy。
3736
- if matches!(
3737
- submit_verification,
3738
- SubmitVerification::SubmitConsumptionUnverified
3739
- ) && consumed == Some(false)
3740
- && !cursor_single_enter_enabled()
3741
- {
3742
- if let Some(m) = marker {
3743
- let mut leftover_resends = UNVERIFIED_COMPOSER_RESEND_MAX;
3744
- while leftover_resends > 0 {
3745
- leftover_resends -= 1;
3746
- let Ok(cap) = self.capture(target, CaptureRange::Tail(15)) else {
3747
- break;
3748
- };
3749
- last_turn_text = Some(cap.text.clone());
3750
- if !should_resend_unverified_wrap_gap(&cap.text, m, tracked_paste) {
3751
- break;
3752
- }
3753
- self.prepare_pane_for_submit(target, true);
3754
- if self
3755
- .run_inject_stage(&submit_argv, InjectStage::Submit)
3756
- .is_err()
3757
- {
3758
- break;
3759
- }
3760
- notify_submit_observer(observer);
3761
- consumption_attempts = consumption_attempts.saturating_add(1);
3762
- let attempt_start = std::time::Instant::now();
3763
- let mut found_consumed = false;
3764
- for _ in 0..12 {
3765
- std::thread::sleep(Duration::from_millis(100));
3766
- match self.capture(target, CaptureRange::Tail(40)) {
3767
- Ok(cap) => {
3768
- capture_tally.record_ok(&cap.text, Some(m));
3769
- if cap.text.contains(m) {
3770
- token_ever_visible = true;
3771
- token_seen_after_enter = Some(true);
3772
- } else if token_seen_after_enter.is_none() {
3773
- token_seen_after_enter = Some(false);
3774
- }
3775
- tracked_paste = latch_paste(&cap.text, tracked_paste);
3776
- let observation = consumption_capture_observation(
3777
- &cap.text,
3778
- marker,
3779
- token_ever_visible,
3780
- tracked_paste,
3781
- );
3782
- consumption_diagnostics.record(observation);
3783
- let obs = submit_attempt_observation(
3784
- consumption_attempts.max(1),
3785
- &cap,
3786
- marker,
3787
- attempt_start.elapsed().as_millis() as u64,
3788
- );
3789
- attempts_detail.push(obs);
3790
- last_turn_text = Some(cap.text.clone());
3791
- let capture_consumed = observation
3792
- .consumption_from_capture_result
3793
- == Some(true);
3794
- let busy = observation.busy.is_some();
3795
- if capture_consumed || busy {
3796
- // Gone+无 latch 会把折行 token 写成已消费;身份仍在则不算。
3797
- if !this_paste_identity_in_composer(
3798
- &cap.text,
3799
- m,
3800
- tracked_paste,
3801
- ) {
3802
- consumption_reason = if capture_consumed {
3803
- SubmitConsumptionReason::ConsumptionFromCapture
3804
- } else {
3805
- SubmitConsumptionReason::FallbackBusy
3806
- };
3807
- found_consumed = true;
3808
- break;
3809
- }
3810
- }
3811
- if !this_paste_identity_in_composer(
3812
- &cap.text,
3813
- m,
3814
- tracked_paste,
3815
- ) {
3816
- consumption_reason = SubmitConsumptionReason::Unknown;
3817
- found_consumed = true;
3818
- break;
3819
- }
3820
- }
3821
- Err(_) => {
3822
- consumption_diagnostics
3823
- .record(ConsumptionCaptureObservation::default());
3824
- capture_tally.record_err();
3825
- break;
3826
- }
3827
- }
3828
- }
3829
- if found_consumed {
3830
- submit_verification =
3831
- SubmitVerification::EnterSentWithoutPlaceholderCheck;
3832
- break;
3833
- }
3834
- }
3835
- }
3836
- }
3837
- let total_elapsed_ms = inject_start.elapsed().as_millis() as u64;
3838
- let surface = probe_inject_target_surface(self, target);
3839
- let mut submit_diagnostics = submit_diagnostics_for_inject(
3840
- total_elapsed_ms,
3841
- attempts_detail,
3842
- &capture_tally,
3843
- token_seen_after_paste,
3844
- token_seen_after_enter,
3845
- surface,
3846
- );
3847
- submit_diagnostics.consumption_reason = consumption_reason;
3848
- submit_diagnostics.busy_signal_kind = consumption_diagnostics.busy_signal_kind;
3849
- submit_diagnostics.busy_line_from_bottom =
3850
- consumption_diagnostics.busy_line_from_bottom;
3851
- submit_diagnostics.current_marker_in_bottom_15 =
3852
- consumption_diagnostics.current_marker_in_bottom_15;
3853
- submit_diagnostics.paste_identity_in_composer =
3854
- consumption_diagnostics.paste_identity_in_composer;
3855
- submit_diagnostics.consumption_from_capture_result =
3856
- consumption_diagnostics.consumption_from_capture_result;
3857
- return Ok(InjectReport {
3858
- stage_reached: InjectStage::Submit,
3859
- inject_verification: inject_verification_after_readback(
3860
- payload,
3861
- token_visible_for_report,
3862
- ),
3863
- submit_verification,
3864
- turn_verification: turn_verification_for_payload(
3865
- payload,
3866
- last_turn_text.as_deref(),
3867
- ),
3868
- attempts: consumption_attempts.saturating_add(capture_retries),
3869
- submit_diagnostics: Some(submit_diagnostics),
3870
- });
3871
- }
3872
- }
3873
- Ok(InjectReport {
3874
- stage_reached: InjectStage::Submit,
3875
- inject_verification: inject_verification_after_readback(
3876
- payload,
3877
- token_visible_for_report,
3878
- ),
3879
- submit_verification: submit_verification_for_key(submit),
3880
- turn_verification: turn_verification_for_payload(payload, None),
3881
- attempts: 1,
3882
- // E50 PR-1: Empty payload / non-Text fallthrough path — no submit
3883
- // diagnostics applicable.
3884
- submit_diagnostics: None,
3885
- })
3886
- }
3887
-
3888
- fn observe_native_input(
3889
- &self,
3890
- target: &Target,
3891
- provider: crate::model::enums::Provider,
3892
- ) -> Result<Option<crate::transport::native_input::InputFrame>, TransportError> {
3893
- self.observe_current_native_input(target, provider)
3894
- }
3895
-
3896
- fn snapshot_enter_rescue(
3897
- &self,
3898
- target: &Target,
3899
- context: &crate::transport::enter_rescue::EnterRescueContext,
3900
- rendered_payload: &str,
3901
- ) -> Result<crate::transport::enter_rescue::EnterRescueContext, TransportError> {
3902
- self.snapshot_rescue_context(target, context, rendered_payload)
3903
- }
3904
-
3905
- fn rescue_enter_guarded(
3906
- &self,
3907
- context: &crate::transport::enter_rescue::EnterRescueContext,
3908
- authorize: &dyn Fn() -> bool,
3909
- observer: Option<&dyn SubmitObserver>,
3910
- ) -> Result<crate::transport::enter_rescue::EnterRescueOutcome, TransportError> {
3911
- self.rescue_guarded_enter(context, authorize, observer)
3912
- }
3913
-
3914
- fn rescue_enter(&self, evidence: &crate::transport::native_input::NativeInputEvidence, authorize: &dyn Fn() -> bool, observer: Option<&dyn SubmitObserver>)
3915
- -> Result<crate::transport::native_input::EnterRescueOutcome, TransportError>
3916
- {
3917
- self.rescue_native_input(evidence, authorize, observer)
3918
- }
3919
-
3920
- fn send_keys(&self, target: &Target, keys: &[Key]) -> Result<(), TransportError> {
3921
- let pane = pane_from_target(target);
3922
- let _pane_input = crate::lifecycle::pane_input_lock::acquire_for_write(
3923
- crate::lifecycle::pane_input_lock::PaneInputLockRequest {
3924
- workspace: self.event_workspace.as_deref(),
3925
- target_key: pane.as_str(),
3926
- operation: "send_keys",
3927
- },
3928
- ).map_err(|_| TransportError::NativeInputNotReady { reason: "required_guard_active".into() })?;
3929
- if keys.contains(&Key::CancelMode) {
3930
- if let Some(mode) = pane_mode_from_raw(self.query(target, PaneField::PaneMode)?) {
3931
- let argv = crate::transport::tmux_cancel_mode_argv(&pane, mode);
3932
- return self.run_ok(&argv);
3933
- }
3934
- return Ok(());
3935
- }
3936
- if keys.iter().any(|k| matches!(k, Key::Enter)) {
3937
- self.prepare_pane_for_submit(target, true);
3938
- }
3939
- let argv = tmux_send_keys_argv(&pane, keys);
3940
- self.run_ok(&argv)
3941
- }
3942
-
3943
- fn capture(
3944
- &self,
3945
- target: &Target,
3946
- range: CaptureRange,
3947
- ) -> Result<CapturedText, TransportError> {
3948
- let pane = pane_from_target(target);
3949
- let argv = self.tmux_argv(&tmux_capture_argv(&pane, range));
3950
- let output = self
3951
- .runner
3952
- .run(&argv)
3953
- .map_err(|source| TransportError::Capture { source })?;
3954
- if !output.success {
3955
- return Err(subprocess_error(argv, output));
3956
- }
3957
- Ok(CapturedText {
3958
- text: normalize_capture(&output.stdout),
3959
- range,
3960
- })
3961
- }
3962
-
3963
- fn query(&self, target: &Target, field: PaneField) -> Result<Option<String>, TransportError> {
3964
- let pane = pane_from_target(target);
3965
- let argv = self.tmux_argv(&tmux_query_argv(&pane, field));
3966
- let output = self.runner.run(&argv)?;
3967
- if !output.success {
3968
- return Ok(None);
3969
- }
3970
- Ok(Some(output.stdout.trim().to_string()))
3971
- }
3972
-
3973
- fn provider_exit_status(&self, pane: &PaneId) -> Result<Option<u8>, TransportError> {
3974
- let argv = self.tmux_argv(&[
3975
- "tmux".to_string(),
3976
- "display-message".to_string(),
3977
- "-p".to_string(),
3978
- "-t".to_string(),
3979
- pane.as_str().to_string(),
3980
- format!("#{{{PROVIDER_EXIT_STATUS_OPTION}}}"),
3981
- ]);
3982
- let output = self.runner.run(&argv)?;
3983
- if !output.success {
3984
- return Ok(None);
3985
- }
3986
- Ok(output.stdout.trim().parse::<u8>().ok())
3987
- }
3988
-
3989
- fn pane_is_dead(&self, pane: &PaneId) -> Result<Option<bool>, TransportError> {
3990
- let argv = self.tmux_argv(&[
3991
- "tmux".to_string(),
3992
- "display-message".to_string(),
3993
- "-p".to_string(),
3994
- "-t".to_string(),
3995
- pane.as_str().to_string(),
3996
- "#{pane_dead}".to_string(),
3997
- ]);
3998
- let output = self.runner.run(&argv)?;
3999
- if !output.success {
4000
- return Ok(None);
4001
- }
4002
- Ok(match output.stdout.trim() {
4003
- "1" => Some(true),
4004
- "0" => Some(false),
4005
- _ => None,
4006
- })
4007
- }
4008
-
4009
- fn liveness(&self, pane: &PaneId) -> Result<PaneLiveness, TransportError> {
4010
- let argv = self.tmux_argv(&[
4011
- "tmux".to_string(),
4012
- "display-message".to_string(),
4013
- "-p".to_string(),
4014
- "-t".to_string(),
4015
- pane.as_str().to_string(),
4016
- "#{pane_id}".to_string(),
4017
- ]);
4018
- let output = self.runner.run(&argv)?;
4019
- if output.success {
4020
- return Ok(PaneLiveness::Live);
4021
- }
4022
- if output
4023
- .stderr
4024
- .to_ascii_lowercase()
4025
- .contains("can't find pane")
4026
- {
4027
- Ok(PaneLiveness::Dead)
4028
- } else {
4029
- Ok(PaneLiveness::Unknown)
4030
- }
4031
- }
4032
-
4033
- fn has_pane(&self, pane: &PaneId) -> Result<Option<bool>, TransportError> {
4034
- let argv = self.tmux_argv(&[
4035
- "tmux".to_string(),
4036
- "display-message".to_string(),
4037
- "-p".to_string(),
4038
- "-t".to_string(),
4039
- pane.as_str().to_string(),
4040
- "#{pane_id}".to_string(),
4041
- ]);
4042
- let output = self.runner.run(&argv)?;
4043
- if output.success {
4044
- let pane_id = output.stdout.trim();
4045
- if pane_id.is_empty() {
4046
- return Ok(Some(false));
4047
- }
4048
- if pane_id == pane.as_str()
4049
- && pane_id.starts_with('%')
4050
- && pane_id[1..].chars().all(|ch| ch.is_ascii_digit())
4051
- {
4052
- return Ok(Some(true));
4053
- }
4054
- return Ok(None);
4055
- }
4056
- let stderr = output.stderr.to_ascii_lowercase();
4057
- if stderr.contains("can't find pane")
4058
- || stderr.contains("no such pane")
4059
- || (stderr.contains("can't find") && stderr.contains("pane"))
4060
- {
4061
- Ok(Some(false))
4062
- } else {
4063
- Ok(None)
4064
- }
4065
- }
4066
-
4067
- fn list_targets(&self) -> Result<Vec<PaneInfo>, TransportError> {
4068
- // P5 (C-P5-3): `#{pane_pid}` rides the single list-panes call (field index 11),
4069
- // killing the per-pane display-message N+1 fallback.
4070
- // Use a printable sentinel so the 12-field frame stays explicit in argv/log evidence;
4071
- // `parse_pane_info_line` retains compatibility with legacy tab-delimited output.
4072
- const TMUX_PANE_FORMAT: &str = "#{pane_id}__TA_FIELD__#{session_name}__TA_FIELD__#{window_index}__TA_FIELD__#{window_name}__TA_FIELD__#{pane_index}__TA_FIELD__#{pane_tty}__TA_FIELD__#{pane_current_command}__TA_FIELD__#{pane_active}__TA_FIELD__#{pane_current_path}__TA_FIELD__#{session_attached}__TA_FIELD__#{pane_in_mode}__TA_FIELD__#{pane_pid}__TA_FIELD__#{@team_agent_pane_binding_nonce}";
4073
- let argv = self.tmux_argv(&[
4074
- "tmux".to_string(),
4075
- "list-panes".to_string(),
4076
- "-a".to_string(),
4077
- "-F".to_string(),
4078
- TMUX_PANE_FORMAT.to_string(),
4079
- ]);
4080
- let output = self.runner.run(&argv)?;
4081
- if !output.success {
4082
- return Ok(Vec::new());
4083
- }
4084
- let mut panes = Vec::new();
4085
- for line in output.stdout.lines().filter(|line| !line.is_empty()) {
4086
- if let Some(mut pane) = parse_pane_info_line(line) {
4087
- // 0.3.5 integration union: P5 (C-P5-3) makes `#{pane_pid}` ride the
4088
- // single list-panes call — on real tmux the fallback below never fires.
4089
- // swallow batch 2 ① keeps it as a RESILIENT degrade for panes whose pid
4090
- // field came back empty (e.g. older tmux without #{pane_pid}): a single
4091
- // pane's probe failure must not fail the WHOLE list — the pane degrades
4092
- // to pane_pid=None and the failure is observable.
4093
- if pane.pane_pid.is_none() {
4094
- match query_pane_pid(self, &pane.pane_id) {
4095
- Ok(pid) => pane.pane_pid = pid,
4096
- Err(error) => {
4097
- if let Some(workspace) = &self.event_workspace {
4098
- let _ = crate::event_log::EventLog::new(workspace).write(
4099
- "tmux.pane_pid_query_failed",
4100
- serde_json::json!({
4101
- "pane_id": pane.pane_id.as_str(),
4102
- "session": pane.session.as_str(),
4103
- "error": error.to_string(),
4104
- }),
4105
- );
4106
- }
4107
- }
4108
- }
4109
- }
4110
- panes.push(pane);
4111
- }
4112
- }
4113
- Ok(panes)
4114
- }
4115
-
4116
- fn has_session(&self, session: &SessionName) -> Result<bool, TransportError> {
4117
- let argv = self.tmux_argv(&[
4118
- "tmux".to_string(),
4119
- "has-session".to_string(),
4120
- "-t".to_string(),
4121
- session.as_str().to_string(),
4122
- ]);
4123
- let output = self.runner.run(&argv)?;
4124
- Ok(output.success)
4125
- }
4126
-
4127
- fn list_windows(&self, session: &SessionName) -> Result<Vec<WindowName>, TransportError> {
4128
- // golden runtime.py:1023-1029 `_tmux_window_exists`: `tmux list-windows -t <s> -F #{window_name}`;
4129
- // returncode != 0 -> false (here: an empty window set), else the window names by line.
4130
- let argv = self.tmux_argv(&[
4131
- "tmux".to_string(),
4132
- "list-windows".to_string(),
4133
- "-t".to_string(),
4134
- session.as_str().to_string(),
4135
- "-F".to_string(),
4136
- "#{window_name}".to_string(),
4137
- ]);
4138
- let output = self.runner.run(&argv)?;
4139
- if !output.success {
4140
- return Ok(Vec::new());
4141
- }
4142
- Ok(output
4143
- .stdout
4144
- .lines()
4145
- .filter(|line| !line.is_empty())
4146
- .map(WindowName::new)
4147
- .collect())
4148
- }
4149
-
4150
- fn configure_adaptive_pane_title(
4151
- &self,
4152
- session: &SessionName,
4153
- window: &WindowName,
4154
- pane: &PaneId,
4155
- title: &str,
4156
- ) -> Result<(), TransportError> {
4157
- let target = format!("{}:{}", session.as_str(), window.as_str());
4158
- self.run_ok(&[
4159
- "tmux".to_string(),
4160
- "set-window-option".to_string(),
4161
- "-t".to_string(),
4162
- target.clone(),
4163
- "pane-border-status".to_string(),
4164
- "bottom".to_string(),
4165
- ])?;
4166
- self.run_ok(&[
4167
- "tmux".to_string(),
4168
- "set-window-option".to_string(),
4169
- "-t".to_string(),
4170
- target,
4171
- "pane-border-format".to_string(),
4172
- " #{pane_title} ".to_string(),
4173
- ])?;
4174
- self.run_ok(&[
4175
- "tmux".to_string(),
4176
- "select-pane".to_string(),
4177
- "-t".to_string(),
4178
- pane.as_str().to_string(),
4179
- "-T".to_string(),
4180
- title.to_string(),
4181
- ])
4182
- }
4183
-
4184
- fn set_session_env(
4185
- &self,
4186
- session: &SessionName,
4187
- key: &str,
4188
- value: &str,
4189
- ) -> Result<SetEnvOutcome, TransportError> {
4190
- let argv = vec![
4191
- "tmux".to_string(),
4192
- "set-environment".to_string(),
4193
- "-t".to_string(),
4194
- session.as_str().to_string(),
4195
- key.to_string(),
4196
- value.to_string(),
4197
- ];
4198
- self.run_ok(&argv)?;
4199
- Ok(SetEnvOutcome::Applied)
4200
- }
4201
-
4202
- fn set_window_option(
4203
- &self,
4204
- session: &SessionName,
4205
- window: &WindowName,
4206
- option: &str,
4207
- value: &str,
4208
- ) -> Result<(), TransportError> {
4209
- let target = format!("{}:{}", session.as_str(), window.as_str());
4210
- let argv = vec![
4211
- "tmux".to_string(),
4212
- "set-window-option".to_string(),
4213
- "-t".to_string(),
4214
- target,
4215
- option.to_string(),
4216
- value.to_string(),
4217
- ];
4218
- self.run_ok(&argv)
4219
- }
4220
-
4221
- fn preserve_session_before_stop(
4222
- &self,
4223
- session: &SessionName,
4224
- targets: &[Target],
4225
- ) -> Result<(), TransportError> {
4226
- let list_argv = self.tmux_argv(&[
4227
- "tmux".to_string(),
4228
- "list-panes".to_string(),
4229
- "-s".to_string(),
4230
- "-t".to_string(),
4231
- format!("={}", session.as_str()),
4232
- "-F".to_string(),
4233
- "#{pane_id}\t#{window_name}".to_string(),
4234
- ]);
4235
- let output = self.runner.run(&list_argv)?;
4236
- if !output.success {
4237
- return Err(subprocess_error(list_argv, output));
4238
- }
4239
- for line in output.stdout.lines() {
4240
- // Some tmux/runner combinations return the literal escape. Split
4241
- // only the first column boundary; window names are not unescaped.
4242
- let separator = line.find('\t').map(|at| (at, 1)).into_iter()
4243
- .chain(line.find("\\t").map(|at| (at, 2)))
4244
- .min_by_key(|(at, _)| *at);
4245
- let Some((at, width)) = separator else {
4246
- return Err(TransportError::Subprocess {
4247
- argv: list_argv,
4248
- code: output.code,
4249
- stderr: "tmux returned an invalid session pane listing".to_string(),
4250
- });
4251
- };
4252
- let (pane, rest) = line.split_at(at);
4253
- let window = &rest[width..];
4254
- if !targets.iter().any(|target| match target {
4255
- Target::Pane(id) => id.as_str() == pane,
4256
- Target::SessionWindow {
4257
- session: owner,
4258
- window: name,
4259
- } => owner == session && name.as_str() == window,
4260
- }) {
4261
- return Ok(());
4262
- }
4263
- }
4264
- // An empty listing cannot prove that this is the last worker.
4265
- if output.stdout.trim().is_empty() {
4266
- return Err(TransportError::TargetNotFound {
4267
- target: session.as_str().to_string(),
4268
- });
4269
- }
4270
- // Use a separate, non-worker window: remain-on-exit does not protect a
4271
- // pane explicitly deleted by kill-pane. Configure by the new pane ID,
4272
- // not a window name that could resolve to another same-named window.
4273
- let spawn_argv = tmux_spawn_argv(
4274
- &SessionName::new(format!("={}", session.as_str())),
4275
- &WindowName::new(KEEPALIVE_WINDOW_NAME),
4276
- "exec sleep 86400",
4277
- false,
4278
- );
4279
- let spawned = self.run_spawn(&spawn_argv)?;
4280
- let pane = spawned.stdout.trim();
4281
- if !pane.starts_with('%')
4282
- || pane.len() == 1
4283
- || !pane[1..].chars().all(|ch| ch.is_ascii_digit())
4284
- {
4285
- return Err(TransportError::Subprocess {
4286
- argv: self.tmux_argv(&spawn_argv),
4287
- code: spawned.code,
4288
- stderr: "tmux keepalive spawn returned no valid pane id".to_string(),
4289
- });
4290
- }
4291
- let result = self
4292
- .run_ok(&[
4293
- "tmux".to_string(),
4294
- "set-window-option".to_string(),
4295
- "-t".to_string(),
4296
- pane.to_string(),
4297
- "remain-on-exit".to_string(),
4298
- "on".to_string(),
4299
- ])
4300
- .and_then(|()| {
4301
- self.run_ok(&[
4302
- "tmux".to_string(),
4303
- "respawn-pane".to_string(),
4304
- "-k".to_string(),
4305
- "-t".to_string(),
4306
- pane.to_string(),
4307
- "exit 0".to_string(),
4308
- ])
4309
- });
4310
- if result.is_err() {
4311
- // The worker has not been killed yet; remove only our new anchor.
4312
- let _ = self.kill_pane(&PaneId::new(pane));
4313
- }
4314
- result
4315
- }
4316
-
4317
- fn kill_server(&self) -> Result<(), TransportError> {
4318
- TmuxBackend::kill_server(self);
4319
- Ok(())
4320
- }
4321
-
4322
- fn kill_session(&self, session: &SessionName) -> Result<(), TransportError> {
4323
- let argv = self.tmux_argv(&[
4324
- "tmux".to_string(),
4325
- "kill-session".to_string(),
4326
- "-t".to_string(),
4327
- session.as_str().to_string(),
4328
- ]);
4329
- self.run_ok(&argv)
4330
- }
4331
-
4332
- fn kill_window(&self, target: &Target) -> Result<(), TransportError> {
4333
- let argv = self.tmux_argv(&[
4334
- "tmux".to_string(),
4335
- "kill-window".to_string(),
4336
- "-t".to_string(),
4337
- target_name(target),
4338
- ]);
4339
- self.run_ok(&argv)
4340
- }
4341
-
4342
- fn kill_pane(&self, pane: &PaneId) -> Result<(), TransportError> {
4343
- let argv = self.tmux_argv(&[
4344
- "tmux".to_string(),
4345
- "kill-pane".to_string(),
4346
- "-t".to_string(),
4347
- pane.as_str().to_string(),
4348
- ]);
4349
- self.run_ok(&argv)
4350
- }
4351
-
4352
- fn attach_session(&self, session: &SessionName) -> Result<AttachOutcome, TransportError> {
4353
- let argv = [
4354
- "tmux".to_string(),
4355
- "attach-session".to_string(),
4356
- "-t".to_string(),
4357
- session.as_str().to_string(),
4358
- ];
4359
- self.run_ok(&argv)?;
4360
- Ok(AttachOutcome::Attached)
4361
- }
4362
- }
4363
-
4364
- /// swallow batch 2 ① fallback probe (only fires when `#{pane_pid}` came back empty —
4365
- /// see the P5 union note in `list_targets`).
4366
- fn query_pane_pid(backend: &TmuxBackend, pane: &PaneId) -> Result<Option<u32>, TransportError> {
4367
- let argv = backend.tmux_argv(&[
4368
- "tmux".to_string(),
4369
- "display-message".to_string(),
4370
- "-p".to_string(),
4371
- "-t".to_string(),
4372
- pane.as_str().to_string(),
4373
- "#{pane_pid}".to_string(),
4374
- ]);
4375
- let output = backend.runner.run(&argv)?;
4376
- if !output.success {
4377
- return Ok(None);
4378
- }
4379
- Ok(parse_optional_u32(output.stdout.trim()))
4380
- }
4381
-
4382
- fn parse_pane_info_line(line: &str) -> Option<PaneInfo> {
4383
- let fields = if line.contains("__TA_FIELD__") {
4384
- line.split("__TA_FIELD__").collect::<Vec<_>>()
4385
- } else {
4386
- line.split('\t').collect::<Vec<_>>()
4387
- };
4388
- if fields.len() < 11 {
4389
- return None;
4390
- }
4391
- let mut leader_env = BTreeMap::new();
4392
- if let Some(nonce) = fields.get(12).and_then(|raw| non_empty(raw)) {
4393
- leader_env.insert(
4394
- PANE_BINDING_NONCE_METADATA_KEY.to_string(),
4395
- nonce.to_string(),
4396
- );
4397
- }
4398
- Some(PaneInfo {
4399
- pane_id: PaneId::new(fields[0]),
4400
- session: SessionName::new(fields[1]),
4401
- window_index: parse_optional_u32(fields[2]),
4402
- window_name: non_empty(fields[3]).map(WindowName::new),
4403
- pane_index: parse_optional_u32(fields[4]),
4404
- tty: non_empty(fields[5]).map(str::to_string),
4405
- current_command: non_empty(fields[6]).map(str::to_string),
4406
- active: fields[7] == "1",
4407
- current_path: non_empty(fields[8]).map(PathBuf::from),
4408
- pane_pid: fields.get(11).and_then(|raw| parse_optional_u32(raw)),
4409
- leader_env,
4410
- })
4411
- }
4412
-
4413
- fn parse_optional_u32(raw: &str) -> Option<u32> {
4414
- if raw.is_empty() {
4415
- return None;
4416
- }
4417
- raw.parse::<u32>().ok()
4418
- }
4419
-
4420
- fn non_empty(raw: &str) -> Option<&str> {
4421
- if raw.is_empty() {
4422
- None
4423
- } else {
4424
- Some(raw)
4425
- }
4426
- }
4427
-
4428
- // 0.5.x Windows portability Batch 5: the `tmux_backend/tests.rs`
4429
- // module uses `std::os::unix::net::UnixListener` for its mock
4430
- // runner + verifies Unix-specific socket-root derivation. Since the
4431
- // tmux backend itself only functions on Unix (design § Route B —
4432
- // tmux is a Unix concept), the test module stays Unix-only.
4433
- #[cfg(all(test, unix))]
4434
- mod tests;
4435
-
4436
- #[cfg(all(test, unix))]
4437
- mod command_runner_regressions {
4438
- use super::{CommandRunner, RealCommandRunner, COMMAND_TIMEOUT};
4439
- use std::io::ErrorKind;
4440
- use std::time::{Duration, Instant, SystemTime, UNIX_EPOCH};
4441
-
4442
- fn shell(command: &str) -> Vec<String> {
4443
- vec!["/bin/sh".into(), "-c".into(), command.into()]
4444
- }
4445
-
4446
- #[test]
4447
- fn nonzero_exit_preserves_both_outputs_and_lossy_utf8() {
4448
- let output = RealCommandRunner
4449
- .run(&shell("printf 'stdout\\377'; printf 'stderr\\376' >&2; exit 17"))
4450
- .unwrap();
4451
- assert!(!output.success);
4452
- assert_eq!(output.code, Some(17));
4453
- assert_eq!(output.stdout, "stdout\u{fffd}");
4454
- assert_eq!(output.stderr, "stderr\u{fffd}");
4455
- }
4456
-
4457
- #[test]
4458
- fn stdin_is_delivered_and_closed_before_waiting_for_exit() {
4459
- let input = "first line\nsecond λ line\n".repeat(32);
4460
- let output = RealCommandRunner
4461
- .run_with_stdin(&["/bin/cat".into()], &input)
4462
- .unwrap();
4463
- assert!(output.success);
4464
- assert_eq!(output.code, Some(0));
4465
- assert_eq!(output.stdout, input);
4466
- assert_eq!(output.stderr, "");
4467
- }
4468
-
4469
- #[test]
4470
- fn signal_exit_retains_absent_exit_code() {
4471
- let output = RealCommandRunner.run(&shell("kill -TERM $$")).unwrap();
4472
- assert!(!output.success);
4473
- assert_eq!(output.code, None);
4474
- }
4475
-
4476
- #[test]
4477
- fn drains_stdout_and_stderr_beyond_pipe_capacity() {
4478
- let output = RealCommandRunner
4479
- .run(&shell(
4480
- "i=0; while [ \"$i\" -lt 20000 ]; do printf 'out\\n'; printf 'err\\n' >&2; i=$((i+1)); done",
4481
- ))
4482
- .unwrap();
4483
- assert!(output.success);
4484
- assert_eq!(output.code, Some(0));
4485
- assert_eq!(output.stdout, "out\n".repeat(20000));
4486
- assert_eq!(output.stderr, "err\n".repeat(20000));
4487
- }
4488
-
4489
- #[test]
4490
- fn timeout_keeps_five_second_budget_and_reaps_the_owned_child() {
4491
- let nonce = SystemTime::now()
4492
- .duration_since(UNIX_EPOCH)
4493
- .unwrap()
4494
- .as_nanos();
4495
- let pid_path = std::env::temp_dir().join(format!(
4496
- "team-agent-runner-timeout-{}-{nonce}.pid",
4497
- std::process::id()
4498
- ));
4499
- let file = std::fs::OpenOptions::new()
4500
- .write(true)
4501
- .create_new(true)
4502
- .open(&pid_path)
4503
- .unwrap();
4504
- drop(file);
4505
- // exec keeps one owned PID and closes both pipes when the runner kills it.
4506
- let mut argv = shell("printf '%s' \"$$\" > \"$1\"; exec /bin/sleep 30");
4507
- argv.extend([
4508
- "runner-timeout-test".into(),
4509
- pid_path.to_string_lossy().into_owned(),
4510
- ]);
4511
- let started = Instant::now();
4512
- let error = RealCommandRunner.run(&argv).unwrap_err();
4513
- let elapsed = started.elapsed();
4514
- let pid: i32 = std::fs::read_to_string(&pid_path).unwrap().parse().unwrap();
4515
- std::fs::remove_file(pid_path).unwrap();
4516
- assert_eq!(error.kind(), ErrorKind::TimedOut);
4517
- assert!(elapsed >= COMMAND_TIMEOUT);
4518
- assert!(elapsed < COMMAND_TIMEOUT + Duration::from_secs(2));
4519
- assert!(pid > 1);
4520
- // SAFETY: signal 0 only probes the exact child PID recorded by this fixture.
4521
- assert_eq!(unsafe { libc::kill(pid, 0) }, -1);
4522
- assert_eq!(
4523
- std::io::Error::last_os_error().raw_os_error(),
4524
- Some(libc::ESRCH)
4525
- );
4526
- }
4527
- }