@team-agent/installer 0.5.128 → 0.6.1

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 (436) hide show
  1. package/README.md +4 -4
  2. package/README.zh.md +1 -1
  3. package/package.json +4 -8
  4. package/skills/team-agent/SKILL.md +37 -20
  5. package/skills/team-agent/command-coverage.json +169 -183
  6. package/skills/team-agent/docs/reference/team-agent-operator.md +64 -30
  7. package/skills/team-agent/references/recovery-runbook.md +1 -1
  8. package/skills/team-agent/references/team-agent-operator.md +64 -30
  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 -1288
  15. package/crates/team-agent/src/cli/arguments.rs +0 -405
  16. package/crates/team-agent/src/cli/attach_app_server_leader.rs +0 -98
  17. package/crates/team-agent/src/cli/diagnose.rs +0 -1721
  18. package/crates/team-agent/src/cli/emit.rs +0 -2930
  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 -1216
  22. package/crates/team-agent/src/cli/intent/runtime_tests.rs +0 -912
  23. package/crates/team-agent/src/cli/intent/tests.rs +0 -689
  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 -6545
  29. package/crates/team-agent/src/cli/models.rs +0 -1206
  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/schedule.rs +0 -175
  34. package/crates/team-agent/src/cli/send/coordinator.rs +0 -164
  35. package/crates/team-agent/src/cli/send/mailbox.rs +0 -145
  36. package/crates/team-agent/src/cli/send/persist.rs +0 -156
  37. package/crates/team-agent/src/cli/send/presentation.rs +0 -370
  38. package/crates/team-agent/src/cli/send/resolve.rs +0 -573
  39. package/crates/team-agent/src/cli/send.rs +0 -199
  40. package/crates/team-agent/src/cli/shutdown_socket.rs +0 -288
  41. package/crates/team-agent/src/cli/spec.rs +0 -165
  42. package/crates/team-agent/src/cli/status.rs +0 -280
  43. package/crates/team-agent/src/cli/status_port/agents.rs +0 -358
  44. package/crates/team-agent/src/cli/status_port/approvals.rs +0 -79
  45. package/crates/team-agent/src/cli/status_port/brief.rs +0 -1981
  46. package/crates/team-agent/src/cli/status_port/compact.rs +0 -240
  47. package/crates/team-agent/src/cli/status_port/format.rs +0 -146
  48. package/crates/team-agent/src/cli/status_port/inbox.rs +0 -62
  49. package/crates/team-agent/src/cli/status_port/runtime.rs +0 -197
  50. package/crates/team-agent/src/cli/status_port/snapshot.rs +0 -208
  51. package/crates/team-agent/src/cli/status_port/store.rs +0 -416
  52. package/crates/team-agent/src/cli/status_port/tests.rs +0 -90
  53. package/crates/team-agent/src/cli/status_port.rs +0 -92
  54. package/crates/team-agent/src/cli/tests/base.rs +0 -885
  55. package/crates/team-agent/src/cli/tests/divergence.rs +0 -518
  56. package/crates/team-agent/src/cli/tests/lane_c.rs +0 -453
  57. package/crates/team-agent/src/cli/tests/leader_watch.rs +0 -322
  58. package/crates/team-agent/src/cli/tests/main_preserved.rs +0 -430
  59. package/crates/team-agent/src/cli/tests/missing_subcommands.rs +0 -336
  60. package/crates/team-agent/src/cli/tests/mod.rs +0 -137
  61. package/crates/team-agent/src/cli/tests/named_address.rs +0 -761
  62. package/crates/team-agent/src/cli/tests/parser_safety.rs +0 -383
  63. package/crates/team-agent/src/cli/tests/run_delegation.rs +0 -484
  64. package/crates/team-agent/src/cli/tests/shutdown_kill_plan.rs +0 -2179
  65. package/crates/team-agent/src/cli/tests/status_brief.rs +0 -1514
  66. package/crates/team-agent/src/cli/tests/status_send.rs +0 -888
  67. package/crates/team-agent/src/cli/tests/verb_install_skill.rs +0 -93
  68. package/crates/team-agent/src/cli/tests/verb_profile.rs +0 -392
  69. package/crates/team-agent/src/cli/triage.rs +0 -234
  70. package/crates/team-agent/src/cli/types.rs +0 -591
  71. package/crates/team-agent/src/codex_app_server.rs +0 -546
  72. package/crates/team-agent/src/communication_mode/mod.rs +0 -56
  73. package/crates/team-agent/src/compiler/tests.rs +0 -827
  74. package/crates/team-agent/src/compiler.rs +0 -890
  75. package/crates/team-agent/src/conpty/backend.rs +0 -829
  76. package/crates/team-agent/src/conpty/mod.rs +0 -33
  77. package/crates/team-agent/src/contract_runtime/backend.rs +0 -1744
  78. package/crates/team-agent/src/contract_runtime/commands.rs +0 -671
  79. package/crates/team-agent/src/contract_runtime/config.rs +0 -364
  80. package/crates/team-agent/src/contract_runtime/config_tests.rs +0 -76
  81. package/crates/team-agent/src/contract_runtime/discovery.rs +0 -449
  82. package/crates/team-agent/src/contract_runtime/fork.rs +0 -361
  83. package/crates/team-agent/src/contract_runtime/forward.rs +0 -288
  84. package/crates/team-agent/src/contract_runtime/framework.rs +0 -367
  85. package/crates/team-agent/src/contract_runtime/mcp.rs +0 -394
  86. package/crates/team-agent/src/contract_runtime/mod.rs +0 -17
  87. package/crates/team-agent/src/contract_runtime/prompt.rs +0 -216
  88. package/crates/team-agent/src/contract_runtime/pump.rs +0 -271
  89. package/crates/team-agent/src/contract_runtime/registry.rs +0 -553
  90. package/crates/team-agent/src/contract_runtime/workspace.rs +0 -228
  91. package/crates/team-agent/src/coordinator/backoff.rs +0 -741
  92. package/crates/team-agent/src/coordinator/conpty_shim.rs +0 -805
  93. package/crates/team-agent/src/coordinator/health.rs +0 -1185
  94. package/crates/team-agent/src/coordinator/mod.rs +0 -119
  95. package/crates/team-agent/src/coordinator/orphan.rs +0 -110
  96. package/crates/team-agent/src/coordinator/runtime_detectors.rs +0 -798
  97. package/crates/team-agent/src/coordinator/runtime_observation.rs +0 -84
  98. package/crates/team-agent/src/coordinator/steps/abnormal.rs +0 -2309
  99. package/crates/team-agent/src/coordinator/steps/delivery.rs +0 -15
  100. package/crates/team-agent/src/coordinator/steps/health_sync.rs +0 -15
  101. package/crates/team-agent/src/coordinator/steps/mod.rs +0 -126
  102. package/crates/team-agent/src/coordinator/steps/persist.rs +0 -15
  103. package/crates/team-agent/src/coordinator/steps/runtime_prompts.rs +0 -15
  104. package/crates/team-agent/src/coordinator/steps/session_gate.rs +0 -16
  105. package/crates/team-agent/src/coordinator/tests/a0_lostupdate.rs +0 -158
  106. package/crates/team-agent/src/coordinator/tests/abnormal.rs +0 -312
  107. package/crates/team-agent/src/coordinator/tests/api_error_recovery.rs +0 -300
  108. package/crates/team-agent/src/coordinator/tests/basics.rs +0 -211
  109. package/crates/team-agent/src/coordinator/tests/daemon.rs +0 -514
  110. package/crates/team-agent/src/coordinator/tests/energy.rs +0 -549
  111. package/crates/team-agent/src/coordinator/tests/health_sync.rs +0 -503
  112. package/crates/team-agent/src/coordinator/tests/main_preserved.rs +0 -186
  113. package/crates/team-agent/src/coordinator/tests/mod.rs +0 -295
  114. package/crates/team-agent/src/coordinator/tests/s3_bounded.rs +0 -207
  115. package/crates/team-agent/src/coordinator/tests/spine.rs +0 -308
  116. package/crates/team-agent/src/coordinator/tests/takeover.rs +0 -286
  117. package/crates/team-agent/src/coordinator/tests/tick_core.rs +0 -237
  118. package/crates/team-agent/src/coordinator/tick.rs +0 -3024
  119. package/crates/team-agent/src/coordinator/types.rs +0 -540
  120. package/crates/team-agent/src/db/agent_health_capture.rs +0 -126
  121. package/crates/team-agent/src/db/message_store.rs +0 -1527
  122. package/crates/team-agent/src/db/migration.rs +0 -984
  123. package/crates/team-agent/src/db/mod.rs +0 -26
  124. package/crates/team-agent/src/db/schema.rs +0 -663
  125. package/crates/team-agent/src/diagnose/comms.rs +0 -242
  126. package/crates/team-agent/src/diagnose/mod.rs +0 -44
  127. package/crates/team-agent/src/diagnose/orphans.rs +0 -889
  128. package/crates/team-agent/src/direct_delivery.rs +0 -368
  129. package/crates/team-agent/src/event_log.rs +0 -502
  130. package/crates/team-agent/src/fake_worker.rs +0 -303
  131. package/crates/team-agent/src/inbox_store.rs +0 -169
  132. package/crates/team-agent/src/kill_audit.rs +0 -106
  133. package/crates/team-agent/src/layout/manager.rs +0 -248
  134. package/crates/team-agent/src/layout/mod.rs +0 -36
  135. package/crates/team-agent/src/layout/overlay.rs +0 -134
  136. package/crates/team-agent/src/layout/placement.rs +0 -52
  137. package/crates/team-agent/src/layout/recovery.rs +0 -106
  138. package/crates/team-agent/src/layout/runtime_sessions.rs +0 -317
  139. package/crates/team-agent/src/layout/sessions.rs +0 -294
  140. package/crates/team-agent/src/layout/tmux_endpoint.rs +0 -165
  141. package/crates/team-agent/src/layout/worker_env.rs +0 -721
  142. package/crates/team-agent/src/layout/worker_window_helpers.rs +0 -37
  143. package/crates/team-agent/src/leader/helpers.rs +0 -178
  144. package/crates/team-agent/src/leader/incident.rs +0 -6
  145. package/crates/team-agent/src/leader/lease.rs +0 -3356
  146. package/crates/team-agent/src/leader/mod.rs +0 -104
  147. package/crates/team-agent/src/leader/owner_bind.rs +0 -400
  148. package/crates/team-agent/src/leader/prompt.rs +0 -905
  149. package/crates/team-agent/src/leader/provider_attribution.rs +0 -247
  150. package/crates/team-agent/src/leader/rediscover/tests.rs +0 -689
  151. package/crates/team-agent/src/leader/rediscover.rs +0 -1192
  152. package/crates/team-agent/src/leader/registry.rs +0 -888
  153. package/crates/team-agent/src/leader/start.rs +0 -4501
  154. package/crates/team-agent/src/leader/takeover.rs +0 -65
  155. package/crates/team-agent/src/leader/tests/basics.rs +0 -337
  156. package/crates/team-agent/src/leader/tests/byte_findings.rs +0 -355
  157. package/crates/team-agent/src/leader/tests/claim_leader_mailbox_flush_contract.rs +0 -544
  158. package/crates/team-agent/src/leader/tests/historical_inventory_upgrade_gate_red.rs +0 -624
  159. package/crates/team-agent/src/leader/tests/identity.rs +0 -465
  160. package/crates/team-agent/src/leader/tests/identity_session_names.rs +0 -42
  161. package/crates/team-agent/src/leader/tests/idle.rs +0 -113
  162. package/crates/team-agent/src/leader/tests/lease_api.rs +0 -520
  163. package/crates/team-agent/src/leader/tests/lease_claim.rs +0 -629
  164. package/crates/team-agent/src/leader/tests/mod.rs +0 -106
  165. package/crates/team-agent/src/leader/tests/prompt_contract.rs +0 -268
  166. package/crates/team-agent/src/leader/tests/rediscover.rs +0 -403
  167. package/crates/team-agent/src/leader/tests/rehomed_env.rs +0 -83
  168. package/crates/team-agent/src/leader/tests/team_in_team_state_scope_red.rs +0 -1273
  169. package/crates/team-agent/src/leader/tests/terminal_and_replay_vs_rerender_invariants_red.rs +0 -417
  170. package/crates/team-agent/src/leader/tests/wake_start_owner.rs +0 -168
  171. package/crates/team-agent/src/leader/types.rs +0 -534
  172. package/crates/team-agent/src/lib.rs +0 -147
  173. package/crates/team-agent/src/lifecycle/helpers.rs +0 -212
  174. package/crates/team-agent/src/lifecycle/launch/add_agent.rs +0 -881
  175. package/crates/team-agent/src/lifecycle/launch/add_agent_state.rs +0 -598
  176. package/crates/team-agent/src/lifecycle/launch/agent_state.rs +0 -332
  177. package/crates/team-agent/src/lifecycle/launch/clone_agent.rs +0 -204
  178. package/crates/team-agent/src/lifecycle/launch/fork_agent.rs +0 -107
  179. package/crates/team-agent/src/lifecycle/launch/fork_entry.rs +0 -144
  180. package/crates/team-agent/src/lifecycle/launch/identity.rs +0 -674
  181. package/crates/team-agent/src/lifecycle/launch/layout.rs +0 -350
  182. package/crates/team-agent/src/lifecycle/launch/leader_context.rs +0 -589
  183. package/crates/team-agent/src/lifecycle/launch/mcp_config.rs +0 -160
  184. package/crates/team-agent/src/lifecycle/launch/ownership.rs +0 -105
  185. package/crates/team-agent/src/lifecycle/launch/pi_mcp.rs +0 -899
  186. package/crates/team-agent/src/lifecycle/launch/pi_mcp_extension.js +0 -225
  187. package/crates/team-agent/src/lifecycle/launch/plan.rs +0 -269
  188. package/crates/team-agent/src/lifecycle/launch/quick_start.rs +0 -5200
  189. package/crates/team-agent/src/lifecycle/launch/quick_start_transport.rs +0 -368
  190. package/crates/team-agent/src/lifecycle/launch/readiness.rs +0 -519
  191. package/crates/team-agent/src/lifecycle/launch/role_source.rs +0 -287
  192. package/crates/team-agent/src/lifecycle/launch/spawn.rs +0 -473
  193. package/crates/team-agent/src/lifecycle/launch/spec_state.rs +0 -801
  194. package/crates/team-agent/src/lifecycle/launch/state_projection.rs +0 -624
  195. package/crates/team-agent/src/lifecycle/launch/worker_env.rs +0 -558
  196. package/crates/team-agent/src/lifecycle/launch.rs +0 -557
  197. package/crates/team-agent/src/lifecycle/lock.rs +0 -350
  198. package/crates/team-agent/src/lifecycle/mod.rs +0 -79
  199. package/crates/team-agent/src/lifecycle/pane_input_lock.rs +0 -239
  200. package/crates/team-agent/src/lifecycle/profile_launch.rs +0 -1067
  201. package/crates/team-agent/src/lifecycle/profile_smoke.rs +0 -557
  202. package/crates/team-agent/src/lifecycle/restart/agent.rs +0 -2199
  203. package/crates/team-agent/src/lifecycle/restart/avatar.rs +0 -1798
  204. package/crates/team-agent/src/lifecycle/restart/claude_fork.rs +0 -163
  205. package/crates/team-agent/src/lifecycle/restart/common.rs +0 -2362
  206. package/crates/team-agent/src/lifecycle/restart/orchestrator.rs +0 -65
  207. package/crates/team-agent/src/lifecycle/restart/preflight.rs +0 -113
  208. package/crates/team-agent/src/lifecycle/restart/rebuild.rs +0 -5135
  209. package/crates/team-agent/src/lifecycle/restart/remove.rs +0 -1504
  210. package/crates/team-agent/src/lifecycle/restart/selection.rs +0 -559
  211. package/crates/team-agent/src/lifecycle/restart/team_state.rs +0 -329
  212. package/crates/team-agent/src/lifecycle/restart.rs +0 -227
  213. package/crates/team-agent/src/lifecycle/role_config.rs +0 -1230
  214. package/crates/team-agent/src/lifecycle/tests/acceptance_b_batch_red.rs +0 -1021
  215. package/crates/team-agent/src/lifecycle/tests/agent_ops.rs +0 -1205
  216. package/crates/team-agent/src/lifecycle/tests/b0_legacy_snapshot_nonauthority_contract.rs +0 -265
  217. package/crates/team-agent/src/lifecycle/tests/b0_reader_hideone_audit_contract.rs +0 -490
  218. package/crates/team-agent/src/lifecycle/tests/behavioral_diff_264_red.rs +0 -656
  219. package/crates/team-agent/src/lifecycle/tests/claude_compatible_config_red.rs +0 -325
  220. package/crates/team-agent/src/lifecycle/tests/claude_profile_launch_red.rs +0 -447
  221. package/crates/team-agent/src/lifecycle/tests/cli_argv_routing_red.rs +0 -1638
  222. package/crates/team-agent/src/lifecycle/tests/clone_agent_preserves_source_tools.rs +0 -427
  223. package/crates/team-agent/src/lifecycle/tests/clone_fork_copilot_perms_red.rs +0 -770
  224. package/crates/team-agent/src/lifecycle/tests/communication_mode_runtime_contract_red.rs +0 -419
  225. package/crates/team-agent/src/lifecycle/tests/copilot_provider_red.rs +0 -2035
  226. package/crates/team-agent/src/lifecycle/tests/core.rs +0 -1327
  227. package/crates/team-agent/src/lifecycle/tests/f032_startup_prompt_best_effort_red.rs +0 -315
  228. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_g0.stdout.txt +0 -222
  229. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_spaced_ids.stdout.txt +0 -9
  230. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_native_mcp_host.mjs +0 -72
  231. package/crates/team-agent/src/lifecycle/tests/gate_fixtures.rs +0 -562
  232. package/crates/team-agent/src/lifecycle/tests/grok_require_explicit_model_red.rs +0 -110
  233. package/crates/team-agent/src/lifecycle/tests/harvest2_a_batch_red.rs +0 -512
  234. package/crates/team-agent/src/lifecycle/tests/host_cotenant_death_p0_contract.rs +0 -921
  235. package/crates/team-agent/src/lifecycle/tests/issue238_codex_effort_contract.rs +0 -68
  236. package/crates/team-agent/src/lifecycle/tests/lane_ops.rs +0 -1851
  237. package/crates/team-agent/src/lifecycle/tests/launch_spawn.rs +0 -3983
  238. package/crates/team-agent/src/lifecycle/tests/lifecycle_lock.rs +0 -339
  239. package/crates/team-agent/src/lifecycle/tests/lifecycle_rollback_red.rs +0 -596
  240. package/crates/team-agent/src/lifecycle/tests/main_preserved.rs +0 -513
  241. package/crates/team-agent/src/lifecycle/tests/mcp_tool_name_format_red.rs +0 -69
  242. package/crates/team-agent/src/lifecycle/tests/phase_b_contracts.rs +0 -824
  243. package/crates/team-agent/src/lifecycle/tests/phase_golden.rs +0 -723
  244. package/crates/team-agent/src/lifecycle/tests/pi_catalog_red.rs +0 -164
  245. package/crates/team-agent/src/lifecycle/tests/pi_command_red.rs +0 -200
  246. package/crates/team-agent/src/lifecycle/tests/pi_compiler_red.rs +0 -210
  247. package/crates/team-agent/src/lifecycle/tests/pi_dual_entry_red.rs +0 -527
  248. package/crates/team-agent/src/lifecycle/tests/pi_executable_mcp_red.rs +0 -1062
  249. package/crates/team-agent/src/lifecycle/tests/pi_fork_session_inheritance_red.rs +0 -1419
  250. package/crates/team-agent/src/lifecycle/tests/pi_lifecycle_doctor_red.rs +0 -98
  251. package/crates/team-agent/src/lifecycle/tests/pi_native_mcp_capability_red.rs +0 -550
  252. package/crates/team-agent/src/lifecycle/tests/pi_session_delivery_red.rs +0 -226
  253. package/crates/team-agent/src/lifecycle/tests/quick_start_worker_readiness_red.rs +0 -332
  254. package/crates/team-agent/src/lifecycle/tests/realmachine_clusters_1_6_red.rs +0 -786
  255. package/crates/team-agent/src/lifecycle/tests/realmachine_residual_g1_g4_red.rs +0 -648
  256. package/crates/team-agent/src/lifecycle/tests/restart.rs +0 -185
  257. package/crates/team-agent/src/lifecycle/tests/restart_build_before_destroy_0540_contract.rs +0 -1053
  258. package/crates/team-agent/src/lifecycle/tests/restart_liveness_red.rs +0 -679
  259. package/crates/team-agent/src/lifecycle/tests/restart_rebind_hotfix_252_red.rs +0 -1126
  260. package/crates/team-agent/src/lifecycle/tests/restart_session_capture_red.rs +0 -153
  261. package/crates/team-agent/src/lifecycle/tests/resume_recover_red.rs +0 -427
  262. package/crates/team-agent/src/lifecycle/tests/stale_team_saveconflict_contract.rs +0 -431
  263. package/crates/team-agent/src/lifecycle/tests/startup_latency_contract.rs +0 -1066
  264. package/crates/team-agent/src/lifecycle/tests/status_credential_redaction_contract.rs +0 -876
  265. package/crates/team-agent/src/lifecycle/tests/subprep_codex_trust_roundtrip_red.rs +0 -1026
  266. package/crates/team-agent/src/lifecycle/tests/swallow_batch4_semantics_red.rs +0 -342
  267. package/crates/team-agent/src/lifecycle/tests/team_in_team_identity_scope_red.rs +0 -543
  268. package/crates/team-agent/src/lifecycle/tests/team_in_team_sibling_quick_start_red.rs +0 -1103
  269. package/crates/team-agent/src/lifecycle/tests/team_in_team_state_scope_red.rs +0 -1276
  270. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_roster_red.rs +0 -145
  271. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_txn_red.rs +0 -603
  272. package/crates/team-agent/src/lifecycle/tests/test_isolation_escape_contract.rs +0 -936
  273. package/crates/team-agent/src/lifecycle/tests/upgrade_compat_0211_red.rs +0 -970
  274. package/crates/team-agent/src/lifecycle/tests/verify_rs031_window_consistency_red.rs +0 -995
  275. package/crates/team-agent/src/lifecycle/tests/worker_spawn_env_red.rs +0 -836
  276. package/crates/team-agent/src/lifecycle/tests.rs +0 -105
  277. package/crates/team-agent/src/lifecycle/types.rs +0 -877
  278. package/crates/team-agent/src/lifecycle/worker_command_context.rs +0 -363
  279. package/crates/team-agent/src/main.rs +0 -52
  280. package/crates/team-agent/src/mcp_server/helpers.rs +0 -510
  281. package/crates/team-agent/src/mcp_server/lifecycle_tools/mod.rs +0 -6
  282. package/crates/team-agent/src/mcp_server/lifecycle_tools/state_status.rs +0 -43
  283. package/crates/team-agent/src/mcp_server/mod.rs +0 -119
  284. package/crates/team-agent/src/mcp_server/normalize.rs +0 -485
  285. package/crates/team-agent/src/mcp_server/readiness.rs +0 -527
  286. package/crates/team-agent/src/mcp_server/readiness_tests.rs +0 -348
  287. package/crates/team-agent/src/mcp_server/tests/golden.rs +0 -285
  288. package/crates/team-agent/src/mcp_server/tests/normalize.rs +0 -247
  289. package/crates/team-agent/src/mcp_server/tests/scoped.rs +0 -158
  290. package/crates/team-agent/src/mcp_server/tests/send.rs +0 -353
  291. package/crates/team-agent/src/mcp_server/tests/tools.rs +0 -341
  292. package/crates/team-agent/src/mcp_server/tests/wire.rs +0 -254
  293. package/crates/team-agent/src/mcp_server/tests.rs +0 -43
  294. package/crates/team-agent/src/mcp_server/tools.rs +0 -889
  295. package/crates/team-agent/src/mcp_server/types.rs +0 -396
  296. package/crates/team-agent/src/mcp_server/wire.rs +0 -867
  297. package/crates/team-agent/src/messaging/activity.rs +0 -461
  298. package/crates/team-agent/src/messaging/address.rs +0 -87
  299. package/crates/team-agent/src/messaging/delivery.rs +0 -3727
  300. package/crates/team-agent/src/messaging/delivery_consumption_tests.rs +0 -234
  301. package/crates/team-agent/src/messaging/enter_rescue.rs +0 -362
  302. package/crates/team-agent/src/messaging/enter_rescue_tests.rs +0 -633
  303. package/crates/team-agent/src/messaging/helpers.rs +0 -336
  304. package/crates/team-agent/src/messaging/leader_channel.rs +0 -287
  305. package/crates/team-agent/src/messaging/leader_receiver.rs +0 -786
  306. package/crates/team-agent/src/messaging/mod.rs +0 -167
  307. package/crates/team-agent/src/messaging/persist.rs +0 -377
  308. package/crates/team-agent/src/messaging/presentation.rs +0 -417
  309. package/crates/team-agent/src/messaging/reminders.rs +0 -316
  310. package/crates/team-agent/src/messaging/results/collection_tests.rs +0 -719
  311. package/crates/team-agent/src/messaging/results.rs +0 -1415
  312. package/crates/team-agent/src/messaging/scheduler.rs +0 -223
  313. package/crates/team-agent/src/messaging/selftest.rs +0 -315
  314. package/crates/team-agent/src/messaging/send.rs +0 -981
  315. package/crates/team-agent/src/messaging/tests/basic.rs +0 -346
  316. package/crates/team-agent/src/messaging/tests/dup_inject.rs +0 -657
  317. package/crates/team-agent/src/messaging/tests/e23.rs +0 -49
  318. package/crates/team-agent/src/messaging/tests/leader_channel.rs +0 -169
  319. package/crates/team-agent/src/messaging/tests/leader_inject_acceptance.rs +0 -817
  320. package/crates/team-agent/src/messaging/tests/main_preserved.rs +0 -85
  321. package/crates/team-agent/src/messaging/tests/mod.rs +0 -306
  322. package/crates/team-agent/src/messaging/tests/runtime.rs +0 -3549
  323. package/crates/team-agent/src/messaging/tests/spine.rs +0 -853
  324. package/crates/team-agent/src/messaging/tests/wave2.rs +0 -381
  325. package/crates/team-agent/src/messaging/trust.rs +0 -215
  326. package/crates/team-agent/src/messaging/types.rs +0 -472
  327. package/crates/team-agent/src/messaging/wait.rs +0 -366
  328. package/crates/team-agent/src/messaging/watchers.rs +0 -916
  329. package/crates/team-agent/src/model/enums.rs +0 -356
  330. package/crates/team-agent/src/model/errors.rs +0 -18
  331. package/crates/team-agent/src/model/ids.rs +0 -165
  332. package/crates/team-agent/src/model/mod.rs +0 -29
  333. package/crates/team-agent/src/model/name_similarity.rs +0 -252
  334. package/crates/team-agent/src/model/pane_authority_refusal.rs +0 -359
  335. package/crates/team-agent/src/model/paths.rs +0 -257
  336. package/crates/team-agent/src/model/routing.rs +0 -387
  337. package/crates/team-agent/src/model/spec.rs +0 -1184
  338. package/crates/team-agent/src/model/task_graph.rs +0 -321
  339. package/crates/team-agent/src/model/testdata/fuzz.golden.yaml +0 -43
  340. package/crates/team-agent/src/model/testdata/fuzz.yaml +0 -43
  341. package/crates/team-agent/src/model/testdata/spec_invalid_a.yaml +0 -209
  342. package/crates/team-agent/src/model/testdata/team.spec.golden.yaml +0 -208
  343. package/crates/team-agent/src/model/testdata/team.spec.yaml +0 -208
  344. package/crates/team-agent/src/model/yaml/tests.rs +0 -188
  345. package/crates/team-agent/src/model/yaml.rs +0 -802
  346. package/crates/team-agent/src/os_probe.rs +0 -280
  347. package/crates/team-agent/src/packaging/install.rs +0 -219
  348. package/crates/team-agent/src/packaging/migrate.rs +0 -38
  349. package/crates/team-agent/src/packaging/mod.rs +0 -91
  350. package/crates/team-agent/src/packaging/repair.rs +0 -33
  351. package/crates/team-agent/src/packaging/tests.rs +0 -822
  352. package/crates/team-agent/src/packaging/types.rs +0 -417
  353. package/crates/team-agent/src/platform/argv.rs +0 -331
  354. package/crates/team-agent/src/platform/errors.rs +0 -104
  355. package/crates/team-agent/src/platform/file_lock.rs +0 -279
  356. package/crates/team-agent/src/platform/mod.rs +0 -5
  357. package/crates/team-agent/src/platform/process.rs +0 -545
  358. package/crates/team-agent/src/provider/adapter.rs +0 -1150
  359. package/crates/team-agent/src/provider/adapters/claude.rs +0 -78
  360. package/crates/team-agent/src/provider/adapters/claude_fork.rs +0 -131
  361. package/crates/team-agent/src/provider/adapters/copilot.rs +0 -75
  362. package/crates/team-agent/src/provider/adapters/copilot_fork.rs +0 -307
  363. package/crates/team-agent/src/provider/adapters/fake.rs +0 -18
  364. package/crates/team-agent/src/provider/adapters/mod.rs +0 -30
  365. package/crates/team-agent/src/provider/adapters/pi.rs +0 -106
  366. package/crates/team-agent/src/provider/approvals/mod.rs +0 -3
  367. package/crates/team-agent/src/provider/approvals/parsing.rs +0 -586
  368. package/crates/team-agent/src/provider/approvals/runtime_prompts.rs +0 -205
  369. package/crates/team-agent/src/provider/argv_route.rs +0 -405
  370. package/crates/team-agent/src/provider/bypass_flags.rs +0 -116
  371. package/crates/team-agent/src/provider/classify.rs +0 -708
  372. package/crates/team-agent/src/provider/command_helpers.rs +0 -45
  373. package/crates/team-agent/src/provider/faults.rs +0 -165
  374. package/crates/team-agent/src/provider/helpers.rs +0 -52
  375. package/crates/team-agent/src/provider/mod.rs +0 -78
  376. package/crates/team-agent/src/provider/model_catalog.rs +0 -910
  377. package/crates/team-agent/src/provider/session/capture.rs +0 -2731
  378. package/crates/team-agent/src/provider/session/context_fork/claude.rs +0 -123
  379. package/crates/team-agent/src/provider/session/context_fork/outcome.rs +0 -172
  380. package/crates/team-agent/src/provider/session/context_fork.rs +0 -396
  381. package/crates/team-agent/src/provider/session/mod.rs +0 -36
  382. package/crates/team-agent/src/provider/session/resume.rs +0 -269
  383. package/crates/team-agent/src/provider/session_scan/claude.rs +0 -523
  384. package/crates/team-agent/src/provider/session_scan/common/tests.rs +0 -316
  385. package/crates/team-agent/src/provider/session_scan/common.rs +0 -654
  386. package/crates/team-agent/src/provider/session_scan/copilot.rs +0 -280
  387. package/crates/team-agent/src/provider/session_scan/pi.rs +0 -185
  388. package/crates/team-agent/src/provider/session_scan.rs +0 -71
  389. package/crates/team-agent/src/provider/startup_prompt.rs +0 -757
  390. package/crates/team-agent/src/provider/submit_now.rs +0 -71
  391. package/crates/team-agent/src/provider/testdata/copilot-ready-marker.txt +0 -5
  392. package/crates/team-agent/src/provider/testdata/copilot-trust-prompt.txt +0 -19
  393. package/crates/team-agent/src/provider/testdata/grok-models-authenticated.stdout +0 -9
  394. package/crates/team-agent/src/provider/testdata/grok-models-unauthenticated.stdout +0 -7
  395. package/crates/team-agent/src/provider/tests/adapter.rs +0 -441
  396. package/crates/team-agent/src/provider/tests/classify.rs +0 -148
  397. package/crates/team-agent/src/provider/tests/command_helpers.rs +0 -35
  398. package/crates/team-agent/src/provider/tests/copilot_fork.rs +0 -191
  399. package/crates/team-agent/src/provider/tests/faults.rs +0 -200
  400. package/crates/team-agent/src/provider/tests/idle.rs +0 -177
  401. package/crates/team-agent/src/provider/tests/wire.rs +0 -213
  402. package/crates/team-agent/src/provider/tests.rs +0 -32
  403. package/crates/team-agent/src/provider/types.rs +0 -529
  404. package/crates/team-agent/src/provider/wire.rs +0 -394
  405. package/crates/team-agent/src/redaction.rs +0 -259
  406. package/crates/team-agent/src/state/abnormal_watch/tests/mod.rs +0 -248
  407. package/crates/team-agent/src/state/abnormal_watch.rs +0 -144
  408. package/crates/team-agent/src/state/identity.rs +0 -914
  409. package/crates/team-agent/src/state/identity_keys.rs +0 -132
  410. package/crates/team-agent/src/state/mod.rs +0 -74
  411. package/crates/team-agent/src/state/owner_gate.rs +0 -482
  412. package/crates/team-agent/src/state/ownership.rs +0 -563
  413. package/crates/team-agent/src/state/paths.rs +0 -395
  414. package/crates/team-agent/src/state/persist.rs +0 -3811
  415. package/crates/team-agent/src/state/projection.rs +0 -1508
  416. package/crates/team-agent/src/state/repository/intent.rs +0 -14
  417. package/crates/team-agent/src/state/repository/tests.rs +0 -184
  418. package/crates/team-agent/src/state/repository.rs +0 -866
  419. package/crates/team-agent/src/state/selector.rs +0 -160
  420. package/crates/team-agent/src/state/testdata/state-rich.canonical.json +0 -133
  421. package/crates/team-agent/src/test_support/models_timeout_fixture.rs +0 -144
  422. package/crates/team-agent/src/tmux_backend/enter_rescue.rs +0 -325
  423. package/crates/team-agent/src/tmux_backend/enter_rescue_tests.rs +0 -432
  424. package/crates/team-agent/src/tmux_backend/native_input.rs +0 -513
  425. package/crates/team-agent/src/tmux_backend/native_input_tests.rs +0 -742
  426. package/crates/team-agent/src/tmux_backend/tests.rs +0 -4103
  427. package/crates/team-agent/src/tmux_backend.rs +0 -4492
  428. package/crates/team-agent/src/topology.rs +0 -537
  429. package/crates/team-agent/src/transport/enter_rescue.rs +0 -166
  430. package/crates/team-agent/src/transport/native_input.rs +0 -491
  431. package/crates/team-agent/src/transport/test_support.rs +0 -743
  432. package/crates/team-agent/src/transport/tests/behavior.rs +0 -326
  433. package/crates/team-agent/src/transport/tests/mod.rs +0 -194
  434. package/crates/team-agent/src/transport/tests/wire.rs +0 -574
  435. package/crates/team-agent/src/transport.rs +0 -1655
  436. package/crates/team-agent/src/transport_factory.rs +0 -819
