@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,368 +0,0 @@
1
- //! Generic contract-native seat fork (avatar): one pipeline for every leaf.
2
- //! The descriptor's fork facet selects the admitted mode, the leaf's H2/H7
3
- //! supply native argv and stage intent, and the shared `Lifecycle::fork` runs
4
- //! F0-F5 with its own compensation. Only the registry dispatches per leaf; a
5
- //! refused provider leaves no role, spec, state, pane or native file behind.
6
- use std::path::{Path, PathBuf};
7
-
8
- use serde_json::{json, Value};
9
- use team_agent_contract::contract::{
10
- fork::{resolve_fork, select_new_seat_mode, ForkMode, ForkRequest},
11
- plan::{resolve_launch, validate_launch_plan},
12
- types::{ContractError, Operation, OperationId, SeatId},
13
- };
14
- use team_agent_contract::host::{clock::RealClock, command::RealCommandRunner, materialize::ScopedMaterializer};
15
- use team_agent_contract::orchestration::{
16
- lifecycle::{Adapter, Lifecycle, Routing},
17
- physical::{PhysicalRuntime, Registration},
18
- store::{OperationRecord, Outcome, SeatStatus},
19
- Error,
20
- };
21
-
22
- use crate::cli::CliError;
23
- use crate::lifecycle::launch::add_agent_state::{inject_agent_into_spec, rollback_add_agent_atomic, upsert_agent_entry};
24
- use crate::model::ids::AgentId;
25
- use crate::model::yaml::Value as Yaml;
26
- use crate::state::selector::SelectedTeam;
27
-
28
- use super::{
29
- backend::{self, Backend, BackendError},
30
- commands,
31
- config::{MemberRoute, RoleConfig},
32
- discovery, framework, registry,
33
- };
34
-
35
- fn error(error: impl std::fmt::Display) -> CliError {
36
- CliError::Runtime(error.to_string())
37
- }
38
-
39
- fn refused(provider: &str, refusal: ContractError) -> CliError {
40
- CliError::Runtime(format!(
41
- "{provider} does not support session forking: {refusal}; no seat, pane or file was created"
42
- ))
43
- }
44
-
45
- /// `fork-agent <source> --as <target>` for a contract seat. None: the source
46
- /// is not a contract seat and keeps its own runtime's fork path.
47
- pub fn fork_agent(
48
- workspace: &Path,
49
- team: Option<&str>,
50
- source: &str,
51
- target: &str,
52
- label: Option<&str>,
53
- ) -> Result<Option<Value>, CliError> {
54
- commands::with_agent(workspace, team, source, "fork-agent", |selected, source_id| {
55
- fork_locked(selected, source_id, target, label)
56
- })
57
- }
58
-
59
- /// Called under the source's lifecycle lock (`with_agent`).
60
- fn fork_locked(
61
- selected: &SelectedTeam,
62
- source_id: &SeatId,
63
- target: &str,
64
- label: Option<&str>,
65
- ) -> Result<Value, CliError> {
66
- let workspace = selected.run_workspace.as_path();
67
- let team = selected.team_key.as_str();
68
- // F0 is read-only: nothing below writes until the role file.
69
- let parent = Backend::open_readonly(workspace, team).map_err(error)?
70
- .store.seat(source_id).map_err(error)?
71
- .ok_or_else(|| error("contract source seat is not in its native store"))?;
72
- let provider = parent.provider.as_str().to_owned();
73
- let descriptor = registry::provider(&provider).map_err(error)?.descriptor();
74
- if target == source_id.as_str() {
75
- // The same seat can only branch in place, and only when admitted.
76
- descriptor.fork.in_window.require("in-window branch").map_err(|refusal| refused(&provider, refusal))?;
77
- return Err(error("contract_capability_unverified: in-window branch dispatch is not wired; no key was sent"));
78
- }
79
- if select_new_seat_mode(descriptor).map_err(|refusal| refused(&provider, refusal))? != ForkMode::NativeNewSeat {
80
- return Err(error(format!(
81
- "contract_capability_unverified: {provider} full-snapshot staging is not wired; no seat was created"
82
- )));
83
- }
84
- let target_id = SeatId::new(target).map_err(|_| error(format!("invalid fork target id: {target}")))?;
85
- if target == "leader" {
86
- return Err(error("fork target id `leader` is reserved"));
87
- }
88
- let source_session = parent.session.as_ref()
89
- .filter(|_| parent.status != SeatStatus::Unknown)
90
- .map(|session| session.native_session.as_str().to_owned())
91
- .ok_or_else(|| error("contract source seat has no captured native session to fork"))?;
92
- if selected.state.get("agents").and_then(|agents| agents.get(target)).is_some() {
93
- return Err(error(format!("agent id already exists: {target}")));
94
- }
95
- let role_path = selected.team_dir.join("agents").join(format!("{target}.md"));
96
- if std::fs::symlink_metadata(&role_path).is_ok() {
97
- return Err(error(format!("role file already exists: {}", role_path.display())));
98
- }
99
- let config = framework::team_config(workspace, &selected.team_dir, team).map_err(error)?
100
- .ok_or_else(|| error("contract team configuration is unavailable"))?;
101
- let source_role = config.roles.iter().find(|role| &role.id == source_id)
102
- .ok_or_else(|| error("contract source role is no longer configured"))?;
103
- if source_role.provider != parent.provider {
104
- return Err(error("contract source role now declares another provider; a fork keeps the parent's"));
105
- }
106
- let role_text = fork_role_text(&std::fs::read_to_string(&source_role.source).map_err(error)?, target, label);
107
- let spec_path = crate::model::paths::runtime_spec_path(workspace, team);
108
- let pre_spec = match std::fs::read_to_string(&spec_path) {
109
- Ok(text) => Some(text),
110
- Err(e) if e.kind() == std::io::ErrorKind::NotFound => None,
111
- Err(e) => return Err(error(e)),
112
- };
113
- write_new(&role_path, role_text.as_bytes()).map_err(error)?;
114
- let undo = Undo {
115
- workspace: workspace.to_path_buf(), team: team.to_owned(), target: target_id.clone(),
116
- role_path: role_path.clone(), role_bytes: role_text.into_bytes(), spec_path: spec_path.clone(), pre_spec,
117
- };
118
- let result = (|| -> Result<Value, CliError> {
119
- let config = framework::team_config(workspace, &selected.team_dir, team).map_err(error)?
120
- .ok_or_else(|| error("contract team configuration is unavailable"))?;
121
- let role = config.roles.iter().find(|role| role.id == target_id)
122
- .ok_or_else(|| error("forked contract role was not configured"))?;
123
- if role.paused || role.provider != parent.provider {
124
- return Err(error("forked contract role is paused or changed provider; nothing was started"));
125
- }
126
- register_spec(selected, &role_path, target, &spec_path, undo.pre_spec.as_deref())?;
127
- let record = native_fork(workspace, team, source_id, role, &config.members).map_err(error)?;
128
- if record.outcome != Outcome::Committed {
129
- return Err(error(BackendError::Shutdown {
130
- operation: record.id, phase: record.phase, outcome: record.outcome, failure: record.failure,
131
- }));
132
- }
133
- // The roster row appears only once the native seat has committed: a
134
- // half-built target never enters the coordinator tick's projection.
135
- upsert_agent_entry(workspace, team, &AgentId::new(target), json!({
136
- "agent_id": target, "provider": role.provider.as_str(), "runtime_family": "contract",
137
- "status": "starting", "contract_instance": null, "pane_id": null, "forked_from": source_id.as_str(),
138
- })).map_err(error)?;
139
- let projection = commands::publish_at(workspace, team, &target_id, true)?;
140
- let coordinator = crate::coordinator::start_coordinator_with_team(
141
- &crate::coordinator::WorkspacePath::new(workspace.to_path_buf()), Some(team),
142
- ).map_err(error)?;
143
- Ok(json!({"ok":coordinator.ok,"status":"forked","runtime":"contract","mode":"native_new_seat",
144
- "provider":provider,"source_agent_id":source_id.as_str(),"new_agent_id":target,"target":target,
145
- "agent_id":target,"operation":record.id,"source_session_id":source_session,
146
- "session_id":projection.get("session_id"),"new_session_id":projection.get("session_id"),
147
- "generation":projection.get("generation"),"backing_state":"verified",
148
- "coordinator":crate::lifecycle::coordinator_start_summary_value(
149
- &crate::lifecycle::CoordinatorStartSummary::from_start_report(&coordinator))}))
150
- })();
151
- result.map_err(|failure| undo.run(failure))
152
- }
153
-
154
- /// The provider-neutral F1-F5: H2 plans the native fork argv for the target,
155
- /// H7 states the intent, and `Lifecycle::fork` registers, spawns, captures the
156
- /// child binding and commits, compensating its own effects on failure.
157
- fn native_fork(
158
- workspace: &Path,
159
- team: &str,
160
- source: &SeatId,
161
- role: &RoleConfig,
162
- members: &[MemberRoute],
163
- ) -> Result<OperationRecord, BackendError> {
164
- let mut backend = Backend::open(workspace, team)?;
165
- backend::require_candidate(&backend.binding)?;
166
- if !backend::seat_unclaimed(&backend, &role.id)? {
167
- return Err(Error::Conflict.into());
168
- }
169
- let parent = backend.store.seat(source)?.ok_or(Error::Invalid("unknown native seat"))?;
170
- let session = parent.session.clone().ok_or(ContractError::Invalid("native fork source session"))?;
171
- if parent.status == SeatStatus::Unknown || parent.provider != role.provider {
172
- return Err(Error::Fence.into());
173
- }
174
- let selected = registry::provider(role.provider.as_str())?;
175
- let descriptor = selected.descriptor();
176
- let discovered = discovery::discover_runtime(&role.provider, workspace)?;
177
- if let Some(path) = selected.native_fork_source(discovered.runtime.as_ref(), &session)? {
178
- // The exact parent backing the native CLI reads must exist before any effect.
179
- let metadata = std::fs::symlink_metadata(&path)?;
180
- if !metadata.is_file() || metadata.len() == 0 {
181
- return Err(ContractError::Invalid("native fork parent backing").into());
182
- }
183
- }
184
- backend::publish_framework_routes(&mut backend, members)?;
185
- let identity = backend.store.propose_identity(&role.id)?;
186
- let server_key = selected.server_key_for(&identity)?;
187
- backend::write_role(&backend.binding, &identity, role)?;
188
- let adapter = backend::launch_adapter(&backend.binding, &identity, &role.provider, &discovered)?;
189
- let hooks = adapter.hooks();
190
- let mut launch = backend::request(&backend.binding, role, identity, &discovered)?;
191
- launch.operation = Operation::NativeNewSeat;
192
- if !descriptor.workspace.shared_cwd {
193
- launch.paths.cwd = super::workspace::prepare(&backend.binding, &role.id)?;
194
- }
195
- backend::require_private_primary(selected, &launch.paths.cwd)?;
196
- backend::preassign_session(selected, &mut launch, &discovered)?;
197
- let operation = OperationId::new(format!("fork-{}", launch.identity.instance.as_str()))?;
198
- let request = ForkRequest {
199
- mode: ForkMode::NativeNewSeat,
200
- auth: launch.auth,
201
- source: session,
202
- expected_source: parent.identity.clone(),
203
- target: launch.identity.clone(),
204
- target_native_session: None,
205
- target_backing: None,
206
- channel: launch.channel,
207
- input_profile: launch.input_profile.clone(),
208
- cwd: launch.paths.cwd.clone(),
209
- native: launch.native.clone(),
210
- evidence_kind: launch.evidence_kind,
211
- selected_turn: None,
212
- operation_id: operation.clone(),
213
- };
214
- launch.fork = Some(Box::new(resolve_fork(descriptor, &hooks, &request)?));
215
- let resolved = resolve_launch(descriptor, &hooks, &launch, Some(&discovered.catalog))?;
216
- let plan = adapter.plan(&resolved)?;
217
- validate_launch_plan(descriptor, &resolved, &plan)?;
218
- let (workspace_topology, _, _) = backend::workspace_tmux(&backend.binding, &role.id, None)?;
219
- let mut io = ScopedMaterializer::new(descriptor, &resolved, &plan, operation.clone(), RealCommandRunner::default())?;
220
- let clock = RealClock::new();
221
- let mut physical = PhysicalRuntime::new(
222
- Registration {
223
- descriptor,
224
- hooks: &hooks,
225
- controls: selected.controls(),
226
- startup: selected.startup(),
227
- session_panel: selected.session_panel(),
228
- },
229
- backend::settings(&backend.binding, selected),
230
- operation.clone(),
231
- &clock,
232
- )?;
233
- physical.evidence = backend::policy_evidence(&role.provider, &launch.native, backend.binding.candidate_sha256)?;
234
- physical.workspace_tmux = Some(workspace_topology);
235
- let routing = Routing {
236
- pane: "unpublished".into(),
237
- binding_key: format!("binding-{}", launch.identity.instance.as_str()),
238
- server_key,
239
- };
240
- let record = Lifecycle { store: &mut backend.store, host: &mut physical, io: &mut io }.fork(
241
- &Adapter { descriptor, hooks: &hooks, catalog: Some(&discovered.catalog) },
242
- &request,
243
- Some((&launch, routing)),
244
- )?;
245
- Ok(record)
246
- }
247
-
248
- /// The target's runtime spec entry and route, compiled exactly as add-agent does.
249
- fn register_spec(
250
- selected: &SelectedTeam,
251
- role_path: &Path,
252
- target: &str,
253
- spec_path: &Path,
254
- pre_spec: Option<&str>,
255
- ) -> Result<(), CliError> {
256
- let mut spec = crate::compiler::compile_team(&selected.team_dir).map_err(error)?;
257
- crate::lifecycle::launch::spec_state::override_spec_workspace(&mut spec, &selected.run_workspace);
258
- let workspace_text = spec.get("team").and_then(|team| team.get("workspace")).and_then(Yaml::as_str)
259
- .map(str::to_owned)
260
- .unwrap_or_else(|| selected.run_workspace.to_string_lossy().into_owned());
261
- let team_meta = crate::compiler::read_front_matter(&selected.team_dir.join("TEAM.md"))
262
- .map(|(meta, _)| meta)
263
- .unwrap_or(Yaml::Null);
264
- let compiled = crate::compiler::compile_role_agent(role_path, &team_meta, &workspace_text).map_err(error)?;
265
- if compiled.id != target {
266
- return Err(error(format!("forked role compiles to '{}', not '{target}'", compiled.id)));
267
- }
268
- let mut latest = pre_spec.and_then(|text| crate::model::yaml::loads(text).ok()).unwrap_or(spec);
269
- inject_agent_into_spec(&mut latest, compiled.agent, &compiled.id).map_err(error)?;
270
- crate::lifecycle::launch::spec_state::write_spec_atomic(spec_path, &latest).map_err(error)
271
- }
272
-
273
- /// The parent's role document under the target's identity: its own name, the
274
- /// optional label as role, every other field and the body unchanged.
275
- fn fork_role_text(source: &str, target: &str, label: Option<&str>) -> String {
276
- let (mut meta, body) = crate::compiler::split_front_matter(source);
277
- if let Yaml::Map(pairs) = &mut meta {
278
- pairs.retain(|(key, _)| key != "agent_id");
279
- set_field(pairs, "name", target);
280
- if let Some(label) = label.map(str::trim).filter(|label| !label.is_empty()) {
281
- set_field(pairs, "role", label);
282
- }
283
- }
284
- format!("---\n{}---\n\n{}", crate::lifecycle::launch::role_source::dump_role_frontmatter(&meta), body)
285
- }
286
-
287
- fn set_field(pairs: &mut Vec<(String, Yaml)>, key: &str, value: &str) {
288
- match pairs.iter_mut().find(|(name, _)| name == key) {
289
- Some((_, old)) => *old = Yaml::Str(value.to_owned()),
290
- None => pairs.push((key.to_owned(), Yaml::Str(value.to_owned()))),
291
- }
292
- }
293
-
294
- fn write_new(path: &Path, bytes: &[u8]) -> std::io::Result<()> {
295
- use std::io::Write;
296
- let mut file = std::fs::OpenOptions::new().write(true).create_new(true).open(path)?;
297
- file.write_all(bytes)?;
298
- file.sync_all()
299
- }
300
-
301
- /// Compensation for this fork's own registration. A started but unpublished
302
- /// native seat is stopped first; if that fails, the role/spec/state stay so
303
- /// status and stop can still reach the live seat.
304
- struct Undo {
305
- workspace: PathBuf,
306
- team: String,
307
- target: SeatId,
308
- role_path: PathBuf,
309
- role_bytes: Vec<u8>,
310
- spec_path: PathBuf,
311
- pre_spec: Option<String>,
312
- }
313
-
314
- impl Undo {
315
- fn run(&self, failure: CliError) -> CliError {
316
- let started = Backend::open_readonly(&self.workspace, &self.team)
317
- .ok()
318
- .and_then(|backend| backend.store.seat(&self.target).ok().flatten())
319
- .is_some_and(|seat| seat.status != SeatStatus::Stopped && seat.physical.is_some());
320
- if started {
321
- if let Err(stop) = backend::stop(&self.workspace, &self.team, &self.target) {
322
- return error(format!(
323
- "{failure}; stopping the forked native seat failed: {stop}; its role, spec and state were kept"
324
- ));
325
- }
326
- }
327
- rollback_add_agent_atomic(
328
- &self.workspace, &self.spec_path, self.pre_spec.as_deref(), None,
329
- Some(self.team.as_str()), &AgentId::new(self.target.as_str()), "fork_agent_failed",
330
- );
331
- let residual = match std::fs::read(&self.role_path) {
332
- Ok(bytes) if bytes == self.role_bytes => std::fs::remove_file(&self.role_path)
333
- .err()
334
- .map(|e| format!("role file {}: {e}", self.role_path.display())),
335
- Ok(_) => Some(format!("role file {} changed; preserved", self.role_path.display())),
336
- Err(e) if e.kind() == std::io::ErrorKind::NotFound => None,
337
- Err(e) => Some(format!("role file {}: {e}", self.role_path.display())),
338
- };
339
- match residual {
340
- None => failure,
341
- Some(residual) => error(format!("{failure}; compensation incomplete: {residual}")),
342
- }
343
- }
344
- }
345
-
346
- #[cfg(test)]
347
- mod tests {
348
- use super::fork_role_text;
349
- use crate::model::yaml::Value;
350
-
351
- #[test]
352
- fn forked_role_keeps_its_body_and_takes_the_target_identity() {
353
- let source = "---\nname: opus-architect\nagent_id: opus-architect\nprovider: claude\nmodel: claude-opus-5-5\n---\n\nYou design the system.\n";
354
- let forked = fork_role_text(source, "opus-fork", Some(" avatar "));
355
- let (meta, body) = crate::compiler::split_front_matter(&forked);
356
- assert_eq!(meta.get("name").and_then(Value::as_str), Some("opus-fork"));
357
- assert!(meta.get("agent_id").is_none());
358
- assert_eq!(meta.get("role").and_then(Value::as_str), Some("avatar"));
359
- assert_eq!(meta.get("provider").and_then(Value::as_str), Some("claude"));
360
- assert_eq!(meta.get("model").and_then(Value::as_str), Some("claude-opus-5-5"));
361
- assert_eq!(body.trim(), "You design the system.");
362
- let unlabeled = fork_role_text("plain body\n", "opus-fork", None);
363
- let (meta, body) = crate::compiler::split_front_matter(&unlabeled);
364
- assert_eq!(meta.get("name").and_then(Value::as_str), Some("opus-fork"));
365
- assert!(meta.get("role").is_none());
366
- assert_eq!(body.trim(), "plain body");
367
- }
368
- }
@@ -1,288 +0,0 @@
1
- //! New-runtime egress into the existing shared framework business APIs. A
2
- //! forwarding intent is not a legacy physical queue, nor proof of presentation.
3
- use serde_json::{json, Value};
4
- use team_agent_contract::contract::{session::CwdIdentity, types::ScopeId};
5
- use team_agent_contract::host::{digest, digest_hex, process::resolve_cwd};
6
- use team_agent_contract::orchestration::{forward::*, store::ContractStore, Error};
7
-
8
- use crate::messaging::{self, MessageTarget, SendOptions, SendOrigin, TrustedSender};
9
- use crate::model::ids::{AgentId, TaskId, TeamKey};
10
-
11
- /// Created from the selected framework Team, never from MCP tool arguments.
12
- pub struct FrameworkContext {
13
- pub workspace: CwdIdentity,
14
- pub team: String,
15
- pub native_scope: ScopeId,
16
- }
17
- impl FrameworkContext {
18
- pub fn route(&self) -> Result<String, Error> {
19
- Ok(format!(
20
- "framework-{}",
21
- digest_hex(digest(&serde_json::to_vec(&(
22
- &self.workspace,
23
- &self.team,
24
- &self.native_scope
25
- ))?))
26
- ))
27
- }
28
- fn validate(&self, store: &ContractStore) -> Result<(), Error> {
29
- if self.team.trim().is_empty()
30
- || self.team.chars().any(char::is_control)
31
- || store.scope() != &self.native_scope
32
- || resolve_cwd(&self.workspace.path).map_err(|_| Error::Fence)? != self.workspace
33
- {
34
- return Err(Error::Fence);
35
- }
36
- let selected = crate::state::selector::resolve_active_team_readonly(
37
- &self.workspace.path,
38
- Some(&self.team),
39
- crate::state::selector::SelectorMode::RuntimeOnly,
40
- )
41
- .map_err(|_| Error::Fence)?;
42
- if selected.team_key != self.team
43
- || resolve_cwd(&selected.run_workspace).map_err(|_| Error::Fence)? != self.workspace
44
- {
45
- return Err(Error::Fence);
46
- }
47
- Ok(())
48
- }
49
- }
50
-
51
- fn framework_result(result_id: &str, source: &str, envelope: &Value) -> Result<Value, Error> {
52
- if envelope.get("agent_id").and_then(Value::as_str) != Some(source)
53
- || envelope
54
- .get("task_id")
55
- .and_then(Value::as_str)
56
- .is_none_or(|task| task.trim().is_empty())
57
- {
58
- return Err(Error::Fence);
59
- }
60
- // K3's compact wire (schema 1 / completed) is not the root business envelope.
61
- // Reuse the shared normalizer rather than maintaining a second alias/schema
62
- // implementation or claiming that a persisted K3 result was forwarded.
63
- let normalized = crate::mcp_server::normalize::normalize_report_envelope(envelope);
64
- if normalized.presentation_error.is_some() {
65
- return Err(Error::Invalid("result presentation"));
66
- }
67
- let mut value = serde_json::to_value(normalized)?;
68
- value["result_id"] = json!(result_id);
69
- Ok(value)
70
- }
71
-
72
- /// Reuses the common root send/result operations. No provider implementation is
73
- /// selected here; the common per-recipient dispatcher remains authoritative.
74
- fn forward_one(context: &FrameworkContext, intent: &ForwardIntent) -> (ForwardState, Value) {
75
- match &intent.payload {
76
- ForwardPayload::Message {
77
- message,
78
- task,
79
- sender,
80
- recipient,
81
- content,
82
- mailbox,
83
- } => {
84
- if sender != intent.source.seat.as_str() {
85
- return (
86
- ForwardState::Refused,
87
- json!({"code":"sender_binding_mismatch"}),
88
- );
89
- }
90
- let mut options = SendOptions {
91
- origin: SendOrigin::Mcp,
92
- task_id: task.as_ref().map(|task| TaskId::new(task.clone())),
93
- route_task_id: false,
94
- sender: TrustedSender::from_runtime_identity(AgentId::new(sender)),
95
- team: Some(TeamKey::new(&context.team)),
96
- message_id: Some(message.as_str().into()),
97
- wait_visible: false,
98
- block_until_delivered: false,
99
- timeout: 2.0,
100
- ..Default::default()
101
- };
102
- if *mailbox {
103
- options.presentation.sink = messaging::presentation::PresentationSink::Casefile;
104
- }
105
- match messaging::send_message(
106
- &context.workspace.path,
107
- &MessageTarget::Single(recipient.clone()),
108
- content,
109
- &options,
110
- ) {
111
- Ok(outcome) => {
112
- let accepted = outcome.message_id.as_deref() == Some(message.as_str())
113
- && matches!(
114
- outcome.status,
115
- messaging::DeliveryStatus::Queued
116
- | messaging::DeliveryStatus::StoredOnly
117
- | messaging::DeliveryStatus::Delivered
118
- | messaging::DeliveryStatus::AlreadyDelivered
119
- | messaging::DeliveryStatus::RetryScheduled
120
- | messaging::DeliveryStatus::FallbackLog
121
- );
122
- let state = if accepted {
123
- ForwardState::Accepted
124
- } else if outcome.message_id.is_none()
125
- && matches!(outcome.status, messaging::DeliveryStatus::Refused)
126
- {
127
- ForwardState::Refused
128
- } else {
129
- ForwardState::Unknown
130
- };
131
- (
132
- state,
133
- json!({"ok":outcome.ok,"message_id":outcome.message_id,
134
- "status":outcome.status,"message_status":outcome.message_status.0,
135
- "reason":outcome.reason,"verification":outcome.verification}),
136
- )
137
- }
138
- // Error alone is not proof that no destination row was written.
139
- Err(_) => (
140
- ForwardState::Unknown,
141
- json!({"code":"framework_send_outcome_unknown"}),
142
- ),
143
- }
144
- }
145
- ForwardPayload::Result {
146
- result_id,
147
- envelope,
148
- } => {
149
- let envelope = match framework_result(result_id, intent.source.seat.as_str(), envelope)
150
- {
151
- Ok(envelope) => envelope,
152
- Err(_) => {
153
- return (
154
- ForwardState::Refused,
155
- json!({"code":"invalid_result_envelope"}),
156
- )
157
- }
158
- };
159
- match messaging::results::report_result_for_owner_team(
160
- &context.workspace.path,
161
- &envelope,
162
- Some(&context.team),
163
- ) {
164
- Ok(receipt) => (ForwardState::Accepted, receipt),
165
- Err(_) => (
166
- ForwardState::Unknown,
167
- json!({"code":"framework_result_outcome_unknown"}),
168
- ),
169
- }
170
- }
171
- }
172
- }
173
-
174
- /// The root coordinator owns this consumer. Claim commits before the delegate
175
- /// is called, so no K3 transaction is held across root framework locks/writes.
176
- /// InFlight/Unknown items require explicit exact-ID reconciliation, not replay.
177
- pub fn drain(
178
- context: &FrameworkContext,
179
- store: &mut ContractStore,
180
- limit: usize,
181
- ) -> Result<usize, Error> {
182
- context.validate(store)?;
183
- let route = context.route()?;
184
- let pending = store.pending_forwards(limit)?;
185
- let mut completed = 0;
186
- for next in pending {
187
- if next.source.scope != context.native_scope {
188
- return Err(Error::Fence);
189
- }
190
- let intent = match store.claim_forward(&next.id) {
191
- Ok(intent) => intent,
192
- Err(Error::Conflict) => continue,
193
- Err(error) => return Err(error),
194
- };
195
- let (state, receipt) = if intent.route != route {
196
- (
197
- ForwardState::Refused,
198
- json!({"code":"framework_route_changed"}),
199
- )
200
- } else {
201
- // Recheck the selected directory before every external operation.
202
- context.validate(store)?;
203
- forward_one(context, &intent)
204
- };
205
- store.finish_forward(&intent.id, state, receipt)?;
206
- completed += 1;
207
- }
208
- Ok(completed)
209
- }
210
-
211
- /// Explicit operator egress only: reuse committed native receipts, never run a
212
- /// coordinator tick, provider admission, input delivery, or candidate migration.
213
- /// The original runtime binding remains authoritative even when this helper was
214
- /// built from a newer revision. Pending forwards retain their exact source IDs.
215
- pub fn drain_scoped_pending_egress(
216
- workspace: &std::path::Path,
217
- team: &str,
218
- expected_scope: &str,
219
- apply: bool,
220
- ) -> Result<Value, String> {
221
- if !workspace.is_absolute() || team.is_empty() || team.trim() != team {
222
- return Err("egress requires an absolute workspace and exact explicit team".into());
223
- }
224
- ScopeId::new(expected_scope).map_err(|error| error.to_string())?;
225
- let selected = crate::state::selector::resolve_active_team_readonly(
226
- workspace, Some(team), crate::state::selector::SelectorMode::RuntimeOnly,
227
- ).map_err(|error| error.to_string())?;
228
- crate::lifecycle::launch::ensure_owner_allowed_for_state(&selected.state, None)
229
- .map_err(|error| error.to_string())?;
230
- let original = super::backend::Backend::open_readonly(&selected.run_workspace, &selected.team_key)
231
- .map_err(|error| error.to_string())?;
232
- if original.binding.scope.as_str() != expected_scope || original.binding.team != team {
233
- return Err("egress scope/binding mismatch".into());
234
- }
235
- let binding = serde_json::to_value(&original.binding).map_err(|error| error.to_string())?;
236
- let before: Vec<_> = original.store.pending_forwards(32).map_err(|error| error.to_string())?
237
- .into_iter().map(|intent| intent.id).collect();
238
- drop(original);
239
- let processed = if apply {
240
- let mut backend = super::backend::Backend::open(&selected.run_workspace, &selected.team_key)
241
- .map_err(|error| error.to_string())?;
242
- if serde_json::to_value(&backend.binding).map_err(|error| error.to_string())? != binding {
243
- return Err("egress binding changed before claim".into());
244
- }
245
- drain(&backend.binding.framework(), &mut backend.store, 32).map_err(|error| error.to_string())?
246
- } else { 0 };
247
- let after = super::backend::Backend::open_readonly(&selected.run_workspace, &selected.team_key)
248
- .map_err(|error| error.to_string())?;
249
- if serde_json::to_value(&after.binding).map_err(|error| error.to_string())? != binding {
250
- return Err("egress binding changed during forwarding".into());
251
- }
252
- let pending: Vec<_> = after.store.pending_forwards(32).map_err(|error| error.to_string())?
253
- .into_iter().map(|intent| intent.id).collect();
254
- Ok(json!({"scope":expected_scope,"team":team,"apply":apply,"processed":processed,
255
- "pending_before":before,"pending_after":pending,"binding_unchanged":true,
256
- "native_input":"not_invoked","coordinator_lifecycle":"not_invoked",
257
- "leader_consumption":"requires actual natural receipt"}))
258
- }
259
-
260
- #[cfg(test)]
261
- mod tests {
262
- use super::*;
263
- #[test]
264
- fn egress_operator_refuses_implicit_workspace_team_and_invalid_scope_before_io() {
265
- for (workspace, team, scope) in [
266
- ("relative", "team", "scope"), ("/", "", "scope"),
267
- ("/", " team", "scope"), ("/", "team", ""), ("/", "team", "bad/scope"),
268
- ] {
269
- assert!(drain_scoped_pending_egress(std::path::Path::new(workspace), team, scope, false).is_err());
270
- assert!(drain_scoped_pending_egress(std::path::Path::new(workspace), team, scope, true).is_err());
271
- }
272
- }
273
- #[test]
274
- fn compact_native_result_becomes_the_existing_framework_business_schema() {
275
- let compact = json!({"schema_version":1,"agent_id":"worker","task_id":"msg-bound","status":"completed","summary":"5535"});
276
- let result = framework_result("result-fixed", "worker", &compact).unwrap();
277
- assert_eq!(result["schema_version"], "result_envelope_v1");
278
- assert_eq!(result["status"], "success");
279
- assert_eq!(result["task_id"], "msg-bound");
280
- assert_eq!(result["summary"], "5535");
281
- assert_eq!(result["result_id"], "result-fixed");
282
- for field in ["changes", "tests", "risks", "artifacts", "next_actions"] {
283
- assert!(result[field].is_array());
284
- }
285
- crate::messaging::helpers::validate_result_envelope(&result).unwrap();
286
- assert!(framework_result("result-fixed", "other", &compact).is_err());
287
- }
288
- }