@team-agent/installer 0.5.127 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (421) hide show
  1. package/README.md +15 -4
  2. package/README.zh.md +1 -1
  3. package/package.json +4 -8
  4. package/skills/team-agent/SKILL.md +41 -26
  5. package/skills/team-agent/command-coverage.json +170 -184
  6. package/skills/team-agent/docs/reference/team-agent-operator.md +66 -32
  7. package/skills/team-agent/references/recovery-runbook.md +1 -1
  8. package/skills/team-agent/references/team-agent-operator.md +66 -32
  9. package/templates/team_state.md +1 -1
  10. package/Cargo.lock +0 -1063
  11. package/Cargo.toml +0 -36
  12. package/crates/team-agent/Cargo.toml +0 -69
  13. package/crates/team-agent/src/app_server_test_support.rs +0 -258
  14. package/crates/team-agent/src/cli/adapters.rs +0 -1298
  15. package/crates/team-agent/src/cli/arguments.rs +0 -401
  16. package/crates/team-agent/src/cli/attach_app_server_leader.rs +0 -98
  17. package/crates/team-agent/src/cli/diagnose.rs +0 -1675
  18. package/crates/team-agent/src/cli/emit.rs +0 -2898
  19. package/crates/team-agent/src/cli/grok_slot.rs +0 -384
  20. package/crates/team-agent/src/cli/helpers.rs +0 -91
  21. package/crates/team-agent/src/cli/intent/runtime.rs +0 -1189
  22. package/crates/team-agent/src/cli/intent/runtime_tests.rs +0 -821
  23. package/crates/team-agent/src/cli/intent/tests.rs +0 -691
  24. package/crates/team-agent/src/cli/intent.rs +0 -664
  25. package/crates/team-agent/src/cli/leader.rs +0 -300
  26. package/crates/team-agent/src/cli/leader_prompt.rs +0 -261
  27. package/crates/team-agent/src/cli/leaders.rs +0 -418
  28. package/crates/team-agent/src/cli/mod.rs +0 -6528
  29. package/crates/team-agent/src/cli/models.rs +0 -449
  30. package/crates/team-agent/src/cli/named_address.rs +0 -1651
  31. package/crates/team-agent/src/cli/profile.rs +0 -342
  32. package/crates/team-agent/src/cli/route.rs +0 -212
  33. package/crates/team-agent/src/cli/send/coordinator.rs +0 -164
  34. package/crates/team-agent/src/cli/send/mailbox.rs +0 -145
  35. package/crates/team-agent/src/cli/send/persist.rs +0 -192
  36. package/crates/team-agent/src/cli/send/presentation.rs +0 -370
  37. package/crates/team-agent/src/cli/send/resolve.rs +0 -573
  38. package/crates/team-agent/src/cli/send.rs +0 -201
  39. package/crates/team-agent/src/cli/shutdown_socket.rs +0 -288
  40. package/crates/team-agent/src/cli/spec.rs +0 -159
  41. package/crates/team-agent/src/cli/status.rs +0 -280
  42. package/crates/team-agent/src/cli/status_port/agents.rs +0 -358
  43. package/crates/team-agent/src/cli/status_port/approvals.rs +0 -79
  44. package/crates/team-agent/src/cli/status_port/brief.rs +0 -2043
  45. package/crates/team-agent/src/cli/status_port/compact.rs +0 -240
  46. package/crates/team-agent/src/cli/status_port/format.rs +0 -146
  47. package/crates/team-agent/src/cli/status_port/inbox.rs +0 -62
  48. package/crates/team-agent/src/cli/status_port/runtime.rs +0 -197
  49. package/crates/team-agent/src/cli/status_port/snapshot.rs +0 -208
  50. package/crates/team-agent/src/cli/status_port/store.rs +0 -416
  51. package/crates/team-agent/src/cli/status_port/tests.rs +0 -90
  52. package/crates/team-agent/src/cli/status_port.rs +0 -92
  53. package/crates/team-agent/src/cli/tests/base.rs +0 -885
  54. package/crates/team-agent/src/cli/tests/divergence.rs +0 -518
  55. package/crates/team-agent/src/cli/tests/lane_c.rs +0 -453
  56. package/crates/team-agent/src/cli/tests/leader_watch.rs +0 -372
  57. package/crates/team-agent/src/cli/tests/main_preserved.rs +0 -430
  58. package/crates/team-agent/src/cli/tests/missing_subcommands.rs +0 -336
  59. package/crates/team-agent/src/cli/tests/mod.rs +0 -137
  60. package/crates/team-agent/src/cli/tests/named_address.rs +0 -760
  61. package/crates/team-agent/src/cli/tests/parser_safety.rs +0 -383
  62. package/crates/team-agent/src/cli/tests/run_delegation.rs +0 -481
  63. package/crates/team-agent/src/cli/tests/shutdown_kill_plan.rs +0 -2179
  64. package/crates/team-agent/src/cli/tests/status_brief.rs +0 -1514
  65. package/crates/team-agent/src/cli/tests/status_send.rs +0 -1091
  66. package/crates/team-agent/src/cli/tests/verb_install_skill.rs +0 -93
  67. package/crates/team-agent/src/cli/tests/verb_profile.rs +0 -392
  68. package/crates/team-agent/src/cli/triage.rs +0 -234
  69. package/crates/team-agent/src/cli/types.rs +0 -591
  70. package/crates/team-agent/src/codex_app_server.rs +0 -546
  71. package/crates/team-agent/src/communication_mode/mod.rs +0 -56
  72. package/crates/team-agent/src/compiler/tests.rs +0 -842
  73. package/crates/team-agent/src/compiler.rs +0 -691
  74. package/crates/team-agent/src/conpty/backend.rs +0 -829
  75. package/crates/team-agent/src/conpty/mod.rs +0 -33
  76. package/crates/team-agent/src/contract_runtime/backend.rs +0 -1610
  77. package/crates/team-agent/src/contract_runtime/commands.rs +0 -671
  78. package/crates/team-agent/src/contract_runtime/config.rs +0 -354
  79. package/crates/team-agent/src/contract_runtime/config_tests.rs +0 -56
  80. package/crates/team-agent/src/contract_runtime/discovery.rs +0 -438
  81. package/crates/team-agent/src/contract_runtime/fork.rs +0 -368
  82. package/crates/team-agent/src/contract_runtime/forward.rs +0 -288
  83. package/crates/team-agent/src/contract_runtime/framework.rs +0 -350
  84. package/crates/team-agent/src/contract_runtime/mcp.rs +0 -399
  85. package/crates/team-agent/src/contract_runtime/mod.rs +0 -17
  86. package/crates/team-agent/src/contract_runtime/prompt.rs +0 -216
  87. package/crates/team-agent/src/contract_runtime/pump.rs +0 -271
  88. package/crates/team-agent/src/contract_runtime/registry.rs +0 -589
  89. package/crates/team-agent/src/contract_runtime/workspace.rs +0 -228
  90. package/crates/team-agent/src/coordinator/backoff.rs +0 -741
  91. package/crates/team-agent/src/coordinator/conpty_shim.rs +0 -805
  92. package/crates/team-agent/src/coordinator/health.rs +0 -1185
  93. package/crates/team-agent/src/coordinator/mod.rs +0 -119
  94. package/crates/team-agent/src/coordinator/orphan.rs +0 -110
  95. package/crates/team-agent/src/coordinator/runtime_detectors.rs +0 -798
  96. package/crates/team-agent/src/coordinator/runtime_observation.rs +0 -84
  97. package/crates/team-agent/src/coordinator/steps/abnormal.rs +0 -2309
  98. package/crates/team-agent/src/coordinator/steps/delivery.rs +0 -15
  99. package/crates/team-agent/src/coordinator/steps/health_sync.rs +0 -15
  100. package/crates/team-agent/src/coordinator/steps/mod.rs +0 -126
  101. package/crates/team-agent/src/coordinator/steps/persist.rs +0 -15
  102. package/crates/team-agent/src/coordinator/steps/runtime_prompts.rs +0 -15
  103. package/crates/team-agent/src/coordinator/steps/session_gate.rs +0 -16
  104. package/crates/team-agent/src/coordinator/tests/a0_lostupdate.rs +0 -158
  105. package/crates/team-agent/src/coordinator/tests/abnormal.rs +0 -312
  106. package/crates/team-agent/src/coordinator/tests/api_error_recovery.rs +0 -338
  107. package/crates/team-agent/src/coordinator/tests/basics.rs +0 -211
  108. package/crates/team-agent/src/coordinator/tests/daemon.rs +0 -514
  109. package/crates/team-agent/src/coordinator/tests/energy.rs +0 -549
  110. package/crates/team-agent/src/coordinator/tests/health_sync.rs +0 -461
  111. package/crates/team-agent/src/coordinator/tests/main_preserved.rs +0 -186
  112. package/crates/team-agent/src/coordinator/tests/mod.rs +0 -295
  113. package/crates/team-agent/src/coordinator/tests/s3_bounded.rs +0 -207
  114. package/crates/team-agent/src/coordinator/tests/spine.rs +0 -308
  115. package/crates/team-agent/src/coordinator/tests/takeover.rs +0 -286
  116. package/crates/team-agent/src/coordinator/tests/tick_core.rs +0 -237
  117. package/crates/team-agent/src/coordinator/tick.rs +0 -3112
  118. package/crates/team-agent/src/coordinator/types.rs +0 -540
  119. package/crates/team-agent/src/db/agent_health_capture.rs +0 -126
  120. package/crates/team-agent/src/db/message_store.rs +0 -1585
  121. package/crates/team-agent/src/db/migration.rs +0 -984
  122. package/crates/team-agent/src/db/mod.rs +0 -26
  123. package/crates/team-agent/src/db/schema.rs +0 -663
  124. package/crates/team-agent/src/diagnose/comms.rs +0 -242
  125. package/crates/team-agent/src/diagnose/mod.rs +0 -44
  126. package/crates/team-agent/src/diagnose/orphans.rs +0 -889
  127. package/crates/team-agent/src/event_log.rs +0 -502
  128. package/crates/team-agent/src/fake_worker.rs +0 -303
  129. package/crates/team-agent/src/kill_audit.rs +0 -106
  130. package/crates/team-agent/src/layout/manager.rs +0 -248
  131. package/crates/team-agent/src/layout/mod.rs +0 -36
  132. package/crates/team-agent/src/layout/overlay.rs +0 -134
  133. package/crates/team-agent/src/layout/placement.rs +0 -52
  134. package/crates/team-agent/src/layout/recovery.rs +0 -106
  135. package/crates/team-agent/src/layout/runtime_sessions.rs +0 -317
  136. package/crates/team-agent/src/layout/sessions.rs +0 -294
  137. package/crates/team-agent/src/layout/tmux_endpoint.rs +0 -165
  138. package/crates/team-agent/src/layout/worker_env.rs +0 -721
  139. package/crates/team-agent/src/layout/worker_window_helpers.rs +0 -37
  140. package/crates/team-agent/src/leader/helpers.rs +0 -178
  141. package/crates/team-agent/src/leader/incident.rs +0 -6
  142. package/crates/team-agent/src/leader/lease.rs +0 -3356
  143. package/crates/team-agent/src/leader/mod.rs +0 -104
  144. package/crates/team-agent/src/leader/owner_bind.rs +0 -400
  145. package/crates/team-agent/src/leader/prompt.rs +0 -905
  146. package/crates/team-agent/src/leader/provider_attribution.rs +0 -247
  147. package/crates/team-agent/src/leader/rediscover/tests.rs +0 -689
  148. package/crates/team-agent/src/leader/rediscover.rs +0 -1192
  149. package/crates/team-agent/src/leader/registry.rs +0 -883
  150. package/crates/team-agent/src/leader/start.rs +0 -4500
  151. package/crates/team-agent/src/leader/takeover.rs +0 -65
  152. package/crates/team-agent/src/leader/tests/basics.rs +0 -337
  153. package/crates/team-agent/src/leader/tests/byte_findings.rs +0 -355
  154. package/crates/team-agent/src/leader/tests/claim_leader_mailbox_flush_contract.rs +0 -544
  155. package/crates/team-agent/src/leader/tests/historical_inventory_upgrade_gate_red.rs +0 -624
  156. package/crates/team-agent/src/leader/tests/identity.rs +0 -465
  157. package/crates/team-agent/src/leader/tests/identity_session_names.rs +0 -42
  158. package/crates/team-agent/src/leader/tests/idle.rs +0 -113
  159. package/crates/team-agent/src/leader/tests/lease_api.rs +0 -520
  160. package/crates/team-agent/src/leader/tests/lease_claim.rs +0 -629
  161. package/crates/team-agent/src/leader/tests/mod.rs +0 -106
  162. package/crates/team-agent/src/leader/tests/prompt_contract.rs +0 -267
  163. package/crates/team-agent/src/leader/tests/rediscover.rs +0 -403
  164. package/crates/team-agent/src/leader/tests/rehomed_env.rs +0 -83
  165. package/crates/team-agent/src/leader/tests/team_in_team_state_scope_red.rs +0 -1273
  166. package/crates/team-agent/src/leader/tests/terminal_and_replay_vs_rerender_invariants_red.rs +0 -417
  167. package/crates/team-agent/src/leader/tests/wake_start_owner.rs +0 -168
  168. package/crates/team-agent/src/leader/types.rs +0 -534
  169. package/crates/team-agent/src/lib.rs +0 -145
  170. package/crates/team-agent/src/lifecycle/helpers.rs +0 -212
  171. package/crates/team-agent/src/lifecycle/launch/add_agent.rs +0 -848
  172. package/crates/team-agent/src/lifecycle/launch/add_agent_state.rs +0 -393
  173. package/crates/team-agent/src/lifecycle/launch/agent_state.rs +0 -332
  174. package/crates/team-agent/src/lifecycle/launch/clone_agent.rs +0 -178
  175. package/crates/team-agent/src/lifecycle/launch/fork_agent.rs +0 -82
  176. package/crates/team-agent/src/lifecycle/launch/fork_entry.rs +0 -63
  177. package/crates/team-agent/src/lifecycle/launch/identity.rs +0 -674
  178. package/crates/team-agent/src/lifecycle/launch/layout.rs +0 -350
  179. package/crates/team-agent/src/lifecycle/launch/leader_context.rs +0 -589
  180. package/crates/team-agent/src/lifecycle/launch/mcp_config.rs +0 -152
  181. package/crates/team-agent/src/lifecycle/launch/ownership.rs +0 -105
  182. package/crates/team-agent/src/lifecycle/launch/pi_mcp.rs +0 -629
  183. package/crates/team-agent/src/lifecycle/launch/pi_mcp_extension.js +0 -226
  184. package/crates/team-agent/src/lifecycle/launch/plan.rs +0 -269
  185. package/crates/team-agent/src/lifecycle/launch/quick_start.rs +0 -5176
  186. package/crates/team-agent/src/lifecycle/launch/quick_start_transport.rs +0 -368
  187. package/crates/team-agent/src/lifecycle/launch/readiness.rs +0 -519
  188. package/crates/team-agent/src/lifecycle/launch/role_source.rs +0 -287
  189. package/crates/team-agent/src/lifecycle/launch/spawn.rs +0 -450
  190. package/crates/team-agent/src/lifecycle/launch/spec_state.rs +0 -801
  191. package/crates/team-agent/src/lifecycle/launch/state_projection.rs +0 -624
  192. package/crates/team-agent/src/lifecycle/launch/worker_env.rs +0 -558
  193. package/crates/team-agent/src/lifecycle/launch.rs +0 -534
  194. package/crates/team-agent/src/lifecycle/lock.rs +0 -350
  195. package/crates/team-agent/src/lifecycle/mod.rs +0 -79
  196. package/crates/team-agent/src/lifecycle/pane_input_lock.rs +0 -239
  197. package/crates/team-agent/src/lifecycle/profile_launch.rs +0 -757
  198. package/crates/team-agent/src/lifecycle/profile_smoke.rs +0 -557
  199. package/crates/team-agent/src/lifecycle/restart/agent.rs +0 -2198
  200. package/crates/team-agent/src/lifecycle/restart/common.rs +0 -2052
  201. package/crates/team-agent/src/lifecycle/restart/orchestrator.rs +0 -65
  202. package/crates/team-agent/src/lifecycle/restart/preflight.rs +0 -113
  203. package/crates/team-agent/src/lifecycle/restart/rebuild.rs +0 -5135
  204. package/crates/team-agent/src/lifecycle/restart/remove.rs +0 -1504
  205. package/crates/team-agent/src/lifecycle/restart/selection.rs +0 -559
  206. package/crates/team-agent/src/lifecycle/restart/team_state.rs +0 -329
  207. package/crates/team-agent/src/lifecycle/restart.rs +0 -223
  208. package/crates/team-agent/src/lifecycle/role_config.rs +0 -1205
  209. package/crates/team-agent/src/lifecycle/tests/acceptance_b_batch_red.rs +0 -1021
  210. package/crates/team-agent/src/lifecycle/tests/agent_ops.rs +0 -1205
  211. package/crates/team-agent/src/lifecycle/tests/b0_legacy_snapshot_nonauthority_contract.rs +0 -265
  212. package/crates/team-agent/src/lifecycle/tests/b0_reader_hideone_audit_contract.rs +0 -490
  213. package/crates/team-agent/src/lifecycle/tests/behavioral_diff_264_red.rs +0 -656
  214. package/crates/team-agent/src/lifecycle/tests/claude_profile_launch_red.rs +0 -135
  215. package/crates/team-agent/src/lifecycle/tests/cli_argv_routing_red.rs +0 -1415
  216. package/crates/team-agent/src/lifecycle/tests/clone_agent_preserves_source_tools.rs +0 -427
  217. package/crates/team-agent/src/lifecycle/tests/clone_fork_copilot_perms_red.rs +0 -396
  218. package/crates/team-agent/src/lifecycle/tests/communication_mode_runtime_contract_red.rs +0 -418
  219. package/crates/team-agent/src/lifecycle/tests/copilot_provider_red.rs +0 -2039
  220. package/crates/team-agent/src/lifecycle/tests/core.rs +0 -1298
  221. package/crates/team-agent/src/lifecycle/tests/f032_startup_prompt_best_effort_red.rs +0 -315
  222. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_g0.stdout.txt +0 -222
  223. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_spaced_ids.stdout.txt +0 -9
  224. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_native_mcp_host.mjs +0 -71
  225. package/crates/team-agent/src/lifecycle/tests/gate_fixtures.rs +0 -562
  226. package/crates/team-agent/src/lifecycle/tests/grok_require_explicit_model_red.rs +0 -110
  227. package/crates/team-agent/src/lifecycle/tests/harvest2_a_batch_red.rs +0 -472
  228. package/crates/team-agent/src/lifecycle/tests/host_cotenant_death_p0_contract.rs +0 -921
  229. package/crates/team-agent/src/lifecycle/tests/issue238_codex_effort_contract.rs +0 -68
  230. package/crates/team-agent/src/lifecycle/tests/lane_ops.rs +0 -1851
  231. package/crates/team-agent/src/lifecycle/tests/launch_spawn.rs +0 -3981
  232. package/crates/team-agent/src/lifecycle/tests/lifecycle_lock.rs +0 -339
  233. package/crates/team-agent/src/lifecycle/tests/lifecycle_rollback_red.rs +0 -596
  234. package/crates/team-agent/src/lifecycle/tests/main_preserved.rs +0 -513
  235. package/crates/team-agent/src/lifecycle/tests/mcp_tool_name_format_red.rs +0 -69
  236. package/crates/team-agent/src/lifecycle/tests/phase_b_contracts.rs +0 -824
  237. package/crates/team-agent/src/lifecycle/tests/phase_golden.rs +0 -723
  238. package/crates/team-agent/src/lifecycle/tests/pi_catalog_red.rs +0 -152
  239. package/crates/team-agent/src/lifecycle/tests/pi_command_red.rs +0 -182
  240. package/crates/team-agent/src/lifecycle/tests/pi_dual_entry_red.rs +0 -374
  241. package/crates/team-agent/src/lifecycle/tests/pi_executable_mcp_red.rs +0 -546
  242. package/crates/team-agent/src/lifecycle/tests/pi_lifecycle_doctor_red.rs +0 -31
  243. package/crates/team-agent/src/lifecycle/tests/pi_native_mcp_capability_red.rs +0 -528
  244. package/crates/team-agent/src/lifecycle/tests/pi_session_delivery_red.rs +0 -134
  245. package/crates/team-agent/src/lifecycle/tests/quick_start_worker_readiness_red.rs +0 -333
  246. package/crates/team-agent/src/lifecycle/tests/realmachine_clusters_1_6_red.rs +0 -786
  247. package/crates/team-agent/src/lifecycle/tests/realmachine_residual_g1_g4_red.rs +0 -648
  248. package/crates/team-agent/src/lifecycle/tests/restart.rs +0 -185
  249. package/crates/team-agent/src/lifecycle/tests/restart_build_before_destroy_0540_contract.rs +0 -1053
  250. package/crates/team-agent/src/lifecycle/tests/restart_liveness_red.rs +0 -679
  251. package/crates/team-agent/src/lifecycle/tests/restart_rebind_hotfix_252_red.rs +0 -1126
  252. package/crates/team-agent/src/lifecycle/tests/restart_session_capture_red.rs +0 -153
  253. package/crates/team-agent/src/lifecycle/tests/resume_recover_red.rs +0 -427
  254. package/crates/team-agent/src/lifecycle/tests/stale_team_saveconflict_contract.rs +0 -431
  255. package/crates/team-agent/src/lifecycle/tests/startup_latency_contract.rs +0 -1066
  256. package/crates/team-agent/src/lifecycle/tests/status_credential_redaction_contract.rs +0 -876
  257. package/crates/team-agent/src/lifecycle/tests/subprep_codex_trust_roundtrip_red.rs +0 -1026
  258. package/crates/team-agent/src/lifecycle/tests/swallow_batch4_semantics_red.rs +0 -90
  259. package/crates/team-agent/src/lifecycle/tests/team_in_team_identity_scope_red.rs +0 -543
  260. package/crates/team-agent/src/lifecycle/tests/team_in_team_sibling_quick_start_red.rs +0 -1103
  261. package/crates/team-agent/src/lifecycle/tests/team_in_team_state_scope_red.rs +0 -1276
  262. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_roster_red.rs +0 -145
  263. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_txn_red.rs +0 -603
  264. package/crates/team-agent/src/lifecycle/tests/test_isolation_escape_contract.rs +0 -936
  265. package/crates/team-agent/src/lifecycle/tests/upgrade_compat_0211_red.rs +0 -970
  266. package/crates/team-agent/src/lifecycle/tests/verify_rs031_window_consistency_red.rs +0 -996
  267. package/crates/team-agent/src/lifecycle/tests/worker_spawn_env_red.rs +0 -827
  268. package/crates/team-agent/src/lifecycle/tests.rs +0 -102
  269. package/crates/team-agent/src/lifecycle/types.rs +0 -861
  270. package/crates/team-agent/src/lifecycle/worker_command_context.rs +0 -370
  271. package/crates/team-agent/src/main.rs +0 -52
  272. package/crates/team-agent/src/mcp_server/helpers.rs +0 -510
  273. package/crates/team-agent/src/mcp_server/lifecycle_tools/mod.rs +0 -6
  274. package/crates/team-agent/src/mcp_server/lifecycle_tools/state_status.rs +0 -43
  275. package/crates/team-agent/src/mcp_server/mod.rs +0 -119
  276. package/crates/team-agent/src/mcp_server/normalize.rs +0 -485
  277. package/crates/team-agent/src/mcp_server/readiness.rs +0 -546
  278. package/crates/team-agent/src/mcp_server/readiness_tests.rs +0 -369
  279. package/crates/team-agent/src/mcp_server/tests/golden.rs +0 -285
  280. package/crates/team-agent/src/mcp_server/tests/normalize.rs +0 -247
  281. package/crates/team-agent/src/mcp_server/tests/scoped.rs +0 -168
  282. package/crates/team-agent/src/mcp_server/tests/send.rs +0 -388
  283. package/crates/team-agent/src/mcp_server/tests/tools.rs +0 -343
  284. package/crates/team-agent/src/mcp_server/tests/wire.rs +0 -254
  285. package/crates/team-agent/src/mcp_server/tests.rs +0 -43
  286. package/crates/team-agent/src/mcp_server/tools.rs +0 -1015
  287. package/crates/team-agent/src/mcp_server/types.rs +0 -396
  288. package/crates/team-agent/src/mcp_server/wire.rs +0 -867
  289. package/crates/team-agent/src/messaging/activity.rs +0 -461
  290. package/crates/team-agent/src/messaging/address.rs +0 -87
  291. package/crates/team-agent/src/messaging/delivery.rs +0 -3785
  292. package/crates/team-agent/src/messaging/delivery_consumption_tests.rs +0 -234
  293. package/crates/team-agent/src/messaging/enter_rescue.rs +0 -362
  294. package/crates/team-agent/src/messaging/enter_rescue_tests.rs +0 -633
  295. package/crates/team-agent/src/messaging/helpers.rs +0 -354
  296. package/crates/team-agent/src/messaging/leader_channel.rs +0 -287
  297. package/crates/team-agent/src/messaging/leader_receiver.rs +0 -786
  298. package/crates/team-agent/src/messaging/mod.rs +0 -166
  299. package/crates/team-agent/src/messaging/persist.rs +0 -377
  300. package/crates/team-agent/src/messaging/presentation.rs +0 -417
  301. package/crates/team-agent/src/messaging/results/collection_tests.rs +0 -719
  302. package/crates/team-agent/src/messaging/results.rs +0 -1415
  303. package/crates/team-agent/src/messaging/scheduler.rs +0 -217
  304. package/crates/team-agent/src/messaging/selftest.rs +0 -315
  305. package/crates/team-agent/src/messaging/send.rs +0 -981
  306. package/crates/team-agent/src/messaging/tests/basic.rs +0 -346
  307. package/crates/team-agent/src/messaging/tests/dup_inject.rs +0 -551
  308. package/crates/team-agent/src/messaging/tests/e23.rs +0 -49
  309. package/crates/team-agent/src/messaging/tests/leader_channel.rs +0 -169
  310. package/crates/team-agent/src/messaging/tests/leader_inject_acceptance.rs +0 -817
  311. package/crates/team-agent/src/messaging/tests/main_preserved.rs +0 -85
  312. package/crates/team-agent/src/messaging/tests/mod.rs +0 -306
  313. package/crates/team-agent/src/messaging/tests/runtime.rs +0 -3655
  314. package/crates/team-agent/src/messaging/tests/spine.rs +0 -837
  315. package/crates/team-agent/src/messaging/tests/wave2.rs +0 -381
  316. package/crates/team-agent/src/messaging/trust.rs +0 -215
  317. package/crates/team-agent/src/messaging/types.rs +0 -471
  318. package/crates/team-agent/src/messaging/wait.rs +0 -366
  319. package/crates/team-agent/src/messaging/watchers.rs +0 -916
  320. package/crates/team-agent/src/model/enums.rs +0 -356
  321. package/crates/team-agent/src/model/errors.rs +0 -18
  322. package/crates/team-agent/src/model/ids.rs +0 -165
  323. package/crates/team-agent/src/model/mod.rs +0 -29
  324. package/crates/team-agent/src/model/name_similarity.rs +0 -252
  325. package/crates/team-agent/src/model/pane_authority_refusal.rs +0 -359
  326. package/crates/team-agent/src/model/paths.rs +0 -257
  327. package/crates/team-agent/src/model/routing.rs +0 -387
  328. package/crates/team-agent/src/model/spec.rs +0 -1184
  329. package/crates/team-agent/src/model/task_graph.rs +0 -321
  330. package/crates/team-agent/src/model/testdata/fuzz.golden.yaml +0 -43
  331. package/crates/team-agent/src/model/testdata/fuzz.yaml +0 -43
  332. package/crates/team-agent/src/model/testdata/spec_invalid_a.yaml +0 -209
  333. package/crates/team-agent/src/model/testdata/team.spec.golden.yaml +0 -208
  334. package/crates/team-agent/src/model/testdata/team.spec.yaml +0 -208
  335. package/crates/team-agent/src/model/yaml/tests.rs +0 -188
  336. package/crates/team-agent/src/model/yaml.rs +0 -802
  337. package/crates/team-agent/src/os_probe.rs +0 -280
  338. package/crates/team-agent/src/packaging/install.rs +0 -219
  339. package/crates/team-agent/src/packaging/migrate.rs +0 -38
  340. package/crates/team-agent/src/packaging/mod.rs +0 -91
  341. package/crates/team-agent/src/packaging/repair.rs +0 -33
  342. package/crates/team-agent/src/packaging/tests.rs +0 -822
  343. package/crates/team-agent/src/packaging/types.rs +0 -417
  344. package/crates/team-agent/src/platform/argv.rs +0 -331
  345. package/crates/team-agent/src/platform/errors.rs +0 -104
  346. package/crates/team-agent/src/platform/file_lock.rs +0 -279
  347. package/crates/team-agent/src/platform/mod.rs +0 -5
  348. package/crates/team-agent/src/platform/process.rs +0 -545
  349. package/crates/team-agent/src/provider/adapter.rs +0 -898
  350. package/crates/team-agent/src/provider/adapters/copilot.rs +0 -75
  351. package/crates/team-agent/src/provider/adapters/copilot_fork.rs +0 -307
  352. package/crates/team-agent/src/provider/adapters/fake.rs +0 -18
  353. package/crates/team-agent/src/provider/adapters/mod.rs +0 -28
  354. package/crates/team-agent/src/provider/approvals/mod.rs +0 -3
  355. package/crates/team-agent/src/provider/approvals/parsing.rs +0 -586
  356. package/crates/team-agent/src/provider/approvals/runtime_prompts.rs +0 -205
  357. package/crates/team-agent/src/provider/argv_route.rs +0 -405
  358. package/crates/team-agent/src/provider/bypass_flags.rs +0 -116
  359. package/crates/team-agent/src/provider/classify.rs +0 -773
  360. package/crates/team-agent/src/provider/command_helpers.rs +0 -45
  361. package/crates/team-agent/src/provider/faults.rs +0 -165
  362. package/crates/team-agent/src/provider/helpers.rs +0 -52
  363. package/crates/team-agent/src/provider/mod.rs +0 -78
  364. package/crates/team-agent/src/provider/model_catalog.rs +0 -722
  365. package/crates/team-agent/src/provider/session/capture.rs +0 -2631
  366. package/crates/team-agent/src/provider/session/context_fork/outcome.rs +0 -168
  367. package/crates/team-agent/src/provider/session/context_fork.rs +0 -264
  368. package/crates/team-agent/src/provider/session/mod.rs +0 -36
  369. package/crates/team-agent/src/provider/session/resume.rs +0 -269
  370. package/crates/team-agent/src/provider/session_scan/common/tests.rs +0 -316
  371. package/crates/team-agent/src/provider/session_scan/common.rs +0 -618
  372. package/crates/team-agent/src/provider/session_scan/copilot.rs +0 -280
  373. package/crates/team-agent/src/provider/session_scan/pi.rs +0 -152
  374. package/crates/team-agent/src/provider/session_scan.rs +0 -61
  375. package/crates/team-agent/src/provider/startup_prompt.rs +0 -757
  376. package/crates/team-agent/src/provider/submit_now.rs +0 -71
  377. package/crates/team-agent/src/provider/testdata/copilot-ready-marker.txt +0 -5
  378. package/crates/team-agent/src/provider/testdata/copilot-trust-prompt.txt +0 -19
  379. package/crates/team-agent/src/provider/testdata/grok-models-authenticated.stdout +0 -9
  380. package/crates/team-agent/src/provider/testdata/grok-models-unauthenticated.stdout +0 -7
  381. package/crates/team-agent/src/provider/tests/adapter.rs +0 -354
  382. package/crates/team-agent/src/provider/tests/classify.rs +0 -201
  383. package/crates/team-agent/src/provider/tests/command_helpers.rs +0 -26
  384. package/crates/team-agent/src/provider/tests/copilot_fork.rs +0 -191
  385. package/crates/team-agent/src/provider/tests/faults.rs +0 -200
  386. package/crates/team-agent/src/provider/tests/idle.rs +0 -140
  387. package/crates/team-agent/src/provider/tests/wire.rs +0 -213
  388. package/crates/team-agent/src/provider/tests.rs +0 -32
  389. package/crates/team-agent/src/provider/types.rs +0 -529
  390. package/crates/team-agent/src/provider/wire.rs +0 -406
  391. package/crates/team-agent/src/redaction.rs +0 -259
  392. package/crates/team-agent/src/state/abnormal_watch/tests/mod.rs +0 -248
  393. package/crates/team-agent/src/state/abnormal_watch.rs +0 -144
  394. package/crates/team-agent/src/state/identity.rs +0 -914
  395. package/crates/team-agent/src/state/identity_keys.rs +0 -132
  396. package/crates/team-agent/src/state/mod.rs +0 -74
  397. package/crates/team-agent/src/state/owner_gate.rs +0 -482
  398. package/crates/team-agent/src/state/ownership.rs +0 -563
  399. package/crates/team-agent/src/state/paths.rs +0 -395
  400. package/crates/team-agent/src/state/persist.rs +0 -3811
  401. package/crates/team-agent/src/state/projection.rs +0 -1508
  402. package/crates/team-agent/src/state/repository/intent.rs +0 -14
  403. package/crates/team-agent/src/state/repository/tests.rs +0 -184
  404. package/crates/team-agent/src/state/repository.rs +0 -866
  405. package/crates/team-agent/src/state/selector.rs +0 -160
  406. package/crates/team-agent/src/state/testdata/state-rich.canonical.json +0 -133
  407. package/crates/team-agent/src/tmux_backend/enter_rescue.rs +0 -325
  408. package/crates/team-agent/src/tmux_backend/enter_rescue_tests.rs +0 -432
  409. package/crates/team-agent/src/tmux_backend/native_input.rs +0 -513
  410. package/crates/team-agent/src/tmux_backend/native_input_tests.rs +0 -742
  411. package/crates/team-agent/src/tmux_backend/tests.rs +0 -4254
  412. package/crates/team-agent/src/tmux_backend.rs +0 -4527
  413. package/crates/team-agent/src/topology.rs +0 -537
  414. package/crates/team-agent/src/transport/enter_rescue.rs +0 -166
  415. package/crates/team-agent/src/transport/native_input.rs +0 -491
  416. package/crates/team-agent/src/transport/test_support.rs +0 -743
  417. package/crates/team-agent/src/transport/tests/behavior.rs +0 -326
  418. package/crates/team-agent/src/transport/tests/mod.rs +0 -194
  419. package/crates/team-agent/src/transport/tests/wire.rs +0 -574
  420. package/crates/team-agent/src/transport.rs +0 -1655
  421. package/crates/team-agent/src/transport_factory.rs +0 -819