@@ -1,4501 +0,0 @@
1
- //!
2
- //! leader::start — leader_start_plan / leader_session_name(派生 tmux session 名)。
3
- //! Managed launch windows: first leader keeps provider_wire; later live
4
- //! leaders in the same A-22 session get a unique suffix so attach targets
5
- //! SESSION:WINDOW without claude_code collisions. state.json records every
6
- //! live pane in leader_receiver.bound_panes and does not overwrite the first
7
- //! pane_id.
8
-
9
- use std::collections::BTreeMap;
10
- use std::io::{IsTerminal, Read, Write};
11
- use std::path::{Path, PathBuf};
12
- use std::process::{Command, Stdio};
13
- use std::sync::atomic::{AtomicBool, Ordering};
14
- use std::time::Duration;
15
-
16
- #[cfg(target_os = "linux")]
17
- use std::os::fd::AsRawFd;
18
- #[cfg(unix)]
19
- use std::os::unix::fs::{FileTypeExt, MetadataExt, OpenOptionsExt};
20
-
21
- use crate::model::pane_authority_refusal as pane_refusal;
22
- use crate::provider::{get_adapter, Provider};
23
- use crate::tmux_backend::TmuxBackend;
24
- use crate::transport::{
25
- CaptureRange, PaneId, PaneInfo, PaneLiveness, SessionName, SpawnResult, Target, Transport,
26
- TransportError, WindowName,
27
- };
28
-
29
- use super::helpers::{
30
- provider_wire, resolve_workspace_for_hash, sanitize_session_folder, sha1_hex_prefix,
31
- };
32
- use super::owner_bind::leader_identity_context;
33
- use super::{
34
- LeaderError, LeaderIdentity, LeaderLaunchOutcome, LeaderLaunchSocket, LeaderLaunchStatus,
35
- LeaderStartMode, LeaderStartPlan,
36
- };
37
-
38
- // ── leader::start — leader_start_plan / session 名 ──
39
-
40
- pub(crate) struct PreparedLeaderStart {
41
- plan: LeaderStartPlan,
42
- ambient_authority: Option<VerifiedAmbientPaneAuthority>,
43
- }
44
-
45
- #[derive(Clone, Copy)]
46
- enum ManagedClientAttachMode {
47
- AttachSession,
48
- SwitchClient,
49
- }
50
-
51
- impl PreparedLeaderStart {
52
- pub(crate) fn plan(&self) -> &LeaderStartPlan {
53
- &self.plan
54
- }
55
- }
56
-
57
- pub(crate) enum PrepareLeaderStartError {
58
- PaneAuthorityRefused(pane_refusal::PaneAuthorityRefusal),
59
- Leader(LeaderError),
60
- }
61
-
62
- impl PrepareLeaderStartError {
63
- fn into_leader_error(self) -> LeaderError {
64
- match self {
65
- Self::PaneAuthorityRefused(refusal) => LeaderError::Validation(format!(
66
- "{}; open a new terminal outside the current tmux/pane or run \
67
- `team-agent attach-leader` from the intended workspace pane",
68
- refusal.reason().as_str()
69
- )),
70
- Self::Leader(error) => error,
71
- }
72
- }
73
- }
74
-
75
- impl From<LeaderError> for PrepareLeaderStartError {
76
- fn from(error: LeaderError) -> Self {
77
- Self::Leader(error)
78
- }
79
- }
80
-
81
- /// `leader_start_plan`(card §46;`__init__.py:82`)。计算 leader 启动计划
82
- /// (exec in-TMUX / new tmux session / attach existing)。provider 未安装 → `Err(Start)`。
83
- pub(crate) fn leader_start_plan(
84
- provider: Provider,
85
- provider_args: &[String],
86
- workspace: &Path,
87
- attach_existing: bool,
88
- confirm_attach: bool,
89
- attach_session: Option<&SessionName>,
90
- external_leader: bool,
91
- ) -> Result<LeaderStartPlan, LeaderError> {
92
- prepare_leader_start(
93
- provider,
94
- provider_args,
95
- workspace,
96
- attach_existing,
97
- confirm_attach,
98
- attach_session,
99
- external_leader,
100
- )
101
- .map(|prepared| prepared.plan)
102
- .map_err(PrepareLeaderStartError::into_leader_error)
103
- }
104
-
105
- pub(crate) fn prepare_leader_start(
106
- provider: Provider,
107
- provider_args: &[String],
108
- workspace: &Path,
109
- attach_existing: bool,
110
- confirm_attach: bool,
111
- attach_session: Option<&SessionName>,
112
- external_leader: bool,
113
- ) -> Result<PreparedLeaderStart, PrepareLeaderStartError> {
114
- prepare_leader_start_with_nested_attach(
115
- provider,
116
- provider_args,
117
- workspace,
118
- attach_existing,
119
- confirm_attach,
120
- attach_session,
121
- external_leader,
122
- false,
123
- )
124
- }
125
-
126
- pub(crate) fn prepare_leader_start_with_nested_attach(
127
- provider: Provider,
128
- provider_args: &[String],
129
- workspace: &Path,
130
- attach_existing: bool,
131
- confirm_attach: bool,
132
- attach_session: Option<&SessionName>,
133
- external_leader: bool,
134
- allow_nested_attach: bool,
135
- ) -> Result<PreparedLeaderStart, PrepareLeaderStartError> {
136
- let explicit_external_path = external_leader || attach_existing || attach_session.is_some();
137
- let state_external_path = workspace_state_uses_external_leader(workspace);
138
- let (ambient_authority, managed_client_attach_mode, managed_exec_provider) =
139
- if explicit_external_path || state_external_path {
140
- (ambient_pane_authority_preflight(workspace)?, None, false)
141
- } else {
142
- managed_launcher_ambient_route(
143
- provider,
144
- provider_args,
145
- workspace,
146
- allow_nested_attach,
147
- )?
148
- };
149
- let plan = leader_start_plan_with_ambient_authority(
150
- provider,
151
- provider_args,
152
- workspace,
153
- attach_existing,
154
- confirm_attach,
155
- attach_session,
156
- external_leader,
157
- ambient_authority.is_some(),
158
- managed_client_attach_mode,
159
- managed_exec_provider,
160
- allow_nested_attach,
161
- )?;
162
- Ok(PreparedLeaderStart {
163
- plan,
164
- ambient_authority,
165
- })
166
- }
167
-
168
- pub(crate) fn leader_start_plan_after_ambient_authority_check(
169
- provider: Provider,
170
- provider_args: &[String],
171
- workspace: &Path,
172
- attach_existing: bool,
173
- confirm_attach: bool,
174
- attach_session: Option<&SessionName>,
175
- external_leader: bool,
176
- ) -> Result<LeaderStartPlan, LeaderError> {
177
- let in_tmux = std::env::var_os("TMUX").is_some();
178
- let explicit_external_path = external_leader || attach_existing || attach_session.is_some();
179
- let managed_client_attach_mode = (!explicit_external_path).then_some(if in_tmux {
180
- ManagedClientAttachMode::SwitchClient
181
- } else {
182
- ManagedClientAttachMode::AttachSession
183
- });
184
- leader_start_plan_with_ambient_authority(
185
- provider,
186
- provider_args,
187
- workspace,
188
- attach_existing,
189
- confirm_attach,
190
- attach_session,
191
- external_leader,
192
- in_tmux,
193
- managed_client_attach_mode,
194
- false,
195
- false,
196
- )
197
- }
198
-
199
- fn leader_start_plan_with_ambient_authority(
200
- provider: Provider,
201
- provider_args: &[String],
202
- workspace: &Path,
203
- attach_existing: bool,
204
- confirm_attach: bool,
205
- attach_session: Option<&SessionName>,
206
- external_leader: bool,
207
- in_tmux: bool,
208
- managed_client_attach_mode: Option<ManagedClientAttachMode>,
209
- managed_exec_provider: bool,
210
- allow_nested_attach: bool,
211
- ) -> Result<LeaderStartPlan, LeaderError> {
212
- if attach_session.is_some() && !confirm_attach {
213
- return Err(LeaderError::Start(
214
- "--attach-session requires --confirm".to_string(),
215
- ));
216
- }
217
- if attach_existing && !confirm_attach {
218
- return Err(LeaderError::Start(
219
- "attach existing leader session requires confirm".to_string(),
220
- ));
221
- }
222
- let adapter = get_adapter(provider);
223
- if !adapter.is_installed() {
224
- let command_name = provider_command_name(provider);
225
- return Err(LeaderError::Start(format!(
226
- "Provider {} command '{}' not found",
227
- provider_wire(provider),
228
- command_name
229
- )));
230
- }
231
- let state = crate::state::persist::load_runtime_state(workspace).ok();
232
- let identity = leader_identity_context(workspace, None, state.as_ref())?;
233
- let external_path = external_leader
234
- || attach_existing
235
- || attach_session.is_some()
236
- || state
237
- .as_ref()
238
- .is_some_and(crate::state::projection::state_is_external_leader);
239
- // 0.3.28 Step 2: managed mode now uses the SAME dedicated leader session
240
- // as the external path (`team-agent-leader-<provider>-<folder>-<sha1[:8]>`)
241
- // — Python parity. Pre-0.3.28 the managed branch used
242
- // `managed_team_session_name(identity) = team-<team_id>` which is the
243
- // worker session — that co-location is the structural root of
244
- // E49/E51/E53/E57-3/E60.
245
- // A-22: managed mode reuses a live provider leader session by prefix;
246
- // when no candidate exists, it falls back to a per-launch nonce. The
247
- // external/attach paths keep the stable workspace-keyed name because a
248
- // nonce would break `--attach-session` reattach.
249
- let session_name = if external_path {
250
- attach_session
251
- .cloned()
252
- .or_else(|| Some(leader_session_name(provider, workspace)))
253
- } else {
254
- Some(managed_leader_session_for_launch(provider, workspace))
255
- };
256
- if !in_tmux {
257
- ensure_tmux_installed()?;
258
- }
259
- let existing_session =
260
- if external_path && !in_tmux && !attach_existing && attach_session.is_none() {
261
- match session_name.as_ref() {
262
- Some(session) => tmux_session_exists(workspace, session)?,
263
- None => false,
264
- }
265
- } else {
266
- false
267
- };
268
- let mode = if managed_exec_provider {
269
- LeaderStartMode::ExecProvider
270
- } else if !external_path {
271
- LeaderStartMode::ManagedTmuxClient
272
- } else if in_tmux {
273
- LeaderStartMode::ExecProvider
274
- } else if attach_existing || attach_session.is_some() || existing_session {
275
- LeaderStartMode::AttachExisting
276
- } else {
277
- LeaderStartMode::NewTmuxSession
278
- };
279
- let leader_env = leader_env_for_identity(provider, &identity);
280
- // First managed leader keeps `provider_wire` (`claude_code`). A second
281
- // live leader in the same A-22 session gets a nonce suffix so attach
282
- // targets a unique `SESSION:WINDOW` instead of colliding.
283
- let managed_window = match (mode, session_name.as_ref()) {
284
- (LeaderStartMode::ManagedTmuxClient, Some(session)) => Some(
285
- managed_leader_window_for_launch(provider, workspace, session),
286
- ),
287
- _ => None,
288
- };
289
- let configured_prompt = if mode == LeaderStartMode::AttachExisting {
290
- None
291
- } else {
292
- super::prompt::load().map_err(|error| error.for_provider(provider))?
293
- };
294
- let mut pi_routed_argv = None;
295
- let mut session_capture = None;
296
- let mut provider_argv = if provider == Provider::Pi && mode != LeaderStartMode::AttachExisting {
297
- let parsed = crate::lifecycle::launch::pi_mcp::parse_pi_leader_args(provider_args)
298
- .map_err(|error| LeaderError::Start(error.to_string()))?;
299
- let mcp_config = adapter
300
- .mcp_config(crate::model::enums::AuthMode::Subscription)
301
- .map_err(|error| LeaderError::Start(error.to_string()))?;
302
- let mcp_config = crate::lifecycle::launch::resolve_mcp_config(
303
- mcp_config,
304
- workspace,
305
- "leader",
306
- identity.team_id.as_str(),
307
- );
308
- let contract = crate::lifecycle::worker_command_context::compile_pi_leader_system_prompt();
309
- let prompt = if let Some(stored) = configured_prompt.as_ref() {
310
- // Read route once and validate conflicts before creating any Pi MCP artifacts.
311
- let mut routed = vec!["pi".to_string()];
312
- crate::provider::argv_route::apply(provider, &mut routed)
313
- .map_err(|error| LeaderError::Start(error.to_string()))?;
314
- let combined = super::prompt::compose_pi_contract(
315
- &contract, &routed, &stored.text, &stored.path,
316
- )?;
317
- pi_routed_argv = Some(routed);
318
- combined
319
- } else {
320
- contract
321
- };
322
- let team_mcp_tools = ["send_message", "report_result", "get_team_status"];
323
- let spawned_at = chrono::Utc::now().to_rfc3339();
324
- let command = crate::lifecycle::launch::pi_mcp::materialize_pi_plan(
325
- crate::lifecycle::launch::pi_mcp::PiMaterializeRequest {
326
- workspace,
327
- team_id: identity.team_id.as_str(),
328
- agent_id: "leader",
329
- model: parsed.model.as_deref(),
330
- effort: parsed.effort,
331
- system_prompt: &prompt,
332
- team_mcp_tools: &team_mcp_tools,
333
- mcp_config: &mcp_config,
334
- session_scope: crate::lifecycle::launch::pi_mcp::pi_leader_session_scope(
335
- provider_args,
336
- external_path,
337
- allow_nested_attach,
338
- ),
339
- session_dir: parsed.session_dir.as_deref(),
340
- },
341
- )
342
- .map_err(|error| LeaderError::Start(error.to_string()))?;
343
- session_capture = Some(crate::provider::CaptureSessionContext {
344
- agent_id: "leader".into(),
345
- spawn_cwd: resolve_workspace_for_hash(workspace),
346
- pane_id: None,
347
- pane_pid: None,
348
- spawned_at: Some(spawned_at),
349
- expected_session_id: command.expected_session_id,
350
- provider_projects_root: command.provider_projects_root,
351
- });
352
- command.argv
353
- } else if provider == Provider::Pi {
354
- Vec::new()
355
- } else {
356
- provider_command_argv(provider, provider_args)
357
- };
358
- if mode != LeaderStartMode::AttachExisting {
359
- if let Some(routed) = pi_routed_argv {
360
- provider_argv.splice(1..1, routed.into_iter().skip(1));
361
- } else {
362
- crate::provider::argv_route::apply(provider, &mut provider_argv)
363
- .map_err(|error| LeaderError::Start(error.to_string()))?;
364
- if let Some(stored) = configured_prompt.as_ref() {
365
- super::prompt::inject(provider, &mut provider_argv, &stored.text, &stored.path)?;
366
- }
367
- }
368
- }
369
- let argv = start_argv(
370
- mode,
371
- provider,
372
- &provider_argv,
373
- workspace,
374
- session_name.as_ref(),
375
- managed_window.as_ref(),
376
- &leader_env,
377
- managed_client_attach_mode,
378
- )?;
379
- let plan_session_name = if mode == LeaderStartMode::ExecProvider && !external_path {
380
- None
381
- } else {
382
- session_name
383
- };
384
- let plan_env = if mode == LeaderStartMode::ExecProvider {
385
- merged_exec_env(&leader_env)
386
- } else {
387
- leader_env.clone()
388
- };
389
- Ok(LeaderStartPlan {
390
- mode,
391
- provider,
392
- workspace: resolve_workspace_for_hash(workspace),
393
- socket: LeaderLaunchSocket::Workspace,
394
- session_name: plan_session_name,
395
- argv,
396
- provider_argv,
397
- leader_prompt: configured_prompt
398
- .as_ref()
399
- .map(|stored| stored.metadata(provider)),
400
- session_capture,
401
- // 0.3.28 Step 2: leader window inside the dedicated leader session is
402
- // named after the provider wire (e.g. `claude_code`), never the
403
- // literal string `leader`. Occupied names get a per-launch suffix.
404
- leader_window: managed_window,
405
- is_external_leader: external_path,
406
- leader_env: plan_env,
407
- identity: Some(identity),
408
- detached: false,
409
- })
410
- }
411
-
412
- pub(crate) fn leader_env_for_identity(
413
- provider: Provider,
414
- identity: &LeaderIdentity,
415
- ) -> BTreeMap<String, String> {
416
- let mut leader_env = BTreeMap::new();
417
- leader_env.insert(
418
- "TEAM_AGENT_LEADER_PROVIDER".to_string(),
419
- provider_wire(provider).to_string(),
420
- );
421
- leader_env.insert(
422
- "TEAM_AGENT_LEADER_SESSION_UUID".to_string(),
423
- identity.leader_session_uuid.as_str().to_string(),
424
- );
425
- leader_env.insert(
426
- "TEAM_AGENT_MACHINE_FINGERPRINT".to_string(),
427
- identity.machine_fingerprint.clone(),
428
- );
429
- leader_env.insert(
430
- "TEAM_AGENT_WORKSPACE".to_string(),
431
- identity.workspace_abspath.to_string_lossy().into_owned(),
432
- );
433
- leader_env.insert(
434
- "TEAM_AGENT_TEAM_ID".to_string(),
435
- identity.team_id.as_str().to_string(),
436
- );
437
- if provider == Provider::Copilot {
438
- leader_env.insert(
439
- "COPILOT_DISABLE_TERMINAL_TITLE".to_string(),
440
- "1".to_string(),
441
- );
442
- }
443
- // Managed providers run after `sh -lc`; restore the launcher's native
444
- // executable lookup path at invocation, not just in the tmux client env.
445
- if let Some(path) = std::env::var_os("PATH").and_then(|path| path.into_string().ok()) {
446
- leader_env.insert("PATH".to_string(), path);
447
- }
448
- leader_env
449
- }
450
-
451
- pub(crate) fn execute_prepared_leader_start(
452
- prepared: &PreparedLeaderStart,
453
- workspace: &Path,
454
- ) -> Result<LeaderLaunchOutcome, LeaderError> {
455
- execute_leader_plan_after_ambient_authority(
456
- &prepared.plan,
457
- workspace,
458
- prepared.ambient_authority.as_ref(),
459
- )
460
- }
461
-
462
- fn execute_leader_plan_after_ambient_authority(
463
- plan: &LeaderStartPlan,
464
- workspace: &Path,
465
- ambient_authority: Option<&VerifiedAmbientPaneAuthority>,
466
- ) -> Result<LeaderLaunchOutcome, LeaderError> {
467
- if plan.mode == LeaderStartMode::ManagedTmuxClient {
468
- return execute_managed_leader_plan(plan, workspace);
469
- }
470
- let mut argv = plan.argv.clone();
471
- let detached = plan.mode == LeaderStartMode::NewTmuxSession
472
- && !std::io::stdin().is_terminal()
473
- && insert_detach_flag(&mut argv);
474
- let bind_verified_ambient = plan.mode == LeaderStartMode::ExecProvider
475
- && (!plan.is_external_leader || workspace_state_uses_external_leader(workspace));
476
- if bind_verified_ambient {
477
- let authority = ambient_authority.ok_or_else(|| {
478
- LeaderError::Validation("exec provider ambient pane authority missing".to_string())
479
- })?;
480
- // 0.5.35 (`.team/artifacts/managed-leader-provider-reentry-locate.md`
481
- // §5/§6): three-way classify BEFORE persist. Same physical pane =
482
- // provider process replacement (refresh only). Different pane with
483
- // an existing canonical binding = no canonical rewrite (claim /
484
- // takeover is the recovery path, §7). Unbound = first-time write.
485
- match classify_exec_provider_binding(workspace, plan, authority)? {
486
- ExecProviderBinding::ManagedReentry => {
487
- refresh_managed_leader_provider_binding(plan, workspace, authority)?;
488
- }
489
- ExecProviderBinding::DifferentPaneAlreadyBound => {
490
- // No canonical state write. Provider still runs below.
491
- }
492
- ExecProviderBinding::Unbound => {
493
- persist_exec_provider_leader_binding(
494
- plan,
495
- workspace,
496
- authority,
497
- plan.is_external_leader,
498
- )?;
499
- }
500
- }
501
- } else if plan.is_external_leader {
502
- persist_external_leader_topology_marker(plan, workspace)?;
503
- }
504
- let process = run_leader_argv(&argv, &plan.leader_env, plan, workspace, None)?;
505
- let code = process.status.code();
506
- if !process.status.success() {
507
- return Err(LeaderError::Start(leader_launcher_failure(&process)));
508
- }
509
- if detached {
510
- Ok(LeaderLaunchOutcome {
511
- status: LeaderLaunchStatus::Detached,
512
- exit_code: code,
513
- session_name: plan.session_name.clone(),
514
- reason: None,
515
- })
516
- } else {
517
- let _ = workspace;
518
- Ok(LeaderLaunchOutcome {
519
- status: LeaderLaunchStatus::Exited,
520
- exit_code: code,
521
- session_name: plan.session_name.clone(),
522
- reason: None,
523
- })
524
- }
525
- }
526
-
527
- struct VerifiedAmbientPaneAuthority {
528
- pane_id: PaneId,
529
- observed: PaneInfo,
530
- endpoint: String,
531
- tmux: String,
532
- }
533
-
534
- fn workspace_state_uses_external_leader(workspace: &Path) -> bool {
535
- crate::state::persist::load_runtime_state_without_migrations(workspace)
536
- .ok()
537
- .as_ref()
538
- .is_some_and(crate::state::projection::state_is_external_leader)
539
- }
540
-
541
- fn workspace_state_is_managed_provider_reentry(workspace: &Path) -> bool {
542
- let Ok(state) = crate::state::persist::load_runtime_state_without_migrations(workspace) else {
543
- return false;
544
- };
545
- if crate::state::projection::state_is_external_leader(&state) {
546
- return false;
547
- }
548
- let Some(team_key) = state
549
- .get("active_team_key")
550
- .and_then(serde_json::Value::as_str)
551
- else {
552
- return false;
553
- };
554
- let Some(receiver) = state
555
- .get("teams")
556
- .and_then(serde_json::Value::as_object)
557
- .and_then(|teams| teams.get(team_key))
558
- .and_then(|team| team.get("leader_receiver"))
559
- else {
560
- return false;
561
- };
562
- let Some(pane) = std::env::var_os("TMUX_PANE") else {
563
- return false;
564
- };
565
- let Some(tmux) = std::env::var_os("TMUX") else {
566
- return false;
567
- };
568
- let tmux = tmux.to_string_lossy();
569
- let endpoint = tmux.split(',').next().unwrap_or("").trim();
570
- receiver.get("status").and_then(serde_json::Value::as_str) == Some("attached")
571
- && receiver.get("pane_id").and_then(serde_json::Value::as_str) == pane.to_str()
572
- && receiver
573
- .get("tmux_socket")
574
- .and_then(serde_json::Value::as_str)
575
- == Some(endpoint)
576
- && receiver
577
- .get("session_name")
578
- .and_then(serde_json::Value::as_str)
579
- .is_some_and(|session| session.starts_with(LEADER_SESSION_PREFIX))
580
- }
581
-
582
- fn ambient_pane_authority_preflight(
583
- workspace: &Path,
584
- ) -> Result<Option<VerifiedAmbientPaneAuthority>, PrepareLeaderStartError> {
585
- let Some(tmux) = std::env::var_os("TMUX") else {
586
- return Ok(None);
587
- };
588
- let tmux = tmux.into_string().map_err(|_| {
589
- PrepareLeaderStartError::PaneAuthorityRefused(ambient_tmux_endpoint_refusal(
590
- workspace,
591
- pane_refusal::AmbientTmuxEndpointUnavailableCause::TmuxValueNotUnicode,
592
- ))
593
- })?;
594
- verified_ambient_pane_authority(workspace, &tmux)
595
- .map(Some)
596
- .map_err(PrepareLeaderStartError::PaneAuthorityRefused)
597
- }
598
-
599
- fn managed_launcher_ambient_route(
600
- provider: Provider,
601
- provider_args: &[String],
602
- workspace: &Path,
603
- allow_nested_attach: bool,
604
- ) -> Result<
605
- (
606
- Option<VerifiedAmbientPaneAuthority>,
607
- Option<ManagedClientAttachMode>,
608
- bool,
609
- ),
610
- PrepareLeaderStartError,
611
- > {
612
- let isolated = || (None, Some(ManagedClientAttachMode::AttachSession), false);
613
- let authority = match ambient_pane_authority_preflight(workspace) {
614
- Ok(Some(authority)) => authority,
615
- Ok(None) => return Ok(isolated()),
616
- Err(PrepareLeaderStartError::PaneAuthorityRefused(_)) if !allow_nested_attach => {
617
- // An inherited tuple cannot authorize adoption, but an ordinary
618
- // managed launch can still create its own workspace pane. Keep
619
- // explicit external/attach and nested-attach intent fail-closed.
620
- return Ok(isolated());
621
- }
622
- Err(error) => return Err(error),
623
- };
624
- if workspace_state_is_managed_provider_reentry(workspace)
625
- || (provider == Provider::Pi && provider_args.is_empty() && !allow_nested_attach)
626
- {
627
- // Only verified current-pane authority permits replacing the caller.
628
- return Ok((Some(authority), None, true));
629
- }
630
- let target_endpoint = crate::tmux_backend::socket_path_for_workspace(workspace);
631
- let same_server = target_endpoint.as_ref().is_some_and(|target| {
632
- let observed = Path::new(&authority.endpoint)
633
- .canonicalize()
634
- .unwrap_or_else(|_| PathBuf::from(&authority.endpoint));
635
- let target = target.canonicalize().unwrap_or_else(|_| target.clone());
636
- observed == target
637
- });
638
- if same_server {
639
- return Ok((
640
- Some(authority),
641
- Some(ManagedClientAttachMode::SwitchClient),
642
- false,
643
- ));
644
- }
645
- if allow_nested_attach {
646
- return Ok((
647
- Some(authority),
648
- Some(ManagedClientAttachMode::AttachSession),
649
- false,
650
- ));
651
- }
652
- // Do not switch/adopt the unrelated server. The existing managed attach
653
- // child clears TMUX/TMUX_PANE without changing the caller's environment.
654
- Ok(isolated())
655
- }
656
-
657
- fn validated_ambient_tmux_endpoint(
658
- workspace: &Path,
659
- tmux: &str,
660
- ) -> Result<String, pane_refusal::PaneAuthorityRefusal> {
661
- let tuple = tmux.split(',').map(str::trim).collect::<Vec<_>>();
662
- let [endpoint, server_pid, session_index] = tuple.as_slice() else {
663
- return Err(ambient_tmux_endpoint_refusal(
664
- workspace,
665
- pane_refusal::AmbientTmuxEndpointUnavailableCause::TmuxTupleFieldCountInvalid,
666
- ));
667
- };
668
- if endpoint.is_empty() {
669
- return Err(ambient_tmux_endpoint_refusal(
670
- workspace,
671
- pane_refusal::AmbientTmuxEndpointUnavailableCause::EndpointMissing,
672
- ));
673
- }
674
- if !Path::new(endpoint).is_absolute() {
675
- return Err(ambient_tmux_endpoint_refusal(
676
- workspace,
677
- pane_refusal::AmbientTmuxEndpointUnavailableCause::EndpointNotAbsolute,
678
- ));
679
- }
680
- if server_pid.parse::<u32>().is_err() {
681
- return Err(ambient_tmux_endpoint_refusal(
682
- workspace,
683
- pane_refusal::AmbientTmuxEndpointUnavailableCause::ServerPidInvalid,
684
- ));
685
- }
686
- if session_index.parse::<u32>().is_err() {
687
- return Err(ambient_tmux_endpoint_refusal(
688
- workspace,
689
- pane_refusal::AmbientTmuxEndpointUnavailableCause::SessionIndexInvalid,
690
- ));
691
- }
692
- Ok((*endpoint).to_string())
693
- }
694
-
695
- fn verified_ambient_pane_authority(
696
- workspace: &Path,
697
- tmux: &str,
698
- ) -> Result<VerifiedAmbientPaneAuthority, pane_refusal::PaneAuthorityRefusal> {
699
- let requested_workspace = resolve_workspace_for_hash(workspace);
700
- let endpoint = validated_ambient_tmux_endpoint(workspace, tmux)?;
701
- let pane_id = match std::env::var_os("TMUX_PANE") {
702
- None => {
703
- return Err(pane_refusal::PaneAuthorityRefusal::new(
704
- pane_refusal::PaneAuthorityRefusalFacts::AmbientPaneIdUnavailable(
705
- pane_refusal::AmbientPaneIdUnavailableFacts {
706
- requested_workspace,
707
- observed_pane_id: pane_refusal::UnavailablePaneAuthorityFact::new(
708
- pane_refusal::AmbientPaneIdUnavailableCause::EnvironmentValueMissing,
709
- ),
710
- endpoint,
711
- },
712
- ),
713
- ));
714
- }
715
- Some(value) => match value.into_string() {
716
- Ok(value) if value.trim().is_empty() => {
717
- return Err(pane_refusal::PaneAuthorityRefusal::new(
718
- pane_refusal::PaneAuthorityRefusalFacts::AmbientPaneIdUnavailable(
719
- pane_refusal::AmbientPaneIdUnavailableFacts {
720
- requested_workspace,
721
- observed_pane_id: pane_refusal::UnavailablePaneAuthorityFact::new(
722
- pane_refusal::AmbientPaneIdUnavailableCause::EnvironmentValueEmpty,
723
- ),
724
- endpoint,
725
- },
726
- ),
727
- ));
728
- }
729
- Ok(value) => PaneId::new(value.trim().to_string()),
730
- Err(_) => {
731
- return Err(pane_refusal::PaneAuthorityRefusal::new(
732
- pane_refusal::PaneAuthorityRefusalFacts::AmbientPaneIdUnavailable(
733
- pane_refusal::AmbientPaneIdUnavailableFacts {
734
- requested_workspace,
735
- observed_pane_id: pane_refusal::UnavailablePaneAuthorityFact::new(
736
- pane_refusal::AmbientPaneIdUnavailableCause::EnvironmentValueNotUnicode,
737
- ),
738
- endpoint,
739
- },
740
- ),
741
- ));
742
- }
743
- },
744
- };
745
- let observed = current_tmux_pane_info(&pane_id, &endpoint).map_err(|error| {
746
- let cause = match error {
747
- CurrentTmuxPaneInfoError::QueryFailed => {
748
- pane_refusal::AmbientPaneWorkspaceUnavailableCause::PaneQueryFailed
749
- }
750
- CurrentTmuxPaneInfoError::PaneNotFound => {
751
- pane_refusal::AmbientPaneWorkspaceUnavailableCause::PaneNotFound
752
- }
753
- };
754
- pane_refusal::PaneAuthorityRefusal::new(
755
- pane_refusal::PaneAuthorityRefusalFacts::AmbientPaneWorkspaceUnavailable(
756
- pane_refusal::AmbientPaneWorkspaceUnavailableFacts {
757
- requested_workspace: requested_workspace.clone(),
758
- observed_pane_id: pane_id.as_str().to_string(),
759
- observed_pane_workspace: pane_refusal::UnavailablePaneAuthorityFact::new(cause),
760
- endpoint: endpoint.clone(),
761
- },
762
- ),
763
- )
764
- })?;
765
- let pane_workspace = observed.current_path.clone().ok_or_else(|| {
766
- pane_refusal::PaneAuthorityRefusal::new(
767
- pane_refusal::PaneAuthorityRefusalFacts::AmbientPaneWorkspaceUnavailable(
768
- pane_refusal::AmbientPaneWorkspaceUnavailableFacts {
769
- requested_workspace: requested_workspace.clone(),
770
- observed_pane_id: pane_id.as_str().to_string(),
771
- observed_pane_workspace: pane_refusal::UnavailablePaneAuthorityFact::new(
772
- pane_refusal::AmbientPaneWorkspaceUnavailableCause::CurrentPathMissing,
773
- ),
774
- endpoint: endpoint.clone(),
775
- },
776
- ),
777
- )
778
- })?;
779
- let caller_tty = caller_controlling_tty().map_err(|cause| {
780
- pane_refusal::PaneAuthorityRefusal::new(
781
- pane_refusal::PaneAuthorityRefusalFacts::CallerControllingTtyUnavailable(
782
- pane_refusal::CallerControllingTtyUnavailableFacts {
783
- requested_workspace: requested_workspace.clone(),
784
- observed_pane_id: pane_id.as_str().to_string(),
785
- endpoint: endpoint.clone(),
786
- caller_controlling_tty: pane_refusal::UnavailablePaneAuthorityFact::new(cause),
787
- },
788
- ),
789
- )
790
- })?;
791
- let pane_tty_path = observed.tty.as_deref().ok_or_else(|| {
792
- pane_refusal::PaneAuthorityRefusal::new(
793
- pane_refusal::PaneAuthorityRefusalFacts::ObservedPaneTtyUnavailable(
794
- pane_refusal::ObservedPaneTtyUnavailableFacts {
795
- requested_workspace: requested_workspace.clone(),
796
- observed_pane_id: pane_id.as_str().to_string(),
797
- endpoint: endpoint.clone(),
798
- observed_pane_tty: pane_refusal::UnavailablePaneAuthorityFact::new(
799
- pane_refusal::ObservedPaneTtyUnavailableCause::PaneTtyMissing,
800
- ),
801
- },
802
- ),
803
- )
804
- })?;
805
- let pane_tty = pane_tty_device(pane_tty_path).map_err(|cause| {
806
- pane_refusal::PaneAuthorityRefusal::new(
807
- pane_refusal::PaneAuthorityRefusalFacts::ObservedPaneTtyUnavailable(
808
- pane_refusal::ObservedPaneTtyUnavailableFacts {
809
- requested_workspace: requested_workspace.clone(),
810
- observed_pane_id: pane_id.as_str().to_string(),
811
- endpoint: endpoint.clone(),
812
- observed_pane_tty: pane_refusal::UnavailablePaneAuthorityFact::new(cause),
813
- },
814
- ),
815
- )
816
- })?;
817
- if caller_tty != pane_tty {
818
- return Err(pane_refusal::PaneAuthorityRefusal::new(
819
- pane_refusal::PaneAuthorityRefusalFacts::PaneTtyMismatch(
820
- pane_refusal::PaneTtyMismatchFacts {
821
- requested_workspace,
822
- observed_pane_id: pane_id.as_str().to_string(),
823
- endpoint,
824
- caller_controlling_tty: caller_tty,
825
- observed_pane_tty: pane_tty,
826
- },
827
- ),
828
- ));
829
- }
830
- if !crate::messaging::leader_channel::path_is_in_workspace(&pane_workspace, workspace) {
831
- return Err(pane_refusal::PaneAuthorityRefusal::new(
832
- pane_refusal::PaneAuthorityRefusalFacts::PaneWorkspaceMismatch(
833
- pane_refusal::PaneWorkspaceMismatchFacts {
834
- requested_workspace,
835
- observed_pane_id: pane_id.as_str().to_string(),
836
- observed_pane_workspace: pane_workspace,
837
- endpoint,
838
- },
839
- ),
840
- ));
841
- }
842
- Ok(VerifiedAmbientPaneAuthority {
843
- pane_id,
844
- observed,
845
- endpoint,
846
- tmux: tmux.to_string(),
847
- })
848
- }
849
-
850
- fn ambient_tmux_endpoint_refusal(
851
- workspace: &Path,
852
- cause: pane_refusal::AmbientTmuxEndpointUnavailableCause,
853
- ) -> pane_refusal::PaneAuthorityRefusal {
854
- pane_refusal::PaneAuthorityRefusal::new(
855
- pane_refusal::PaneAuthorityRefusalFacts::AmbientTmuxEndpointUnavailable(
856
- pane_refusal::AmbientTmuxEndpointUnavailableFacts {
857
- requested_workspace: resolve_workspace_for_hash(workspace),
858
- endpoint: pane_refusal::UnavailablePaneAuthorityFact::new(cause),
859
- },
860
- ),
861
- )
862
- }
863
-
864
- #[cfg(target_os = "macos")]
865
- fn caller_controlling_tty() -> Result<u64, pane_refusal::CallerControllingTtyUnavailableCause> {
866
- // `/dev/tty` proves that this process has a controlling terminal, but its
867
- // own path and rdev remain the generic alias. Query the process table for
868
- // the actual controlling device identity.
869
- let _controlling_tty = std::fs::File::open("/dev/tty")
870
- .map_err(|_| pane_refusal::CallerControllingTtyUnavailableCause::NoControllingTty)?;
871
- let mut info = std::mem::MaybeUninit::<libc::proc_bsdinfo>::zeroed();
872
- let info_size = std::mem::size_of::<libc::proc_bsdinfo>();
873
- let read = unsafe {
874
- libc::proc_pidinfo(
875
- libc::getpid(),
876
- libc::PROC_PIDTBSDINFO,
877
- 0,
878
- info.as_mut_ptr().cast(),
879
- info_size as libc::c_int,
880
- )
881
- };
882
- if read != info_size as libc::c_int {
883
- return Err(pane_refusal::CallerControllingTtyUnavailableCause::DeviceIdentityUnresolvable);
884
- }
885
- Ok(u64::from(unsafe { info.assume_init() }.e_tdev))
886
- }
887
-
888
- #[cfg(target_os = "linux")]
889
- fn caller_controlling_tty() -> Result<u64, pane_refusal::CallerControllingTtyUnavailableCause> {
890
- let controlling_tty = std::fs::OpenOptions::new()
891
- .read(true)
892
- .custom_flags(libc::O_NOCTTY | libc::O_CLOEXEC)
893
- .open("/dev/tty")
894
- .map_err(|_| pane_refusal::CallerControllingTtyUnavailableCause::NoControllingTty)?;
895
- let mut device = 0 as libc::c_uint;
896
- let result = unsafe { libc::ioctl(controlling_tty.as_raw_fd(), libc::TIOCGDEV, &mut device) };
897
- if result != 0 {
898
- return Err(pane_refusal::CallerControllingTtyUnavailableCause::DeviceIdentityUnresolvable);
899
- }
900
- Ok(u64::from(device))
901
- }
902
-
903
- #[cfg(not(any(target_os = "macos", target_os = "linux")))]
904
- fn caller_controlling_tty() -> Result<u64, pane_refusal::CallerControllingTtyUnavailableCause> {
905
- Err(pane_refusal::CallerControllingTtyUnavailableCause::PlatformUnsupported)
906
- }
907
-
908
- #[cfg(unix)]
909
- fn pane_tty_device(path: &str) -> Result<u64, pane_refusal::ObservedPaneTtyUnavailableCause> {
910
- let pane_tty = std::fs::OpenOptions::new()
911
- .read(true)
912
- .custom_flags(libc::O_NOCTTY | libc::O_CLOEXEC)
913
- .open(path)
914
- .map_err(|_| pane_refusal::ObservedPaneTtyUnavailableCause::PaneTtyUnresolvable)?;
915
- let metadata = pane_tty
916
- .metadata()
917
- .map_err(|_| pane_refusal::ObservedPaneTtyUnavailableCause::PaneTtyUnresolvable)?;
918
- if !metadata.file_type().is_char_device() {
919
- return Err(pane_refusal::ObservedPaneTtyUnavailableCause::PaneTtyNotCharacterDevice);
920
- }
921
- Ok(metadata.rdev())
922
- }
923
-
924
- #[cfg(not(unix))]
925
- fn pane_tty_device(_path: &str) -> Result<u64, pane_refusal::ObservedPaneTtyUnavailableCause> {
926
- Err(pane_refusal::ObservedPaneTtyUnavailableCause::PaneTtyUnresolvable)
927
- }
928
-
929
- /// B5: the deterministic leader-session naming prefix IS the ownership truth source —
930
- /// shutdown's socket teardown spares sessions carrying it (no separate registry).
931
- pub const LEADER_SESSION_PREFIX: &str = "team-agent-leader-";
932
-
933
- /// `leader_session_name`(card §48;`__init__.py:186`)。确定派生 tmux session 名
934
- /// `team-agent-leader-<provider>-<folder>-<sha1[:8]>`(workspace.resolve() 的 sha1 前 8 hex)。
935
- pub fn leader_session_name(provider: Provider, workspace: &Path) -> SessionName {
936
- let resolved = resolve_workspace_for_hash(workspace);
937
- let folder_raw = resolved
938
- .file_name()
939
- .and_then(|n| n.to_str())
940
- .unwrap_or("workspace");
941
- let folder = sanitize_session_folder(folder_raw);
942
- let hash = sha1_hex_prefix(resolved.to_string_lossy().as_bytes(), 8);
943
- SessionName::new(format!(
944
- "{LEADER_SESSION_PREFIX}{}-{folder}-{hash}",
945
- provider_wire(provider)
946
- ))
947
- }
948
-
949
- /// 0.4.10+ mirror-session fix v2: managed-mode session name with a
950
- /// per-launch nonce.
951
- ///
952
- /// Format: `team-agent-leader-<provider>-<folder>-<hash>-<nonce>`.
953
- /// `nonce` = `<pid_hex>-<epoch_nanos_hex>`. The pid distinguishes
954
- /// concurrent launches; the epoch_nanos distinguishes sequential ones.
955
- ///
956
- /// Each `team-agent <provider>` entry in the managed (non-tmux) path gets
957
- /// its OWN session, matching the user expectation that `tmux new-session
958
- /// + claude` is independent every time. The workspace-keyed prefix is
959
- /// preserved so existing leader-session-anchored protections
960
- /// (`LEADER_SESSION_PREFIX` matchers in shutdown/cli/mod.rs) still
961
- /// classify these sessions as leader sessions.
962
- ///
963
- /// External / attach paths keep the stable `leader_session_name` —
964
- /// per-launch nonce would break `--attach-session <name>` reattach
965
- /// semantics.
966
- fn managed_leader_session_name(provider: Provider, workspace: &Path) -> SessionName {
967
- let resolved = resolve_workspace_for_hash(workspace);
968
- let folder_raw = resolved
969
- .file_name()
970
- .and_then(|n| n.to_str())
971
- .unwrap_or("workspace");
972
- let folder = sanitize_session_folder(folder_raw);
973
- let hash = sha1_hex_prefix(resolved.to_string_lossy().as_bytes(), 8);
974
- let pid = std::process::id();
975
- let epoch_nanos = std::time::SystemTime::now()
976
- .duration_since(std::time::UNIX_EPOCH)
977
- .map(|d| d.as_nanos())
978
- .unwrap_or(0);
979
- SessionName::new(format!(
980
- "{LEADER_SESSION_PREFIX}{}-{folder}-{hash}-{pid:x}-{epoch_nanos:x}",
981
- provider_wire(provider)
982
- ))
983
- }
984
-
985
- fn managed_leader_session_for_launch(provider: Provider, workspace: &Path) -> SessionName {
986
- let candidates = crate::transport_factory::tmux_workspace_transport(workspace)
987
- .list_targets()
988
- .unwrap_or_default()
989
- .into_iter()
990
- .map(|target| target.session.as_str().to_string());
991
- managed_leader_session_from_candidates(provider, workspace, candidates)
992
- }
993
-
994
- fn managed_leader_session_from_candidates(
995
- provider: Provider,
996
- workspace: &Path,
997
- candidates: impl IntoIterator<Item = String>,
998
- ) -> SessionName {
999
- let prefix = format!("{LEADER_SESSION_PREFIX}{}-", provider_wire(provider));
1000
- let existing = candidates
1001
- .into_iter()
1002
- .filter(|name| name.starts_with(&prefix))
1003
- .collect::<std::collections::BTreeSet<_>>();
1004
- existing
1005
- .into_iter()
1006
- .next()
1007
- .map(SessionName::new)
1008
- .unwrap_or_else(|| managed_leader_session_name(provider, workspace))
1009
- }
1010
-
1011
- /// Base window is `provider_wire` (`claude_code`). A second live leader in
1012
- /// the same session cannot reuse that name: tmux then fails
1013
- /// `attach-session -t SESSION:claude_code` with `can't find window`.
1014
- fn managed_leader_window_from_occupied(
1015
- base: &str,
1016
- occupied: impl IntoIterator<Item = String>,
1017
- nonce: &str,
1018
- ) -> WindowName {
1019
- let occupied = occupied
1020
- .into_iter()
1021
- .collect::<std::collections::BTreeSet<_>>();
1022
- if !occupied.contains(base) {
1023
- return WindowName::new(base);
1024
- }
1025
- let mut candidate = format!("{base}-{nonce}");
1026
- let mut n = 2u32;
1027
- while occupied.contains(&candidate) {
1028
- candidate = format!("{base}-{nonce}-{n}");
1029
- n = n.saturating_add(1);
1030
- if n > 32 {
1031
- break;
1032
- }
1033
- }
1034
- WindowName::new(candidate)
1035
- }
1036
-
1037
- fn managed_leader_window_for_launch(
1038
- provider: Provider,
1039
- workspace: &Path,
1040
- session: &SessionName,
1041
- ) -> WindowName {
1042
- let base = provider_wire(provider);
1043
- let transport = crate::transport_factory::tmux_workspace_transport(workspace);
1044
- let session_exists = transport.has_session(session).unwrap_or(false);
1045
- if !session_exists {
1046
- return WindowName::new(base);
1047
- }
1048
- let occupied = match transport.list_windows(session) {
1049
- Ok(windows) => windows
1050
- .into_iter()
1051
- .map(|window| window.as_str().to_string())
1052
- .collect::<Vec<_>>(),
1053
- // Cannot prove the base name is free: suffix rather than collide.
1054
- Err(_) => vec![base.to_string()],
1055
- };
1056
- let pid = std::process::id();
1057
- let epoch_nanos = std::time::SystemTime::now()
1058
- .duration_since(std::time::UNIX_EPOCH)
1059
- .map(|d| d.as_nanos())
1060
- .unwrap_or(0);
1061
- let nonce = format!("{pid:x}-{epoch_nanos:x}");
1062
- managed_leader_window_from_occupied(base, occupied, &nonce)
1063
- }
1064
-
1065
- fn start_argv(
1066
- mode: LeaderStartMode,
1067
- provider: Provider,
1068
- provider_argv: &[String],
1069
- workspace: &Path,
1070
- session_name: Option<&SessionName>,
1071
- leader_window: Option<&WindowName>,
1072
- leader_env: &BTreeMap<String, String>,
1073
- managed_client_attach_mode: Option<ManagedClientAttachMode>,
1074
- ) -> Result<Vec<String>, LeaderError> {
1075
- match mode {
1076
- LeaderStartMode::ExecProvider => Ok(provider_argv.to_vec()),
1077
- LeaderStartMode::ManagedTmuxClient => {
1078
- let Some(session) = session_name else {
1079
- return Err(LeaderError::Start(
1080
- "managed leader session missing".to_string(),
1081
- ));
1082
- };
1083
- let Some(window) = leader_window else {
1084
- return Err(LeaderError::Start(
1085
- "managed leader window missing".to_string(),
1086
- ));
1087
- };
1088
- let attach_mode = managed_client_attach_mode.ok_or_else(|| {
1089
- LeaderError::Start("managed client attach mode missing".to_string())
1090
- })?;
1091
- managed_client_argv(workspace, session, window, attach_mode)
1092
- }
1093
- LeaderStartMode::AttachExisting => {
1094
- let Some(session) = session_name else {
1095
- return Err(LeaderError::Start("attach session missing".to_string()));
1096
- };
1097
- let argv = vec![
1098
- "tmux".to_string(),
1099
- "attach-session".to_string(),
1100
- "-t".to_string(),
1101
- session.as_str().to_string(),
1102
- ];
1103
- Ok(TmuxBackend::argv_for_workspace(workspace, &argv))
1104
- }
1105
- LeaderStartMode::NewTmuxSession => {
1106
- let Some(session) = session_name else {
1107
- return Err(LeaderError::Start("leader session missing".to_string()));
1108
- };
1109
- let resolved_workspace = resolve_workspace_for_hash(workspace);
1110
- let mut exports = leader_export_assignments(leader_env);
1111
- if let Some(path) = std::env::var_os("PATH").and_then(|p| p.into_string().ok()) {
1112
- exports.push(shlex_quote(&format!("PATH={path}")));
1113
- }
1114
- let shell = format!(
1115
- "cd {} && export {} && exec {}",
1116
- shlex_quote(&resolved_workspace.to_string_lossy()),
1117
- exports.join(" "),
1118
- shell_join(provider_argv)
1119
- );
1120
- let argv = vec![
1121
- "tmux".to_string(),
1122
- "new-session".to_string(),
1123
- "-s".to_string(),
1124
- session.as_str().to_string(),
1125
- "-n".to_string(),
1126
- provider_wire(provider).to_string(),
1127
- "-c".to_string(),
1128
- resolved_workspace.to_string_lossy().into_owned(),
1129
- "sh".to_string(),
1130
- "-lc".to_string(),
1131
- shell,
1132
- ];
1133
- Ok(TmuxBackend::argv_for_workspace(workspace, &argv))
1134
- }
1135
- }
1136
- }
1137
-
1138
- fn provider_command_argv(provider: Provider, provider_args: &[String]) -> Vec<String> {
1139
- let mut argv = vec![provider_command_name(provider).to_string()];
1140
- argv.extend(normalized_provider_args(provider_args));
1141
- argv
1142
- }
1143
-
1144
- fn normalized_provider_args(provider_args: &[String]) -> impl Iterator<Item = String> + '_ {
1145
- provider_args
1146
- .iter()
1147
- .skip(usize::from(
1148
- provider_args.first().is_some_and(|arg| arg == "--"),
1149
- ))
1150
- .cloned()
1151
- }
1152
-
1153
- // 0.3.28 Step 2: `managed_team_session_name` deleted. Both paths use the
1154
- // dedicated leader-session namespace; managed launches select a live prefix
1155
- // candidate before falling back to the nonce helper, while external/attach
1156
- // launches use the stable `leader_session_name`.
1157
-
1158
- fn managed_client_argv(
1159
- workspace: &Path,
1160
- session: &SessionName,
1161
- window: &WindowName,
1162
- attach_mode: ManagedClientAttachMode,
1163
- ) -> Result<Vec<String>, LeaderError> {
1164
- // Attach to the launch's actual window (base `provider_wire` or a unique
1165
- // suffix). Targeting only `provider_wire` collides when two live leaders
1166
- // share the A-22 session (`can't find window: claude_code`).
1167
- let target = format!("{}:{}", session.as_str(), window.as_str());
1168
- let argv = match attach_mode {
1169
- ManagedClientAttachMode::SwitchClient => vec![
1170
- "tmux".to_string(),
1171
- "switch-client".to_string(),
1172
- "-t".to_string(),
1173
- target,
1174
- ],
1175
- ManagedClientAttachMode::AttachSession => vec![
1176
- "tmux".to_string(),
1177
- "attach-session".to_string(),
1178
- "-t".to_string(),
1179
- target,
1180
- ],
1181
- };
1182
- Ok(TmuxBackend::argv_for_workspace(workspace, &argv))
1183
- }
1184
-
1185
- fn execute_managed_leader_plan(
1186
- plan: &LeaderStartPlan,
1187
- workspace: &Path,
1188
- ) -> Result<LeaderLaunchOutcome, LeaderError> {
1189
- execute_managed_leader_plan_attempt(plan, workspace, true)
1190
- }
1191
-
1192
- fn execute_managed_leader_plan_attempt(
1193
- plan: &LeaderStartPlan,
1194
- workspace: &Path,
1195
- allow_attach_recovery: bool,
1196
- ) -> Result<LeaderLaunchOutcome, LeaderError> {
1197
- let Some(session) = plan.session_name.as_ref() else {
1198
- return Err(LeaderError::Start(
1199
- "managed leader session missing".to_string(),
1200
- ));
1201
- };
1202
- let Some(window) = plan.leader_window.as_ref() else {
1203
- return Err(LeaderError::Start(
1204
- "managed leader window missing".to_string(),
1205
- ));
1206
- };
1207
- // 0.5.x Phase 1d Batch 6: use the factory tmux channel helper
1208
- // (thin wrapper over `TmuxBackend::for_workspace`) for
1209
- // grep-visibility of every intentional tmux-only leader-launcher
1210
- // site. Semantics unchanged; managed leader hosting stays
1211
- // tmux-only per design §Batch 6.
1212
- let transport = crate::transport_factory::tmux_workspace_transport(workspace);
1213
- let session_existed_before = transport.has_session(session).map_err(|error| {
1214
- LeaderError::Start(format!("managed leader session probe failed: {error}"))
1215
- })?;
1216
- let spawned = ensure_managed_leader_pane(
1217
- &transport,
1218
- session,
1219
- window,
1220
- plan,
1221
- workspace,
1222
- session_existed_before,
1223
- )?;
1224
- // A-55 (window rename race): tmux defaults `allow-rename` + `automatic-rename`
1225
- // ON, so the pane's shell wrapper can print an OSC title-set escape during
1226
- // init (zshrc/starship/PROMPT_COMMAND) and rename the window away from WINDOW
1227
- // between spawn-poll and attach — making `attach-session -t SESSION:WINDOW`
1228
- // fail with "can't find window: WINDOW". Lock both off right after spawn,
1229
- // before run_leader_argv. Best-effort: a failure must NOT abort the launcher
1230
- // (old tmux may lack the option), but it is audited below.
1231
- let (rename_result, rename_stderr) =
1232
- lock_down_window_rename(&transport, session, &spawned.window);
1233
- write_window_rename_lockdown_event(workspace, &rename_result, &rename_stderr);
1234
- if let Err(error) = persist_managed_leader_binding(plan, workspace, &spawned) {
1235
- cleanup_managed_leader_resources(
1236
- &transport,
1237
- session,
1238
- &spawned,
1239
- session_existed_before,
1240
- workspace,
1241
- "binding_persist_failed",
1242
- );
1243
- return Err(error);
1244
- }
1245
- spawn_managed_provider_startup_prompt_handler(
1246
- plan.provider,
1247
- workspace.to_path_buf(),
1248
- spawned.pane_id.as_str().to_string(),
1249
- );
1250
- let process = match run_leader_argv(
1251
- &plan.argv,
1252
- &BTreeMap::new(),
1253
- plan,
1254
- workspace,
1255
- Some(ManagedAttachWatch {
1256
- transport: &transport,
1257
- spawned: &spawned,
1258
- session,
1259
- session_existed_before,
1260
- workspace,
1261
- provider_label: provider_command_name(plan.provider),
1262
- }),
1263
- ) {
1264
- Ok(process) => process,
1265
- Err(error) => {
1266
- cleanup_managed_leader_resources(
1267
- &transport,
1268
- session,
1269
- &spawned,
1270
- session_existed_before,
1271
- workspace,
1272
- "launcher_spawn_failed",
1273
- );
1274
- return Err(error);
1275
- }
1276
- };
1277
- if process.intentional_teardown {
1278
- return Ok(LeaderLaunchOutcome {
1279
- status: LeaderLaunchStatus::Exited,
1280
- exit_code: Some(0),
1281
- session_name: plan.session_name.clone(),
1282
- reason: None,
1283
- });
1284
- }
1285
- let code = process.status.code();
1286
- if !process.status.success() {
1287
- cleanup_managed_leader_resources(
1288
- &transport,
1289
- session,
1290
- &spawned,
1291
- session_existed_before,
1292
- workspace,
1293
- "launcher_exit_failed",
1294
- );
1295
- let failure = LeaderError::Start(leader_launcher_failure(&process));
1296
- if allow_attach_recovery {
1297
- if let Ok(retry_plan) = managed_leader_attach_recovery_plan(plan, workspace) {
1298
- return execute_managed_leader_plan_attempt(&retry_plan, workspace, false);
1299
- }
1300
- }
1301
- return Err(failure);
1302
- }
1303
- if let Err(error) = ensure_managed_provider_live_after_attach(&transport, &spawned) {
1304
- cleanup_managed_leader_resources(
1305
- &transport,
1306
- session,
1307
- &spawned,
1308
- session_existed_before,
1309
- workspace,
1310
- "provider_not_live_after_attach",
1311
- );
1312
- return Err(error);
1313
- }
1314
- Ok(LeaderLaunchOutcome {
1315
- status: LeaderLaunchStatus::Exited,
1316
- exit_code: code,
1317
- session_name: plan.session_name.clone(),
1318
- reason: None,
1319
- })
1320
- }
1321
-
1322
- fn managed_leader_attach_recovery_plan(
1323
- plan: &LeaderStartPlan,
1324
- workspace: &Path,
1325
- ) -> Result<LeaderStartPlan, LeaderError> {
1326
- let session = managed_leader_session_for_launch(plan.provider, workspace);
1327
- let window = managed_leader_window_for_launch(plan.provider, workspace, &session);
1328
- let attach_mode = if plan.argv.iter().any(|arg| arg == "switch-client") {
1329
- ManagedClientAttachMode::SwitchClient
1330
- } else {
1331
- ManagedClientAttachMode::AttachSession
1332
- };
1333
- let argv = managed_client_argv(workspace, &session, &window, attach_mode)?;
1334
- let mut retry_plan = plan.clone();
1335
- retry_plan.session_name = Some(session);
1336
- retry_plan.leader_window = Some(window);
1337
- retry_plan.argv = argv;
1338
- Ok(retry_plan)
1339
- }
1340
-
1341
- fn ensure_managed_leader_pane(
1342
- transport: &dyn Transport,
1343
- session: &SessionName,
1344
- window: &WindowName,
1345
- plan: &LeaderStartPlan,
1346
- workspace: &Path,
1347
- session_existed_before: bool,
1348
- ) -> Result<SpawnResult, LeaderError> {
1349
- // A-22: a managed launch may reuse an existing provider leader session;
1350
- // only a newly selected nonce session is absent before this probe.
1351
- // Reusing the existing session adds one pane; a new session uses the
1352
- // first-spawn path.
1353
- if session_existed_before {
1354
- // 0.4.x (CR C-1 + C-2): leader env_unset reuses the worker
1355
- // provider_env_unsets (single source of truth) + spawn through the
1356
- // leader shell wrapper so provider exit returns to a shell, not
1357
- // `[exited]`.
1358
- let env_unset = leader_env_unset_for_provider(plan.provider);
1359
- let provider_label = provider_command_name(plan.provider);
1360
- transport
1361
- .spawn_into_with_leader_shell_wrapper(
1362
- session,
1363
- window,
1364
- &plan.provider_argv,
1365
- workspace,
1366
- &plan.leader_env,
1367
- &env_unset,
1368
- provider_label,
1369
- )
1370
- .map_err(|error| prompt_aware_spawn_error(plan, error))
1371
- } else {
1372
- let env_unset = leader_env_unset_for_provider(plan.provider);
1373
- let provider_label = provider_command_name(plan.provider);
1374
- transport
1375
- .spawn_first_with_leader_shell_wrapper(
1376
- session,
1377
- window,
1378
- &plan.provider_argv,
1379
- workspace,
1380
- &plan.leader_env,
1381
- &env_unset,
1382
- provider_label,
1383
- )
1384
- .map_err(|error| prompt_aware_spawn_error(plan, error))
1385
- }
1386
- }
1387
-
1388
- fn prompt_aware_spawn_error(plan: &LeaderStartPlan, error: TransportError) -> LeaderError {
1389
- let Some(metadata) = plan.leader_prompt.as_ref() else {
1390
- return LeaderError::Start(error.to_string());
1391
- };
1392
- // Transport subprocess errors contain the full tmux shell argv. Preserve
1393
- // real exit/I/O evidence without exposing the process-level prompt payload.
1394
- let mut safe = super::prompt::PromptError::new(
1395
- "leader_prompt_carrier_failed",
1396
- "Leader prompt-bearing transport spawn failed; argv and stderr withheld",
1397
- Some(&metadata.config_path),
1398
- )
1399
- .for_provider(plan.provider);
1400
- match error {
1401
- TransportError::Subprocess { code, .. } => safe.exit_code = code,
1402
- TransportError::Spawn { source, .. } | TransportError::Inject { source, .. }
1403
- | TransportError::Capture { source } | TransportError::Io(source) => {
1404
- safe.io_kind = Some(format!("{:?}", source.kind()));
1405
- }
1406
- oversized @ TransportError::CommandTooLong { .. } => {
1407
- safe.error = oversized.to_string();
1408
- }
1409
- _ => {}
1410
- }
1411
- safe.action = "Inspect the owned launcher and transport metadata; do not repeat or change carriers to bypass the failure";
1412
- LeaderError::Prompt(safe)
1413
- }
1414
-
1415
- struct ManagedAttachWatch<'a> {
1416
- transport: &'a dyn Transport,
1417
- spawned: &'a SpawnResult,
1418
- session: &'a SessionName,
1419
- session_existed_before: bool,
1420
- workspace: &'a Path,
1421
- provider_label: &'a str,
1422
- }
1423
-
1424
- #[cfg(unix)]
1425
- static MANAGED_ATTACH_TEARDOWN: AtomicBool = AtomicBool::new(false);
1426
-
1427
- #[cfg(unix)]
1428
- struct ManagedTermGuard {
1429
- old: libc::sighandler_t,
1430
- }
1431
-
1432
- #[cfg(unix)]
1433
- impl ManagedTermGuard {
1434
- fn install() -> Self {
1435
- MANAGED_ATTACH_TEARDOWN.store(false, Ordering::SeqCst);
1436
- let handler = managed_term_handler as *const () as libc::sighandler_t;
1437
- let old = unsafe { libc::signal(libc::SIGTERM, handler) };
1438
- Self { old }
1439
- }
1440
- }
1441
-
1442
- #[cfg(unix)]
1443
- impl Drop for ManagedTermGuard {
1444
- fn drop(&mut self) {
1445
- unsafe {
1446
- libc::signal(libc::SIGTERM, self.old);
1447
- }
1448
- MANAGED_ATTACH_TEARDOWN.store(false, Ordering::SeqCst);
1449
- }
1450
- }
1451
-
1452
- #[cfg(unix)]
1453
- extern "C" fn managed_term_handler(_: libc::c_int) {
1454
- MANAGED_ATTACH_TEARDOWN.store(true, Ordering::SeqCst);
1455
- }
1456
-
1457
- fn managed_attach_should_teardown(watch: &ManagedAttachWatch<'_>) -> bool {
1458
- matches!(
1459
- leader_provider_health(
1460
- watch.transport,
1461
- &watch.spawned.pane_id,
1462
- watch.provider_label
1463
- ),
1464
- LeaderProviderHealth::ProviderExited | LeaderProviderHealth::Unreachable
1465
- )
1466
- }
1467
-
1468
- fn bound_pane_snapshot(
1469
- pane_id: &str,
1470
- session_name: &serde_json::Value,
1471
- window_name: &serde_json::Value,
1472
- tmux_socket: &serde_json::Value,
1473
- ) -> serde_json::Value {
1474
- serde_json::json!({
1475
- "pane_id": pane_id,
1476
- "session_name": session_name,
1477
- "window_name": window_name,
1478
- "tmux_socket": tmux_socket,
1479
- })
1480
- }
1481
-
1482
- fn merge_bound_panes(
1483
- existing: Option<&serde_json::Value>,
1484
- new_pane: serde_json::Value,
1485
- ) -> Vec<serde_json::Value> {
1486
- let new_id = new_pane
1487
- .get("pane_id")
1488
- .and_then(serde_json::Value::as_str)
1489
- .unwrap_or("")
1490
- .to_string();
1491
- let mut panes = Vec::new();
1492
- if let Some(existing) = existing {
1493
- if let Some(arr) = existing
1494
- .get("bound_panes")
1495
- .and_then(serde_json::Value::as_array)
1496
- {
1497
- panes.extend(arr.iter().cloned());
1498
- } else if let Some(old_pane) = existing.get("pane_id").and_then(serde_json::Value::as_str) {
1499
- panes.push(bound_pane_snapshot(
1500
- old_pane,
1501
- existing
1502
- .get("session_name")
1503
- .unwrap_or(&serde_json::Value::Null),
1504
- existing
1505
- .get("window_name")
1506
- .unwrap_or(&serde_json::Value::Null),
1507
- existing
1508
- .get("tmux_socket")
1509
- .unwrap_or(&serde_json::Value::Null),
1510
- ));
1511
- }
1512
- }
1513
- if !new_id.is_empty()
1514
- && !panes.iter().any(|pane| {
1515
- pane.get("pane_id").and_then(serde_json::Value::as_str) == Some(new_id.as_str())
1516
- })
1517
- {
1518
- panes.push(new_pane);
1519
- }
1520
- panes
1521
- }
1522
-
1523
- fn apply_clear_to_leader_receiver(
1524
- recv: &mut serde_json::Map<String, serde_json::Value>,
1525
- pane_id: &str,
1526
- ) -> bool {
1527
- let mut changed = false;
1528
- if let Some(arr) = recv
1529
- .get_mut("bound_panes")
1530
- .and_then(serde_json::Value::as_array_mut)
1531
- {
1532
- let before = arr.len();
1533
- arr.retain(|pane| pane.get("pane_id").and_then(serde_json::Value::as_str) != Some(pane_id));
1534
- if arr.len() != before {
1535
- changed = true;
1536
- }
1537
- }
1538
- let scalar_match = recv.get("pane_id").and_then(serde_json::Value::as_str) == Some(pane_id);
1539
- if scalar_match {
1540
- let promoted = recv
1541
- .get("bound_panes")
1542
- .and_then(serde_json::Value::as_array)
1543
- .and_then(|arr| arr.first())
1544
- .cloned();
1545
- if let Some(next) = promoted {
1546
- recv.insert("status".to_string(), serde_json::json!("attached"));
1547
- recv.insert(
1548
- "pane_id".to_string(),
1549
- next.get("pane_id")
1550
- .cloned()
1551
- .unwrap_or(serde_json::Value::Null),
1552
- );
1553
- recv.insert(
1554
- "pane".to_string(),
1555
- next.get("pane_id")
1556
- .cloned()
1557
- .unwrap_or(serde_json::Value::Null),
1558
- );
1559
- if let Some(session) = next.get("session_name") {
1560
- recv.insert("session_name".to_string(), session.clone());
1561
- }
1562
- if let Some(window) = next.get("window_name") {
1563
- recv.insert("window_name".to_string(), window.clone());
1564
- }
1565
- } else {
1566
- recv.insert("status".to_string(), serde_json::json!("exited"));
1567
- recv.remove("pane_id");
1568
- recv.remove("pane");
1569
- }
1570
- changed = true;
1571
- }
1572
- changed
1573
- }
1574
-
1575
- fn clear_managed_leader_receiver_pane(workspace: &Path, pane_id: &str) {
1576
- let Ok(mut state) = crate::state::persist::load_runtime_state(workspace) else {
1577
- return;
1578
- };
1579
- let mut changed = false;
1580
- if let Some(teams) = state
1581
- .get_mut("teams")
1582
- .and_then(serde_json::Value::as_object_mut)
1583
- {
1584
- for (_key, team) in teams.iter_mut() {
1585
- let Some(team_obj) = team.as_object_mut() else {
1586
- continue;
1587
- };
1588
- if let Some(recv) = team_obj
1589
- .get_mut("leader_receiver")
1590
- .and_then(serde_json::Value::as_object_mut)
1591
- {
1592
- if apply_clear_to_leader_receiver(recv, pane_id) {
1593
- changed = true;
1594
- }
1595
- }
1596
- if let Some(owner) = team_obj
1597
- .get_mut("team_owner")
1598
- .and_then(serde_json::Value::as_object_mut)
1599
- {
1600
- if owner.get("pane_id").and_then(serde_json::Value::as_str) == Some(pane_id) {
1601
- owner.remove("pane_id");
1602
- changed = true;
1603
- }
1604
- }
1605
- }
1606
- }
1607
- if !changed {
1608
- return;
1609
- }
1610
- let team_key = state
1611
- .get("active_team_key")
1612
- .and_then(serde_json::Value::as_str)
1613
- .unwrap_or("current")
1614
- .to_string();
1615
- let _ = crate::state::repository::StateRepository::new(workspace).save(
1616
- crate::state::repository::StateWriteIntent::LeaderStartBinding {
1617
- team_key: &team_key,
1618
- transport_kind: "managed",
1619
- },
1620
- &state,
1621
- );
1622
- }
1623
-
1624
- fn cleanup_managed_leader_resources(
1625
- transport: &dyn Transport,
1626
- session: &SessionName,
1627
- spawned: &SpawnResult,
1628
- session_existed_before: bool,
1629
- workspace: &Path,
1630
- reason: &str,
1631
- ) {
1632
- // Own window only — never kill-server (same socket may host other teams).
1633
- // Last window in the session lets tmux destroy the session itself.
1634
- let window_target = Target::SessionWindow {
1635
- session: spawned.session.clone(),
1636
- window: spawned.window.clone(),
1637
- };
1638
- let window_result = transport
1639
- .kill_window(&window_target)
1640
- .map(|_| "ok".to_string())
1641
- .unwrap_or_else(|error| error.to_string());
1642
- let mut action = "kill_window".to_string();
1643
- let mut result = window_result;
1644
- if !session_existed_before {
1645
- match transport.list_windows(session) {
1646
- Ok(windows) if windows.is_empty() => {
1647
- let session_result = transport
1648
- .kill_session(session)
1649
- .map(|_| "ok".to_string())
1650
- .unwrap_or_else(|error| error.to_string());
1651
- action = "kill_window+kill_session".to_string();
1652
- result = format!("{result};kill_session={session_result}");
1653
- }
1654
- Ok(_) => {}
1655
- Err(error) => {
1656
- action = "kill_window+list_windows_err".to_string();
1657
- result = format!("{result};list_windows={error}");
1658
- }
1659
- }
1660
- }
1661
- clear_managed_leader_receiver_pane(workspace, spawned.pane_id.as_str());
1662
- write_leader_startup_prompt_event(
1663
- workspace,
1664
- "leader.launcher.rollback",
1665
- serde_json::json!({
1666
- "reason": reason,
1667
- "session": session.as_str(),
1668
- "pane_id": spawned.pane_id.as_str(),
1669
- "session_preexisted": session_existed_before,
1670
- "action": action,
1671
- "result": result,
1672
- }),
1673
- );
1674
- }
1675
-
1676
- /// 0.4.x (CR C-1): leader provider env-unset list — SINGLE SOURCE OF TRUTH
1677
- /// reused from worker spawn (`profile_launch::provider_env_unsets`).
1678
- /// Audit grep guard: this function MUST be the only place in
1679
- /// `crates/team-agent/src/leader/` that constructs a Claude/Codex/Copilot
1680
- /// env-unset list. Any new code path that needs it must call this function
1681
- /// or the underlying `provider_env_unsets`. Use `AuthMode::Subscription` —
1682
- /// the leader is the user's interactive provider, never CompatibleApi/
1683
- /// OfficialApi which are worker-only auth modes today.
1684
- fn leader_env_unset_for_provider(provider: Provider) -> Vec<String> {
1685
- crate::lifecycle::profile_launch::provider_env_unsets(
1686
- provider,
1687
- crate::model::enums::AuthMode::Subscription,
1688
- )
1689
- .into_iter()
1690
- .collect()
1691
- }
1692
-
1693
- fn ensure_managed_provider_live_after_attach(
1694
- transport: &dyn Transport,
1695
- spawned: &SpawnResult,
1696
- ) -> Result<(), LeaderError> {
1697
- let live = match transport.liveness(&spawned.pane_id) {
1698
- Ok(PaneLiveness::Live) => true,
1699
- Ok(PaneLiveness::Dead) => false,
1700
- Ok(PaneLiveness::Unknown) | Err(_) => managed_spawned_pane_in_targets(transport, spawned),
1701
- };
1702
- if live {
1703
- return Ok(());
1704
- }
1705
- Err(LeaderError::Start(format!(
1706
- "managed leader provider pane is not running after tmux client returned: {} {}:{}",
1707
- spawned.pane_id.as_str(),
1708
- spawned.session.as_str(),
1709
- spawned.window.as_str()
1710
- )))
1711
- }
1712
-
1713
- /// Reconcile real pane liveness with the supervising wrapper's exit receipt.
1714
- /// Restored provider output may contain any exit-marker text; it is not process
1715
- /// state and must never authorize destructive managed-window cleanup.
1716
- pub fn leader_provider_health(
1717
- transport: &dyn Transport,
1718
- pane_id: &PaneId,
1719
- _expected_provider_label: &str,
1720
- ) -> LeaderProviderHealth {
1721
- if matches!(transport.liveness(pane_id), Ok(PaneLiveness::Dead)) {
1722
- return LeaderProviderHealth::Unreachable;
1723
- }
1724
- if matches!(transport.provider_exit_status(pane_id), Ok(Some(_))) {
1725
- return LeaderProviderHealth::ProviderExited;
1726
- }
1727
- // Missing/unsupported receipts (including old wrappers) are not proof of exit.
1728
- LeaderProviderHealth::Alive
1729
- }
1730
-
1731
- /// Health status reported by [`leader_provider_health`].
1732
- #[derive(Debug, Clone, Copy, PartialEq, Eq)]
1733
- pub enum LeaderProviderHealth {
1734
- /// Provider process appears to be the pane's current command.
1735
- Alive,
1736
- /// Pane has fallen back to a shell with the exit marker present —
1737
- /// provider has exited.
1738
- ProviderExited,
1739
- /// Pane is dead / unaddressable.
1740
- Unreachable,
1741
- }
1742
-
1743
- /// 0.4.x (CR R6 + R3): single-source shell-tail detection.
1744
- /// Used by:
1745
- /// - shutdown logic to recognise a leader pane in shell-tail mode
1746
- /// as still owned by the leader (not stray).
1747
- ///
1748
- /// Matches by basename (case-insensitive) — `pane_current_command` returns
1749
- /// the basename of the running binary. Conservative whitelist of POSIX +
1750
- /// common shell processes; missing entries here are false negatives
1751
- /// (shell tail looks like provider absent → health says Alive) which is the
1752
- /// safe default per the CR R6 conservative-Alive rule.
1753
- fn is_interactive_shell_basename(name: &str) -> bool {
1754
- let trimmed = name.trim().to_ascii_lowercase();
1755
- let basename = std::path::Path::new(&trimmed)
1756
- .file_name()
1757
- .and_then(|s| s.to_str())
1758
- .unwrap_or(&trimmed);
1759
- matches!(
1760
- basename,
1761
- "zsh"
1762
- | "bash"
1763
- | "sh"
1764
- | "fish"
1765
- | "dash"
1766
- | "ksh"
1767
- | "tcsh"
1768
- | "csh"
1769
- | "ash"
1770
- | "mksh"
1771
- | "yash"
1772
- | "elvish"
1773
- | "nu"
1774
- | "nushell"
1775
- | "xonsh"
1776
- )
1777
- }
1778
-
1779
- fn managed_spawned_pane_in_targets(transport: &dyn Transport, spawned: &SpawnResult) -> bool {
1780
- transport
1781
- .list_targets()
1782
- .unwrap_or_default()
1783
- .iter()
1784
- .any(|pane| {
1785
- pane.pane_id.as_str() == spawned.pane_id.as_str()
1786
- && pane.session.as_str() == spawned.session.as_str()
1787
- && pane.window_name.as_ref().map(WindowName::as_str)
1788
- == Some(spawned.window.as_str())
1789
- })
1790
- }
1791
-
1792
- /// Keep the launcher's native identity with the canonical pane. The backing
1793
- /// JSONL may not exist until Pi's first turn; receipt observation resolves it by
1794
- /// exact header, never by filename/mtime or the Team Agent owner UUID.
1795
- fn bind_plan_session(receiver: &mut serde_json::Value, plan: &LeaderStartPlan) {
1796
- if let Some(capture) = &plan.session_capture {
1797
- let native = serde_json::json!({
1798
- "expected_session_id": capture.expected_session_id,
1799
- "provider_projects_root": capture.provider_projects_root,
1800
- "spawn_cwd": capture.spawn_cwd,
1801
- "spawned_at": capture.spawned_at,
1802
- "pane_id": receiver.get("pane_id"),
1803
- "tmux_socket": receiver.get("tmux_socket"),
1804
- "leader_session_uuid": receiver.get("leader_session_uuid"),
1805
- "owner_epoch": receiver.get("owner_epoch"),
1806
- });
1807
- receiver["native_session"] = native;
1808
- }
1809
- }
1810
-
1811
- fn persist_managed_leader_binding(
1812
- plan: &LeaderStartPlan,
1813
- workspace: &Path,
1814
- spawned: &SpawnResult,
1815
- ) -> Result<(), LeaderError> {
1816
- let identity = plan
1817
- .identity
1818
- .as_ref()
1819
- .ok_or_else(|| LeaderError::Start("managed leader identity missing".to_string()))?;
1820
- let mut state = crate::state::persist::load_runtime_state(workspace)
1821
- .unwrap_or_else(|_| serde_json::json!({}));
1822
- let team_key = identity.team_id.as_str().to_string();
1823
- let existing_recv = state
1824
- .get("teams")
1825
- .and_then(|teams| teams.get(&team_key))
1826
- .and_then(|team| team.get("leader_receiver"))
1827
- .cloned();
1828
- let now = chrono::Utc::now().to_rfc3339();
1829
- let socket = crate::tmux_backend::socket_path_for_workspace(workspace)
1830
- .map(|path| path.to_string_lossy().to_string())
1831
- .unwrap_or_else(|| crate::tmux_backend::socket_name_for_workspace(workspace));
1832
- let provider = serde_json::to_value(plan.provider)?;
1833
- let session = spawned.session.as_str().to_string();
1834
- let window = spawned.window.as_str().to_string();
1835
- let pane = spawned.pane_id.as_str().to_string();
1836
- let keep_existing_scalar = existing_recv
1837
- .as_ref()
1838
- .and_then(|recv| recv.get("pane_id"))
1839
- .and_then(serde_json::Value::as_str)
1840
- .is_some_and(|old| old != pane);
1841
- let current_epoch = state
1842
- .get("owner_epoch")
1843
- .and_then(serde_json::Value::as_u64)
1844
- .or_else(|| {
1845
- state
1846
- .get("team_owner")
1847
- .and_then(|owner| owner.get("owner_epoch"))
1848
- .and_then(serde_json::Value::as_u64)
1849
- })
1850
- .unwrap_or(0);
1851
- let owner_epoch = if keep_existing_scalar {
1852
- existing_recv
1853
- .as_ref()
1854
- .and_then(|recv| recv.get("owner_epoch"))
1855
- .and_then(serde_json::Value::as_u64)
1856
- .unwrap_or(current_epoch)
1857
- } else {
1858
- current_epoch.saturating_add(1)
1859
- };
1860
- let attach_mode = if plan.argv.iter().any(|arg| arg == "switch-client") {
1861
- "switch-client"
1862
- } else {
1863
- "attach-session"
1864
- };
1865
- let new_binding = bound_pane_snapshot(
1866
- &pane,
1867
- &serde_json::json!(session),
1868
- &serde_json::json!(window),
1869
- &serde_json::json!(socket),
1870
- );
1871
- let bound_panes = merge_bound_panes(existing_recv.as_ref(), new_binding);
1872
- let existing_owner = state
1873
- .get("teams")
1874
- .and_then(|teams| teams.get(&team_key))
1875
- .and_then(|team| team.get("team_owner"))
1876
- .cloned();
1877
- let keep_field = |existing: Option<&serde_json::Value>, key: &str, fallback: serde_json::Value| {
1878
- existing
1879
- .and_then(|value| value.get(key))
1880
- .cloned()
1881
- .unwrap_or(fallback)
1882
- };
1883
- let (scalar_pane, scalar_session, scalar_window, scalar_attached_at) =
1884
- match existing_recv.as_ref() {
1885
- Some(recv) if keep_existing_scalar => (
1886
- recv.get("pane_id")
1887
- .and_then(serde_json::Value::as_str)
1888
- .unwrap_or(pane.as_str())
1889
- .to_string(),
1890
- recv.get("session_name")
1891
- .cloned()
1892
- .unwrap_or_else(|| serde_json::json!(session)),
1893
- recv.get("window_name")
1894
- .cloned()
1895
- .unwrap_or_else(|| serde_json::json!(window)),
1896
- recv.get("attached_at")
1897
- .and_then(serde_json::Value::as_str)
1898
- .unwrap_or(now.as_str())
1899
- .to_string(),
1900
- ),
1901
- _ => (
1902
- pane.clone(),
1903
- serde_json::json!(session),
1904
- serde_json::json!(window),
1905
- now.clone(),
1906
- ),
1907
- };
1908
- let leader_session_uuid = if keep_existing_scalar {
1909
- keep_field(
1910
- existing_recv.as_ref(),
1911
- "leader_session_uuid",
1912
- serde_json::json!(identity.leader_session_uuid),
1913
- )
1914
- } else {
1915
- serde_json::json!(identity.leader_session_uuid)
1916
- };
1917
- let discovery = if keep_existing_scalar {
1918
- keep_field(
1919
- existing_recv.as_ref(),
1920
- "discovery",
1921
- serde_json::json!("managed_launcher"),
1922
- )
1923
- } else {
1924
- serde_json::json!("managed_launcher")
1925
- };
1926
- let mut receiver = serde_json::json!({
1927
- "mode": "direct_tmux",
1928
- "status": "attached",
1929
- "provider": provider.clone(),
1930
- "pane_id": scalar_pane,
1931
- "pane": scalar_pane,
1932
- "session_name": scalar_session,
1933
- "window_name": scalar_window,
1934
- "tmux_socket": socket,
1935
- "leader_session_uuid": leader_session_uuid.clone(),
1936
- "owner_epoch": owner_epoch,
1937
- "attached_at": scalar_attached_at,
1938
- "discovery": discovery,
1939
- "bound_panes": bound_panes,
1940
- });
1941
- if keep_existing_scalar {
1942
- for key in ["native_session", "rollout_path"] {
1943
- if let Some(value) = existing_recv.as_ref().and_then(|old| old.get(key)) {
1944
- receiver[key] = value.clone();
1945
- }
1946
- }
1947
- } else {
1948
- bind_plan_session(&mut receiver, plan);
1949
- }
1950
- let owner_uuid = if keep_existing_scalar {
1951
- keep_field(
1952
- existing_owner.as_ref(),
1953
- "leader_session_uuid",
1954
- leader_session_uuid.clone(),
1955
- )
1956
- } else {
1957
- leader_session_uuid.clone()
1958
- };
1959
- let claimed_via = if keep_existing_scalar {
1960
- keep_field(
1961
- existing_owner.as_ref(),
1962
- "claimed_via",
1963
- serde_json::json!("claim-leader"),
1964
- )
1965
- } else {
1966
- serde_json::json!("claim-leader")
1967
- };
1968
- let claimed_at = if keep_existing_scalar {
1969
- keep_field(existing_owner.as_ref(), "claimed_at", serde_json::json!(now))
1970
- } else {
1971
- serde_json::json!(now)
1972
- };
1973
- let owner = serde_json::json!({
1974
- "pane_id": scalar_pane,
1975
- "provider": provider.clone(),
1976
- "machine_fingerprint": identity.machine_fingerprint,
1977
- "leader_session_uuid": owner_uuid,
1978
- "owner_epoch": owner_epoch,
1979
- "claimed_at": claimed_at,
1980
- "claimed_via": claimed_via,
1981
- "os_user": identity.os_user,
1982
- });
1983
- if let Some(obj) = state.as_object_mut() {
1984
- // unit-4 (Stage 1) ROOT CAUSE FIX of 0.3.39 leader mis-kill:
1985
- //
1986
- // BEFORE: `obj.insert("session_name", json!(session));` wrote the
1987
- // leader launcher session (always `team-agent-leader-*`) into the
1988
- // top-level worker-session-name field, hijacking the identity used
1989
- // by restart/shutdown when they decided what tmux session to kill.
1990
- //
1991
- // AFTER: the launcher session is recorded ONLY in
1992
- // `leader_receiver.session_name` (the `receiver` block above) and
1993
- // `team_owner.pane_id`. The top-level `state.session_name` keeps
1994
- // whatever value the worker quick-start put there (the real worker
1995
- // session). If the workspace has never been quick-started yet
1996
- // (no `session_name` field at all), we leave the field absent —
1997
- // restart and shutdown have safe default branches for that case.
1998
- //
1999
- // unit-3's preflight is the belt-and-suspenders backstop: even if a
2000
- // future regression reintroduces this overwrite, restart now refuses
2001
- // before killing a leader-prefixed session_name.
2002
- if !crate::layout::sessions::LEADER_SESSION_PREFIX.is_empty()
2003
- && session.starts_with(crate::layout::sessions::LEADER_SESSION_PREFIX)
2004
- {
2005
- // Explicit: skip the overwrite for leader-prefixed launcher
2006
- // sessions. The receiver block records the launcher session in
2007
- // its proper home (`leader_receiver.session_name`).
2008
- } else {
2009
- obj.insert("session_name".to_string(), serde_json::json!(session));
2010
- }
2011
- obj.insert(
2012
- "active_team_key".to_string(),
2013
- serde_json::json!(identity.team_id.as_str()),
2014
- );
2015
- obj.insert("tmux_socket".to_string(), serde_json::json!(socket));
2016
- obj.insert("is_external_leader".to_string(), serde_json::json!(false));
2017
- obj.insert(
2018
- "leader_client".to_string(),
2019
- serde_json::json!({
2020
- "diagnostic_only": true,
2021
- "attach_mode": attach_mode,
2022
- "tmux": std::env::var("TMUX").ok(),
2023
- }),
2024
- );
2025
- }
2026
- // Stage 3a/d (identity-boundary unified plan, architect direction
2027
- // 2026-06-23): build the teams.<key> entry from the non-owner fields
2028
- // of state (compact_team_state strips the `teams` key), then publish
2029
- // the canonical owner record AFTER teams.insert so write_owner's
2030
- // teams.<key>.{team_owner,leader_receiver,owner_epoch} is the final
2031
- // word and doesn't get overwritten by the compacted entry.
2032
- let entry = crate::state::projection::compact_team_state(&state);
2033
- if let Some(obj) = state.as_object_mut() {
2034
- let teams = obj
2035
- .entry("teams".to_string())
2036
- .or_insert_with(|| serde_json::json!({}));
2037
- if let Some(teams) = teams.as_object_mut() {
2038
- teams.insert(identity.team_id.as_str().to_string(), entry);
2039
- }
2040
- }
2041
- let record = crate::state::ownership::OwnershipWrite::new()
2042
- .with_leader_receiver(receiver)
2043
- .with_team_owner(owner)
2044
- .with_owner_epoch(owner_epoch);
2045
- crate::state::ownership::write_owner(&mut state, identity.team_id.as_str(), record);
2046
- crate::state::repository::StateRepository::new(workspace).save(
2047
- crate::state::repository::StateWriteIntent::LeaderStartBinding {
2048
- team_key: identity.team_id.as_str(),
2049
- transport_kind: "managed",
2050
- },
2051
- &state,
2052
- )?;
2053
- Ok(())
2054
- }
2055
-
2056
- fn persist_exec_provider_leader_binding(
2057
- plan: &LeaderStartPlan,
2058
- workspace: &Path,
2059
- authority: &VerifiedAmbientPaneAuthority,
2060
- is_external_leader: bool,
2061
- ) -> Result<(), LeaderError> {
2062
- let identity = plan
2063
- .identity
2064
- .as_ref()
2065
- .ok_or_else(|| LeaderError::Start("exec provider leader identity missing".to_string()))?;
2066
- let pane = authority.pane_id.as_str();
2067
- let target = &authority.observed;
2068
- let mut state = crate::state::persist::load_runtime_state(workspace)
2069
- .unwrap_or_else(|_| serde_json::json!({}));
2070
- let owner_epoch = state
2071
- .get("owner_epoch")
2072
- .and_then(serde_json::Value::as_u64)
2073
- .or_else(|| {
2074
- state
2075
- .get("team_owner")
2076
- .and_then(|owner| owner.get("owner_epoch"))
2077
- .and_then(serde_json::Value::as_u64)
2078
- })
2079
- .unwrap_or(0)
2080
- .saturating_add(1);
2081
- let now = chrono::Utc::now().to_rfc3339();
2082
- let socket = authority.endpoint.as_str();
2083
- let provider = serde_json::to_value(plan.provider)?;
2084
- let mut receiver = serde_json::json!({
2085
- "mode": "direct_tmux",
2086
- "status": "attached",
2087
- "provider": provider.clone(),
2088
- "pane_id": pane,
2089
- "pane": pane,
2090
- "leader_session_uuid": identity.leader_session_uuid,
2091
- "owner_epoch": owner_epoch,
2092
- "attached_at": now,
2093
- "discovery": "current_pane",
2094
- });
2095
- if let Some(obj) = receiver.as_object_mut() {
2096
- obj.insert(
2097
- "session_name".to_string(),
2098
- serde_json::json!(target.session.as_str()),
2099
- );
2100
- if let Some(window_name) = target.window_name.as_ref() {
2101
- obj.insert(
2102
- "window_name".to_string(),
2103
- serde_json::json!(window_name.as_str()),
2104
- );
2105
- }
2106
- obj.insert("tmux_socket".to_string(), serde_json::json!(socket));
2107
- }
2108
- bind_plan_session(&mut receiver, plan);
2109
- let owner = serde_json::json!({
2110
- "pane_id": pane,
2111
- "provider": provider.clone(),
2112
- "machine_fingerprint": identity.machine_fingerprint,
2113
- "leader_session_uuid": identity.leader_session_uuid,
2114
- "owner_epoch": owner_epoch,
2115
- "claimed_at": now,
2116
- "claimed_via": "claim-leader",
2117
- "os_user": identity.os_user,
2118
- });
2119
- if let Some(obj) = state.as_object_mut() {
2120
- obj.insert(
2121
- "active_team_key".to_string(),
2122
- serde_json::json!(identity.team_id.as_str()),
2123
- );
2124
- // The ambient session identifies the leader receiver, not workers.
2125
- // Leave any existing worker session untouched, including unknown state.
2126
- obj.insert("tmux_endpoint".to_string(), serde_json::json!(socket));
2127
- obj.insert("tmux_socket".to_string(), serde_json::json!(socket));
2128
- obj.insert(
2129
- "is_external_leader".to_string(),
2130
- serde_json::json!(is_external_leader),
2131
- );
2132
- obj.insert(
2133
- "leader_client".to_string(),
2134
- serde_json::json!({
2135
- "diagnostic_only": true,
2136
- "attach_mode": "exec-provider",
2137
- "tmux": authority.tmux.as_str(),
2138
- }),
2139
- );
2140
- }
2141
- // Stage 3a/d (identity-boundary unified plan, architect direction
2142
- // 2026-06-23): compact-then-write-owner ordering as in
2143
- // persist_managed_leader_binding above. write_owner must be the final
2144
- // write so the canonical teams.<key> owner record survives.
2145
- let entry = crate::state::projection::compact_team_state(&state);
2146
- if let Some(obj) = state.as_object_mut() {
2147
- let teams = obj
2148
- .entry("teams".to_string())
2149
- .or_insert_with(|| serde_json::json!({}));
2150
- if let Some(teams) = teams.as_object_mut() {
2151
- teams.insert(identity.team_id.as_str().to_string(), entry);
2152
- }
2153
- }
2154
- let record = crate::state::ownership::OwnershipWrite::new()
2155
- .with_leader_receiver(receiver)
2156
- .with_team_owner(owner)
2157
- .with_owner_epoch(owner_epoch);
2158
- crate::state::ownership::write_owner(&mut state, identity.team_id.as_str(), record);
2159
- crate::state::repository::StateRepository::new(workspace).save(
2160
- crate::state::repository::StateWriteIntent::LeaderStartBinding {
2161
- team_key: identity.team_id.as_str(),
2162
- transport_kind: "exec_provider",
2163
- },
2164
- &state,
2165
- )?;
2166
- Ok(())
2167
- }
2168
-
2169
- /// 0.5.35 (`.team/artifacts/managed-leader-provider-reentry-locate.md` §5/§6):
2170
- /// three-way classification of an in-tmux ExecProvider invocation. Physical-
2171
- /// channel-first — never consults `pane_current_command` or gates on
2172
- /// `leader_session_uuid` equality (§6 forbids uuid-mismatch hard refusal).
2173
- enum ExecProviderBinding {
2174
- ManagedReentry,
2175
- DifferentPaneAlreadyBound,
2176
- Unbound,
2177
- }
2178
-
2179
- fn classify_exec_provider_binding(
2180
- workspace: &Path,
2181
- plan: &LeaderStartPlan,
2182
- authority: &VerifiedAmbientPaneAuthority,
2183
- ) -> Result<ExecProviderBinding, LeaderError> {
2184
- let pane = authority.pane_id.as_str();
2185
- let state = match crate::state::persist::load_runtime_state(workspace) {
2186
- Ok(state) => state,
2187
- Err(_) => return Ok(ExecProviderBinding::Unbound),
2188
- };
2189
- let team_key = plan
2190
- .identity
2191
- .as_ref()
2192
- .map(|identity| identity.team_id.as_str().to_string())
2193
- .or_else(|| {
2194
- state
2195
- .get("active_team_key")
2196
- .and_then(serde_json::Value::as_str)
2197
- .filter(|s| !s.is_empty())
2198
- .map(str::to_string)
2199
- });
2200
- let Some(team_key) = team_key else {
2201
- return Ok(ExecProviderBinding::Unbound);
2202
- };
2203
- let Some(receiver) = state
2204
- .pointer(&format!("/teams/{team_key}/leader_receiver"))
2205
- .and_then(serde_json::Value::as_object)
2206
- else {
2207
- return Ok(ExecProviderBinding::Unbound);
2208
- };
2209
- let receiver_pane = receiver
2210
- .get("pane_id")
2211
- .or_else(|| receiver.get("pane"))
2212
- .and_then(serde_json::Value::as_str)
2213
- .unwrap_or("");
2214
- if receiver_pane.is_empty() {
2215
- return Ok(ExecProviderBinding::Unbound);
2216
- }
2217
- if receiver_pane != pane {
2218
- return Ok(ExecProviderBinding::DifferentPaneAlreadyBound);
2219
- }
2220
- let leader_prefixed_session = authority
2221
- .observed
2222
- .session
2223
- .as_str()
2224
- .starts_with(LEADER_SESSION_PREFIX);
2225
- if !leader_prefixed_session {
2226
- return Ok(ExecProviderBinding::DifferentPaneAlreadyBound);
2227
- }
2228
- let recorded_socket = receiver
2229
- .get("tmux_socket")
2230
- .and_then(serde_json::Value::as_str)
2231
- .filter(|s| !s.is_empty());
2232
- if let Some(recorded_socket) = recorded_socket {
2233
- if authority.endpoint != recorded_socket {
2234
- return Ok(ExecProviderBinding::DifferentPaneAlreadyBound);
2235
- }
2236
- }
2237
- Ok(ExecProviderBinding::ManagedReentry)
2238
- }
2239
-
2240
- /// 0.5.35: same-pane provider re-entry refresh path. Preserves canonical
2241
- /// team runtime identity (`session_name`/`team_dir`/`spec_path`/`agents`/
2242
- /// `tasks`) and epoch non-regressively; updates only diagnostic receiver
2243
- /// fields. Stage 3 strip preserved (root `team_owner`/`leader_receiver`/
2244
- /// `owner_epoch` are NOT reintroduced — writes go through
2245
- /// `state::ownership::write_owner` into the canonical teams.<key> slot).
2246
- fn refresh_managed_leader_provider_binding(
2247
- plan: &LeaderStartPlan,
2248
- workspace: &Path,
2249
- authority: &VerifiedAmbientPaneAuthority,
2250
- ) -> Result<(), LeaderError> {
2251
- let identity = plan.identity.as_ref().ok_or_else(|| {
2252
- LeaderError::Start("managed leader re-entry identity missing".to_string())
2253
- })?;
2254
- let pane = authority.pane_id.as_str();
2255
- let target = &authority.observed;
2256
- let mut state = crate::state::persist::load_runtime_state(workspace)
2257
- .unwrap_or_else(|_| serde_json::json!({}));
2258
- let team_key = identity.team_id.as_str();
2259
- let existing_receiver = state
2260
- .pointer(&format!("/teams/{team_key}/leader_receiver"))
2261
- .cloned()
2262
- .unwrap_or_else(|| serde_json::json!({}));
2263
- let existing_owner = crate::state::ownership::read_owner_value(&state, team_key)
2264
- .cloned()
2265
- .unwrap_or_else(|| serde_json::json!({}));
2266
- let existing_epoch = state
2267
- .pointer(&format!("/teams/{team_key}/owner_epoch"))
2268
- .and_then(serde_json::Value::as_u64)
2269
- .or_else(|| {
2270
- existing_owner
2271
- .get("owner_epoch")
2272
- .and_then(serde_json::Value::as_u64)
2273
- })
2274
- .or_else(|| {
2275
- existing_receiver
2276
- .get("owner_epoch")
2277
- .and_then(serde_json::Value::as_u64)
2278
- })
2279
- .unwrap_or(0);
2280
- let now = chrono::Utc::now().to_rfc3339();
2281
- let provider = serde_json::to_value(plan.provider)?;
2282
- let mut receiver = match existing_receiver.as_object() {
2283
- Some(map) => serde_json::Value::Object(map.clone()),
2284
- None => serde_json::json!({}),
2285
- };
2286
- if let Some(obj) = receiver.as_object_mut() {
2287
- obj.insert("mode".to_string(), serde_json::json!("direct_tmux"));
2288
- obj.insert("status".to_string(), serde_json::json!("attached"));
2289
- obj.insert("provider".to_string(), provider.clone());
2290
- obj.insert("pane_id".to_string(), serde_json::json!(pane));
2291
- obj.insert("pane".to_string(), serde_json::json!(pane));
2292
- obj.insert("attached_at".to_string(), serde_json::json!(now.clone()));
2293
- obj.insert("discovery".to_string(), serde_json::json!("managed_leader"));
2294
- obj.insert("owner_epoch".to_string(), serde_json::json!(existing_epoch));
2295
- obj.entry("leader_session_uuid".to_string())
2296
- .or_insert_with(|| serde_json::json!(identity.leader_session_uuid.as_str()));
2297
- obj.insert(
2298
- "session_name".to_string(),
2299
- serde_json::json!(target.session.as_str()),
2300
- );
2301
- if let Some(window_name) = target.window_name.as_ref() {
2302
- obj.insert(
2303
- "window_name".to_string(),
2304
- serde_json::json!(window_name.as_str()),
2305
- );
2306
- }
2307
- if let Some(pane_pid) = target.pane_pid {
2308
- obj.insert("pane_pid".to_string(), serde_json::json!(pane_pid));
2309
- }
2310
- }
2311
- let mut owner = match existing_owner.as_object() {
2312
- Some(map) => serde_json::Value::Object(map.clone()),
2313
- None => serde_json::json!({}),
2314
- };
2315
- if let Some(obj) = owner.as_object_mut() {
2316
- obj.insert("pane_id".to_string(), serde_json::json!(pane));
2317
- obj.insert("provider".to_string(), provider);
2318
- obj.insert("owner_epoch".to_string(), serde_json::json!(existing_epoch));
2319
- obj.entry("machine_fingerprint".to_string())
2320
- .or_insert_with(|| serde_json::json!(identity.machine_fingerprint.as_str()));
2321
- obj.entry("leader_session_uuid".to_string())
2322
- .or_insert_with(|| serde_json::json!(identity.leader_session_uuid.as_str()));
2323
- obj.entry("claimed_via".to_string())
2324
- .or_insert_with(|| serde_json::json!("claim-leader"));
2325
- obj.entry("os_user".to_string())
2326
- .or_insert_with(|| serde_json::json!(identity.os_user.as_str()));
2327
- }
2328
- if let Some(obj) = state.as_object_mut() {
2329
- obj.insert("active_team_key".to_string(), serde_json::json!(team_key));
2330
- obj.insert(
2331
- "leader_client".to_string(),
2332
- serde_json::json!({
2333
- "diagnostic_only": true,
2334
- "attach_mode": "exec-provider",
2335
- "tmux": authority.tmux.as_str(),
2336
- "reentry": true,
2337
- }),
2338
- );
2339
- }
2340
- let record = crate::state::ownership::OwnershipWrite::new()
2341
- .with_leader_receiver(receiver)
2342
- .with_team_owner(owner)
2343
- .with_owner_epoch(existing_epoch);
2344
- crate::state::ownership::write_owner(&mut state, team_key, record);
2345
- crate::state::repository::StateRepository::new(workspace).save(
2346
- crate::state::repository::StateWriteIntent::LeaderStartBinding {
2347
- team_key,
2348
- transport_kind: "managed_reentry",
2349
- },
2350
- &state,
2351
- )?;
2352
- Ok(())
2353
- }
2354
-
2355
- enum CurrentTmuxPaneInfoError {
2356
- QueryFailed,
2357
- PaneNotFound,
2358
- }
2359
-
2360
- fn current_tmux_pane_info(
2361
- pane_id: &PaneId,
2362
- endpoint: &str,
2363
- ) -> Result<crate::transport::PaneInfo, CurrentTmuxPaneInfoError> {
2364
- crate::transport_factory::tmux_endpoint_transport(endpoint)
2365
- .list_targets()
2366
- .map_err(|_| CurrentTmuxPaneInfoError::QueryFailed)?
2367
- .into_iter()
2368
- .find(|target| target.pane_id == *pane_id)
2369
- .ok_or(CurrentTmuxPaneInfoError::PaneNotFound)
2370
- }
2371
-
2372
- fn persist_external_leader_topology_marker(
2373
- plan: &LeaderStartPlan,
2374
- workspace: &Path,
2375
- ) -> Result<(), LeaderError> {
2376
- let identity = plan
2377
- .identity
2378
- .as_ref()
2379
- .ok_or_else(|| LeaderError::Start("external leader identity missing".to_string()))?;
2380
- let mut state = crate::state::persist::load_runtime_state(workspace)
2381
- .unwrap_or_else(|_| serde_json::json!({}));
2382
- if let Some(obj) = state.as_object_mut() {
2383
- obj.entry("workspace".to_string()).or_insert_with(|| {
2384
- serde_json::json!(resolve_workspace_for_hash(workspace)
2385
- .to_string_lossy()
2386
- .to_string())
2387
- });
2388
- obj.entry("active_team_key".to_string())
2389
- .or_insert_with(|| serde_json::json!(identity.team_id.as_str()));
2390
- if let Some(session) = plan.session_name.as_ref() {
2391
- obj.entry("session_name".to_string())
2392
- .or_insert_with(|| serde_json::json!(session.as_str()));
2393
- }
2394
- obj.insert("is_external_leader".to_string(), serde_json::json!(true));
2395
- }
2396
- let entry = crate::state::projection::compact_team_state(&state);
2397
- if let Some(obj) = state.as_object_mut() {
2398
- let teams = obj
2399
- .entry("teams".to_string())
2400
- .or_insert_with(|| serde_json::json!({}));
2401
- if let Some(teams) = teams.as_object_mut() {
2402
- teams.insert(identity.team_id.as_str().to_string(), entry);
2403
- }
2404
- }
2405
- crate::state::repository::StateRepository::new(workspace).save(
2406
- crate::state::repository::StateWriteIntent::LeaderStartBinding {
2407
- team_key: identity.team_id.as_str(),
2408
- transport_kind: "external",
2409
- },
2410
- &state,
2411
- )?;
2412
- Ok(())
2413
- }
2414
-
2415
- fn insert_detach_flag(argv: &mut Vec<String>) -> bool {
2416
- if argv.iter().any(|arg| arg == "-d") {
2417
- return false;
2418
- }
2419
- let Some(pos) = argv.iter().position(|arg| arg == "new-session") else {
2420
- return false;
2421
- };
2422
- argv.insert(pos + 1, "-d".to_string());
2423
- true
2424
- }
2425
-
2426
- fn run_leader_argv(
2427
- argv: &[String],
2428
- env: &BTreeMap<String, String>,
2429
- plan: &LeaderStartPlan,
2430
- workspace: &Path,
2431
- managed_watch: Option<ManagedAttachWatch<'_>>,
2432
- ) -> Result<LeaderProcessExit, LeaderError> {
2433
- let Some(program) = argv.first() else {
2434
- return Err(LeaderError::Start(
2435
- "leader launch argv is empty".to_string(),
2436
- ));
2437
- };
2438
- let diagnostics_path = launcher_diagnostics_path(workspace);
2439
- if let Err(error) = write_launcher_diagnostics_header(&diagnostics_path, plan, argv) {
2440
- return Err(LeaderError::Start(format!(
2441
- "leader launcher diagnostics unavailable; startup_stage=diagnostics_create; launcher_diagnostics={}; error={error}",
2442
- diagnostics_path.display()
2443
- )));
2444
- }
2445
- // 0.4.x regression fix (env-leak scenario 1, in-tmux ExecProvider path):
2446
- // the managed-tmux path got the provider env-unset block via the shell
2447
- // wrapper (cb9c217), but the ExecProvider in-tmux path here is a direct
2448
- // Command::spawn().wait() — it inherits the parent process's full env
2449
- // including any CLAUDE_CODE_SESSION_ID / CLAUDE_CODE_CHILD_SESSION /
2450
- // CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS / CLAUDE_CODE_ENTRYPOINT /
2451
- // CLAUDE_CODE_EXECPATH / CLAUDECODE that the launching shell carries.
2452
- // Apply the SAME env-unset list used by the managed path (CR R6 single
2453
- // source: profile_launch::provider_env_unsets via
2454
- // leader_env_unset_for_provider).
2455
- let env_unset = leader_env_unset_for_provider(plan.provider);
2456
- let mut command = Command::new(program);
2457
- command.args(argv.iter().skip(1)).stdin(Stdio::inherit());
2458
- let capture_stdout = !std::io::stdout().is_terminal();
2459
- command.stdout(if capture_stdout {
2460
- Stdio::piped()
2461
- } else {
2462
- Stdio::inherit()
2463
- });
2464
- let capture_stderr =
2465
- plan.mode != LeaderStartMode::ExecProvider || !std::io::stderr().is_terminal();
2466
- command.stderr(if capture_stderr {
2467
- Stdio::piped()
2468
- } else {
2469
- Stdio::inherit()
2470
- });
2471
- // 0.4.x order fix: env_remove MUST run AFTER envs(). The `env` map comes
2472
- // from `merged_exec_env` which seeds with `std::env::vars().collect()` —
2473
- // calling `.envs(env)` re-adds every inherited CLAUDE_CODE_* the launching
2474
- // shell carried, overwriting any prior env_remove. By removing AFTER the
2475
- // bulk envs() call, the final Command env table has the leak keys
2476
- // structurally absent. Verified by the regression grep guard that the
2477
- // env_remove call appears AFTER `command.envs(env)`.
2478
- command.envs(env);
2479
- for key in &env_unset {
2480
- command.env_remove(key);
2481
- }
2482
- if plan.mode == LeaderStartMode::ManagedTmuxClient
2483
- && argv.iter().any(|arg| arg == "attach-session")
2484
- {
2485
- command.env_remove("TMUX");
2486
- command.env_remove("TMUX_PANE");
2487
- }
2488
- let mut child = command.spawn().map_err(|error| {
2489
- LeaderError::Start(format!(
2490
- "leader launcher spawn failed; startup_stage=spawn; launcher_diagnostics={}; error={error}",
2491
- diagnostics_path.display()
2492
- ))
2493
- })?;
2494
- append_launcher_diagnostics(&diagnostics_path, "startup_stage=spawned\n").map_err(|error| {
2495
- LeaderError::Start(format!(
2496
- "leader launcher diagnostics write failed; startup_stage=spawned; launcher_diagnostics={}; error={error}",
2497
- diagnostics_path.display()
2498
- ))
2499
- })?;
2500
- // Captured transport diagnostics can echo the shell argv carrying the
2501
- // prompt. Do not tee those bytes before redaction. Native ExecProvider
2502
- // business streams and inherited TTY stdout keep their existing behavior.
2503
- let withhold_transport_output = plan.leader_prompt.is_some()
2504
- && plan.mode != LeaderStartMode::ExecProvider;
2505
- let stdout_reader = child.stdout.take().map(|mut child_stdout| {
2506
- std::thread::spawn(move || {
2507
- let mut captured = Vec::new();
2508
- let mut buf = [0_u8; 4096];
2509
- loop {
2510
- let Ok(read) = child_stdout.read(&mut buf) else {
2511
- break;
2512
- };
2513
- if read == 0 {
2514
- break;
2515
- }
2516
- if !withhold_transport_output {
2517
- let _ = std::io::stdout().write_all(&buf[..read]);
2518
- }
2519
- captured.extend_from_slice(&buf[..read]);
2520
- }
2521
- captured
2522
- })
2523
- });
2524
- let stderr_reader = child.stderr.take().map(|mut child_stderr| {
2525
- std::thread::spawn(move || {
2526
- let mut captured = Vec::new();
2527
- let mut buf = [0_u8; 4096];
2528
- loop {
2529
- let Ok(read) = child_stderr.read(&mut buf) else {
2530
- break;
2531
- };
2532
- if read == 0 {
2533
- break;
2534
- }
2535
- if !withhold_transport_output {
2536
- let _ = std::io::stderr().write_all(&buf[..read]);
2537
- }
2538
- captured.extend_from_slice(&buf[..read]);
2539
- }
2540
- captured
2541
- })
2542
- });
2543
- if plan.mode == LeaderStartMode::ExecProvider {
2544
- spawn_exec_provider_startup_prompt_handler(plan.provider, workspace.to_path_buf());
2545
- }
2546
- #[cfg(unix)]
2547
- let _term_guard = managed_watch.as_ref().map(|_| ManagedTermGuard::install());
2548
- let (status, intentional_teardown) = if let Some(watch) = managed_watch.as_ref() {
2549
- wait_managed_attach_child(&mut child, watch)?
2550
- } else {
2551
- (child.wait().map_err(LeaderError::Io)?, false)
2552
- };
2553
- let stdout = match stdout_reader {
2554
- Some(reader) => match reader.join() {
2555
- Ok(bytes) => String::from_utf8_lossy(&bytes).into_owned(),
2556
- Err(_) => String::new(),
2557
- },
2558
- None => String::new(),
2559
- };
2560
- let stderr = match stderr_reader {
2561
- Some(reader) => match reader.join() {
2562
- Ok(bytes) => String::from_utf8_lossy(&bytes).into_owned(),
2563
- Err(_) => String::new(),
2564
- },
2565
- None => String::new(),
2566
- };
2567
- append_launcher_diagnostics(
2568
- &diagnostics_path,
2569
- &format!(
2570
- "startup_stage=exited\nexit_code={}\nchild_stdout={}\nchild_stderr={}\n",
2571
- status
2572
- .code()
2573
- .map(|code| code.to_string())
2574
- .unwrap_or_else(|| "signal".to_string()),
2575
- prompt_aware_diagnostic_text(plan, &stdout),
2576
- prompt_aware_diagnostic_text(plan, &stderr),
2577
- ),
2578
- )
2579
- .map_err(|error| {
2580
- LeaderError::Start(format!(
2581
- "leader launcher diagnostics write failed; startup_stage=exited; launcher_diagnostics={}; error={error}",
2582
- diagnostics_path.display()
2583
- ))
2584
- })?;
2585
- let stderr = if plan.leader_prompt.is_some() {
2586
- prompt_aware_diagnostic_text(plan, &stderr)
2587
- } else {
2588
- stderr
2589
- };
2590
- Ok(LeaderProcessExit {
2591
- status,
2592
- stderr,
2593
- diagnostics_path,
2594
- intentional_teardown,
2595
- })
2596
- }
2597
-
2598
- fn wait_managed_attach_child(
2599
- child: &mut std::process::Child,
2600
- watch: &ManagedAttachWatch<'_>,
2601
- ) -> Result<(std::process::ExitStatus, bool), LeaderError> {
2602
- loop {
2603
- if let Some(status) = child.try_wait().map_err(LeaderError::Io)? {
2604
- return Ok((status, false));
2605
- }
2606
- let signalled = {
2607
- #[cfg(unix)]
2608
- {
2609
- MANAGED_ATTACH_TEARDOWN.load(Ordering::SeqCst)
2610
- }
2611
- #[cfg(not(unix))]
2612
- {
2613
- false
2614
- }
2615
- };
2616
- if signalled || managed_attach_should_teardown(watch) {
2617
- // `managed_attach_should_teardown` costs a tmux round-trip, and the
2618
- // attach child can lose that race: it dies BY ITSELF inside the
2619
- // window (`open terminal failed: not a terminal`, or a client whose
2620
- // attach was rejected). Re-check before we touch anything. A child
2621
- // that already failed on its own was never torn down by us, so it
2622
- // must NOT be reported as an intentional teardown — its non-zero
2623
- // status has to reach the launcher failure path
2624
- // (`execute_managed_leader_plan_attempt`), which is what surfaces the
2625
- // error and drives attach recovery. Only the FAILING self-exit is
2626
- // diverted: a clean self-exit keeps the pre-existing behaviour
2627
- // (cleanup + intentional teardown + exit 0), and an explicit signal
2628
- // teardown stays intentional regardless.
2629
- if !signalled {
2630
- if let Some(status) = child.try_wait().map_err(LeaderError::Io)? {
2631
- if !status.success() {
2632
- return Ok((status, false));
2633
- }
2634
- }
2635
- }
2636
- let reason = if signalled {
2637
- "launcher_signal"
2638
- } else {
2639
- "provider_exited"
2640
- };
2641
- cleanup_managed_leader_resources(
2642
- watch.transport,
2643
- watch.session,
2644
- watch.spawned,
2645
- watch.session_existed_before,
2646
- watch.workspace,
2647
- reason,
2648
- );
2649
- let status = terminate_managed_attach_child(child)?;
2650
- return Ok((status, true));
2651
- }
2652
- std::thread::sleep(Duration::from_millis(200));
2653
- }
2654
- }
2655
-
2656
- fn terminate_managed_attach_child(
2657
- child: &mut std::process::Child,
2658
- ) -> Result<std::process::ExitStatus, LeaderError> {
2659
- if let Some(status) = child.try_wait().map_err(LeaderError::Io)? {
2660
- return Ok(status);
2661
- }
2662
- #[cfg(unix)]
2663
- unsafe {
2664
- libc::kill(child.id() as i32, libc::SIGTERM);
2665
- }
2666
- for _ in 0..20 {
2667
- std::thread::sleep(Duration::from_millis(50));
2668
- if let Some(status) = child.try_wait().map_err(LeaderError::Io)? {
2669
- return Ok(status);
2670
- }
2671
- }
2672
- let _ = child.kill();
2673
- child.wait().map_err(LeaderError::Io)
2674
- }
2675
-
2676
- fn launcher_diagnostics_path(workspace: &Path) -> PathBuf {
2677
- let stamp = chrono::Utc::now().format("%Y%m%d-%H%M%S%.6f");
2678
- workspace.join(".team").join("logs").join(format!(
2679
- "launcher-diagnostics-{stamp}-{}.log",
2680
- std::process::id()
2681
- ))
2682
- }
2683
-
2684
- fn prompt_aware_diagnostic_text(plan: &LeaderStartPlan, text: &str) -> String {
2685
- if plan.leader_prompt.is_some() {
2686
- "[withheld: Leader prompt-bearing launch]".to_string()
2687
- } else {
2688
- crate::redaction::redact_external_text(text)
2689
- }
2690
- }
2691
-
2692
- fn write_launcher_diagnostics_header(
2693
- path: &Path,
2694
- plan: &LeaderStartPlan,
2695
- argv: &[String],
2696
- ) -> Result<(), std::io::Error> {
2697
- if let Some(parent) = path.parent() {
2698
- std::fs::create_dir_all(parent)?;
2699
- }
2700
- let metadata = plan
2701
- .leader_prompt
2702
- .as_ref()
2703
- .map(serde_json::to_string)
2704
- .transpose()
2705
- .map_err(|error| std::io::Error::new(std::io::ErrorKind::InvalidData, error))?
2706
- .map(|metadata| format!("leader_prompt={metadata}\n"))
2707
- .unwrap_or_default();
2708
- std::fs::write(
2709
- path,
2710
- format!(
2711
- "startup_stage=prepare\nmode={:?}\nprovider={}\nargv={}\n{}",
2712
- plan.mode,
2713
- provider_wire(plan.provider),
2714
- prompt_aware_diagnostic_text(plan, &argv.join(" ")),
2715
- metadata,
2716
- ),
2717
- )
2718
- }
2719
-
2720
- fn append_launcher_diagnostics(path: &Path, text: &str) -> Result<(), std::io::Error> {
2721
- use std::io::Write as _;
2722
- let mut file = std::fs::OpenOptions::new().append(true).open(path)?;
2723
- file.write_all(text.as_bytes())
2724
- }
2725
-
2726
- const LEADER_STDERR_LIMIT: usize = 8192;
2727
-
2728
- struct LeaderProcessExit {
2729
- status: std::process::ExitStatus,
2730
- stderr: String,
2731
- diagnostics_path: PathBuf,
2732
- intentional_teardown: bool,
2733
- }
2734
-
2735
- fn push_bounded_stderr(captured: &mut Vec<u8>, chunk: &[u8]) {
2736
- if chunk.len() >= LEADER_STDERR_LIMIT {
2737
- captured.clear();
2738
- captured.extend_from_slice(&chunk[chunk.len() - LEADER_STDERR_LIMIT..]);
2739
- return;
2740
- }
2741
- let excess = captured
2742
- .len()
2743
- .saturating_add(chunk.len())
2744
- .saturating_sub(LEADER_STDERR_LIMIT);
2745
- if excess > 0 {
2746
- captured.drain(..excess);
2747
- }
2748
- captured.extend_from_slice(chunk);
2749
- }
2750
-
2751
- fn leader_launcher_failure(process: &LeaderProcessExit) -> String {
2752
- let status = process
2753
- .status
2754
- .code()
2755
- .map(|code| code.to_string())
2756
- .unwrap_or_else(|| "signal".to_string());
2757
- format!(
2758
- "{}; startup_stage=exited; launcher_diagnostics={}",
2759
- format_launcher_failure(&status, process.status.code().is_none(), &process.stderr),
2760
- process.diagnostics_path.display()
2761
- )
2762
- }
2763
-
2764
- fn format_launcher_failure(status: &str, signaled: bool, raw_stderr: &str) -> String {
2765
- let stderr_class = classify_launcher_stderr(raw_stderr, signaled);
2766
- let stderr = bounded_stderr_text(crate::redaction::redact_external_text(raw_stderr.trim()));
2767
- let stderr = if stderr.is_empty() {
2768
- "<empty>".to_string()
2769
- } else {
2770
- stderr
2771
- };
2772
- format!(
2773
- "leader launcher exited with status {status}; stderr_class={stderr_class}; stderr_excerpt={stderr}"
2774
- )
2775
- }
2776
-
2777
- fn bounded_stderr_text(stderr: String) -> String {
2778
- if stderr.len() <= LEADER_STDERR_LIMIT {
2779
- return stderr;
2780
- }
2781
- let mut start = stderr.len() - LEADER_STDERR_LIMIT;
2782
- while !stderr.is_char_boundary(start) {
2783
- start += 1;
2784
- }
2785
- stderr[start..].to_string()
2786
- }
2787
-
2788
- fn classify_launcher_stderr(stderr: &str, signaled: bool) -> &'static str {
2789
- let stderr = stderr.to_ascii_lowercase();
2790
- if stderr.contains("server exited") {
2791
- "server_exited"
2792
- } else if stderr.contains("no server running") || stderr.contains("failed to connect to server")
2793
- {
2794
- "no_server"
2795
- } else if stderr.contains("not a terminal") {
2796
- "not_a_terminal"
2797
- } else if stderr.contains("can't find session") || stderr.contains("no sessions") {
2798
- "target_missing"
2799
- } else if signaled {
2800
- "signal"
2801
- } else {
2802
- "non_zero"
2803
- }
2804
- }
2805
-
2806
- fn spawn_exec_provider_startup_prompt_handler(provider: Provider, workspace: PathBuf) {
2807
- let Some(pane_id) = std::env::var("TMUX_PANE")
2808
- .ok()
2809
- .filter(|value| !value.trim().is_empty())
2810
- else {
2811
- write_leader_startup_prompt_event(
2812
- &workspace,
2813
- "leader.startup_prompt_skipped",
2814
- serde_json::json!({
2815
- "provider": provider_wire(provider),
2816
- "reason": "tmux_pane_missing",
2817
- "action": "skip",
2818
- }),
2819
- );
2820
- return;
2821
- };
2822
- std::thread::spawn(move || {
2823
- let transport = tmux_transport_for_current_pane();
2824
- let _ = handle_exec_provider_startup_prompts(
2825
- provider, &workspace, &pane_id, &transport, 30, 0.5,
2826
- );
2827
- });
2828
- }
2829
-
2830
- fn spawn_managed_provider_startup_prompt_handler(
2831
- provider: Provider,
2832
- workspace: PathBuf,
2833
- pane_id: String,
2834
- ) {
2835
- std::thread::spawn(move || {
2836
- // Phase 1d Batch 6: factory tmux workspace helper for
2837
- // grep-visibility. Semantics unchanged.
2838
- let transport = crate::transport_factory::tmux_workspace_transport(&workspace);
2839
- let _ = handle_exec_provider_startup_prompts(
2840
- provider, &workspace, &pane_id, &transport, 30, 0.5,
2841
- );
2842
- });
2843
- }
2844
-
2845
- fn tmux_transport_for_current_pane() -> TmuxBackend {
2846
- // Phase 1d Batch 6: factory tmux channel helpers for
2847
- // grep-visibility. Semantics unchanged; this is intentionally
2848
- // tmux-only (caller pane = tmux `$TMUX` endpoint or default socket,
2849
- // MUST-12 anchor).
2850
- crate::tmux_backend::socket_name_from_tmux_env()
2851
- .map(|endpoint| crate::transport_factory::tmux_endpoint_transport(&endpoint))
2852
- .unwrap_or_else(crate::transport_factory::tmux_default_transport)
2853
- }
2854
-
2855
- fn handle_exec_provider_startup_prompts(
2856
- provider: Provider,
2857
- workspace: &Path,
2858
- pane_id: &str,
2859
- transport: &dyn Transport,
2860
- checks: usize,
2861
- sleep_s: f64,
2862
- ) -> crate::provider::StartupPromptOutcome {
2863
- let target = Target::Pane(PaneId::new(pane_id.to_string()));
2864
- let outcome =
2865
- get_adapter(provider).handle_startup_prompts_outcome(transport, &target, checks, sleep_s);
2866
- for handled in &outcome.handled {
2867
- write_leader_startup_prompt_event(
2868
- workspace,
2869
- "leader.startup_prompt_handled",
2870
- serde_json::json!({
2871
- "provider": provider_wire(provider),
2872
- "pane_id": pane_id,
2873
- "prompt": handled.prompt,
2874
- "action": handled.action,
2875
- }),
2876
- );
2877
- }
2878
- if let Some(error) = &outcome.capture_error {
2879
- write_leader_startup_prompt_event(
2880
- workspace,
2881
- "leader.startup_prompt_capture_failed",
2882
- serde_json::json!({
2883
- "provider": provider_wire(provider),
2884
- "pane_id": pane_id,
2885
- "action": "capture",
2886
- "error": error,
2887
- }),
2888
- );
2889
- }
2890
- outcome
2891
- }
2892
-
2893
- fn write_leader_startup_prompt_event(workspace: &Path, event: &str, fields: serde_json::Value) {
2894
- let _ = crate::event_log::EventLog::new(workspace).write(event, fields);
2895
- }
2896
-
2897
- /// A-55 (window rename race): lock the freshly-spawned leader window against
2898
- /// rename — `allow-rename off` (refuse pane-internal OSC title-set renames)
2899
- /// AND `automatic-rename off` (refuse tmux's own command-driven rename). Both
2900
- /// must be set; tmux treats them as independent. Best-effort: a failure must
2901
- /// NOT abort the launcher (old tmux may lack the option) — return the outcome
2902
- /// for audit instead of propagating an error. Returns (result, tmux_stderr).
2903
- fn lock_down_window_rename(
2904
- transport: &dyn Transport,
2905
- session: &SessionName,
2906
- window: &WindowName,
2907
- ) -> (String, String) {
2908
- let allow_rename = transport.set_window_option(session, window, "allow-rename", "off");
2909
- let automatic_rename = transport.set_window_option(session, window, "automatic-rename", "off");
2910
- let (result, stderr) = match (&allow_rename, &automatic_rename) {
2911
- (Ok(()), Ok(())) => ("ok".to_string(), String::new()),
2912
- (Ok(()), Err(error)) => ("failed".to_string(), error.to_string()),
2913
- (Err(error), Ok(())) => ("failed".to_string(), error.to_string()),
2914
- (Err(a), Err(b)) => (
2915
- "failed".to_string(),
2916
- format!("allow-rename: {a}; automatic-rename: {b}"),
2917
- ),
2918
- };
2919
- (result, stderr)
2920
- }
2921
-
2922
- /// A-55: audit the rename-lockdown outcome to the event log. Failure does not
2923
- /// abort the launcher; record ok/failed + tmux stderr for regression triage.
2924
- fn write_window_rename_lockdown_event(workspace: &Path, result: &str, stderr: &str) {
2925
- write_leader_startup_prompt_event(
2926
- workspace,
2927
- "leader.launcher.window_rename_lockdown",
2928
- serde_json::json!({
2929
- "result": result,
2930
- "tmux_stderr": stderr,
2931
- }),
2932
- );
2933
- }
2934
-
2935
- fn ensure_tmux_installed() -> Result<(), LeaderError> {
2936
- match Command::new("tmux").arg("-V").output() {
2937
- Ok(output) if output.status.success() => Ok(()),
2938
- Ok(_) | Err(_) => Err(LeaderError::Start(
2939
- "tmux is not installed; install tmux 3.3+ or start the leader from an existing tmux pane"
2940
- .to_string(),
2941
- )),
2942
- }
2943
- }
2944
-
2945
- fn provider_command_name(provider: Provider) -> &'static str {
2946
- match provider {
2947
- Provider::Claude | Provider::ClaudeCode => "claude",
2948
- Provider::Codex => "codex",
2949
- // §B leader 入口接缝(设计 design.md line 40):`team-agent copilot` 启 leader
2950
- // 即 spawn 真 copilot 命令;B5 session 名前缀 `team-agent-leader-copilot-*`
2951
- // (leader/start.rs:192-204 派生)自动覆盖前缀保护。
2952
- Provider::Copilot => "copilot",
2953
- Provider::GeminiCli => "gemini",
2954
- Provider::Grok => "grok",
2955
- Provider::Pi => "pi",
2956
- Provider::Fake => "fake",
2957
- }
2958
- }
2959
-
2960
- fn tmux_session_exists(workspace: &Path, session: &SessionName) -> Result<bool, LeaderError> {
2961
- // Phase 1d Batch 6: factory tmux workspace helper for
2962
- // grep-visibility. Tmux-only anchor (managed leader session lookup).
2963
- crate::transport_factory::tmux_workspace_transport(workspace)
2964
- .has_session(session)
2965
- .map_err(|e| LeaderError::Start(format!("tmux has-session failed: {e}")))
2966
- }
2967
-
2968
- fn leader_export_assignments(leader_env: &BTreeMap<String, String>) -> Vec<String> {
2969
- [
2970
- "TEAM_AGENT_LEADER_PROVIDER",
2971
- "TEAM_AGENT_LEADER_SESSION_UUID",
2972
- "TEAM_AGENT_MACHINE_FINGERPRINT",
2973
- "TEAM_AGENT_WORKSPACE",
2974
- "TEAM_AGENT_TEAM_ID",
2975
- ]
2976
- .iter()
2977
- .filter_map(|key| {
2978
- leader_env
2979
- .get(*key)
2980
- .map(|value| shlex_quote(&format!("{key}={value}")))
2981
- })
2982
- .collect()
2983
- }
2984
-
2985
- fn merged_exec_env(leader_env: &BTreeMap<String, String>) -> BTreeMap<String, String> {
2986
- let mut env: BTreeMap<String, String> = std::env::vars().collect();
2987
- env.extend(
2988
- leader_env
2989
- .iter()
2990
- .map(|(key, value)| (key.clone(), value.clone())),
2991
- );
2992
- env
2993
- }
2994
-
2995
- fn shell_join(args: &[String]) -> String {
2996
- args.iter()
2997
- .map(|arg| shlex_quote(arg))
2998
- .collect::<Vec<_>>()
2999
- .join(" ")
3000
- }
3001
-
3002
- fn shlex_quote(raw: &str) -> String {
3003
- if !raw.is_empty()
3004
- && raw.bytes().all(|b| {
3005
- b.is_ascii_alphanumeric()
3006
- || matches!(
3007
- b,
3008
- b'@' | b'%' | b'_' | b'+' | b'=' | b':' | b',' | b'.' | b'/' | b'-'
3009
- )
3010
- })
3011
- {
3012
- raw.to_string()
3013
- } else {
3014
- format!("'{}'", raw.replace('\'', "'\"'\"'"))
3015
- }
3016
- }
3017
-
3018
- #[cfg(test)]
3019
- mod tests {
3020
- use std::collections::BTreeMap;
3021
- use std::path::Path;
3022
- use std::sync::Mutex;
3023
-
3024
- use crate::leader::{
3025
- LeaderIdentity, LeaderLaunchSocket, LeaderSessionUuidSource, LeaderStartMode,
3026
- LeaderStartPlan,
3027
- };
3028
- use crate::model::enums::PaneLiveness;
3029
- use crate::model::ids::{LeaderSessionUuid, TeamKey};
3030
- use crate::provider::{Provider, COPILOT_READY_MARKER, COPILOT_TRUST_PROMPT_MARKER};
3031
- use crate::transport::{
3032
- AttachOutcome, BackendKind, CaptureRange, CapturedText, InjectPayload, InjectReport,
3033
- InjectStage, InjectVerification, Key, PaneField, PaneId, PaneInfo, SessionName,
3034
- SetEnvOutcome, SpawnResult, SubmitVerification, Target, Transport, TransportError,
3035
- TurnVerification, WindowName,
3036
- };
3037
-
3038
- use super::{
3039
- clear_managed_leader_receiver_pane, ensure_managed_provider_live_after_attach,
3040
- execute_leader_plan_after_ambient_authority, format_launcher_failure,
3041
- handle_exec_provider_startup_prompts, is_interactive_shell_basename,
3042
- lock_down_window_rename, managed_client_argv, managed_leader_window_from_occupied,
3043
- persist_exec_provider_leader_binding, persist_managed_leader_binding,
3044
- push_bounded_stderr, shlex_quote,
3045
- write_window_rename_lockdown_event, ManagedClientAttachMode, VerifiedAmbientPaneAuthority,
3046
- LEADER_STDERR_LIMIT,
3047
- };
3048
-
3049
- struct ScriptedTransport {
3050
- screens: Mutex<Vec<String>>,
3051
- sent: Mutex<Vec<(Target, Vec<Key>)>>,
3052
- liveness: PaneLiveness,
3053
- exit_status: Option<u8>,
3054
- targets: Vec<PaneInfo>,
3055
- window_options: Mutex<Vec<(String, String)>>,
3056
- window_option_error: Mutex<Option<String>>,
3057
- kills: Mutex<Vec<String>>,
3058
- windows: Mutex<Vec<WindowName>>,
3059
- }
3060
-
3061
- impl ScriptedTransport {
3062
- fn new(screens: Vec<String>) -> Self {
3063
- Self {
3064
- screens: Mutex::new(screens),
3065
- sent: Mutex::new(Vec::new()),
3066
- liveness: PaneLiveness::Unknown,
3067
- exit_status: None,
3068
- targets: Vec::new(),
3069
- window_options: Mutex::new(Vec::new()),
3070
- window_option_error: Mutex::new(None),
3071
- kills: Mutex::new(Vec::new()),
3072
- windows: Mutex::new(Vec::new()),
3073
- }
3074
- }
3075
-
3076
- fn with_liveness(liveness: PaneLiveness) -> Self {
3077
- Self {
3078
- screens: Mutex::new(Vec::new()),
3079
- sent: Mutex::new(Vec::new()),
3080
- liveness,
3081
- exit_status: None,
3082
- targets: Vec::new(),
3083
- window_options: Mutex::new(Vec::new()),
3084
- window_option_error: Mutex::new(None),
3085
- kills: Mutex::new(Vec::new()),
3086
- windows: Mutex::new(Vec::new()),
3087
- }
3088
- }
3089
-
3090
- fn with_liveness_and_targets(liveness: PaneLiveness, targets: Vec<PaneInfo>) -> Self {
3091
- Self {
3092
- screens: Mutex::new(Vec::new()),
3093
- sent: Mutex::new(Vec::new()),
3094
- liveness,
3095
- exit_status: None,
3096
- targets,
3097
- window_options: Mutex::new(Vec::new()),
3098
- window_option_error: Mutex::new(None),
3099
- kills: Mutex::new(Vec::new()),
3100
- windows: Mutex::new(Vec::new()),
3101
- }
3102
- }
3103
-
3104
- /// A-55: a ScriptedTransport whose `set_window_option` always fails with
3105
- /// the given tmux stderr — proves the lockdown never aborts the launcher.
3106
- fn with_window_option_error(error: &str) -> Self {
3107
- Self {
3108
- screens: Mutex::new(Vec::new()),
3109
- sent: Mutex::new(Vec::new()),
3110
- liveness: PaneLiveness::Unknown,
3111
- exit_status: None,
3112
- targets: Vec::new(),
3113
- window_options: Mutex::new(Vec::new()),
3114
- window_option_error: Mutex::new(Some(error.to_string())),
3115
- kills: Mutex::new(Vec::new()),
3116
- windows: Mutex::new(Vec::new()),
3117
- }
3118
- }
3119
-
3120
- fn sent(&self) -> Vec<(Target, Vec<Key>)> {
3121
- match self.sent.lock() {
3122
- Ok(guard) => guard.clone(),
3123
- Err(poisoned) => poisoned.into_inner().clone(),
3124
- }
3125
- }
3126
-
3127
- /// All `set-window-option option value` pairs, in call order.
3128
- fn window_options(&self) -> Vec<(String, String)> {
3129
- match self.window_options.lock() {
3130
- Ok(guard) => guard.clone(),
3131
- Err(poisoned) => poisoned.into_inner().clone(),
3132
- }
3133
- }
3134
-
3135
- fn record_kill(&self, action: &str) {
3136
- match self.kills.lock() {
3137
- Ok(mut guard) => guard.push(action.to_string()),
3138
- Err(poisoned) => poisoned.into_inner().push(action.to_string()),
3139
- }
3140
- }
3141
-
3142
- fn kills(&self) -> Vec<String> {
3143
- match self.kills.lock() {
3144
- Ok(guard) => guard.clone(),
3145
- Err(poisoned) => poisoned.into_inner().clone(),
3146
- }
3147
- }
3148
- }
3149
-
3150
- impl Transport for ScriptedTransport {
3151
- fn kind(&self) -> BackendKind {
3152
- BackendKind::Tmux
3153
- }
3154
-
3155
- fn spawn_first(
3156
- &self,
3157
- _session: &SessionName,
3158
- _window: &WindowName,
3159
- _argv: &[String],
3160
- _cwd: &Path,
3161
- _env: &BTreeMap<String, String>,
3162
- ) -> Result<SpawnResult, TransportError> {
3163
- Err(TransportError::Io(std::io::Error::other(
3164
- "spawn_first not used by startup-prompt test",
3165
- )))
3166
- }
3167
-
3168
- fn spawn_into(
3169
- &self,
3170
- _session: &SessionName,
3171
- _window: &WindowName,
3172
- _argv: &[String],
3173
- _cwd: &Path,
3174
- _env: &BTreeMap<String, String>,
3175
- ) -> Result<SpawnResult, TransportError> {
3176
- Err(TransportError::Io(std::io::Error::other(
3177
- "spawn_into not used by startup-prompt test",
3178
- )))
3179
- }
3180
-
3181
- fn inject(
3182
- &self,
3183
- _target: &Target,
3184
- _payload: &InjectPayload,
3185
- _submit: Key,
3186
- _bracketed: bool,
3187
- ) -> Result<InjectReport, TransportError> {
3188
- Ok(InjectReport {
3189
- stage_reached: InjectStage::Submit,
3190
- inject_verification: InjectVerification::CaptureContainsToken,
3191
- submit_verification: SubmitVerification::EnterSentWithoutPlaceholderCheck,
3192
- turn_verification: TurnVerification::NotRequired,
3193
- attempts: 1,
3194
- submit_diagnostics: None,
3195
- })
3196
- }
3197
-
3198
- fn send_keys(&self, target: &Target, keys: &[Key]) -> Result<(), TransportError> {
3199
- match self.sent.lock() {
3200
- Ok(mut guard) => guard.push((target.clone(), keys.to_vec())),
3201
- Err(poisoned) => poisoned.into_inner().push((target.clone(), keys.to_vec())),
3202
- }
3203
- Ok(())
3204
- }
3205
-
3206
- fn capture(
3207
- &self,
3208
- _target: &Target,
3209
- range: CaptureRange,
3210
- ) -> Result<CapturedText, TransportError> {
3211
- let text = match self.screens.lock() {
3212
- Ok(mut guard) => {
3213
- if guard.is_empty() {
3214
- String::new()
3215
- } else {
3216
- guard.remove(0)
3217
- }
3218
- }
3219
- Err(poisoned) => {
3220
- let mut guard = poisoned.into_inner();
3221
- if guard.is_empty() {
3222
- String::new()
3223
- } else {
3224
- guard.remove(0)
3225
- }
3226
- }
3227
- };
3228
- Ok(CapturedText { text, range })
3229
- }
3230
-
3231
- fn query(
3232
- &self,
3233
- _target: &Target,
3234
- _field: PaneField,
3235
- ) -> Result<Option<String>, TransportError> {
3236
- Ok(None)
3237
- }
3238
-
3239
- fn liveness(&self, _pane: &PaneId) -> Result<PaneLiveness, TransportError> {
3240
- Ok(self.liveness)
3241
- }
3242
-
3243
- fn provider_exit_status(&self, _pane: &PaneId) -> Result<Option<u8>, TransportError> {
3244
- Ok(self.exit_status)
3245
- }
3246
-
3247
- fn list_targets(&self) -> Result<Vec<PaneInfo>, TransportError> {
3248
- Ok(self.targets.clone())
3249
- }
3250
-
3251
- fn has_session(&self, _session: &SessionName) -> Result<bool, TransportError> {
3252
- Ok(false)
3253
- }
3254
-
3255
- fn list_windows(&self, _session: &SessionName) -> Result<Vec<WindowName>, TransportError> {
3256
- match self.windows.lock() {
3257
- Ok(guard) => Ok(guard.clone()),
3258
- Err(poisoned) => Ok(poisoned.into_inner().clone()),
3259
- }
3260
- }
3261
-
3262
- fn set_session_env(
3263
- &self,
3264
- _session: &SessionName,
3265
- _key: &str,
3266
- _value: &str,
3267
- ) -> Result<SetEnvOutcome, TransportError> {
3268
- Ok(SetEnvOutcome::Applied)
3269
- }
3270
-
3271
- fn set_window_option(
3272
- &self,
3273
- _session: &SessionName,
3274
- _window: &WindowName,
3275
- option: &str,
3276
- value: &str,
3277
- ) -> Result<(), TransportError> {
3278
- if let Some(stderr) = self
3279
- .window_option_error
3280
- .lock()
3281
- .ok()
3282
- .and_then(|guard| guard.clone())
3283
- {
3284
- return Err(TransportError::Subprocess {
3285
- argv: vec!["tmux".to_string(), "set-window-option".to_string()],
3286
- code: Some(1),
3287
- stderr,
3288
- });
3289
- }
3290
- match self.window_options.lock() {
3291
- Ok(mut guard) => guard.push((option.to_string(), value.to_string())),
3292
- Err(poisoned) => poisoned
3293
- .into_inner()
3294
- .push((option.to_string(), value.to_string())),
3295
- }
3296
- Ok(())
3297
- }
3298
-
3299
- fn kill_server(&self) -> Result<(), TransportError> {
3300
- self.record_kill("kill_server");
3301
- Ok(())
3302
- }
3303
-
3304
- fn kill_session(&self, session: &SessionName) -> Result<(), TransportError> {
3305
- self.record_kill(&format!("kill_session:{}", session.as_str()));
3306
- Ok(())
3307
- }
3308
-
3309
- fn kill_window(&self, target: &Target) -> Result<(), TransportError> {
3310
- self.record_kill(&format!("kill_window:{target:?}"));
3311
- match self.windows.lock() {
3312
- Ok(mut guard) => guard.clear(),
3313
- Err(poisoned) => poisoned.into_inner().clear(),
3314
- }
3315
- Ok(())
3316
- }
3317
-
3318
- fn attach_session(&self, _session: &SessionName) -> Result<AttachOutcome, TransportError> {
3319
- Ok(AttachOutcome::Unsupported {
3320
- reason: "not used by startup-prompt test".to_string(),
3321
- })
3322
- }
3323
- }
3324
-
3325
- fn managed_spawn_result() -> SpawnResult {
3326
- SpawnResult {
3327
- pane_id: PaneId::new("%42"),
3328
- session: SessionName::new("team-agent-leader-claude_code-demo"),
3329
- window: WindowName::new("claude_code"),
3330
- child_pid: Some(1234),
3331
- }
3332
- }
3333
-
3334
- fn managed_pane_info(spawned: &SpawnResult) -> PaneInfo {
3335
- PaneInfo {
3336
- pane_id: spawned.pane_id.clone(),
3337
- session: spawned.session.clone(),
3338
- window_index: Some(0),
3339
- window_name: Some(spawned.window.clone()),
3340
- pane_index: Some(0),
3341
- tty: None,
3342
- current_command: Some("claude".to_string()),
3343
- current_path: None,
3344
- active: true,
3345
- pane_pid: spawned.child_pid,
3346
- leader_env: BTreeMap::new(),
3347
- }
3348
- }
3349
-
3350
- #[test]
3351
- fn managed_attach_success_requires_live_provider_pane() {
3352
- let spawned = managed_spawn_result();
3353
- let transport = ScriptedTransport::with_liveness(PaneLiveness::Dead);
3354
-
3355
- let err = ensure_managed_provider_live_after_attach(&transport, &spawned)
3356
- .expect_err("dead provider pane must fail managed launch");
3357
-
3358
- let text = err.to_string();
3359
- assert!(
3360
- text.contains("managed leader provider pane is not running"),
3361
- "{text}"
3362
- );
3363
- assert!(text.contains("%42"), "{text}");
3364
- assert!(text.contains("claude_code"), "{text}");
3365
- }
3366
-
3367
- #[test]
3368
- fn managed_attach_success_accepts_live_provider_pane() {
3369
- let spawned = managed_spawn_result();
3370
- let transport = ScriptedTransport::with_liveness(PaneLiveness::Live);
3371
-
3372
- ensure_managed_provider_live_after_attach(&transport, &spawned)
3373
- .expect("live provider pane keeps managed launch successful");
3374
- }
3375
-
3376
- #[test]
3377
- fn managed_attach_success_uses_target_scan_when_liveness_unknown() {
3378
- let spawned = managed_spawn_result();
3379
- let transport = ScriptedTransport::with_liveness_and_targets(
3380
- PaneLiveness::Unknown,
3381
- vec![managed_pane_info(&spawned)],
3382
- );
3383
-
3384
- ensure_managed_provider_live_after_attach(&transport, &spawned)
3385
- .expect("target scan can prove provider pane is still live");
3386
- }
3387
-
3388
- struct EnvGuard {
3389
- saved: Vec<(&'static str, Option<String>)>,
3390
- }
3391
-
3392
- impl EnvGuard {
3393
- fn set(vars: &[(&'static str, Option<&str>)]) -> Self {
3394
- let saved = vars
3395
- .iter()
3396
- .map(|(key, _)| (*key, std::env::var(key).ok()))
3397
- .collect::<Vec<_>>();
3398
- for (key, value) in vars {
3399
- unsafe {
3400
- match value {
3401
- Some(value) => std::env::set_var(key, value),
3402
- None => std::env::remove_var(key),
3403
- }
3404
- }
3405
- }
3406
- Self { saved }
3407
- }
3408
- }
3409
-
3410
- impl Drop for EnvGuard {
3411
- fn drop(&mut self) {
3412
- for (key, value) in self.saved.drain(..).rev() {
3413
- unsafe {
3414
- match value {
3415
- Some(value) => std::env::set_var(key, value),
3416
- None => std::env::remove_var(key),
3417
- }
3418
- }
3419
- }
3420
- }
3421
- }
3422
-
3423
- #[test]
3424
- fn external_exec_provider_persists_topology_before_provider_exec() {
3425
- let workspace =
3426
- std::env::temp_dir().join(format!("ta-external-pre-exec-{}", std::process::id()));
3427
- std::fs::create_dir_all(&workspace).unwrap();
3428
- let state_path = crate::state::persist::runtime_state_path(&workspace);
3429
- let command = format!(
3430
- "test -f {path} && grep -q is_external_leader {path}",
3431
- path = shlex_quote(&state_path.to_string_lossy())
3432
- );
3433
- let identity = LeaderIdentity {
3434
- leader_session_uuid: LeaderSessionUuid::derive(
3435
- "fp",
3436
- &workspace.to_string_lossy(),
3437
- "tester",
3438
- "current",
3439
- )
3440
- .unwrap(),
3441
- leader_session_uuid_source: LeaderSessionUuidSource::Derived,
3442
- machine_fingerprint: "fp".to_string(),
3443
- workspace_abspath: workspace.clone(),
3444
- os_user: "tester".to_string(),
3445
- team_id: TeamKey::new("current"),
3446
- };
3447
- let plan = LeaderStartPlan {
3448
- mode: LeaderStartMode::ExecProvider,
3449
- provider: Provider::Codex,
3450
- workspace: workspace.clone(),
3451
- socket: LeaderLaunchSocket::Workspace,
3452
- session_name: None,
3453
- argv: vec!["sh".to_string(), "-c".to_string(), command],
3454
- provider_argv: vec!["codex".to_string()],
3455
- leader_prompt: None,
3456
- session_capture: None,
3457
- leader_window: None,
3458
- is_external_leader: true,
3459
- leader_env: BTreeMap::new(),
3460
- identity: Some(identity),
3461
- detached: false,
3462
- };
3463
-
3464
- let outcome = execute_leader_plan_after_ambient_authority(&plan, &workspace, None)
3465
- .expect("external marker must be present before provider argv runs");
3466
-
3467
- assert_eq!(outcome.status, crate::leader::LeaderLaunchStatus::Exited);
3468
- let state = crate::state::persist::load_runtime_state(&workspace).unwrap();
3469
- assert_eq!(state["is_external_leader"], serde_json::json!(true));
3470
- assert_eq!(
3471
- state["teams"]["current"]["is_external_leader"],
3472
- serde_json::json!(true)
3473
- );
3474
- let _ = std::fs::remove_dir_all(&workspace);
3475
- }
3476
-
3477
- fn exec_binding_fixture(workspace: &Path) -> (LeaderStartPlan, VerifiedAmbientPaneAuthority) {
3478
- let identity = LeaderIdentity {
3479
- leader_session_uuid: LeaderSessionUuid::derive(
3480
- "fp", &workspace.to_string_lossy(), "tester", "current",
3481
- ).unwrap(),
3482
- leader_session_uuid_source: LeaderSessionUuidSource::Derived,
3483
- machine_fingerprint: "fp".into(), workspace_abspath: workspace.into(),
3484
- os_user: "tester".into(), team_id: TeamKey::new("current"),
3485
- };
3486
- let plan = LeaderStartPlan {
3487
- mode: LeaderStartMode::ExecProvider, provider: Provider::Pi,
3488
- workspace: workspace.into(), socket: LeaderLaunchSocket::Workspace,
3489
- session_name: None, argv: vec![], provider_argv: vec!["pi".into()],
3490
- leader_prompt: None, session_capture: None, leader_window: None,
3491
- is_external_leader: false, leader_env: BTreeMap::new(),
3492
- identity: Some(identity), detached: false,
3493
- };
3494
- let authority = VerifiedAmbientPaneAuthority {
3495
- pane_id: PaneId::new("%77"),
3496
- observed: PaneInfo {
3497
- pane_id: PaneId::new("%77"), session: SessionName::new("cursor-gate-leader"),
3498
- window_index: Some(0), window_name: Some(WindowName::new("pi")),
3499
- pane_index: Some(0), tty: Some("/dev/ttys077".into()),
3500
- current_command: Some("pi".into()), current_path: Some(workspace.into()),
3501
- active: true, pane_pid: None, leader_env: BTreeMap::new(),
3502
- },
3503
- endpoint: "/private/tmp/fixture-exec-leader.sock".into(),
3504
- tmux: "/private/tmp/fixture-exec-leader.sock,123,0".into(),
3505
- };
3506
- (plan, authority)
3507
- }
3508
-
3509
- fn exec_binding_workspace() -> std::path::PathBuf {
3510
- let workspace = std::env::temp_dir().join(format!("ta-exec-bootstrap-{}-{}",
3511
- std::process::id(), std::time::SystemTime::now()
3512
- .duration_since(std::time::UNIX_EPOCH).unwrap().as_nanos()));
3513
- std::fs::create_dir(&workspace).unwrap();
3514
- workspace
3515
- }
3516
-
3517
- #[test]
3518
- fn exec_provider_non_prefixed_receiver_produces_fresh_quick_start_bootstrap() {
3519
- let workspace = exec_binding_workspace();
3520
- let (plan, authority) = exec_binding_fixture(&workspace);
3521
- persist_exec_provider_leader_binding(&plan, &workspace, &authority, false).unwrap();
3522
- let state = crate::state::persist::load_runtime_state(&workspace).unwrap();
3523
- let before = state.clone();
3524
- assert!(state["session_name"].is_null());
3525
- assert!(state["teams"]["current"]["session_name"].is_null());
3526
- assert_eq!(state["teams"]["current"]["leader_receiver"]["session_name"], "cursor-gate-leader");
3527
- assert!(!crate::lifecycle::launch::quick_start_has_runtime_for_test(&state, "current"));
3528
- assert_eq!(state, before);
3529
- std::fs::remove_dir_all(workspace).unwrap();
3530
- }
3531
-
3532
- #[test]
3533
- fn exec_provider_preserves_existing_workers_and_never_clears_runtime_markers() {
3534
- for status in ["running", "stopped", "unknown"] {
3535
- let workspace = exec_binding_workspace();
3536
- let (plan, authority) = exec_binding_fixture(&workspace);
3537
- let path = crate::state::persist::runtime_state_path(&workspace);
3538
- std::fs::create_dir_all(path.parent().unwrap()).unwrap();
3539
- std::fs::write(&path, serde_json::json!({
3540
- "active_team_key":"current", "session_name":"team-existing-workers",
3541
- "spec_path":"/fixture/spec.yml", "team_dir":"/fixture/roles",
3542
- "agents":{"worker":{"agent_id":"worker","provider":"pi","status":status}},
3543
- "tasks":[{"task_id":"existing-task"}],
3544
- }).to_string()).unwrap();
3545
- persist_exec_provider_leader_binding(&plan, &workspace, &authority, false).unwrap();
3546
- let state = crate::state::persist::load_runtime_state(&workspace).unwrap();
3547
- for row in [&state, &state["teams"]["current"]] {
3548
- assert_eq!(row["session_name"], "team-existing-workers");
3549
- assert_eq!(row["agents"]["worker"]["status"], status);
3550
- assert_eq!(row["spec_path"], "/fixture/spec.yml");
3551
- assert_eq!(row["team_dir"], "/fixture/roles");
3552
- assert_eq!(row["tasks"][0]["task_id"], "existing-task");
3553
- }
3554
- // Ownership writers update only the canonical team record, not the
3555
- // legacy root view that retains the existing worker runtime.
3556
- assert_eq!(
3557
- state["teams"]["current"]["leader_receiver"]["session_name"],
3558
- "cursor-gate-leader"
3559
- );
3560
- assert!(state["leader_receiver"].is_null());
3561
- assert!(crate::lifecycle::launch::quick_start_has_runtime_for_test(&state, "current"));
3562
- std::fs::remove_dir_all(workspace).unwrap();
3563
- }
3564
- }
3565
-
3566
- #[test]
3567
- #[serial_test::serial(env)]
3568
- fn default_exec_provider_persists_current_pane_binding_before_provider_exec() {
3569
- let workspace =
3570
- std::env::temp_dir().join(format!("ta-current-pane-pre-exec-{}", std::process::id()));
3571
- std::fs::create_dir_all(&workspace).unwrap();
3572
- let state_path = crate::state::persist::runtime_state_path(&workspace);
3573
- let command = format!(
3574
- "test -f {path} && grep -q leader_receiver {path}",
3575
- path = shlex_quote(&state_path.to_string_lossy())
3576
- );
3577
- let _env = EnvGuard::set(&[
3578
- ("TMUX", Some("/private/tmp/tmux-501/default,88432,187")),
3579
- ("TMUX_PANE", Some("%77")),
3580
- ]);
3581
- let identity = LeaderIdentity {
3582
- leader_session_uuid: LeaderSessionUuid::derive(
3583
- "fp",
3584
- &workspace.to_string_lossy(),
3585
- "tester",
3586
- "current",
3587
- )
3588
- .unwrap(),
3589
- leader_session_uuid_source: LeaderSessionUuidSource::Derived,
3590
- machine_fingerprint: "fp".to_string(),
3591
- workspace_abspath: workspace.clone(),
3592
- os_user: "tester".to_string(),
3593
- team_id: TeamKey::new("current"),
3594
- };
3595
- let plan = LeaderStartPlan {
3596
- mode: LeaderStartMode::ExecProvider,
3597
- provider: Provider::Fake,
3598
- workspace: workspace.clone(),
3599
- socket: LeaderLaunchSocket::Workspace,
3600
- session_name: None,
3601
- argv: vec!["sh".to_string(), "-c".to_string(), command],
3602
- provider_argv: vec!["fake".to_string()],
3603
- leader_prompt: None,
3604
- session_capture: None,
3605
- leader_window: None,
3606
- is_external_leader: false,
3607
- leader_env: BTreeMap::new(),
3608
- identity: Some(identity),
3609
- detached: false,
3610
- };
3611
-
3612
- let authority = VerifiedAmbientPaneAuthority {
3613
- pane_id: PaneId::new("%77"),
3614
- observed: PaneInfo {
3615
- pane_id: PaneId::new("%77"),
3616
- session: SessionName::new("team-agent-leader-current"),
3617
- window_index: Some(0),
3618
- window_name: Some(WindowName::new("codex")),
3619
- pane_index: Some(0),
3620
- tty: Some("/dev/ttys077".to_string()),
3621
- current_command: Some("codex".to_string()),
3622
- current_path: Some(workspace.clone()),
3623
- active: true,
3624
- pane_pid: None,
3625
- leader_env: BTreeMap::new(),
3626
- },
3627
- endpoint: "/private/tmp/tmux-501/default".to_string(),
3628
- tmux: "/private/tmp/tmux-501/default,123,0".to_string(),
3629
- };
3630
- let outcome =
3631
- execute_leader_plan_after_ambient_authority(&plan, &workspace, Some(&authority))
3632
- .expect("current pane binding must be present before provider argv runs");
3633
-
3634
- assert_eq!(outcome.status, crate::leader::LeaderLaunchStatus::Exited);
3635
- let state = crate::state::persist::load_runtime_state(&workspace).unwrap();
3636
- assert_eq!(state["is_external_leader"], serde_json::json!(false));
3637
- // Stage 3d: canonical owner/receiver at teams.<team_key>.
3638
- assert_eq!(
3639
- state["teams"]["current"]["leader_receiver"]["pane_id"],
3640
- serde_json::json!("%77")
3641
- );
3642
- assert_eq!(
3643
- state["teams"]["current"]["leader_receiver"]["tmux_socket"],
3644
- serde_json::json!("/private/tmp/tmux-501/default")
3645
- );
3646
- assert_eq!(
3647
- state["teams"]["current"]["team_owner"]["pane_id"],
3648
- serde_json::json!("%77")
3649
- );
3650
- assert_eq!(
3651
- state["leader_client"]["attach_mode"],
3652
- serde_json::json!("exec-provider")
3653
- );
3654
- let _ = std::fs::remove_dir_all(&workspace);
3655
- }
3656
-
3657
- #[test]
3658
- fn exec_provider_leader_startup_prompt_handler_reuses_copilot_adapter() {
3659
- let transport = ScriptedTransport::new(vec![
3660
- COPILOT_TRUST_PROMPT_MARKER.to_string(),
3661
- COPILOT_READY_MARKER.to_string(),
3662
- ]);
3663
- let workspace =
3664
- std::env::temp_dir().join(format!("ta_rs_red2_leader_startup_{}", std::process::id()));
3665
- let _ = std::fs::create_dir_all(&workspace);
3666
-
3667
- let outcome = handle_exec_provider_startup_prompts(
3668
- Provider::Copilot,
3669
- &workspace,
3670
- "%0",
3671
- &transport,
3672
- 5,
3673
- 0.0,
3674
- );
3675
-
3676
- assert_eq!(outcome.handled.len(), 1);
3677
- assert_eq!(outcome.handled[0].prompt, "copilot_workspace_trust");
3678
- assert_eq!(outcome.handled[0].action, "sent_enter_yes_session");
3679
- let sent = transport.sent();
3680
- assert_eq!(sent.len(), 1);
3681
- assert_eq!(sent[0].0, Target::Pane(PaneId::new("%0")));
3682
- assert_eq!(sent[0].1, vec![Key::Enter]);
3683
- }
3684
-
3685
- #[test]
3686
- fn interactive_shell_basename_recognizes_supported_shells() {
3687
- let shells = [
3688
- "zsh", "bash", "sh", "fish", "dash", "ksh", "tcsh", "csh", "ash", "mksh", "yash",
3689
- "elvish", "nu", "nushell", "xonsh",
3690
- ];
3691
- for shell in shells {
3692
- assert!(is_interactive_shell_basename(shell));
3693
- assert!(is_interactive_shell_basename(&shell.to_uppercase()));
3694
- }
3695
- for provider in ["claude", "codex", "copilot", "gemini"] {
3696
- assert!(!is_interactive_shell_basename(provider));
3697
- }
3698
- }
3699
-
3700
- // ═══════════════════════════════════════════════════════════════════
3701
- // 0.4.10+ mirror-session fix v2 (option B: independent session per launch).
3702
- //
3703
- // The managed selector reuses a live provider leader prefix when present;
3704
- // its no-candidate fallback appends a per-launch nonce.
3705
- // ═══════════════════════════════════════════════════════════════════
3706
-
3707
- #[test]
3708
- fn managed_leader_session_name_carries_leader_prefix() {
3709
- // Protection invariant: every session name returned by the
3710
- // managed path must still match LEADER_SESSION_PREFIX so the
3711
- // shutdown / cli/mod.rs prefix matchers still classify it as a
3712
- // leader session.
3713
- let workspace =
3714
- std::env::temp_dir().join(format!("ta_rs_mgr_prefix_{}", std::process::id()));
3715
- let _ = std::fs::create_dir_all(&workspace);
3716
- let name = super::managed_leader_session_name(Provider::ClaudeCode, &workspace);
3717
- assert!(
3718
- name.as_str()
3719
- .starts_with(super::super::LEADER_SESSION_PREFIX),
3720
- "managed session name must carry LEADER_SESSION_PREFIX (`{}`); \
3721
- got `{}`",
3722
- super::super::LEADER_SESSION_PREFIX,
3723
- name.as_str()
3724
- );
3725
- assert!(
3726
- name.as_str().contains("claude_code"),
3727
- "managed session name must include provider wire; got `{}`",
3728
- name.as_str()
3729
- );
3730
- let _ = std::fs::remove_dir_all(&workspace);
3731
- }
3732
-
3733
- #[test]
3734
- fn managed_leader_session_name_is_unique_per_call() {
3735
- // Two consecutive calls must return DIFFERENT names — the
3736
- // per-launch nonce defeats the mirror-session bug.
3737
- let workspace =
3738
- std::env::temp_dir().join(format!("ta_rs_mgr_unique_{}", std::process::id()));
3739
- let _ = std::fs::create_dir_all(&workspace);
3740
- let a = super::managed_leader_session_name(Provider::ClaudeCode, &workspace);
3741
- // Sleep > 1ns to ensure epoch_nanos advances even on coarse clocks.
3742
- std::thread::sleep(std::time::Duration::from_millis(1));
3743
- let b = super::managed_leader_session_name(Provider::ClaudeCode, &workspace);
3744
- assert_ne!(
3745
- a.as_str(),
3746
- b.as_str(),
3747
- "two managed launches in the same workspace must get \
3748
- DIFFERENT session names (mirror-session fix v2); got \
3749
- `{}` vs `{}`",
3750
- a.as_str(),
3751
- b.as_str()
3752
- );
3753
- let _ = std::fs::remove_dir_all(&workspace);
3754
- }
3755
-
3756
- #[test]
3757
- fn leader_session_name_is_stable_across_calls() {
3758
- // External / attach paths must keep the stable workspace-keyed
3759
- // name — `--attach-session <name>` reattach would break if the
3760
- // name varied per call.
3761
- let workspace =
3762
- std::env::temp_dir().join(format!("ta_rs_lsn_stable_{}", std::process::id()));
3763
- let _ = std::fs::create_dir_all(&workspace);
3764
- let a = super::leader_session_name(Provider::ClaudeCode, &workspace);
3765
- let b = super::leader_session_name(Provider::ClaudeCode, &workspace);
3766
- assert_eq!(
3767
- a.as_str(),
3768
- b.as_str(),
3769
- "leader_session_name must be deterministic per workspace \
3770
- (external/attach paths depend on stability); got `{}` vs `{}`",
3771
- a.as_str(),
3772
- b.as_str()
3773
- );
3774
- let _ = std::fs::remove_dir_all(&workspace);
3775
- }
3776
-
3777
- // Tombstone for `managed_path_uses_nonce_session_name_grep_guard`: A-22
3778
- // replaced that implementation-shape assertion with the contract guard
3779
- // below. Keep the old name here for audit/search provenance.
3780
- #[test]
3781
- fn a22_launch_session_reuse_contract() {
3782
- let manifest = std::path::Path::new(env!("CARGO_MANIFEST_DIR"));
3783
- let start_rs = manifest.join("src").join("leader").join("start.rs");
3784
- let contents = std::fs::read_to_string(&start_rs).expect("read leader/start.rs");
3785
- let start = contents
3786
- .find("fn leader_start_plan_with_ambient_authority(")
3787
- .expect("leader_start_plan_with_ambient_authority must exist");
3788
- let end = contents[start + 1..]
3789
- .find("\nfn ")
3790
- .map(|offset| start + 1 + offset)
3791
- .unwrap_or(contents.len());
3792
- let body = &contents[start..end];
3793
- assert!(
3794
- body.contains("managed_leader_session_for_launch(provider, workspace)"),
3795
- "managed launch must select from the A-22 candidate contract; body excerpt: {body}"
3796
- );
3797
- assert!(
3798
- body.contains("leader_session_name(provider, workspace)"),
3799
- "leader_start_plan must keep leader_session_name on the \
3800
- external/attach paths; body excerpt: {body}"
3801
- );
3802
- let workspace =
3803
- std::env::temp_dir().join(format!("ta_rs_a22_contract_{}", std::process::id()));
3804
- let reused = super::managed_leader_session_from_candidates(
3805
- Provider::ClaudeCode,
3806
- &workspace,
3807
- vec![
3808
- "team-worker-not-a-leader".to_string(),
3809
- "team-agent-leader-claude_code-z".to_string(),
3810
- "team-agent-leader-codex-other".to_string(),
3811
- "team-agent-leader-claude_code-a".to_string(),
3812
- ],
3813
- );
3814
- assert_eq!(
3815
- reused.as_str(),
3816
- "team-agent-leader-claude_code-a",
3817
- "managed launch must deterministically reuse a matching leader prefix session"
3818
- );
3819
- let _ = std::fs::remove_dir_all(workspace);
3820
- }
3821
-
3822
- #[test]
3823
- fn a22_launch_session_without_candidate_gets_nonce() {
3824
- let workspace =
3825
- std::env::temp_dir().join(format!("ta_rs_a22_nonce_{}", std::process::id()));
3826
- let fresh = super::managed_leader_session_from_candidates(
3827
- Provider::ClaudeCode,
3828
- &workspace,
3829
- std::iter::empty(),
3830
- );
3831
- assert!(
3832
- fresh.as_str().starts_with("team-agent-leader-claude_code-"),
3833
- "no candidate must create a leader-prefixed managed session: {}",
3834
- fresh.as_str()
3835
- );
3836
- assert_ne!(
3837
- fresh.as_str(),
3838
- super::leader_session_name(Provider::ClaudeCode, &workspace).as_str(),
3839
- "managed fallback must carry a per-launch nonce"
3840
- );
3841
- let _ = std::fs::remove_dir_all(workspace);
3842
- }
3843
-
3844
- #[test]
3845
- fn a22_external_attach_session_name_remains_stable() {
3846
- let workspace =
3847
- std::env::temp_dir().join(format!("ta_rs_a22_external_{}", std::process::id()));
3848
- let stable = super::leader_session_name(Provider::ClaudeCode, &workspace);
3849
- assert_eq!(
3850
- stable.as_str(),
3851
- super::leader_session_name(Provider::ClaudeCode, &workspace).as_str(),
3852
- "external/attach paths must keep the stable workspace-keyed session name"
3853
- );
3854
- let _ = std::fs::remove_dir_all(workspace);
3855
- }
3856
-
3857
- #[test]
3858
- fn launcher_failure_redacts_credentials_before_persistence() {
3859
- let failure = format_launcher_failure(
3860
- "1",
3861
- false,
3862
- "open terminal failed: not a terminal API_TOKEN=secret-value \
3863
- Authorization: Bearer abcdefghijklmnopqrstuvwxyz",
3864
- );
3865
-
3866
- assert!(failure.contains("stderr_class=not_a_terminal"));
3867
- assert!(failure.contains("[REDACTED]"));
3868
- assert!(!failure.contains("secret-value"));
3869
- assert!(!failure.contains("abcdefghijklmnopqrstuvwxyz"));
3870
- }
3871
-
3872
- #[test]
3873
- fn launcher_stderr_capture_is_bounded_to_tail() {
3874
- let mut captured = vec![b'a'; LEADER_STDERR_LIMIT - 2];
3875
- push_bounded_stderr(&mut captured, b"XYZ");
3876
-
3877
- assert_eq!(captured.len(), LEADER_STDERR_LIMIT);
3878
- assert!(captured.ends_with(b"XYZ"));
3879
- }
3880
-
3881
- #[test]
3882
- fn managed_leader_launch_disables_window_rename() {
3883
- let transport = ScriptedTransport::with_liveness(PaneLiveness::Live);
3884
- let session = SessionName::new("team-agent-leader-claude_code-demo");
3885
- let window = WindowName::new("claude_code");
3886
-
3887
- let (result, stderr) = lock_down_window_rename(&transport, &session, &window);
3888
-
3889
- assert_eq!(result, "ok", "both set-window-option calls must succeed");
3890
- assert!(stderr.is_empty());
3891
- let options = transport.window_options();
3892
- assert_eq!(
3893
- options,
3894
- vec![
3895
- ("allow-rename".to_string(), "off".to_string()),
3896
- ("automatic-rename".to_string(), "off".to_string()),
3897
- ],
3898
- "both rename lockdown options must be issued, in order"
3899
- );
3900
- }
3901
-
3902
- #[test]
3903
- fn launcher_survives_set_window_option_failure() {
3904
- let workspace =
3905
- std::env::temp_dir().join(format!("ta-rename-lockdown-fail-{}", std::process::id()));
3906
- std::fs::create_dir_all(&workspace).unwrap();
3907
- let transport = ScriptedTransport::with_window_option_error(
3908
- "set-window-option: unknown option: allow-rename",
3909
- );
3910
- let session = SessionName::new("team-agent-leader-claude_code-demo");
3911
- let window = WindowName::new("claude_code");
3912
-
3913
- // Lockdown must NOT abort the launcher: it returns a failed outcome
3914
- // (recorded for audit) instead of propagating an error.
3915
- let (result, stderr) = lock_down_window_rename(&transport, &session, &window);
3916
-
3917
- assert_eq!(
3918
- result, "failed",
3919
- "a set-window-option failure is audited, not fatal"
3920
- );
3921
- assert!(
3922
- stderr.contains("unknown option"),
3923
- "tmux stderr must surface in the audit payload: {stderr}"
3924
- );
3925
-
3926
- // The audit event lands in the workspace event log with result=failed.
3927
- write_window_rename_lockdown_event(&workspace, &result, &stderr);
3928
- let events = crate::event_log::EventLog::new(&workspace).tail(0).unwrap();
3929
- let lockdown = events
3930
- .iter()
3931
- .find(|event| event["event"] == "leader.launcher.window_rename_lockdown")
3932
- .expect("rename_lockdown event must be written even on failure");
3933
- assert_eq!(lockdown["result"], "failed");
3934
- assert!(
3935
- lockdown["tmux_stderr"]
3936
- .as_str()
3937
- .unwrap_or_default()
3938
- .contains("unknown option"),
3939
- "event must carry tmux stderr for regression triage: {lockdown}"
3940
- );
3941
-
3942
- std::fs::remove_dir_all(&workspace).ok();
3943
- }
3944
-
3945
- #[test]
3946
- fn cleanup_managed_leader_kills_own_window_not_server() {
3947
- let workspace =
3948
- std::env::temp_dir().join(format!("ta-cleanup-own-window-{}", std::process::id()));
3949
- std::fs::create_dir_all(&workspace).unwrap();
3950
- let spawned = managed_spawn_result();
3951
- let transport = ScriptedTransport::with_liveness(PaneLiveness::Live);
3952
- super::cleanup_managed_leader_resources(
3953
- &transport,
3954
- &spawned.session,
3955
- &spawned,
3956
- false,
3957
- &workspace,
3958
- "test_own_window",
3959
- );
3960
- let kills = transport.kills();
3961
- assert!(
3962
- kills.iter().any(|k| k.starts_with("kill_window:")),
3963
- "cleanup must kill the launched window: {kills:?}"
3964
- );
3965
- assert!(
3966
- !kills.iter().any(|k| k == "kill_server"),
3967
- "cleanup must not kill-server: {kills:?}"
3968
- );
3969
- let _ = std::fs::remove_dir_all(&workspace);
3970
- }
3971
-
3972
- #[test]
3973
- fn cleanup_managed_leader_clears_stale_pane_pointer() {
3974
- let workspace =
3975
- std::env::temp_dir().join(format!("ta-cleanup-pane-pointer-{}", std::process::id()));
3976
- std::fs::create_dir_all(workspace.join(".team").join("runtime")).unwrap();
3977
- let state = serde_json::json!({
3978
- "active_team_key": "current",
3979
- "teams": {
3980
- "current": {
3981
- "leader_receiver": {
3982
- "status": "attached",
3983
- "pane_id": "%42",
3984
- "pane": "%42"
3985
- },
3986
- "team_owner": { "pane_id": "%42" }
3987
- }
3988
- }
3989
- });
3990
- std::fs::write(
3991
- crate::state::persist::runtime_state_path(&workspace),
3992
- serde_json::to_vec_pretty(&state).unwrap(),
3993
- )
3994
- .unwrap();
3995
- super::clear_managed_leader_receiver_pane(&workspace, "%42");
3996
- let loaded = crate::state::persist::load_runtime_state(&workspace).unwrap();
3997
- let recv = &loaded["teams"]["current"]["leader_receiver"];
3998
- assert_eq!(recv["status"], serde_json::json!("exited"));
3999
- assert!(
4000
- recv.get("pane_id").is_none(),
4001
- "dangling pane_id must be gone: {recv}"
4002
- );
4003
- assert!(
4004
- loaded["teams"]["current"]["team_owner"]
4005
- .get("pane_id")
4006
- .is_none(),
4007
- "owner pane_id must be gone: {loaded}"
4008
- );
4009
- let _ = std::fs::remove_dir_all(&workspace);
4010
- }
4011
-
4012
- #[test]
4013
- fn managed_attach_teardown_requires_exit_receipt_not_replayed_markers() {
4014
- let spawned = managed_spawn_result();
4015
- let mut transport = ScriptedTransport::new(vec![
4016
- "[team-agent] pi exited with 1\n[team-agent] Provider exited".to_string(),
4017
- ]);
4018
- transport.liveness = PaneLiveness::Live;
4019
- for exit_status in [None, Some(0), Some(17)] {
4020
- transport.exit_status = exit_status;
4021
- let watch = super::ManagedAttachWatch {
4022
- transport: &transport,
4023
- spawned: &spawned,
4024
- session: &spawned.session,
4025
- session_existed_before: false,
4026
- workspace: Path::new("/tmp"),
4027
- provider_label: "pi",
4028
- };
4029
- assert_eq!(
4030
- super::managed_attach_should_teardown(&watch),
4031
- exit_status.is_some()
4032
- );
4033
- }
4034
- assert_eq!(
4035
- transport.screens.lock().unwrap().len(),
4036
- 1,
4037
- "health must not read history"
4038
- );
4039
- transport.liveness = PaneLiveness::Dead;
4040
- transport.exit_status = None;
4041
- assert_eq!(
4042
- super::leader_provider_health(&transport, &spawned.pane_id, "pi"),
4043
- super::LeaderProviderHealth::Unreachable
4044
- );
4045
- }
4046
-
4047
- #[test]
4048
- fn managed_attach_teardown_does_not_fire_on_live_provider_screen() {
4049
- let spawned = managed_spawn_result();
4050
- let transport = ScriptedTransport::new(vec!["Welcome to Claude Code".to_string()]);
4051
- let watch = super::ManagedAttachWatch {
4052
- transport: &transport,
4053
- spawned: &spawned,
4054
- session: &spawned.session,
4055
- session_existed_before: false,
4056
- workspace: Path::new("/tmp"),
4057
- provider_label: "claude",
4058
- };
4059
- assert!(
4060
- !super::managed_attach_should_teardown(&watch),
4061
- "live welcome screen must not teardown"
4062
- );
4063
- }
4064
-
4065
- #[test]
4066
- fn managed_attach_wait_watches_provider_exit_grep_guard() {
4067
- let manifest = std::path::Path::new(env!("CARGO_MANIFEST_DIR"));
4068
- let start_rs = manifest.join("src").join("leader").join("start.rs");
4069
- let contents = std::fs::read_to_string(&start_rs).expect("read leader/start.rs");
4070
- let start = contents
4071
- .find("fn run_leader_argv(")
4072
- .expect("run_leader_argv must exist");
4073
- let end = contents[start + 1..]
4074
- .find("\nfn ")
4075
- .map(|offset| start + 1 + offset)
4076
- .unwrap_or(contents.len());
4077
- let body = &contents[start..end];
4078
- assert!(
4079
- body.contains("wait_managed_attach_child"),
4080
- "managed attach wait must watch provider lifetime; body excerpt: {body}"
4081
- );
4082
- let cleanup = contents
4083
- .find("fn cleanup_managed_leader_resources(")
4084
- .expect("cleanup_managed_leader_resources must exist");
4085
- let cleanup_end = contents[cleanup + 1..]
4086
- .find("\nfn ")
4087
- .map(|offset| cleanup + 1 + offset)
4088
- .unwrap_or(contents.len());
4089
- let cleanup_body = &contents[cleanup..cleanup_end];
4090
- assert!(
4091
- !cleanup_body.contains("kill_server"),
4092
- "cleanup must not call kill_server; body excerpt: {cleanup_body}"
4093
- );
4094
- assert!(
4095
- cleanup_body.contains("kill_window"),
4096
- "cleanup must kill own window; body excerpt: {cleanup_body}"
4097
- );
4098
- assert!(
4099
- cleanup_body.contains("clear_managed_leader_receiver_pane"),
4100
- "cleanup must clear state.json pane pointer; body excerpt: {cleanup_body}"
4101
- );
4102
- }
4103
-
4104
- fn persist_test_identity(workspace: &Path) -> LeaderIdentity {
4105
- persist_test_identity_named(workspace, "tester")
4106
- }
4107
-
4108
- fn persist_test_identity_named(workspace: &Path, os_user: &str) -> LeaderIdentity {
4109
- LeaderIdentity {
4110
- leader_session_uuid: LeaderSessionUuid::derive(
4111
- "fp",
4112
- &workspace.to_string_lossy(),
4113
- os_user,
4114
- "current",
4115
- )
4116
- .unwrap(),
4117
- leader_session_uuid_source: LeaderSessionUuidSource::Derived,
4118
- machine_fingerprint: "fp".to_string(),
4119
- workspace_abspath: workspace.to_path_buf(),
4120
- os_user: os_user.to_string(),
4121
- team_id: TeamKey::new("current"),
4122
- }
4123
- }
4124
-
4125
- fn persist_test_plan(workspace: &Path) -> LeaderStartPlan {
4126
- LeaderStartPlan {
4127
- mode: LeaderStartMode::ManagedTmuxClient,
4128
- provider: Provider::ClaudeCode,
4129
- workspace: workspace.to_path_buf(),
4130
- socket: LeaderLaunchSocket::Workspace,
4131
- session_name: Some(SessionName::new("team-agent-leader-claude_code-demo")),
4132
- argv: vec!["tmux".to_string(), "attach-session".to_string()],
4133
- provider_argv: vec!["claude".to_string()],
4134
- leader_prompt: None,
4135
- session_capture: None,
4136
- leader_window: Some(WindowName::new("claude_code")),
4137
- is_external_leader: false,
4138
- leader_env: BTreeMap::new(),
4139
- identity: Some(persist_test_identity(workspace)),
4140
- detached: false,
4141
- }
4142
- }
4143
-
4144
- #[cfg(unix)]
4145
- #[test]
4146
- fn leader_prompt_transport_capture_hides_argv_echo_without_muting_native_exec() {
4147
- const TEST: &str = "leader::start::tests::leader_prompt_transport_capture_hides_argv_echo_without_muting_native_exec";
4148
- const KEY: &str = "TEAM_AGENT_TEST_PROMPT_CAPTURE_CASE";
4149
- const BODY: &str = "SENSITIVE_PROMPT_309_CAPTURE";
4150
- if let Ok(case) = std::env::var(KEY) {
4151
- let root = std::env::temp_dir().join(format!("ta-prompt-capture-{}-{case}", std::process::id()));
4152
- std::fs::create_dir_all(&root).unwrap();
4153
- let mut plan = persist_test_plan(&root);
4154
- plan.mode = if case == "exec_configured" { LeaderStartMode::ExecProvider } else { LeaderStartMode::NewTmuxSession };
4155
- if case != "transport_absent" {
4156
- plan.leader_prompt = Some(crate::leader::prompt::PromptMetadata {
4157
- config_path: root.join("leader-prompt.txt"), carrier: "--append-system-prompt", bytes: BODY.len(),
4158
- });
4159
- }
4160
- // Controlled launcher echoes its received argv and fails; no native Agent/Team.
4161
- let argv = vec!["/bin/sh".to_string(), "-c".to_string(),
4162
- "printf '%s\\n' \"$1\"; printf '%s\\n' \"$1\" >&2; exit 23".to_string(), "launcher".to_string(), BODY.to_string()];
4163
- let outcome = super::run_leader_argv(&argv, &BTreeMap::new(), &plan, &root, None).unwrap();
4164
- assert_eq!(outcome.status.code(), Some(23));
4165
- if plan.leader_prompt.is_some() { assert!(!outcome.stderr.contains(BODY)); }
4166
- std::fs::remove_dir_all(root).unwrap();
4167
- return;
4168
- }
4169
- for case in ["transport_configured", "transport_absent", "exec_configured"] {
4170
- let output = std::process::Command::new(std::env::current_exe().unwrap())
4171
- .args(["--exact", TEST, "--nocapture", "--test-threads=1"])
4172
- .env(KEY, case).env_remove("TMUX").env_remove("TMUX_PANE")
4173
- .output().unwrap();
4174
- assert!(output.status.success(), "controlled child failed: {:?} {}", output.status, String::from_utf8_lossy(&output.stderr));
4175
- for bytes in [&output.stdout, &output.stderr] {
4176
- assert_eq!(String::from_utf8_lossy(bytes).contains(BODY), case != "transport_configured", "capture policy differs for {case}");
4177
- }
4178
- }
4179
- }
4180
-
4181
- #[test]
4182
- fn leader_prompt_diagnostics_hide_payload_but_keep_unconfigured_baseline_and_native_cause() {
4183
- let root = std::env::temp_dir().join(format!("ta-prompt-diagnostics-{}", std::process::id()));
4184
- std::fs::create_dir_all(&root).unwrap();
4185
- let path = root.join("launcher.log");
4186
- let mut plan = persist_test_plan(&root);
4187
- let plain = vec!["tmux".to_string(), "attach-session".to_string()];
4188
- super::write_launcher_diagnostics_header(&path, &plan, &plain).unwrap();
4189
- assert_eq!(std::fs::read_to_string(&path).unwrap(),
4190
- "startup_stage=prepare\nmode=ManagedTmuxClient\nprovider=claude_code\nargv=tmux attach-session\n");
4191
- const BODY: &str = "LEADER_ONLY_SENSITIVE_309";
4192
- plan.leader_prompt = Some(crate::leader::prompt::PromptMetadata {
4193
- config_path: root.join("leader-prompt.txt"), carrier: "--append-system-prompt", bytes: BODY.len(),
4194
- });
4195
- let shell = vec!["tmux".to_string(), "new-session".to_string(),
4196
- format!("claude --append-system-prompt '{BODY}'")];
4197
- super::write_launcher_diagnostics_header(&path, &plan, &shell).unwrap();
4198
- let header = std::fs::read_to_string(&path).unwrap();
4199
- assert!(!header.contains(BODY));
4200
- assert!(header.contains("leader_prompt={") && header.contains("--append-system-prompt"));
4201
- assert!(!super::prompt_aware_diagnostic_text(&plan, BODY).contains(BODY));
4202
- let error = super::prompt_aware_spawn_error(&plan, TransportError::Subprocess {
4203
- argv: shell, code: Some(7), stderr: BODY.to_string(),
4204
- });
4205
- let crate::leader::LeaderError::Prompt(error) = error else { panic!("typed carrier failure required") };
4206
- assert_eq!(error.reason, "leader_prompt_carrier_failed");
4207
- assert_eq!(error.exit_code, Some(7));
4208
- assert!(!error.report().to_string().contains(BODY));
4209
- std::fs::remove_dir_all(root).unwrap();
4210
- }
4211
-
4212
- #[test]
4213
- fn multi_leader_window_keeps_base_when_free() {
4214
- let window =
4215
- managed_leader_window_from_occupied("claude_code", Vec::<String>::new(), "deadbeef");
4216
- assert_eq!(window.as_str(), "claude_code");
4217
- }
4218
-
4219
- #[test]
4220
- fn multi_leader_window_suffixes_when_taken() {
4221
- let window = managed_leader_window_from_occupied(
4222
- "claude_code",
4223
- vec!["claude_code".to_string()],
4224
- "aa-bb",
4225
- );
4226
- assert_eq!(window.as_str(), "claude_code-aa-bb");
4227
- assert_ne!(window.as_str(), "claude_code");
4228
- }
4229
-
4230
- #[test]
4231
- fn multi_leader_attach_targets_unique_window() {
4232
- let session = SessionName::new("team-agent-leader-claude_code-demo");
4233
- let window = WindowName::new("claude_code-aa-bb");
4234
- let argv = managed_client_argv(
4235
- Path::new("/tmp"),
4236
- &session,
4237
- &window,
4238
- ManagedClientAttachMode::AttachSession,
4239
- )
4240
- .expect("argv");
4241
- let target = argv
4242
- .windows(2)
4243
- .find(|pair| pair[0] == "-t")
4244
- .map(|pair| pair[1].as_str())
4245
- .expect("-t target");
4246
- assert_eq!(
4247
- target,
4248
- "team-agent-leader-claude_code-demo:claude_code-aa-bb"
4249
- );
4250
- assert!(
4251
- !target.ends_with(":claude_code"),
4252
- "attach must not collapse to the colliding provider_wire name: {target}"
4253
- );
4254
- }
4255
-
4256
- #[test]
4257
- fn multi_leader_persist_keeps_first_pane_id() {
4258
- let workspace =
4259
- std::env::temp_dir().join(format!("ta-multi-leader-persist-{}", std::process::id()));
4260
- std::fs::create_dir_all(workspace.join(".team").join("runtime")).unwrap();
4261
- let plan = persist_test_plan(&workspace);
4262
- let first = SpawnResult {
4263
- pane_id: PaneId::new("%0"),
4264
- session: SessionName::new("team-agent-leader-claude_code-demo"),
4265
- window: WindowName::new("claude_code"),
4266
- child_pid: Some(1),
4267
- };
4268
- persist_managed_leader_binding(&plan, &workspace, &first).expect("first persist");
4269
- let second = SpawnResult {
4270
- pane_id: PaneId::new("%1"),
4271
- session: SessionName::new("team-agent-leader-claude_code-demo"),
4272
- window: WindowName::new("claude_code-aa-bb"),
4273
- child_pid: Some(2),
4274
- };
4275
- persist_managed_leader_binding(&plan, &workspace, &second).expect("second persist");
4276
- let loaded = crate::state::persist::load_runtime_state(&workspace).unwrap();
4277
- let recv = &loaded["teams"]["current"]["leader_receiver"];
4278
- assert_eq!(
4279
- recv["pane_id"],
4280
- serde_json::json!("%0"),
4281
- "second launch must not overwrite the first pane pointer: {recv}"
4282
- );
4283
- let panes = recv["bound_panes"].as_array().expect("bound_panes");
4284
- let ids: Vec<&str> = panes
4285
- .iter()
4286
- .filter_map(|pane| pane.get("pane_id").and_then(serde_json::Value::as_str))
4287
- .collect();
4288
- assert!(ids.contains(&"%0"), "bound_panes missing first: {recv}");
4289
- assert!(ids.contains(&"%1"), "bound_panes missing second: {recv}");
4290
- let _ = std::fs::remove_dir_all(&workspace);
4291
- }
4292
-
4293
- #[test]
4294
- fn pi_managed_leader_persists_native_identity_with_the_canonical_pane() {
4295
- let workspace = std::env::temp_dir().join(format!(
4296
- "ta-pi-leader-native-binding-{}", std::process::id()
4297
- ));
4298
- std::fs::create_dir_all(workspace.join(".team/runtime")).unwrap();
4299
- let mut plan = persist_test_plan(&workspace);
4300
- plan.provider = Provider::Pi;
4301
- plan.session_capture = Some(crate::provider::CaptureSessionContext {
4302
- agent_id: "leader".into(),
4303
- spawn_cwd: workspace.clone(),
4304
- pane_id: None,
4305
- pane_pid: None,
4306
- spawned_at: Some("2026-10-10T03:59:07Z".into()),
4307
- expected_session_id: Some(crate::provider::SessionId::new("native-first")),
4308
- provider_projects_root: Some(workspace.join("pi-sessions")),
4309
- });
4310
- let mut pane = SpawnResult {
4311
- pane_id: PaneId::new("%0"),
4312
- session: SessionName::new("team-agent-leader-pi-demo"),
4313
- window: WindowName::new("pi"),
4314
- child_pid: Some(1),
4315
- };
4316
- persist_managed_leader_binding(&plan, &workspace, &pane).unwrap();
4317
- let first = crate::state::persist::load_runtime_state(&workspace).unwrap();
4318
- let receiver = &first["teams"]["current"]["leader_receiver"];
4319
- let native = &receiver["native_session"];
4320
- assert_eq!(native["expected_session_id"], "native-first");
4321
- assert_ne!(native["expected_session_id"], receiver["leader_session_uuid"]);
4322
- assert_eq!(native["provider_projects_root"], serde_json::json!(workspace.join("pi-sessions")));
4323
- for key in ["pane_id", "tmux_socket", "leader_session_uuid", "owner_epoch"] {
4324
- assert_eq!(native[key], receiver[key]);
4325
- }
4326
- pane.pane_id = PaneId::new("%1");
4327
- plan.session_capture.as_mut().unwrap().expected_session_id =
4328
- Some(crate::provider::SessionId::new("native-second"));
4329
- persist_managed_leader_binding(&plan, &workspace, &pane).unwrap();
4330
- let second = crate::state::persist::load_runtime_state(&workspace).unwrap();
4331
- assert_eq!(second["teams"]["current"]["leader_receiver"]["native_session"], *native);
4332
- let _ = std::fs::remove_dir_all(workspace);
4333
- }
4334
-
4335
- #[test]
4336
- fn multi_leader_persist_keeps_first_owner_uuid() {
4337
- let workspace = std::env::temp_dir().join(format!(
4338
- "ta-multi-leader-uuid-{}",
4339
- std::process::id()
4340
- ));
4341
- std::fs::create_dir_all(workspace.join(".team").join("runtime")).unwrap();
4342
- let original_uuid = "b2b230cfd645e78cf49e8147ba32ff3b";
4343
- let state = serde_json::json!({
4344
- "active_team_key": "current",
4345
- "teams": {
4346
- "current": {
4347
- "leader_receiver": {
4348
- "status": "attached",
4349
- "pane_id": "%0",
4350
- "discovery": "env_pane",
4351
- "leader_session_uuid": original_uuid,
4352
- "owner_epoch": 1,
4353
- "attached_at": "2026-09-09T17:08:31.965311+00:00",
4354
- "tmux_socket": "/private/tmp/tmux-501/ta-33bddc6e7687",
4355
- "session_name": null,
4356
- "provider": "codex"
4357
- },
4358
- "team_owner": {
4359
- "pane_id": "%0",
4360
- "leader_session_uuid": original_uuid,
4361
- "owner_epoch": 1,
4362
- "claimed_via": "quick-start"
4363
- }
4364
- }
4365
- }
4366
- });
4367
- std::fs::write(
4368
- crate::state::persist::runtime_state_path(&workspace),
4369
- serde_json::to_vec_pretty(&state).unwrap(),
4370
- )
4371
- .unwrap();
4372
- let mut plan = persist_test_plan(&workspace);
4373
- plan.identity = Some(persist_test_identity_named(&workspace, "second-launcher"));
4374
- let second_uuid = plan
4375
- .identity
4376
- .as_ref()
4377
- .unwrap()
4378
- .leader_session_uuid
4379
- .as_str()
4380
- .to_string();
4381
- assert_ne!(second_uuid, original_uuid);
4382
- let spawned = SpawnResult {
4383
- pane_id: PaneId::new("%2"),
4384
- session: SessionName::new(
4385
- "team-agent-leader-codex-team-agent-live-0578-r4-19450903",
4386
- ),
4387
- window: WindowName::new("codex-second"),
4388
- child_pid: Some(2),
4389
- };
4390
- persist_managed_leader_binding(&plan, &workspace, &spawned).expect("second persist");
4391
- let loaded = crate::state::persist::load_runtime_state(&workspace).unwrap();
4392
- let recv = &loaded["teams"]["current"]["leader_receiver"];
4393
- let owner = &loaded["teams"]["current"]["team_owner"];
4394
- assert_eq!(recv["pane_id"], serde_json::json!("%0"));
4395
- assert_eq!(recv["leader_session_uuid"], serde_json::json!(original_uuid));
4396
- assert_eq!(recv["discovery"], serde_json::json!("env_pane"));
4397
- assert_eq!(recv["session_name"], serde_json::Value::Null);
4398
- assert_eq!(recv["owner_epoch"], serde_json::json!(1));
4399
- assert_eq!(
4400
- owner["leader_session_uuid"],
4401
- serde_json::json!(original_uuid)
4402
- );
4403
- let panes = recv["bound_panes"].as_array().expect("bound_panes");
4404
- let ids: Vec<&str> = panes
4405
- .iter()
4406
- .filter_map(|pane| pane.get("pane_id").and_then(serde_json::Value::as_str))
4407
- .collect();
4408
- assert!(ids.contains(&"%0"), "bound_panes missing first: {recv}");
4409
- assert!(ids.contains(&"%2"), "bound_panes missing second: {recv}");
4410
- let _ = std::fs::remove_dir_all(&workspace);
4411
- }
4412
-
4413
- #[test]
4414
- fn multi_leader_clear_promotes_remaining() {
4415
- let workspace =
4416
- std::env::temp_dir().join(format!("ta-multi-leader-promote-{}", std::process::id()));
4417
- std::fs::create_dir_all(workspace.join(".team").join("runtime")).unwrap();
4418
- let state = serde_json::json!({
4419
- "active_team_key": "current",
4420
- "teams": {
4421
- "current": {
4422
- "leader_receiver": {
4423
- "status": "attached",
4424
- "pane_id": "%0",
4425
- "pane": "%0",
4426
- "session_name": "s",
4427
- "window_name": "claude_code",
4428
- "bound_panes": [
4429
- {
4430
- "pane_id": "%0",
4431
- "session_name": "s",
4432
- "window_name": "claude_code"
4433
- },
4434
- {
4435
- "pane_id": "%1",
4436
- "session_name": "s",
4437
- "window_name": "claude_code-2"
4438
- }
4439
- ]
4440
- },
4441
- "team_owner": { "pane_id": "%0" }
4442
- }
4443
- }
4444
- });
4445
- std::fs::write(
4446
- crate::state::persist::runtime_state_path(&workspace),
4447
- serde_json::to_vec_pretty(&state).unwrap(),
4448
- )
4449
- .unwrap();
4450
- clear_managed_leader_receiver_pane(&workspace, "%0");
4451
- let loaded = crate::state::persist::load_runtime_state(&workspace).unwrap();
4452
- let recv = &loaded["teams"]["current"]["leader_receiver"];
4453
- assert_eq!(recv["pane_id"], serde_json::json!("%1"));
4454
- assert_eq!(recv["status"], serde_json::json!("attached"));
4455
- let panes = recv["bound_panes"].as_array().expect("bound_panes");
4456
- assert_eq!(panes.len(), 1);
4457
- assert_eq!(panes[0]["pane_id"], serde_json::json!("%1"));
4458
- assert!(
4459
- loaded["teams"]["current"]["team_owner"]
4460
- .get("pane_id")
4461
- .is_none(),
4462
- "owner pane for the exited leader must be gone: {loaded}"
4463
- );
4464
- let _ = std::fs::remove_dir_all(&workspace);
4465
- }
4466
-
4467
- #[test]
4468
- fn multi_leader_launch_window_dedup_contract() {
4469
- let manifest = std::path::Path::new(env!("CARGO_MANIFEST_DIR"));
4470
- let start_rs = manifest.join("src").join("leader").join("start.rs");
4471
- let contents = std::fs::read_to_string(&start_rs).expect("read leader/start.rs");
4472
- let start = contents
4473
- .find("fn leader_start_plan_with_ambient_authority(")
4474
- .expect("leader_start_plan_with_ambient_authority must exist");
4475
- let end = contents[start + 1..]
4476
- .find("\nfn ")
4477
- .map(|offset| start + 1 + offset)
4478
- .unwrap_or(contents.len());
4479
- let body = &contents[start..end];
4480
- assert!(
4481
- body.contains("managed_leader_window_for_launch(provider, workspace, session)"),
4482
- "managed launch must pick a unique window in the A-22 session; body excerpt: {body}"
4483
- );
4484
- let argv_start = contents
4485
- .find("fn managed_client_argv(")
4486
- .expect("managed_client_argv must exist");
4487
- let argv_end = contents[argv_start + 1..]
4488
- .find("\nfn ")
4489
- .map(|offset| argv_start + 1 + offset)
4490
- .unwrap_or(contents.len());
4491
- let argv_body = &contents[argv_start..argv_end];
4492
- assert!(
4493
- argv_body.contains("window.as_str()"),
4494
- "attach target must use the launch window, not a hardcoded wire name; body excerpt: {argv_body}"
4495
- );
4496
- assert!(
4497
- !argv_body.contains("provider_wire(provider)"),
4498
- "attach target must not collapse to provider_wire; body excerpt: {argv_body}"
4499
- );
4500
- }
4501
- }