@@ -1,829 +0,0 @@
1
- //!
2
- //! `ConPtyBackend` — implements the existing `Transport` trait using the
3
- //! named-pipe protocol in `super::protocol`.
4
- //!
5
- //! ## Design boundary (design.md §Transport Boundary:97-124)
6
- //!
7
- //! Every trait method has one of three flavours:
8
- //!
9
- //! - **Required**: forwards to the shim via `PipeClient::request`.
10
- //! - **Exempt typed no-op**: e.g. `configure_adaptive_pane_title` — the
11
- //! shim has no pane title so the method returns `Ok(())` locally.
12
- //! - **Typed unsupported**: `attach_session` returns
13
- //! `AttachOutcome::Unsupported { reason }` because ConPTY has no attach
14
- //! concept (design.md:123-124; there is no `tmux attach`).
15
- //!
16
- //! ## Phase 1a scope
17
- //!
18
- //! This file lands the Transport impl **shape** + honest degradation
19
- //! when no pipe client is connected. The pipe transport itself
20
- //! (Windows named-pipe socket + real shim binary) lives in Phase 1b.
21
- //!
22
- //! When a `PipeClient` is not available (Mac dev host, tests, or a live
23
- //! Windows host whose shim died), every trait method returns
24
- //! `TransportError::MuxUnavailable { backend: BackendKind::ConPty, detail }`
25
- //! — the same honest-fail path the coordinator uses today when a tmux
26
- //! server is missing. This satisfies MUST-NOT-13 (do not silently
27
- //! success) + CR C-3 (stale shim → honest degradation).
28
- //!
29
- //! ## CR anchors
30
- //!
31
- //! - **C-1 pipe_token**: only lives in `PipeClient` in-memory state.
32
- //! `ConPtyBackend` is Send+Sync; the token field is behind
33
- //! `parking_lot::Mutex` and is NEVER handed out via a getter that
34
- //! could feed serialisation.
35
- //! - **C-2 kill_server**: this backend's `kill_server` closes the
36
- //! pipe + tells the shim to `Shutdown`. Semantics are per-workspace
37
- //! (each `ConPtyBackend` owns exactly one team shim), so callers who
38
- //! invoke `kill_server` in a `KillDecision::KillWholeServer` branch
39
- //! still get the same "tear down this workspace's transport" effect
40
- //! they get from tmux.
41
- //! - **C-3 stale event**: when `state.shim_pid` disagrees with what
42
- //! `hello` returns, the backend emits `conpty_transport.shim_pid_stale`
43
- //! BEFORE returning `MuxUnavailable`. Handled in
44
- //! `PipeClient::ensure_hello` (Phase 1b).
45
- //! - **C-5 pipe_token_mismatch**: the `PipeClient::request` inspection
46
- //! of the response's `ProtocolError::PipeTokenMismatch` translates
47
- //! directly to `TransportError::MuxUnavailable`. The client MUST NOT
48
- //! silently rotate its own token.
49
-
50
- use std::collections::BTreeMap;
51
- use std::path::Path;
52
- use std::sync::atomic::{AtomicU64, Ordering};
53
-
54
- use crate::model::enums::PaneLiveness;
55
- use crate::transport::{
56
- AttachOutcome, BackendKind, CaptureRange, CapturedText, InjectPayload, InjectReport,
57
- InjectStage, InjectVerification, Key, PaneField, PaneId, PaneInfo, SessionName, SetEnvOutcome,
58
- SpawnResult, SubmitVerification, Target, Transport, TransportError, TurnVerification,
59
- WindowName,
60
- };
61
-
62
- use conpty_transport::{
63
- protocol, CaptureRequest, HelloResult, InjectRequest, Op, ProtocolError, Request, Response,
64
- SpawnRequest, SpawnResult as ProtoSpawnResult,
65
- };
66
-
67
- /// The `Transport` implementation for the named ConPTY backend.
68
- ///
69
- /// The pipe client is optional so this struct can be constructed on
70
- /// non-Windows hosts and in tests without a live shim; all trait methods
71
- /// return `MuxUnavailable` in that case (honest degradation, not silent
72
- /// success).
73
- pub struct ConPtyBackend {
74
- /// Canonical workspace-hash + team-key key — used only for the
75
- /// `MuxUnavailable` diagnostic detail so operators see which shim
76
- /// was expected.
77
- workspace_hash: String,
78
- team_key: String,
79
- /// In-memory pipe_token learned from `hello`. CR C-1: never
80
- /// persisted. Stored behind std::sync::Mutex so the backend can
81
- /// be `Send + Sync` and shared across threads.
82
- pipe_token: std::sync::Mutex<Option<String>>,
83
- /// Present when a `PipeClient` is wired. When present, all
84
- /// Required trait methods forward through the client; when absent,
85
- /// they degrade to `MuxUnavailable` honest-fail.
86
- ///
87
- /// 0.5.x CR C-5 fix (leader msg_a89b5a03bbf0): behind a Mutex so
88
- /// the lazy `ensure_pipe_client` path can populate it on first
89
- /// Op call. Prior shape kept it in `Option<...>` outside a lock,
90
- /// which was fine when the factory pre-wired via
91
- /// `with_pipe_client` but is racy under lazy semantics.
92
- pipe_client: std::sync::Mutex<Option<Box<dyn PipeClientTrait>>>,
93
- /// Optional pipe-name hint used by lazy connect. The factory
94
- /// stashes this when it sees `state.transport.shim.pipe_name`
95
- /// (Batch 5+), and `ensure_pipe_client` uses it on first Op that
96
- /// needs the pipe. `None` = factory had no hint → backend stays
97
- /// unwired.
98
- pipe_hint: Option<String>,
99
- /// Monotonic request id counter — never persisted, never surfaced
100
- /// to callers.
101
- request_counter: AtomicU64,
102
- }
103
-
104
- impl ConPtyBackend {
105
- /// New backend for `(workspace_hash, team_key)`. The pipe client is
106
- /// left unset; callers wire it via `with_pipe_client` (Batch 6
107
- /// direct-handoff) or `with_pipe_hint` (Batch 5+ lazy connect).
108
- pub fn new(workspace_hash: impl Into<String>, team_key: impl Into<String>) -> Self {
109
- Self {
110
- workspace_hash: workspace_hash.into(),
111
- team_key: team_key.into(),
112
- pipe_token: std::sync::Mutex::new(None),
113
- pipe_client: std::sync::Mutex::new(None),
114
- pipe_hint: None,
115
- request_counter: AtomicU64::new(0),
116
- }
117
- }
118
-
119
- /// 0.5.x CR C-5 fix (leader msg_a89b5a03bbf0): stash a pipe-name
120
- /// hint for lazy connect. This is what the factory uses in
121
- /// `build_conpty` — no I/O at resolve time; the connect is
122
- /// deferred to the first Op that needs the pipe.
123
- ///
124
- /// Idempotent: calling twice with the same hint is a no-op;
125
- /// calling with a different hint overrides the previous. The
126
- /// factory calls this ONCE per resolve.
127
- pub fn with_pipe_hint(mut self, pipe_name: impl Into<String>) -> Self {
128
- self.pipe_hint = Some(pipe_name.into());
129
- self
130
- }
131
-
132
- /// Read the current pipe-name hint (for factory logic that
133
- /// derives a fallback hint from env override).
134
- pub fn pipe_hint_ref(&self) -> Option<&str> {
135
- self.pipe_hint.as_deref()
136
- }
137
-
138
- /// Wire a live PipeClient. Immediately performs `hello` to negotiate
139
- /// the pipe_token; on failure, drops the client so subsequent calls
140
- /// degrade honestly.
141
- ///
142
- /// Used by `lifecycle/launch.rs` Batch 6 direct-handoff path
143
- /// (quick-start conpty spawn on Windows), where the coordinator
144
- /// already has a Hello-connected client from
145
- /// `coordinator::conpty_shim::spawn_shim_and_handshake`. The
146
- /// client becomes the backend's initial `pipe_client` cache
147
- /// value, unifying with the lazy path (subsequent Ops just find
148
- /// a wired client and skip the lazy `ensure_pipe_client` cost).
149
- pub fn with_pipe_client(
150
- self,
151
- client: Box<dyn PipeClientTrait>,
152
- ) -> Result<Self, TransportError> {
153
- // Hello does NOT require token pre-match; use a placeholder.
154
- let req = Request::new(
155
- self.next_request_id(),
156
- &self.workspace_hash,
157
- &self.team_key,
158
- "PENDING",
159
- Op::Hello,
160
- );
161
- let resp = client.request(&req)?;
162
- if !resp.ok {
163
- return Err(TransportError::MuxUnavailable {
164
- backend: BackendKind::ConPty,
165
- detail: format!("hello failed: {:?}", resp.error),
166
- });
167
- }
168
- let hello: HelloResult =
169
- serde_json::from_value(resp.result).map_err(|e| TransportError::MuxUnavailable {
170
- backend: BackendKind::ConPty,
171
- detail: format!("hello response malformed: {e}"),
172
- })?;
173
- *self.pipe_token.lock().unwrap() = Some(hello.pipe_token);
174
- *self.pipe_client.lock().unwrap() = Some(client);
175
- Ok(self)
176
- }
177
-
178
- /// 0.5.x CR C-5 fix (leader msg_a89b5a03bbf0): the lazy-connect
179
- /// helper. Called from `dispatch` on the first Op that needs the
180
- /// pipe.
181
- ///
182
- /// Semantics:
183
- /// 1. If `pipe_client` is already set (Batch 6 direct-handoff or
184
- /// a prior lazy connect), return Ok immediately.
185
- /// 2. Else if `pipe_hint` is set, attempt
186
- /// `NamedPipeClient::connect(&hint, 2000)` (the same 2000ms
187
- /// timeout the factory used pre-C-5-fix — leader constraint
188
- /// "沿用 2000ms 语义"), perform Hello, cache the client.
189
- /// 3. Else return `MuxUnavailable::no_pipe_client`.
190
- ///
191
- /// On Unix this fn is a no-op stub — `NamedPipeClient` doesn't
192
- /// exist there. Callers that reach this path on Unix already
193
- /// have `pipe_client == None` and fall to the error branch,
194
- /// which is the pre-C-5-fix behavior.
195
- fn ensure_pipe_client(&self) -> Result<(), TransportError> {
196
- // Fast path: already wired.
197
- if self.pipe_client.lock().unwrap().is_some() {
198
- return Ok(());
199
- }
200
- // Lazy path: need a hint + Windows backend.
201
- #[cfg(windows)]
202
- {
203
- let Some(pipe_name) = self.pipe_hint.as_ref() else {
204
- return Err(self.mux_unavailable("no_pipe_hint"));
205
- };
206
- let client = conpty_transport::NamedPipeClient::connect(pipe_name, 2000)
207
- .map_err(|e| self.mux_unavailable(&format!("connect_failed: {e}")))?;
208
- let adapter = crate::conpty::PipeClientAdapter(client);
209
- // Perform Hello inline to negotiate pipe_token.
210
- let req = Request::new(
211
- self.next_request_id(),
212
- &self.workspace_hash,
213
- &self.team_key,
214
- "PENDING",
215
- Op::Hello,
216
- );
217
- let resp = adapter.request(&req)?;
218
- if !resp.ok {
219
- return Err(TransportError::MuxUnavailable {
220
- backend: BackendKind::ConPty,
221
- detail: format!("hello_failed: {:?}", resp.error),
222
- });
223
- }
224
- let hello: HelloResult = serde_json::from_value(resp.result).map_err(|e| {
225
- TransportError::MuxUnavailable {
226
- backend: BackendKind::ConPty,
227
- detail: format!("hello_response_malformed: {e}"),
228
- }
229
- })?;
230
- *self.pipe_token.lock().unwrap() = Some(hello.pipe_token);
231
- *self.pipe_client.lock().unwrap() = Some(Box::new(adapter));
232
- Ok(())
233
- }
234
- #[cfg(not(windows))]
235
- {
236
- // Unix has no NamedPipeClient. If we got here without a
237
- // wired client, degrade honestly.
238
- Err(self.mux_unavailable("no_pipe_client"))
239
- }
240
- }
241
-
242
- fn next_request_id(&self) -> String {
243
- let n = self.request_counter.fetch_add(1, Ordering::Relaxed);
244
- format!("req-{n}")
245
- }
246
-
247
- fn build_request(&self, op: Op, payload: serde_json::Value) -> Result<Request, TransportError> {
248
- let token = self
249
- .pipe_token
250
- .lock()
251
- .unwrap()
252
- .clone()
253
- .ok_or_else(|| self.mux_unavailable("hello_never_completed"))?;
254
- Ok(Request::new(
255
- self.next_request_id(),
256
- &self.workspace_hash,
257
- &self.team_key,
258
- token,
259
- op,
260
- )
261
- .with_payload(payload))
262
- }
263
-
264
- fn dispatch(&self, op: Op, payload: serde_json::Value) -> Result<Response, TransportError> {
265
- // 0.5.x CR C-5 fix (leader msg_a89b5a03bbf0): trigger the
266
- // lazy connect + Hello on first Op that needs the pipe. If a
267
- // client was pre-wired (Batch 6 direct-handoff) or a prior
268
- // Op already connected, `ensure_pipe_client` is a fast
269
- // no-op.
270
- self.ensure_pipe_client()?;
271
- let req = self.build_request(op, payload)?;
272
- let client_guard = self.pipe_client.lock().unwrap();
273
- let client = client_guard
274
- .as_ref()
275
- .ok_or_else(|| self.mux_unavailable(&format!("{op:?}").to_lowercase()))?;
276
- let resp = client.request(&req)?;
277
- if !resp.ok {
278
- return Err(map_protocol_error(resp.error.as_ref()));
279
- }
280
- Ok(resp)
281
- }
282
-
283
- fn do_spawn(
284
- &self,
285
- session: &SessionName,
286
- window: &WindowName,
287
- argv: &[String],
288
- cwd: &Path,
289
- env: &BTreeMap<String, String>,
290
- env_unset: &[String],
291
- ) -> Result<SpawnResult, TransportError> {
292
- let payload = serde_json::to_value(SpawnRequest {
293
- session: session.as_str().to_string(),
294
- window: window.as_str().to_string(),
295
- argv: argv.to_vec(),
296
- cwd: cwd.to_string_lossy().to_string(),
297
- env: env.clone(),
298
- env_unset: env_unset.to_vec(),
299
- cols: 120,
300
- rows: 30,
301
- })
302
- .map_err(|e| TransportError::Spawn {
303
- backend: BackendKind::ConPty,
304
- source: std::io::Error::other(e),
305
- })?;
306
- let resp = self.dispatch(Op::Spawn, payload)?;
307
- let spawn: ProtoSpawnResult =
308
- serde_json::from_value(resp.result).map_err(|e| TransportError::Spawn {
309
- backend: BackendKind::ConPty,
310
- source: std::io::Error::other(e),
311
- })?;
312
- Ok(SpawnResult {
313
- pane_id: PaneId::new(spawn.pane_id),
314
- session: SessionName::new(spawn.session),
315
- window: WindowName::new(spawn.window),
316
- child_pid: spawn.child_pid,
317
- })
318
- }
319
-
320
- /// Build a `MuxUnavailable` error explaining that no pipe client is
321
- /// wired for this backend. The detail string carries the
322
- /// `(workspace_hash, team_key)` so operators can correlate with
323
- /// state.json's `transport.pipe_name`.
324
- fn mux_unavailable(&self, op: &str) -> TransportError {
325
- TransportError::MuxUnavailable {
326
- backend: BackendKind::ConPty,
327
- detail: format!(
328
- "no_pipe_client (op={op}, workspace_hash={ws}, team_key={team}); \
329
- no live shim wired — this is honest degradation, not silent success",
330
- ws = self.workspace_hash,
331
- team = self.team_key,
332
- ),
333
- }
334
- }
335
- }
336
-
337
- /// Resolve a `Target` to a pane_id string for the shim protocol.
338
- /// SessionWindow targets look up via `list_targets` are not supported
339
- /// at the trait boundary today — the coordinator delivery path always
340
- /// resolves worker IDs to `Target::Pane` before injection. If a
341
- /// SessionWindow slips in, return a `TargetNotFound`.
342
- fn pane_id_from_target(target: &Target) -> Result<String, TransportError> {
343
- match target {
344
- Target::Pane(p) => Ok(p.as_str().to_string()),
345
- Target::SessionWindow { session, window } => Err(TransportError::TargetNotFound {
346
- target: format!(
347
- "conpty backend requires Target::Pane; got SessionWindow({}, {})",
348
- session.as_str(),
349
- window.as_str()
350
- ),
351
- }),
352
- }
353
- }
354
-
355
- /// Map a `ProtocolError` returned by the shim to a `TransportError`
356
- /// per design §Request Shape:332-338 + CR C-5.
357
- fn map_protocol_error(err: Option<&ProtocolError>) -> TransportError {
358
- let Some(err) = err else {
359
- return TransportError::MuxUnavailable {
360
- backend: BackendKind::ConPty,
361
- detail: "shim returned ok=false without error payload".to_string(),
362
- };
363
- };
364
- match err {
365
- // CR C-5: token mismatch is honest MuxUnavailable — never silent
366
- // retry with a rotated token.
367
- ProtocolError::PipeTokenMismatch { message } => TransportError::MuxUnavailable {
368
- backend: BackendKind::ConPty,
369
- detail: format!("pipe_token_mismatch: {message}"),
370
- },
371
- ProtocolError::SchemaSkew {
372
- message,
373
- sent,
374
- expected,
375
- } => TransportError::MuxUnavailable {
376
- backend: BackendKind::ConPty,
377
- detail: format!("schema_skew sent={sent} expected={expected}: {message}"),
378
- },
379
- ProtocolError::TargetNotFound { message } => TransportError::TargetNotFound {
380
- target: message.clone(),
381
- },
382
- ProtocolError::Spawn { message } => TransportError::Spawn {
383
- backend: BackendKind::ConPty,
384
- source: std::io::Error::other(message.clone()),
385
- },
386
- ProtocolError::Inject { message, stage } => TransportError::Inject {
387
- stage: match stage.as_str() {
388
- "text" | "load_buffer" => InjectStage::LoadBuffer,
389
- _ => InjectStage::Submit,
390
- },
391
- source: std::io::Error::other(message.clone()),
392
- },
393
- ProtocolError::Capture { message } => TransportError::Capture {
394
- source: std::io::Error::other(message.clone()),
395
- },
396
- ProtocolError::ShimUnavailable { message } | ProtocolError::Other { message } => {
397
- TransportError::MuxUnavailable {
398
- backend: BackendKind::ConPty,
399
- detail: message.clone(),
400
- }
401
- }
402
- }
403
- }
404
-
405
- /// Object-safe pipe-client trait so `ConPtyBackend` can hold a boxed
406
- /// client without depending on the concrete Windows named-pipe type.
407
- /// Phase 1b implements this against a real `\\.\pipe\...` handle;
408
- /// Phase 1a tests can implement it against an in-memory
409
- /// `Cursor<Vec<u8>>` pair.
410
- ///
411
- /// The `request` method returns the raw `Response`; the backend layer
412
- /// maps errors into `TransportError`.
413
- pub trait PipeClientTrait: Send + Sync {
414
- fn request(&self, req: &Request) -> Result<Response, TransportError>;
415
- }
416
-
417
- /// Wrap a `conpty_transport::PipeClient` (which returns `Response`
418
- /// directly) into a `PipeClientTrait` (which returns
419
- /// `Result<Response, TransportError>`). Used by team-agent's fake-worker
420
- /// path to plug in the portable `LocalShimClient`.
421
- pub struct PipeClientAdapter<C: conpty_transport::PipeClient>(pub C);
422
-
423
- impl<C: conpty_transport::PipeClient> PipeClientTrait for PipeClientAdapter<C> {
424
- fn request(&self, req: &Request) -> Result<Response, TransportError> {
425
- Ok(self.0.request(req))
426
- }
427
- }
428
-
429
- impl Transport for ConPtyBackend {
430
- fn kind(&self) -> BackendKind {
431
- BackendKind::ConPty
432
- }
433
-
434
- fn probes_real_tmux_socket_roots(&self) -> bool {
435
- // Design §Transport Boundary:102 — ConPTY exposes pipe name via
436
- // a separate diagnostic field, NOT this tmux method.
437
- false
438
- }
439
-
440
- fn tmux_endpoint(&self) -> Option<String> {
441
- // Same — pipe name is exposed elsewhere, not here.
442
- None
443
- }
444
-
445
- fn spawn_first(
446
- &self,
447
- session: &SessionName,
448
- window: &WindowName,
449
- argv: &[String],
450
- cwd: &Path,
451
- env: &BTreeMap<String, String>,
452
- ) -> Result<SpawnResult, TransportError> {
453
- self.do_spawn(session, window, argv, cwd, env, &[])
454
- }
455
-
456
- fn spawn_into(
457
- &self,
458
- session: &SessionName,
459
- window: &WindowName,
460
- argv: &[String],
461
- cwd: &Path,
462
- env: &BTreeMap<String, String>,
463
- ) -> Result<SpawnResult, TransportError> {
464
- self.do_spawn(session, window, argv, cwd, env, &[])
465
- }
466
-
467
- fn spawn_first_with_env_unset(
468
- &self,
469
- session: &SessionName,
470
- window: &WindowName,
471
- argv: &[String],
472
- cwd: &Path,
473
- env: &BTreeMap<String, String>,
474
- env_unset: &[String],
475
- ) -> Result<SpawnResult, TransportError> {
476
- self.do_spawn(session, window, argv, cwd, env, env_unset)
477
- }
478
-
479
- fn spawn_into_with_env_unset(
480
- &self,
481
- session: &SessionName,
482
- window: &WindowName,
483
- argv: &[String],
484
- cwd: &Path,
485
- env: &BTreeMap<String, String>,
486
- env_unset: &[String],
487
- ) -> Result<SpawnResult, TransportError> {
488
- self.do_spawn(session, window, argv, cwd, env, env_unset)
489
- }
490
-
491
- fn inject(
492
- &self,
493
- target: &Target,
494
- payload: &InjectPayload,
495
- submit: Key,
496
- _bracketed: bool,
497
- ) -> Result<InjectReport, TransportError> {
498
- let pane_id = pane_id_from_target(target)?;
499
- let text = payload.text().unwrap_or("").to_string();
500
- let submit_key = match submit {
501
- Key::Enter => Some("enter".to_string()),
502
- Key::Up => Some("up".to_string()),
503
- Key::Down => Some("down".to_string()),
504
- Key::Left => Some("left".to_string()),
505
- Key::Right => Some("right".to_string()),
506
- Key::Escape => Some("escape".to_string()),
507
- Key::CtrlC => Some("ctrl_c".to_string()),
508
- Key::Char(_) | Key::CancelMode => None,
509
- };
510
- let payload_json = serde_json::to_value(InjectRequest {
511
- pane_id,
512
- text,
513
- submit_key,
514
- bracketed: _bracketed,
515
- })
516
- .map_err(|e| TransportError::Inject {
517
- stage: InjectStage::LoadBuffer,
518
- source: std::io::Error::other(e),
519
- })?;
520
- self.dispatch(Op::Inject, payload_json)?;
521
- // Design §SubmitVerification:346 — text + CR = EnterSentWithoutPlaceholderCheck.
522
- Ok(InjectReport {
523
- stage_reached: InjectStage::Submit,
524
- inject_verification: if matches!(payload, InjectPayload::Empty) {
525
- InjectVerification::NoToken
526
- } else {
527
- InjectVerification::CaptureContainsToken
528
- },
529
- submit_verification: match submit {
530
- Key::Enter => SubmitVerification::EnterSentWithoutPlaceholderCheck,
531
- other => SubmitVerification::KeySentAfterVisibleToken { key: other },
532
- },
533
- turn_verification: TurnVerification::NotYetObserved,
534
- attempts: 1,
535
- submit_diagnostics: None,
536
- })
537
- }
538
-
539
- fn send_keys(&self, _target: &Target, _keys: &[Key]) -> Result<(), TransportError> {
540
- self.dispatch(Op::SendKeys, serde_json::Value::Null)?;
541
- Ok(())
542
- }
543
-
544
- fn capture(
545
- &self,
546
- target: &Target,
547
- range: CaptureRange,
548
- ) -> Result<CapturedText, TransportError> {
549
- let pane_id = pane_id_from_target(target)?;
550
- let range_str = match range {
551
- CaptureRange::Full => "full".to_string(),
552
- CaptureRange::Head(n) => format!("head:{n}"),
553
- CaptureRange::Tail(n) => format!("tail:{n}"),
554
- };
555
- let payload = serde_json::to_value(CaptureRequest {
556
- pane_id,
557
- range: range_str,
558
- })
559
- .map_err(|e| TransportError::Capture {
560
- source: std::io::Error::other(e),
561
- })?;
562
- let resp = self.dispatch(Op::Capture, payload)?;
563
- let cap: protocol::CaptureResult =
564
- serde_json::from_value(resp.result).map_err(|e| TransportError::Capture {
565
- source: std::io::Error::other(e),
566
- })?;
567
- Ok(CapturedText {
568
- text: cap.text,
569
- range,
570
- })
571
- }
572
-
573
- fn query(&self, _target: &Target, _field: PaneField) -> Result<Option<String>, TransportError> {
574
- Ok(None)
575
- }
576
-
577
- fn liveness(&self, pane: &PaneId) -> Result<PaneLiveness, TransportError> {
578
- let resp = self.dispatch(Op::Liveness, serde_json::json!({"pane_id": pane.as_str()}))?;
579
- let known = resp.result["known"].as_bool().unwrap_or(false);
580
- let alive = resp.result["alive"].as_bool().unwrap_or(false);
581
- Ok(match (known, alive) {
582
- (true, true) => PaneLiveness::Live,
583
- (true, false) => PaneLiveness::Dead,
584
- _ => PaneLiveness::Unknown,
585
- })
586
- }
587
-
588
- fn list_targets(&self) -> Result<Vec<PaneInfo>, TransportError> {
589
- let resp = self.dispatch(Op::ListTargets, serde_json::Value::Null)?;
590
- let empty = vec![];
591
- let list = resp.result["targets"].as_array().unwrap_or(&empty);
592
- Ok(list
593
- .iter()
594
- .map(|row| PaneInfo {
595
- pane_id: PaneId::new(row["pane_id"].as_str().unwrap_or("").to_string()),
596
- session: SessionName::new(row["session"].as_str().unwrap_or("").to_string()),
597
- window_index: None,
598
- window_name: row["window"]
599
- .as_str()
600
- .map(|w| WindowName::new(w.to_string())),
601
- pane_index: None,
602
- tty: None,
603
- current_command: None,
604
- current_path: None,
605
- active: true,
606
- pane_pid: row["child_pid"].as_u64().map(|p| p as u32),
607
- leader_env: BTreeMap::new(),
608
- })
609
- .collect())
610
- }
611
-
612
- fn has_session(&self, session: &SessionName) -> Result<bool, TransportError> {
613
- let resp = self.dispatch(
614
- Op::HasSession,
615
- serde_json::json!({"session": session.as_str()}),
616
- )?;
617
- Ok(resp.result["present"].as_bool().unwrap_or(false))
618
- }
619
-
620
- fn list_windows(&self, session: &SessionName) -> Result<Vec<WindowName>, TransportError> {
621
- let resp = self.dispatch(
622
- Op::ListWindows,
623
- serde_json::json!({"session": session.as_str()}),
624
- )?;
625
- let empty = vec![];
626
- let list = resp.result["windows"].as_array().unwrap_or(&empty);
627
- Ok(list
628
- .iter()
629
- .filter_map(|v| v.as_str())
630
- .map(|s| WindowName::new(s.to_string()))
631
- .collect())
632
- }
633
-
634
- fn set_session_env(
635
- &self,
636
- _session: &SessionName,
637
- _key: &str,
638
- _value: &str,
639
- ) -> Result<SetEnvOutcome, TransportError> {
640
- // Design §Transport Boundary:118 — ConPTY internalises env at
641
- // spawn time; post-spawn mutation is NOT supported. This is a
642
- // typed capability refusal, NOT an error, so it returns
643
- // `Ok(InternalizedAtSpawn)` even without a live pipe client.
644
- Ok(SetEnvOutcome::InternalizedAtSpawn)
645
- }
646
-
647
- fn set_window_option(
648
- &self,
649
- _session: &SessionName,
650
- _window: &WindowName,
651
- _option: &str,
652
- _value: &str,
653
- ) -> Result<(), TransportError> {
654
- // Design §Transport Boundary: window options are tmux concepts; ConPTY
655
- // has no per-window option registry, so this is a typed capability
656
- // refusal. Callers must `let _ =` this (A-55 lockdown is best-effort).
657
- Err(TransportError::MuxUnavailable {
658
- backend: BackendKind::ConPty,
659
- detail: "set-window-option is tmux-only".to_string(),
660
- })
661
- }
662
-
663
- fn has_pane(&self, pane: &PaneId) -> Result<Option<bool>, TransportError> {
664
- let resp = self.dispatch(Op::HasPane, serde_json::json!({"pane_id": pane.as_str()}))?;
665
- Ok(Some(resp.result["present"].as_bool().unwrap_or(false)))
666
- }
667
-
668
- fn kill_server(&self) -> Result<(), TransportError> {
669
- // CR C-2: kill_server on ConPTY = shutdown this workspace's
670
- // shim (per-team, NOT global). Existing tmux callers already
671
- // gate the invocation on a KillDecision::KillWholeServer
672
- // branch that scopes to the caller's transport instance, so
673
- // per-workspace semantics naturally hold here.
674
- self.dispatch(Op::Shutdown, serde_json::Value::Null)?;
675
- Ok(())
676
- }
677
-
678
- fn kill_session(&self, session: &SessionName) -> Result<(), TransportError> {
679
- self.dispatch(
680
- Op::KillSession,
681
- serde_json::json!({"session": session.as_str()}),
682
- )?;
683
- Ok(())
684
- }
685
-
686
- fn kill_window(&self, target: &Target) -> Result<(), TransportError> {
687
- match target {
688
- Target::Pane(pane) => {
689
- self.dispatch(Op::KillPane, serde_json::json!({"pane_id": pane.as_str()}))?;
690
- }
691
- Target::SessionWindow { session, window } => {
692
- self.dispatch(
693
- Op::KillWindow,
694
- serde_json::json!({
695
- "session": session.as_str(),
696
- "window": window.as_str(),
697
- }),
698
- )?;
699
- }
700
- }
701
- Ok(())
702
- }
703
-
704
- fn kill_pane(&self, pane: &PaneId) -> Result<(), TransportError> {
705
- self.dispatch(Op::KillPane, serde_json::json!({"pane_id": pane.as_str()}))?;
706
- Ok(())
707
- }
708
-
709
- fn attach_session(&self, _session: &SessionName) -> Result<AttachOutcome, TransportError> {
710
- // Design §Transport Boundary:123 + §Visibility Without tmux attach:374
711
- // — ConPTY has NO attach concept. Typed refusal, not error.
712
- // This is honest and matches the tmux-only method's semantics.
713
- Ok(AttachOutcome::Unsupported {
714
- reason: "ConPTY worker backend has no interactive attach; \
715
- use `team-agent capture` or the optional \
716
- `windows-view` (Phase 5) for scrollback."
717
- .to_string(),
718
- })
719
- }
720
- }
721
-
722
- #[cfg(test)]
723
- mod tests {
724
- use super::*;
725
-
726
- #[test]
727
- fn kind_is_conpty() {
728
- let b = ConPtyBackend::new("wshash", "team-a");
729
- assert_eq!(b.kind(), BackendKind::ConPty);
730
- }
731
-
732
- #[test]
733
- fn tmux_specific_methods_return_none_or_false() {
734
- let b = ConPtyBackend::new("wshash", "team-a");
735
- // Design §Transport Boundary:102 — ConPTY MUST NOT lie by
736
- // reporting a fake tmux socket.
737
- assert_eq!(b.tmux_endpoint(), None);
738
- assert!(!b.probes_real_tmux_socket_roots());
739
- }
740
-
741
- #[test]
742
- fn attach_session_returns_typed_unsupported() {
743
- // Design §Transport Boundary:123 anchor. The refusal is
744
- // `AttachOutcome::Unsupported`, NOT a `TransportError`.
745
- let b = ConPtyBackend::new("wshash", "team-a");
746
- let out = b.attach_session(&SessionName::new("s")).unwrap();
747
- match out {
748
- AttachOutcome::Unsupported { reason } => {
749
- assert!(!reason.is_empty(), "reason must be non-empty");
750
- }
751
- other => panic!("expected Unsupported, got {other:?}"),
752
- }
753
- }
754
-
755
- #[test]
756
- fn set_session_env_returns_internalized_at_spawn() {
757
- // Design §Transport Boundary:118. Typed refusal, not error.
758
- let b = ConPtyBackend::new("wshash", "team-a");
759
- let out = b
760
- .set_session_env(&SessionName::new("s"), "KEY", "value")
761
- .unwrap();
762
- assert_eq!(out, SetEnvOutcome::InternalizedAtSpawn);
763
- }
764
-
765
- #[test]
766
- fn no_pipe_client_returns_honest_mux_unavailable_not_success() {
767
- // MUST-NOT-13 + CR C-3: with no pipe client wired we must NOT
768
- // silently pretend the spawn/inject/capture succeeded.
769
- //
770
- // Each backend method dispatches through the underlying protocol
771
- // `Op::*`; when no client is wired the `mux_unavailable` diag
772
- // records the lowercased op discriminant ("spawn", "inject",
773
- // etc.). Every method must therefore surface a distinct-shape
774
- // MuxUnavailable, not silently swallow the request.
775
- let b = ConPtyBackend::new("wshash", "team-a");
776
- let errs = [
777
- b.spawn_first(
778
- &SessionName::new("s"),
779
- &WindowName::new("w"),
780
- &[],
781
- Path::new("/tmp"),
782
- &BTreeMap::new(),
783
- )
784
- .unwrap_err(),
785
- b.spawn_into(
786
- &SessionName::new("s"),
787
- &WindowName::new("w"),
788
- &[],
789
- Path::new("/tmp"),
790
- &BTreeMap::new(),
791
- )
792
- .unwrap_err(),
793
- b.inject(
794
- &Target::Pane(PaneId::new("conpty:test")),
795
- &InjectPayload::Empty,
796
- Key::Enter,
797
- false,
798
- )
799
- .unwrap_err(),
800
- b.capture(
801
- &Target::Pane(PaneId::new("conpty:test")),
802
- CaptureRange::Tail(80),
803
- )
804
- .unwrap_err(),
805
- b.list_targets().unwrap_err(),
806
- b.kill_session(&SessionName::new("s")).unwrap_err(),
807
- ];
808
- for err in errs {
809
- match err {
810
- TransportError::MuxUnavailable { backend, detail } => {
811
- assert_eq!(backend, BackendKind::ConPty);
812
- assert!(
813
- detail.contains("no_pipe_client"),
814
- "detail must anchor on `no_pipe_client` tag, got {detail}"
815
- );
816
- assert!(
817
- detail.contains("workspace_hash=wshash"),
818
- "detail must include workspace_hash, got {detail}"
819
- );
820
- assert!(
821
- detail.contains("team_key=team-a"),
822
- "detail must include team_key, got {detail}"
823
- );
824
- }
825
- other => panic!("expected MuxUnavailable, got {other:?}"),
826
- }
827
- }
828
- }
829
- }