@team-agent/installer 0.5.128 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (436) hide show
  1. package/README.md +4 -4
  2. package/README.zh.md +1 -1
  3. package/package.json +4 -8
  4. package/skills/team-agent/SKILL.md +37 -20
  5. package/skills/team-agent/command-coverage.json +169 -183
  6. package/skills/team-agent/docs/reference/team-agent-operator.md +64 -30
  7. package/skills/team-agent/references/recovery-runbook.md +1 -1
  8. package/skills/team-agent/references/team-agent-operator.md +64 -30
  9. package/templates/team_state.md +1 -1
  10. package/Cargo.lock +0 -1063
  11. package/Cargo.toml +0 -36
  12. package/crates/team-agent/Cargo.toml +0 -69
  13. package/crates/team-agent/src/app_server_test_support.rs +0 -258
  14. package/crates/team-agent/src/cli/adapters.rs +0 -1288
  15. package/crates/team-agent/src/cli/arguments.rs +0 -405
  16. package/crates/team-agent/src/cli/attach_app_server_leader.rs +0 -98
  17. package/crates/team-agent/src/cli/diagnose.rs +0 -1721
  18. package/crates/team-agent/src/cli/emit.rs +0 -2930
  19. package/crates/team-agent/src/cli/grok_slot.rs +0 -384
  20. package/crates/team-agent/src/cli/helpers.rs +0 -91
  21. package/crates/team-agent/src/cli/intent/runtime.rs +0 -1216
  22. package/crates/team-agent/src/cli/intent/runtime_tests.rs +0 -912
  23. package/crates/team-agent/src/cli/intent/tests.rs +0 -689
  24. package/crates/team-agent/src/cli/intent.rs +0 -664
  25. package/crates/team-agent/src/cli/leader.rs +0 -300
  26. package/crates/team-agent/src/cli/leader_prompt.rs +0 -261
  27. package/crates/team-agent/src/cli/leaders.rs +0 -418
  28. package/crates/team-agent/src/cli/mod.rs +0 -6545
  29. package/crates/team-agent/src/cli/models.rs +0 -1206
  30. package/crates/team-agent/src/cli/named_address.rs +0 -1651
  31. package/crates/team-agent/src/cli/profile.rs +0 -342
  32. package/crates/team-agent/src/cli/route.rs +0 -212
  33. package/crates/team-agent/src/cli/schedule.rs +0 -175
  34. package/crates/team-agent/src/cli/send/coordinator.rs +0 -164
  35. package/crates/team-agent/src/cli/send/mailbox.rs +0 -145
  36. package/crates/team-agent/src/cli/send/persist.rs +0 -156
  37. package/crates/team-agent/src/cli/send/presentation.rs +0 -370
  38. package/crates/team-agent/src/cli/send/resolve.rs +0 -573
  39. package/crates/team-agent/src/cli/send.rs +0 -199
  40. package/crates/team-agent/src/cli/shutdown_socket.rs +0 -288
  41. package/crates/team-agent/src/cli/spec.rs +0 -165
  42. package/crates/team-agent/src/cli/status.rs +0 -280
  43. package/crates/team-agent/src/cli/status_port/agents.rs +0 -358
  44. package/crates/team-agent/src/cli/status_port/approvals.rs +0 -79
  45. package/crates/team-agent/src/cli/status_port/brief.rs +0 -1981
  46. package/crates/team-agent/src/cli/status_port/compact.rs +0 -240
  47. package/crates/team-agent/src/cli/status_port/format.rs +0 -146
  48. package/crates/team-agent/src/cli/status_port/inbox.rs +0 -62
  49. package/crates/team-agent/src/cli/status_port/runtime.rs +0 -197
  50. package/crates/team-agent/src/cli/status_port/snapshot.rs +0 -208
  51. package/crates/team-agent/src/cli/status_port/store.rs +0 -416
  52. package/crates/team-agent/src/cli/status_port/tests.rs +0 -90
  53. package/crates/team-agent/src/cli/status_port.rs +0 -92
  54. package/crates/team-agent/src/cli/tests/base.rs +0 -885
  55. package/crates/team-agent/src/cli/tests/divergence.rs +0 -518
  56. package/crates/team-agent/src/cli/tests/lane_c.rs +0 -453
  57. package/crates/team-agent/src/cli/tests/leader_watch.rs +0 -322
  58. package/crates/team-agent/src/cli/tests/main_preserved.rs +0 -430
  59. package/crates/team-agent/src/cli/tests/missing_subcommands.rs +0 -336
  60. package/crates/team-agent/src/cli/tests/mod.rs +0 -137
  61. package/crates/team-agent/src/cli/tests/named_address.rs +0 -761
  62. package/crates/team-agent/src/cli/tests/parser_safety.rs +0 -383
  63. package/crates/team-agent/src/cli/tests/run_delegation.rs +0 -484
  64. package/crates/team-agent/src/cli/tests/shutdown_kill_plan.rs +0 -2179
  65. package/crates/team-agent/src/cli/tests/status_brief.rs +0 -1514
  66. package/crates/team-agent/src/cli/tests/status_send.rs +0 -888
  67. package/crates/team-agent/src/cli/tests/verb_install_skill.rs +0 -93
  68. package/crates/team-agent/src/cli/tests/verb_profile.rs +0 -392
  69. package/crates/team-agent/src/cli/triage.rs +0 -234
  70. package/crates/team-agent/src/cli/types.rs +0 -591
  71. package/crates/team-agent/src/codex_app_server.rs +0 -546
  72. package/crates/team-agent/src/communication_mode/mod.rs +0 -56
  73. package/crates/team-agent/src/compiler/tests.rs +0 -827
  74. package/crates/team-agent/src/compiler.rs +0 -890
  75. package/crates/team-agent/src/conpty/backend.rs +0 -829
  76. package/crates/team-agent/src/conpty/mod.rs +0 -33
  77. package/crates/team-agent/src/contract_runtime/backend.rs +0 -1744
  78. package/crates/team-agent/src/contract_runtime/commands.rs +0 -671
  79. package/crates/team-agent/src/contract_runtime/config.rs +0 -364
  80. package/crates/team-agent/src/contract_runtime/config_tests.rs +0 -76
  81. package/crates/team-agent/src/contract_runtime/discovery.rs +0 -449
  82. package/crates/team-agent/src/contract_runtime/fork.rs +0 -361
  83. package/crates/team-agent/src/contract_runtime/forward.rs +0 -288
  84. package/crates/team-agent/src/contract_runtime/framework.rs +0 -367
  85. package/crates/team-agent/src/contract_runtime/mcp.rs +0 -394
  86. package/crates/team-agent/src/contract_runtime/mod.rs +0 -17
  87. package/crates/team-agent/src/contract_runtime/prompt.rs +0 -216
  88. package/crates/team-agent/src/contract_runtime/pump.rs +0 -271
  89. package/crates/team-agent/src/contract_runtime/registry.rs +0 -553
  90. package/crates/team-agent/src/contract_runtime/workspace.rs +0 -228
  91. package/crates/team-agent/src/coordinator/backoff.rs +0 -741
  92. package/crates/team-agent/src/coordinator/conpty_shim.rs +0 -805
  93. package/crates/team-agent/src/coordinator/health.rs +0 -1185
  94. package/crates/team-agent/src/coordinator/mod.rs +0 -119
  95. package/crates/team-agent/src/coordinator/orphan.rs +0 -110
  96. package/crates/team-agent/src/coordinator/runtime_detectors.rs +0 -798
  97. package/crates/team-agent/src/coordinator/runtime_observation.rs +0 -84
  98. package/crates/team-agent/src/coordinator/steps/abnormal.rs +0 -2309
  99. package/crates/team-agent/src/coordinator/steps/delivery.rs +0 -15
  100. package/crates/team-agent/src/coordinator/steps/health_sync.rs +0 -15
  101. package/crates/team-agent/src/coordinator/steps/mod.rs +0 -126
  102. package/crates/team-agent/src/coordinator/steps/persist.rs +0 -15
  103. package/crates/team-agent/src/coordinator/steps/runtime_prompts.rs +0 -15
  104. package/crates/team-agent/src/coordinator/steps/session_gate.rs +0 -16
  105. package/crates/team-agent/src/coordinator/tests/a0_lostupdate.rs +0 -158
  106. package/crates/team-agent/src/coordinator/tests/abnormal.rs +0 -312
  107. package/crates/team-agent/src/coordinator/tests/api_error_recovery.rs +0 -300
  108. package/crates/team-agent/src/coordinator/tests/basics.rs +0 -211
  109. package/crates/team-agent/src/coordinator/tests/daemon.rs +0 -514
  110. package/crates/team-agent/src/coordinator/tests/energy.rs +0 -549
  111. package/crates/team-agent/src/coordinator/tests/health_sync.rs +0 -503
  112. package/crates/team-agent/src/coordinator/tests/main_preserved.rs +0 -186
  113. package/crates/team-agent/src/coordinator/tests/mod.rs +0 -295
  114. package/crates/team-agent/src/coordinator/tests/s3_bounded.rs +0 -207
  115. package/crates/team-agent/src/coordinator/tests/spine.rs +0 -308
  116. package/crates/team-agent/src/coordinator/tests/takeover.rs +0 -286
  117. package/crates/team-agent/src/coordinator/tests/tick_core.rs +0 -237
  118. package/crates/team-agent/src/coordinator/tick.rs +0 -3024
  119. package/crates/team-agent/src/coordinator/types.rs +0 -540
  120. package/crates/team-agent/src/db/agent_health_capture.rs +0 -126
  121. package/crates/team-agent/src/db/message_store.rs +0 -1527
  122. package/crates/team-agent/src/db/migration.rs +0 -984
  123. package/crates/team-agent/src/db/mod.rs +0 -26
  124. package/crates/team-agent/src/db/schema.rs +0 -663
  125. package/crates/team-agent/src/diagnose/comms.rs +0 -242
  126. package/crates/team-agent/src/diagnose/mod.rs +0 -44
  127. package/crates/team-agent/src/diagnose/orphans.rs +0 -889
  128. package/crates/team-agent/src/direct_delivery.rs +0 -368
  129. package/crates/team-agent/src/event_log.rs +0 -502
  130. package/crates/team-agent/src/fake_worker.rs +0 -303
  131. package/crates/team-agent/src/inbox_store.rs +0 -169
  132. package/crates/team-agent/src/kill_audit.rs +0 -106
  133. package/crates/team-agent/src/layout/manager.rs +0 -248
  134. package/crates/team-agent/src/layout/mod.rs +0 -36
  135. package/crates/team-agent/src/layout/overlay.rs +0 -134
  136. package/crates/team-agent/src/layout/placement.rs +0 -52
  137. package/crates/team-agent/src/layout/recovery.rs +0 -106
  138. package/crates/team-agent/src/layout/runtime_sessions.rs +0 -317
  139. package/crates/team-agent/src/layout/sessions.rs +0 -294
  140. package/crates/team-agent/src/layout/tmux_endpoint.rs +0 -165
  141. package/crates/team-agent/src/layout/worker_env.rs +0 -721
  142. package/crates/team-agent/src/layout/worker_window_helpers.rs +0 -37
  143. package/crates/team-agent/src/leader/helpers.rs +0 -178
  144. package/crates/team-agent/src/leader/incident.rs +0 -6
  145. package/crates/team-agent/src/leader/lease.rs +0 -3356
  146. package/crates/team-agent/src/leader/mod.rs +0 -104
  147. package/crates/team-agent/src/leader/owner_bind.rs +0 -400
  148. package/crates/team-agent/src/leader/prompt.rs +0 -905
  149. package/crates/team-agent/src/leader/provider_attribution.rs +0 -247
  150. package/crates/team-agent/src/leader/rediscover/tests.rs +0 -689
  151. package/crates/team-agent/src/leader/rediscover.rs +0 -1192
  152. package/crates/team-agent/src/leader/registry.rs +0 -888
  153. package/crates/team-agent/src/leader/start.rs +0 -4501
  154. package/crates/team-agent/src/leader/takeover.rs +0 -65
  155. package/crates/team-agent/src/leader/tests/basics.rs +0 -337
  156. package/crates/team-agent/src/leader/tests/byte_findings.rs +0 -355
  157. package/crates/team-agent/src/leader/tests/claim_leader_mailbox_flush_contract.rs +0 -544
  158. package/crates/team-agent/src/leader/tests/historical_inventory_upgrade_gate_red.rs +0 -624
  159. package/crates/team-agent/src/leader/tests/identity.rs +0 -465
  160. package/crates/team-agent/src/leader/tests/identity_session_names.rs +0 -42
  161. package/crates/team-agent/src/leader/tests/idle.rs +0 -113
  162. package/crates/team-agent/src/leader/tests/lease_api.rs +0 -520
  163. package/crates/team-agent/src/leader/tests/lease_claim.rs +0 -629
  164. package/crates/team-agent/src/leader/tests/mod.rs +0 -106
  165. package/crates/team-agent/src/leader/tests/prompt_contract.rs +0 -268
  166. package/crates/team-agent/src/leader/tests/rediscover.rs +0 -403
  167. package/crates/team-agent/src/leader/tests/rehomed_env.rs +0 -83
  168. package/crates/team-agent/src/leader/tests/team_in_team_state_scope_red.rs +0 -1273
  169. package/crates/team-agent/src/leader/tests/terminal_and_replay_vs_rerender_invariants_red.rs +0 -417
  170. package/crates/team-agent/src/leader/tests/wake_start_owner.rs +0 -168
  171. package/crates/team-agent/src/leader/types.rs +0 -534
  172. package/crates/team-agent/src/lib.rs +0 -147
  173. package/crates/team-agent/src/lifecycle/helpers.rs +0 -212
  174. package/crates/team-agent/src/lifecycle/launch/add_agent.rs +0 -881
  175. package/crates/team-agent/src/lifecycle/launch/add_agent_state.rs +0 -598
  176. package/crates/team-agent/src/lifecycle/launch/agent_state.rs +0 -332
  177. package/crates/team-agent/src/lifecycle/launch/clone_agent.rs +0 -204
  178. package/crates/team-agent/src/lifecycle/launch/fork_agent.rs +0 -107
  179. package/crates/team-agent/src/lifecycle/launch/fork_entry.rs +0 -144
  180. package/crates/team-agent/src/lifecycle/launch/identity.rs +0 -674
  181. package/crates/team-agent/src/lifecycle/launch/layout.rs +0 -350
  182. package/crates/team-agent/src/lifecycle/launch/leader_context.rs +0 -589
  183. package/crates/team-agent/src/lifecycle/launch/mcp_config.rs +0 -160
  184. package/crates/team-agent/src/lifecycle/launch/ownership.rs +0 -105
  185. package/crates/team-agent/src/lifecycle/launch/pi_mcp.rs +0 -899
  186. package/crates/team-agent/src/lifecycle/launch/pi_mcp_extension.js +0 -225
  187. package/crates/team-agent/src/lifecycle/launch/plan.rs +0 -269
  188. package/crates/team-agent/src/lifecycle/launch/quick_start.rs +0 -5200
  189. package/crates/team-agent/src/lifecycle/launch/quick_start_transport.rs +0 -368
  190. package/crates/team-agent/src/lifecycle/launch/readiness.rs +0 -519
  191. package/crates/team-agent/src/lifecycle/launch/role_source.rs +0 -287
  192. package/crates/team-agent/src/lifecycle/launch/spawn.rs +0 -473
  193. package/crates/team-agent/src/lifecycle/launch/spec_state.rs +0 -801
  194. package/crates/team-agent/src/lifecycle/launch/state_projection.rs +0 -624
  195. package/crates/team-agent/src/lifecycle/launch/worker_env.rs +0 -558
  196. package/crates/team-agent/src/lifecycle/launch.rs +0 -557
  197. package/crates/team-agent/src/lifecycle/lock.rs +0 -350
  198. package/crates/team-agent/src/lifecycle/mod.rs +0 -79
  199. package/crates/team-agent/src/lifecycle/pane_input_lock.rs +0 -239
  200. package/crates/team-agent/src/lifecycle/profile_launch.rs +0 -1067
  201. package/crates/team-agent/src/lifecycle/profile_smoke.rs +0 -557
  202. package/crates/team-agent/src/lifecycle/restart/agent.rs +0 -2199
  203. package/crates/team-agent/src/lifecycle/restart/avatar.rs +0 -1798
  204. package/crates/team-agent/src/lifecycle/restart/claude_fork.rs +0 -163
  205. package/crates/team-agent/src/lifecycle/restart/common.rs +0 -2362
  206. package/crates/team-agent/src/lifecycle/restart/orchestrator.rs +0 -65
  207. package/crates/team-agent/src/lifecycle/restart/preflight.rs +0 -113
  208. package/crates/team-agent/src/lifecycle/restart/rebuild.rs +0 -5135
  209. package/crates/team-agent/src/lifecycle/restart/remove.rs +0 -1504
  210. package/crates/team-agent/src/lifecycle/restart/selection.rs +0 -559
  211. package/crates/team-agent/src/lifecycle/restart/team_state.rs +0 -329
  212. package/crates/team-agent/src/lifecycle/restart.rs +0 -227
  213. package/crates/team-agent/src/lifecycle/role_config.rs +0 -1230
  214. package/crates/team-agent/src/lifecycle/tests/acceptance_b_batch_red.rs +0 -1021
  215. package/crates/team-agent/src/lifecycle/tests/agent_ops.rs +0 -1205
  216. package/crates/team-agent/src/lifecycle/tests/b0_legacy_snapshot_nonauthority_contract.rs +0 -265
  217. package/crates/team-agent/src/lifecycle/tests/b0_reader_hideone_audit_contract.rs +0 -490
  218. package/crates/team-agent/src/lifecycle/tests/behavioral_diff_264_red.rs +0 -656
  219. package/crates/team-agent/src/lifecycle/tests/claude_compatible_config_red.rs +0 -325
  220. package/crates/team-agent/src/lifecycle/tests/claude_profile_launch_red.rs +0 -447
  221. package/crates/team-agent/src/lifecycle/tests/cli_argv_routing_red.rs +0 -1638
  222. package/crates/team-agent/src/lifecycle/tests/clone_agent_preserves_source_tools.rs +0 -427
  223. package/crates/team-agent/src/lifecycle/tests/clone_fork_copilot_perms_red.rs +0 -770
  224. package/crates/team-agent/src/lifecycle/tests/communication_mode_runtime_contract_red.rs +0 -419
  225. package/crates/team-agent/src/lifecycle/tests/copilot_provider_red.rs +0 -2035
  226. package/crates/team-agent/src/lifecycle/tests/core.rs +0 -1327
  227. package/crates/team-agent/src/lifecycle/tests/f032_startup_prompt_best_effort_red.rs +0 -315
  228. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_g0.stdout.txt +0 -222
  229. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_spaced_ids.stdout.txt +0 -9
  230. package/crates/team-agent/src/lifecycle/tests/fixtures/pi_native_mcp_host.mjs +0 -72
  231. package/crates/team-agent/src/lifecycle/tests/gate_fixtures.rs +0 -562
  232. package/crates/team-agent/src/lifecycle/tests/grok_require_explicit_model_red.rs +0 -110
  233. package/crates/team-agent/src/lifecycle/tests/harvest2_a_batch_red.rs +0 -512
  234. package/crates/team-agent/src/lifecycle/tests/host_cotenant_death_p0_contract.rs +0 -921
  235. package/crates/team-agent/src/lifecycle/tests/issue238_codex_effort_contract.rs +0 -68
  236. package/crates/team-agent/src/lifecycle/tests/lane_ops.rs +0 -1851
  237. package/crates/team-agent/src/lifecycle/tests/launch_spawn.rs +0 -3983
  238. package/crates/team-agent/src/lifecycle/tests/lifecycle_lock.rs +0 -339
  239. package/crates/team-agent/src/lifecycle/tests/lifecycle_rollback_red.rs +0 -596
  240. package/crates/team-agent/src/lifecycle/tests/main_preserved.rs +0 -513
  241. package/crates/team-agent/src/lifecycle/tests/mcp_tool_name_format_red.rs +0 -69
  242. package/crates/team-agent/src/lifecycle/tests/phase_b_contracts.rs +0 -824
  243. package/crates/team-agent/src/lifecycle/tests/phase_golden.rs +0 -723
  244. package/crates/team-agent/src/lifecycle/tests/pi_catalog_red.rs +0 -164
  245. package/crates/team-agent/src/lifecycle/tests/pi_command_red.rs +0 -200
  246. package/crates/team-agent/src/lifecycle/tests/pi_compiler_red.rs +0 -210
  247. package/crates/team-agent/src/lifecycle/tests/pi_dual_entry_red.rs +0 -527
  248. package/crates/team-agent/src/lifecycle/tests/pi_executable_mcp_red.rs +0 -1062
  249. package/crates/team-agent/src/lifecycle/tests/pi_fork_session_inheritance_red.rs +0 -1419
  250. package/crates/team-agent/src/lifecycle/tests/pi_lifecycle_doctor_red.rs +0 -98
  251. package/crates/team-agent/src/lifecycle/tests/pi_native_mcp_capability_red.rs +0 -550
  252. package/crates/team-agent/src/lifecycle/tests/pi_session_delivery_red.rs +0 -226
  253. package/crates/team-agent/src/lifecycle/tests/quick_start_worker_readiness_red.rs +0 -332
  254. package/crates/team-agent/src/lifecycle/tests/realmachine_clusters_1_6_red.rs +0 -786
  255. package/crates/team-agent/src/lifecycle/tests/realmachine_residual_g1_g4_red.rs +0 -648
  256. package/crates/team-agent/src/lifecycle/tests/restart.rs +0 -185
  257. package/crates/team-agent/src/lifecycle/tests/restart_build_before_destroy_0540_contract.rs +0 -1053
  258. package/crates/team-agent/src/lifecycle/tests/restart_liveness_red.rs +0 -679
  259. package/crates/team-agent/src/lifecycle/tests/restart_rebind_hotfix_252_red.rs +0 -1126
  260. package/crates/team-agent/src/lifecycle/tests/restart_session_capture_red.rs +0 -153
  261. package/crates/team-agent/src/lifecycle/tests/resume_recover_red.rs +0 -427
  262. package/crates/team-agent/src/lifecycle/tests/stale_team_saveconflict_contract.rs +0 -431
  263. package/crates/team-agent/src/lifecycle/tests/startup_latency_contract.rs +0 -1066
  264. package/crates/team-agent/src/lifecycle/tests/status_credential_redaction_contract.rs +0 -876
  265. package/crates/team-agent/src/lifecycle/tests/subprep_codex_trust_roundtrip_red.rs +0 -1026
  266. package/crates/team-agent/src/lifecycle/tests/swallow_batch4_semantics_red.rs +0 -342
  267. package/crates/team-agent/src/lifecycle/tests/team_in_team_identity_scope_red.rs +0 -543
  268. package/crates/team-agent/src/lifecycle/tests/team_in_team_sibling_quick_start_red.rs +0 -1103
  269. package/crates/team-agent/src/lifecycle/tests/team_in_team_state_scope_red.rs +0 -1276
  270. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_roster_red.rs +0 -145
  271. package/crates/team-agent/src/lifecycle/tests/team_key_retirement_txn_red.rs +0 -603
  272. package/crates/team-agent/src/lifecycle/tests/test_isolation_escape_contract.rs +0 -936
  273. package/crates/team-agent/src/lifecycle/tests/upgrade_compat_0211_red.rs +0 -970
  274. package/crates/team-agent/src/lifecycle/tests/verify_rs031_window_consistency_red.rs +0 -995
  275. package/crates/team-agent/src/lifecycle/tests/worker_spawn_env_red.rs +0 -836
  276. package/crates/team-agent/src/lifecycle/tests.rs +0 -105
  277. package/crates/team-agent/src/lifecycle/types.rs +0 -877
  278. package/crates/team-agent/src/lifecycle/worker_command_context.rs +0 -363
  279. package/crates/team-agent/src/main.rs +0 -52
  280. package/crates/team-agent/src/mcp_server/helpers.rs +0 -510
  281. package/crates/team-agent/src/mcp_server/lifecycle_tools/mod.rs +0 -6
  282. package/crates/team-agent/src/mcp_server/lifecycle_tools/state_status.rs +0 -43
  283. package/crates/team-agent/src/mcp_server/mod.rs +0 -119
  284. package/crates/team-agent/src/mcp_server/normalize.rs +0 -485
  285. package/crates/team-agent/src/mcp_server/readiness.rs +0 -527
  286. package/crates/team-agent/src/mcp_server/readiness_tests.rs +0 -348
  287. package/crates/team-agent/src/mcp_server/tests/golden.rs +0 -285
  288. package/crates/team-agent/src/mcp_server/tests/normalize.rs +0 -247
  289. package/crates/team-agent/src/mcp_server/tests/scoped.rs +0 -158
  290. package/crates/team-agent/src/mcp_server/tests/send.rs +0 -353
  291. package/crates/team-agent/src/mcp_server/tests/tools.rs +0 -341
  292. package/crates/team-agent/src/mcp_server/tests/wire.rs +0 -254
  293. package/crates/team-agent/src/mcp_server/tests.rs +0 -43
  294. package/crates/team-agent/src/mcp_server/tools.rs +0 -889
  295. package/crates/team-agent/src/mcp_server/types.rs +0 -396
  296. package/crates/team-agent/src/mcp_server/wire.rs +0 -867
  297. package/crates/team-agent/src/messaging/activity.rs +0 -461
  298. package/crates/team-agent/src/messaging/address.rs +0 -87
  299. package/crates/team-agent/src/messaging/delivery.rs +0 -3727
  300. package/crates/team-agent/src/messaging/delivery_consumption_tests.rs +0 -234
  301. package/crates/team-agent/src/messaging/enter_rescue.rs +0 -362
  302. package/crates/team-agent/src/messaging/enter_rescue_tests.rs +0 -633
  303. package/crates/team-agent/src/messaging/helpers.rs +0 -336
  304. package/crates/team-agent/src/messaging/leader_channel.rs +0 -287
  305. package/crates/team-agent/src/messaging/leader_receiver.rs +0 -786
  306. package/crates/team-agent/src/messaging/mod.rs +0 -167
  307. package/crates/team-agent/src/messaging/persist.rs +0 -377
  308. package/crates/team-agent/src/messaging/presentation.rs +0 -417
  309. package/crates/team-agent/src/messaging/reminders.rs +0 -316
  310. package/crates/team-agent/src/messaging/results/collection_tests.rs +0 -719
  311. package/crates/team-agent/src/messaging/results.rs +0 -1415
  312. package/crates/team-agent/src/messaging/scheduler.rs +0 -223
  313. package/crates/team-agent/src/messaging/selftest.rs +0 -315
  314. package/crates/team-agent/src/messaging/send.rs +0 -981
  315. package/crates/team-agent/src/messaging/tests/basic.rs +0 -346
  316. package/crates/team-agent/src/messaging/tests/dup_inject.rs +0 -657
  317. package/crates/team-agent/src/messaging/tests/e23.rs +0 -49
  318. package/crates/team-agent/src/messaging/tests/leader_channel.rs +0 -169
  319. package/crates/team-agent/src/messaging/tests/leader_inject_acceptance.rs +0 -817
  320. package/crates/team-agent/src/messaging/tests/main_preserved.rs +0 -85
  321. package/crates/team-agent/src/messaging/tests/mod.rs +0 -306
  322. package/crates/team-agent/src/messaging/tests/runtime.rs +0 -3549
  323. package/crates/team-agent/src/messaging/tests/spine.rs +0 -853
  324. package/crates/team-agent/src/messaging/tests/wave2.rs +0 -381
  325. package/crates/team-agent/src/messaging/trust.rs +0 -215
  326. package/crates/team-agent/src/messaging/types.rs +0 -472
  327. package/crates/team-agent/src/messaging/wait.rs +0 -366
  328. package/crates/team-agent/src/messaging/watchers.rs +0 -916
  329. package/crates/team-agent/src/model/enums.rs +0 -356
  330. package/crates/team-agent/src/model/errors.rs +0 -18
  331. package/crates/team-agent/src/model/ids.rs +0 -165
  332. package/crates/team-agent/src/model/mod.rs +0 -29
  333. package/crates/team-agent/src/model/name_similarity.rs +0 -252
  334. package/crates/team-agent/src/model/pane_authority_refusal.rs +0 -359
  335. package/crates/team-agent/src/model/paths.rs +0 -257
  336. package/crates/team-agent/src/model/routing.rs +0 -387
  337. package/crates/team-agent/src/model/spec.rs +0 -1184
  338. package/crates/team-agent/src/model/task_graph.rs +0 -321
  339. package/crates/team-agent/src/model/testdata/fuzz.golden.yaml +0 -43
  340. package/crates/team-agent/src/model/testdata/fuzz.yaml +0 -43
  341. package/crates/team-agent/src/model/testdata/spec_invalid_a.yaml +0 -209
  342. package/crates/team-agent/src/model/testdata/team.spec.golden.yaml +0 -208
  343. package/crates/team-agent/src/model/testdata/team.spec.yaml +0 -208
  344. package/crates/team-agent/src/model/yaml/tests.rs +0 -188
  345. package/crates/team-agent/src/model/yaml.rs +0 -802
  346. package/crates/team-agent/src/os_probe.rs +0 -280
  347. package/crates/team-agent/src/packaging/install.rs +0 -219
  348. package/crates/team-agent/src/packaging/migrate.rs +0 -38
  349. package/crates/team-agent/src/packaging/mod.rs +0 -91
  350. package/crates/team-agent/src/packaging/repair.rs +0 -33
  351. package/crates/team-agent/src/packaging/tests.rs +0 -822
  352. package/crates/team-agent/src/packaging/types.rs +0 -417
  353. package/crates/team-agent/src/platform/argv.rs +0 -331
  354. package/crates/team-agent/src/platform/errors.rs +0 -104
  355. package/crates/team-agent/src/platform/file_lock.rs +0 -279
  356. package/crates/team-agent/src/platform/mod.rs +0 -5
  357. package/crates/team-agent/src/platform/process.rs +0 -545
  358. package/crates/team-agent/src/provider/adapter.rs +0 -1150
  359. package/crates/team-agent/src/provider/adapters/claude.rs +0 -78
  360. package/crates/team-agent/src/provider/adapters/claude_fork.rs +0 -131
  361. package/crates/team-agent/src/provider/adapters/copilot.rs +0 -75
  362. package/crates/team-agent/src/provider/adapters/copilot_fork.rs +0 -307
  363. package/crates/team-agent/src/provider/adapters/fake.rs +0 -18
  364. package/crates/team-agent/src/provider/adapters/mod.rs +0 -30
  365. package/crates/team-agent/src/provider/adapters/pi.rs +0 -106
  366. package/crates/team-agent/src/provider/approvals/mod.rs +0 -3
  367. package/crates/team-agent/src/provider/approvals/parsing.rs +0 -586
  368. package/crates/team-agent/src/provider/approvals/runtime_prompts.rs +0 -205
  369. package/crates/team-agent/src/provider/argv_route.rs +0 -405
  370. package/crates/team-agent/src/provider/bypass_flags.rs +0 -116
  371. package/crates/team-agent/src/provider/classify.rs +0 -708
  372. package/crates/team-agent/src/provider/command_helpers.rs +0 -45
  373. package/crates/team-agent/src/provider/faults.rs +0 -165
  374. package/crates/team-agent/src/provider/helpers.rs +0 -52
  375. package/crates/team-agent/src/provider/mod.rs +0 -78
  376. package/crates/team-agent/src/provider/model_catalog.rs +0 -910
  377. package/crates/team-agent/src/provider/session/capture.rs +0 -2731
  378. package/crates/team-agent/src/provider/session/context_fork/claude.rs +0 -123
  379. package/crates/team-agent/src/provider/session/context_fork/outcome.rs +0 -172
  380. package/crates/team-agent/src/provider/session/context_fork.rs +0 -396
  381. package/crates/team-agent/src/provider/session/mod.rs +0 -36
  382. package/crates/team-agent/src/provider/session/resume.rs +0 -269
  383. package/crates/team-agent/src/provider/session_scan/claude.rs +0 -523
  384. package/crates/team-agent/src/provider/session_scan/common/tests.rs +0 -316
  385. package/crates/team-agent/src/provider/session_scan/common.rs +0 -654
  386. package/crates/team-agent/src/provider/session_scan/copilot.rs +0 -280
  387. package/crates/team-agent/src/provider/session_scan/pi.rs +0 -185
  388. package/crates/team-agent/src/provider/session_scan.rs +0 -71
  389. package/crates/team-agent/src/provider/startup_prompt.rs +0 -757
  390. package/crates/team-agent/src/provider/submit_now.rs +0 -71
  391. package/crates/team-agent/src/provider/testdata/copilot-ready-marker.txt +0 -5
  392. package/crates/team-agent/src/provider/testdata/copilot-trust-prompt.txt +0 -19
  393. package/crates/team-agent/src/provider/testdata/grok-models-authenticated.stdout +0 -9
  394. package/crates/team-agent/src/provider/testdata/grok-models-unauthenticated.stdout +0 -7
  395. package/crates/team-agent/src/provider/tests/adapter.rs +0 -441
  396. package/crates/team-agent/src/provider/tests/classify.rs +0 -148
  397. package/crates/team-agent/src/provider/tests/command_helpers.rs +0 -35
  398. package/crates/team-agent/src/provider/tests/copilot_fork.rs +0 -191
  399. package/crates/team-agent/src/provider/tests/faults.rs +0 -200
  400. package/crates/team-agent/src/provider/tests/idle.rs +0 -177
  401. package/crates/team-agent/src/provider/tests/wire.rs +0 -213
  402. package/crates/team-agent/src/provider/tests.rs +0 -32
  403. package/crates/team-agent/src/provider/types.rs +0 -529
  404. package/crates/team-agent/src/provider/wire.rs +0 -394
  405. package/crates/team-agent/src/redaction.rs +0 -259
  406. package/crates/team-agent/src/state/abnormal_watch/tests/mod.rs +0 -248
  407. package/crates/team-agent/src/state/abnormal_watch.rs +0 -144
  408. package/crates/team-agent/src/state/identity.rs +0 -914
  409. package/crates/team-agent/src/state/identity_keys.rs +0 -132
  410. package/crates/team-agent/src/state/mod.rs +0 -74
  411. package/crates/team-agent/src/state/owner_gate.rs +0 -482
  412. package/crates/team-agent/src/state/ownership.rs +0 -563
  413. package/crates/team-agent/src/state/paths.rs +0 -395
  414. package/crates/team-agent/src/state/persist.rs +0 -3811
  415. package/crates/team-agent/src/state/projection.rs +0 -1508
  416. package/crates/team-agent/src/state/repository/intent.rs +0 -14
  417. package/crates/team-agent/src/state/repository/tests.rs +0 -184
  418. package/crates/team-agent/src/state/repository.rs +0 -866
  419. package/crates/team-agent/src/state/selector.rs +0 -160
  420. package/crates/team-agent/src/state/testdata/state-rich.canonical.json +0 -133
  421. package/crates/team-agent/src/test_support/models_timeout_fixture.rs +0 -144
  422. package/crates/team-agent/src/tmux_backend/enter_rescue.rs +0 -325
  423. package/crates/team-agent/src/tmux_backend/enter_rescue_tests.rs +0 -432
  424. package/crates/team-agent/src/tmux_backend/native_input.rs +0 -513
  425. package/crates/team-agent/src/tmux_backend/native_input_tests.rs +0 -742
  426. package/crates/team-agent/src/tmux_backend/tests.rs +0 -4103
  427. package/crates/team-agent/src/tmux_backend.rs +0 -4492
  428. package/crates/team-agent/src/topology.rs +0 -537
  429. package/crates/team-agent/src/transport/enter_rescue.rs +0 -166
  430. package/crates/team-agent/src/transport/native_input.rs +0 -491
  431. package/crates/team-agent/src/transport/test_support.rs +0 -743
  432. package/crates/team-agent/src/transport/tests/behavior.rs +0 -326
  433. package/crates/team-agent/src/transport/tests/mod.rs +0 -194
  434. package/crates/team-agent/src/transport/tests/wire.rs +0 -574
  435. package/crates/team-agent/src/transport.rs +0 -1655
  436. package/crates/team-agent/src/transport_factory.rs +0 -819
@@ -1,654 +0,0 @@
1
- //! ---
2
- //! purpose: 各 provider 共用的通用候选扫描与解析底座——枚举可能的会话文件、读头解析、按进程世代与身份 marker 过滤
3
- //! contract:
4
- //! provides:
5
- //! - name: candidate_session_files
6
- //! what: 枚举候选文件(隔离根 + spawn_cwd 递归),去重排序并按 mtime 截到 300 条
7
- //! - name: parse_candidate_files
8
- //! what: 逐个读头 64KB 解析成 CapturedSessionCandidate,途中套 cwd 匹配、embedded 身份、claude cwd 字段与 leader marker 四道排除
9
- //! - name: apply_spawned_at_filter
10
- //! what: 剔除早于席位进程世代边界(spawned_at)的存档;spawned_at 存在但解析不了则清空候选
11
- //! - name: apply_spawn_time_window_if_unique
12
- //! what: 只有当"落在 spawn 之后"的候选恰好剩一条时才据此收窄,否则不动
13
- //! - name: sort_expected_first_if_needed
14
- //! what: 有 pending id 时把命中的候选排到最前
15
- //! - name: read_head_text
16
- //! what: 读文件头若干字节并截到最后一个完整行
17
- //! - name: parse_session_records
18
- //! what: 先按整体 JSON 解析(数组/单值),失败再按 JSONL 逐行解析
19
- //! - name: embedded_team_agent_worker_id_from_text
20
- //! what: 从正文里抽出 "You are Team Agent worker `<id>`" 的 id,字符集受限校验
21
- //! - name: rollout_path_embedded_team_agent_worker_id
22
- //! what: 上一条的按路径版本(读头后再抽)
23
- //! - name: record_cwd
24
- //! what: 从记录里取 cwd(顶层 cwd 或 session_meta.payload.cwd / payload.cwd)
25
- //! - name: paths_equivalent
26
- //! what: 路径等价判定:相等、canonicalize 后相等、或左的父目录等于右
27
- //! - name: CAPTURE_HEAD_BYTES
28
- //! what: 统一的读头窗口 64KB
29
- //! requires:
30
- //! - name: crate::provider::helpers
31
- //! what: find_session_id 与 parse_jsonl_records
32
- //! - name: super::claude
33
- //! what: claude 家族的 projects 目录推导、cwd 字段判据与 leader marker 判据
34
- //! boundary:
35
- //! - 一律只读:不写盘、不改 state、不发事件
36
- //! - 只产出候选与事实;归属最终由上游分配器裁定,本文件不写会话
37
- //! - spawn_cwd 递归最深 4 层,且跳过 .team 运行时目录(claude 的隔离根例外)
38
- //! - 候选上限 300 条,超出按 mtime 由新到旧截断——截掉的部分不留痕迹
39
- //! - "看起来像会话文件"的判据很宽(.json/.jsonl 后缀,或名字含 session/rollout/席位 id),收窄靠后续 provider 专属过滤
40
- //! maturity: wired
41
- //! ---
42
- use std::path::{Path, PathBuf};
43
-
44
- use crate::provider::helpers::{find_session_id, parse_jsonl_records};
45
- use crate::provider::types::{
46
- CaptureVia, CapturedSession, Confidence, ProviderError, RolloutPath, SessionId,
47
- };
48
- use crate::provider::Provider;
49
-
50
- use super::{CaptureSessionContext, CapturedSessionCandidate};
51
-
52
- pub(super) struct SessionCandidate {
53
- pub(super) path: PathBuf,
54
- requires_cwd_match: bool,
55
- }
56
-
57
- /// P2 (C-P2-2/3) / Python claude.py:300 — candidates are capped to the newest `cap`
58
- /// by mtime (descending priority: old candidates must not crowd out new ones).
59
- const CAPTURE_CANDIDATE_CAP: usize = 300;
60
-
61
- /// P2 (C-P2-1): head window >= Python's 200-line read.
62
- pub(super) const CAPTURE_HEAD_BYTES: u64 = 65_536;
63
-
64
- /// ---
65
- /// purpose: 枚举本席位可能对应的会话文件,产出待解析的候选路径表
66
- /// params:
67
- /// provider: 决定要不要去 ~/.claude/projects 找
68
- /// context: provider_projects_root(隔离根)、spawn_cwd(必扫)、agent_id(参与文件名匹配)
69
- /// returns: 去重并排序后的候选;requires_cwd_match=false 的排前面,同组按路径字典序
70
- /// errors: 只有 spawn_cwd 这一层根目录读不开才上抛 Io;隔离根读失败静默跳过
71
- /// contract:
72
- /// provides:
73
- /// - name: candidate_session_files
74
- /// what: 只列路径,不打开文件内容(截断时会取 mtime)
75
- /// boundary:
76
- /// - spawn_cwd 递归最深 4 层;工作区是用户代码仓,任何名含 session 的 json 都会被列进来
77
- /// - .team 运行时目录一律排除,除非它就在 claude 的隔离根之下
78
- /// - 超过 300 条按 mtime 由新到旧截断;被截掉的候选不产生任何信号
79
- /// - 任何 provider 都不走 HOME 分支——Copilot / Pi 各有专属扫描,退役的 legacy 席位不扫描
80
- /// ---
81
- pub(super) fn candidate_session_files(
82
- provider: Provider,
83
- context: &CaptureSessionContext,
84
- ) -> Result<Vec<SessionCandidate>, ProviderError> {
85
- let mut out = Vec::new();
86
- if let Some(root) = context.provider_projects_root.as_ref() {
87
- let allowed_team_root =
88
- matches!(provider, Provider::Claude | Provider::ClaudeCode).then_some(root.as_path());
89
- collect_optional_candidate_files(root, &context.agent_id, allowed_team_root, &mut out)?;
90
- }
91
- collect_candidate_files(
92
- &context.spawn_cwd,
93
- &context.agent_id,
94
- 0,
95
- false,
96
- None,
97
- &mut out,
98
- )?;
99
- if let Some(home) = std::env::var_os("HOME").map(PathBuf::from) {
100
- match provider {
101
- Provider::Claude | Provider::ClaudeCode => {
102
- if let Some(dir) = super::claude::projects_dir_for_cwd(&home, &context.spawn_cwd) {
103
- collect_optional_candidate_files(&dir, &context.agent_id, None, &mut out)?;
104
- }
105
- collect_optional_candidate_files(
106
- &home.join(".claude").join("projects"),
107
- &context.agent_id,
108
- None,
109
- &mut out,
110
- )?;
111
- }
112
- Provider::Codex
113
- | Provider::Copilot
114
- | Provider::Grok
115
- | Provider::Pi
116
- | Provider::GeminiCli
117
- | Provider::Fake => {}
118
- }
119
- }
120
- out.sort_by(|a, b| {
121
- a.requires_cwd_match
122
- .cmp(&b.requires_cwd_match)
123
- .then_with(|| a.path.to_string_lossy().cmp(&b.path.to_string_lossy()))
124
- });
125
- out.dedup_by(|a, b| a.path == b.path && a.requires_cwd_match == b.requires_cwd_match);
126
- cap_candidates_by_mtime(&mut out, CAPTURE_CANDIDATE_CAP);
127
- Ok(out)
128
- }
129
-
130
- /// ---
131
- /// purpose: 把候选路径读头解析成结构化候选,并在解析途中就滤掉明显不属于本席位的
132
- /// params:
133
- /// provider: 决定是否套用 claude 专属的两道排除
134
- /// context: 提供 spawn_cwd 与 agent_id 两个比对基准
135
- /// candidates: candidate_session_files 的产物
136
- /// returns: 通过全部排除的候选;每条带 embedded 身份、positive_agent_id_match 与 agent_path_match
137
- /// contract:
138
- /// provides:
139
- /// - name: parse_candidate_files
140
- /// what: 每个文件只读头 64KB,且只取到最后一个完整行
141
- /// boundary:
142
- /// - 四道排除:读不出头 / 解析不出记录 → 跳过;requires_cwd_match 的候选 cwd 对不上 → 跳过;embedded 身份存在且不等于本席位 → 跳过;claude 家族有 session id 却无 cwd 字段、或含 leader marker → 跳过
143
- /// - 无 session id 的候选不丢弃,降级为 FsMtimeFallback + Confidence::Low
144
- /// - 身份判定用两套文本:正文 text 判 TEAM_AGENT_ID,未截行的原始字节判 embedded worker id
145
- /// ---
146
- pub(super) fn parse_candidate_files(
147
- provider: Provider,
148
- context: &CaptureSessionContext,
149
- candidates: Vec<SessionCandidate>,
150
- ) -> Vec<CapturedSessionCandidate> {
151
- let mut out = Vec::new();
152
- for candidate in candidates {
153
- let path = candidate.path;
154
- let Ok(head_bytes) = read_head_bytes(&path, CAPTURE_HEAD_BYTES) else {
155
- continue;
156
- };
157
- let text = complete_head_text(&head_bytes);
158
- let identity_text = String::from_utf8_lossy(&head_bytes);
159
- let records = parse_session_records(&text);
160
- if records.is_empty() {
161
- continue;
162
- }
163
- if candidate.requires_cwd_match
164
- && !provider_home_records_match_spawn_cwd(&records, &context.spawn_cwd)
165
- {
166
- continue;
167
- }
168
- let session_id = records.iter().find_map(find_session_id);
169
- if matches!(provider, Provider::Claude | Provider::ClaudeCode)
170
- && session_id.is_some()
171
- && !records.iter().any(super::claude::has_cwd_field)
172
- {
173
- continue;
174
- }
175
- let captured_via = if session_id.is_some() {
176
- CaptureVia::FsWatch
177
- } else {
178
- CaptureVia::FsMtimeFallback
179
- };
180
- let attribution_confidence = if session_id.is_some() {
181
- Confidence::High
182
- } else {
183
- Confidence::Low
184
- };
185
- let embedded_agent_id = embedded_team_agent_worker_id_from_text(&identity_text);
186
- if embedded_agent_id
187
- .as_deref()
188
- .is_some_and(|id| id != context.agent_id.as_str())
189
- {
190
- continue;
191
- }
192
- let positive_agent_id_match = candidate_text_has_team_agent_id(&text, context)
193
- || embedded_agent_id.as_deref() == Some(context.agent_id.as_str());
194
- let agent_path_match = candidate_path_matches_agent_id(&path, context);
195
- if matches!(provider, Provider::Claude | Provider::ClaudeCode)
196
- && super::claude::records_have_leader_marker(&records)
197
- {
198
- continue;
199
- }
200
- out.push(CapturedSessionCandidate {
201
- captured: CapturedSession {
202
- session_id: session_id.map(SessionId::new),
203
- rollout_path: Some(RolloutPath::new(path)),
204
- captured_via,
205
- attribution_confidence,
206
- spawn_cwd: context.spawn_cwd.clone(),
207
- },
208
- embedded_agent_id,
209
- positive_agent_id_match,
210
- agent_path_match,
211
- });
212
- }
213
- out
214
- }
215
-
216
- /// Reject provider files older than the persisted process-cohort boundary.
217
- /// ---
218
- /// purpose: 用席位的进程世代边界剔除上一代/别人留下的旧存档
219
- /// params:
220
- /// _provider: 保留调用形状;所有 provider 都按文件 mtime 判定
221
- /// context: spawned_at 缺失则不过滤(legacy 行)
222
- /// out: 就地过滤的候选列表
223
- /// contract:
224
- /// provides:
225
- /// - name: apply_spawned_at_filter
226
- /// what: fail-closed —— spawned_at 存在但解析不了时清空候选,绝不放行
227
- /// boundary:
228
- /// - 无 spawned_at 时整体跳过过滤,把守卫让给分配器的身份与唯一性判据
229
- /// - 无 rollout_path、取不到时间的候选一律剔除
230
- /// ---
231
- pub(super) fn apply_spawned_at_filter(
232
- _provider: Provider,
233
- context: &CaptureSessionContext,
234
- out: &mut Vec<CapturedSessionCandidate>,
235
- ) {
236
- let Some(raw_spawned_at) = context.spawned_at.as_deref() else {
237
- // Legacy direct capture_session_id callers have no cohort boundary;
238
- // the canonical runtime capture path rejects such rows before scan.
239
- return;
240
- };
241
- let Some(spawned_at) = parse_spawned_at(raw_spawned_at) else {
242
- out.clear();
243
- return;
244
- };
245
- out.retain(|candidate| {
246
- let Some(path) = candidate.captured.rollout_path.as_ref() else {
247
- return false;
248
- };
249
- candidate_mtime(path.as_path()).is_some_and(|mtime| mtime >= spawned_at)
250
- });
251
- }
252
-
253
- /// RFC3339 only; the caller decides what `None` means (the filter clears).
254
- pub(super) fn parse_spawned_at(raw: &str) -> Option<std::time::SystemTime> {
255
- chrono::DateTime::parse_from_rfc3339(raw)
256
- .ok()
257
- .map(|dt| std::time::SystemTime::from(dt.with_timezone(&chrono::Utc)))
258
- }
259
-
260
- fn candidate_mtime(path: &Path) -> Option<std::time::SystemTime> {
261
- std::fs::metadata(path)
262
- .and_then(|meta| meta.modified())
263
- .ok()
264
- }
265
-
266
- /// ---
267
- /// purpose: 在时间窗只能唯一确定一条候选时才据此收窄,避免用弱判据在多条候选间乱挑
268
- /// params:
269
- /// _provider: 保留调用形状;所有 provider 都用 mtime
270
- /// context: 需要 spawned_at;有 expected id 且候选不超过 1 条时直接不动
271
- /// out: 就地可能被替换的候选列表
272
- /// contract:
273
- /// provides:
274
- /// - name: apply_spawn_time_window_if_unique
275
- /// what: 只在窗内恰好剩 1 条时替换整表;0 条或 ≥2 条一律保持原样
276
- /// boundary:
277
- /// - 无 spawned_at 或解析失败则不过滤(与 apply_spawned_at_filter 的 fail-closed 相反,此处是不作为)
278
- /// - 不排序、不去重;只做"唯一即取"的收窄
279
- /// ---
280
- pub(super) fn apply_spawn_time_window_if_unique(
281
- _provider: Provider,
282
- context: &CaptureSessionContext,
283
- out: &mut Vec<CapturedSessionCandidate>,
284
- ) {
285
- if context.expected_session_id.is_some() && out.len() <= 1 {
286
- return;
287
- }
288
- let Some(spawned_at) = context.spawned_at.as_deref().and_then(parse_spawned_at) else {
289
- return;
290
- };
291
- let within: Vec<CapturedSessionCandidate> = out
292
- .iter()
293
- .filter(|candidate| {
294
- candidate
295
- .captured
296
- .rollout_path
297
- .as_ref()
298
- .and_then(|p| candidate_mtime(p.as_path()))
299
- .is_some_and(|created_at| created_at >= spawned_at)
300
- })
301
- .cloned()
302
- .collect();
303
- if within.len() == 1 {
304
- *out = within;
305
- }
306
- }
307
-
308
- /// ---
309
- /// purpose: 有 pending id 时把命中的候选排到最前,让下游取首条即取到期望的那个
310
- /// params:
311
- /// context: 无 expected_session_id 则不动
312
- /// out: 就地排序的候选切片
313
- /// contract:
314
- /// provides:
315
- /// - name: sort_expected_first_if_needed
316
- /// what: 稳定排序,只按"是否命中 expected"分两档,不改组内相对次序
317
- /// boundary:
318
- /// - 只排序不过滤——未命中的候选仍在表里
319
- /// ---
320
- pub(super) fn sort_expected_first_if_needed(
321
- context: &CaptureSessionContext,
322
- out: &mut [CapturedSessionCandidate],
323
- ) {
324
- if let Some(expected) = context.expected_session_id.as_ref() {
325
- out.sort_by_key(|candidate| {
326
- candidate
327
- .captured
328
- .session_id
329
- .as_ref()
330
- .is_none_or(|session| session.as_str() != expected.as_str())
331
- });
332
- }
333
- }
334
-
335
- fn cap_candidates_by_mtime(out: &mut Vec<SessionCandidate>, cap: usize) {
336
- if out.len() <= cap {
337
- return;
338
- }
339
- let mut ranked: Vec<(std::time::SystemTime, usize)> = out
340
- .iter()
341
- .enumerate()
342
- .map(|(index, candidate)| {
343
- let mtime = std::fs::metadata(&candidate.path)
344
- .and_then(|meta| meta.modified())
345
- .unwrap_or(std::time::SystemTime::UNIX_EPOCH);
346
- (mtime, index)
347
- })
348
- .collect();
349
- ranked.sort_by(|a, b| b.0.cmp(&a.0));
350
- let keep: std::collections::BTreeSet<usize> = ranked
351
- .into_iter()
352
- .take(cap)
353
- .map(|(_, index)| index)
354
- .collect();
355
- let mut index = 0;
356
- out.retain(|_| {
357
- let kept = keep.contains(&index);
358
- index += 1;
359
- kept
360
- });
361
- }
362
-
363
- /// ---
364
- /// purpose: 读文件头若干字节并截到最后一个完整行,供各 provider 解析记录
365
- /// params:
366
- /// path: 待读文件
367
- /// max_bytes: 读取上限;全模块统一用 CAPTURE_HEAD_BYTES(64KB)
368
- /// returns: 到最后一个换行为止的文本;整段无换行时返回读到的全部
369
- /// errors: 打不开或读失败时上抛 io::Error
370
- /// contract:
371
- /// provides:
372
- /// - name: read_head_text
373
- /// what: 只读、不加锁、不改 mtime
374
- /// boundary:
375
- /// - 刻意丢弃末尾不完整的一行——半条 JSON 会让解析器把整段判废
376
- /// - 非 UTF-8 字节按 lossy 转换,不报错
377
- /// - 只看头部;窗口之外的内容对所有基于本函数的判据都不可见
378
- /// ---
379
- pub(super) fn read_head_text(path: &Path, max_bytes: u64) -> std::io::Result<String> {
380
- read_head_bytes(path, max_bytes).map(|bytes| complete_head_text(&bytes))
381
- }
382
-
383
- fn read_head_bytes(path: &Path, max_bytes: u64) -> std::io::Result<Vec<u8>> {
384
- use std::io::Read;
385
- let file = std::fs::File::open(path)?;
386
- let mut bytes = Vec::new();
387
- file.take(max_bytes).read_to_end(&mut bytes)?;
388
- Ok(bytes)
389
- }
390
-
391
- fn complete_head_text(bytes: &[u8]) -> String {
392
- let complete = match bytes.iter().rposition(|byte| *byte == b'\n') {
393
- Some(last_newline) => &bytes[..=last_newline],
394
- None => &bytes[..],
395
- };
396
- String::from_utf8_lossy(complete).into_owned()
397
- }
398
-
399
- fn collect_optional_candidate_files(
400
- dir: &Path,
401
- agent_id: &str,
402
- allowed_team_root: Option<&Path>,
403
- out: &mut Vec<SessionCandidate>,
404
- ) -> Result<(), ProviderError> {
405
- if dir.exists() {
406
- let _ = collect_candidate_files(dir, agent_id, 0, true, allowed_team_root, out);
407
- }
408
- Ok(())
409
- }
410
-
411
- fn collect_candidate_files(
412
- dir: &Path,
413
- agent_id: &str,
414
- depth: usize,
415
- requires_cwd_match: bool,
416
- allowed_team_root: Option<&Path>,
417
- out: &mut Vec<SessionCandidate>,
418
- ) -> Result<(), ProviderError> {
419
- if depth > 4 || !may_traverse_session_directory(dir, allowed_team_root) {
420
- return Ok(());
421
- }
422
- #[cfg(test)]
423
- tests::record_directory_read(dir);
424
- let entries = match std::fs::read_dir(dir) {
425
- Ok(entries) => entries,
426
- Err(e) if depth == 0 => return Err(ProviderError::Io(format!("{}: {e}", dir.display()))),
427
- Err(_) => return Ok(()),
428
- };
429
- for entry in entries {
430
- let Ok(entry) = entry else {
431
- continue;
432
- };
433
- #[cfg(test)]
434
- tests::record_entry();
435
- let path = entry.path();
436
- if !may_traverse_session_directory(&path, allowed_team_root) {
437
- continue;
438
- }
439
- // read_dir already supplies the type for ordinary entries. Only links
440
- // (or an unavailable type) need the old, following metadata lookup.
441
- let is_dir = match entry.file_type() {
442
- Ok(kind) if !kind.is_symlink() => kind.is_dir(),
443
- _ => {
444
- #[cfg(test)]
445
- tests::record_following_metadata();
446
- path.is_dir()
447
- }
448
- };
449
- if is_dir {
450
- collect_candidate_files(
451
- &path,
452
- agent_id,
453
- depth.saturating_add(1),
454
- requires_cwd_match,
455
- allowed_team_root,
456
- out,
457
- )?;
458
- } else if looks_like_session_file(&path, agent_id, allowed_team_root) {
459
- out.push(SessionCandidate {
460
- path,
461
- requires_cwd_match,
462
- });
463
- }
464
- }
465
- Ok(())
466
- }
467
-
468
- fn may_traverse_session_directory(path: &Path, allowed_team_root: Option<&Path>) -> bool {
469
- !path_is_under_team_runtime(path)
470
- || allowed_team_root.is_some_and(|root| path.starts_with(root) || root.starts_with(path))
471
- }
472
-
473
- fn looks_like_session_file(path: &Path, agent_id: &str, allowed_team_root: Option<&Path>) -> bool {
474
- if path_is_under_team_runtime(path)
475
- && !allowed_team_root.is_some_and(|root| path.starts_with(root))
476
- {
477
- return false;
478
- }
479
- let Some(name) = path.file_name().and_then(|s| s.to_str()) else {
480
- return false;
481
- };
482
- name.ends_with(".jsonl")
483
- || name.ends_with(".json")
484
- || name.contains("session")
485
- || name.contains("rollout")
486
- || (!agent_id.is_empty() && name.contains(agent_id))
487
- }
488
-
489
- /// ---
490
- /// purpose: 把会话文本解析成记录数组,兼容整体 JSON 与 JSONL 两种存档形态
491
- /// params:
492
- /// text: 已读入的文本(通常是 read_head_text 的产物)
493
- /// returns: JSON 数组则展开;JSON 单值则包成一条;都不是则按 JSONL 逐行解析
494
- /// contract:
495
- /// provides:
496
- /// - name: parse_session_records
497
- /// what: 纯解析,无 I/O
498
- /// boundary:
499
- /// - JSONL 分支跳过解析失败的行,不报错——因此"记录为空"不区分"文件空"与"全是坏行"
500
- /// ---
501
- pub(super) fn parse_session_records(text: &str) -> Vec<serde_json::Value> {
502
- match serde_json::from_str::<serde_json::Value>(text) {
503
- Ok(serde_json::Value::Array(items)) => items,
504
- Ok(value) => vec![value],
505
- Err(_) => parse_jsonl_records(text),
506
- }
507
- }
508
-
509
- fn provider_home_records_match_spawn_cwd(records: &[serde_json::Value], spawn_cwd: &Path) -> bool {
510
- let cwd_values: Vec<String> = records.iter().filter_map(record_cwd).collect();
511
- !cwd_values.is_empty()
512
- && cwd_values
513
- .iter()
514
- .any(|cwd| paths_equivalent(Path::new(cwd), spawn_cwd))
515
- }
516
-
517
- fn candidate_text_has_team_agent_id(text: &str, context: &CaptureSessionContext) -> bool {
518
- let id = context.agent_id.as_str();
519
- if id.is_empty() {
520
- return false;
521
- }
522
- [
523
- format!("\"TEAM_AGENT_ID\":\"{id}\""),
524
- format!("\"TEAM_AGENT_ID\": \"{id}\""),
525
- format!("TEAM_AGENT_ID={id}"),
526
- format!("env.TEAM_AGENT_ID=\"{id}\""),
527
- format!("env.TEAM_AGENT_ID=\\\"{id}\\\""),
528
- format!("\"TEAM_AGENT_AGENT_ID\":\"{id}\""),
529
- format!("\"TEAM_AGENT_AGENT_ID\": \"{id}\""),
530
- format!("TEAM_AGENT_AGENT_ID={id}"),
531
- ]
532
- .iter()
533
- .any(|needle| text.contains(needle))
534
- }
535
-
536
- /// ---
537
- /// purpose: 从会话正文里抽出 team-agent 写进 prompt 的席位身份 marker,作为归属的强证据
538
- /// params:
539
- /// text: 待搜索的文本
540
- /// returns: marker 后反引号之间的 id;未找到、为空或含非法字符时 None
541
- /// contract:
542
- /// provides:
543
- /// - name: embedded_team_agent_worker_id_from_text
544
- /// what: 纯文本查找,无 I/O
545
- /// boundary:
546
- /// - 只取第一处 marker;后续出现的一律忽略
547
- /// - id 字符集限定为 ASCII 字母数字与 _ - .;越界即判无
548
- /// - 找不到只说明"这段文本里没有",不等于该会话不属于任何席位
549
- /// ---
550
- pub(crate) fn embedded_team_agent_worker_id_from_text(text: &str) -> Option<String> {
551
- const PREFIX: &str = "You are Team Agent worker `";
552
- let start = text.find(PREFIX)? + PREFIX.len();
553
- let rest = &text[start..];
554
- let end = rest.find('`')?;
555
- let id = &rest[..end];
556
- if id.is_empty()
557
- || !id
558
- .chars()
559
- .all(|ch| ch.is_ascii_alphanumeric() || matches!(ch, '_' | '-' | '.'))
560
- {
561
- return None;
562
- }
563
- Some(id.to_string())
564
- }
565
-
566
- /// ---
567
- /// purpose: 按路径取该存档的 embedded 席位身份,供捕获链外的调用方直接查归属
568
- /// params:
569
- /// path: 存档文件路径
570
- /// returns: 读头 64KB 后抽到的席位 id;读失败或没抽到给 None
571
- /// contract:
572
- /// provides:
573
- /// - name: rollout_path_embedded_team_agent_worker_id
574
- /// what: read_head_text + embedded_team_agent_worker_id_from_text 的组合,只读
575
- /// boundary:
576
- /// - 读失败与"文件里确实没有 marker"都返回 None,两者不可区分
577
- /// - marker 若出现在 64KB 之后则看不见
578
- /// ---
579
- pub(crate) fn rollout_path_embedded_team_agent_worker_id(path: &Path) -> Option<String> {
580
- read_head_text(path, CAPTURE_HEAD_BYTES)
581
- .ok()
582
- .and_then(|text| embedded_team_agent_worker_id_from_text(&text))
583
- }
584
-
585
- fn candidate_path_matches_agent_id(path: &Path, context: &CaptureSessionContext) -> bool {
586
- let id = context.agent_id.as_str();
587
- if id.is_empty() {
588
- return false;
589
- }
590
- let Some(name) = path.file_name().and_then(|value| value.to_str()) else {
591
- return false;
592
- };
593
- let dashed = id.replace('_', "-");
594
- name.contains(id) || name.contains(&dashed)
595
- }
596
-
597
- /// ---
598
- /// purpose: 从一条会话记录里取工作目录,兼容 claude 顶层 cwd 与 codex session_meta.payload.cwd 两种形状
599
- /// params:
600
- /// record: 单条已解析记录
601
- /// returns: 顶层 cwd 优先;否则取 session_meta.payload.cwd 或 payload.cwd;都没有则 None
602
- /// contract:
603
- /// provides:
604
- /// - name: record_cwd
605
- /// what: 纯取值,不做路径归一或存在性检查
606
- /// boundary:
607
- /// - 只认这三个位置;其它自定义字段一概不看
608
- /// ---
609
- pub(super) fn record_cwd(record: &serde_json::Value) -> Option<String> {
610
- record
611
- .get("cwd")
612
- .and_then(serde_json::Value::as_str)
613
- .or_else(|| {
614
- record
615
- .get("session_meta")
616
- .and_then(|v| v.get("payload"))
617
- .or_else(|| record.get("payload"))
618
- .and_then(|v| v.get("cwd"))
619
- .and_then(serde_json::Value::as_str)
620
- })
621
- .map(ToString::to_string)
622
- }
623
-
624
- /// ---
625
- /// purpose: 判断记录里的 cwd 与席位 spawn_cwd 是不是同一个工作目录
626
- /// params:
627
- /// left: 记录里的 cwd
628
- /// right: 席位 spawn_cwd
629
- /// returns: 字面相等、canonicalize 后相等、或 left 的父目录等于 right 时为 true
630
- /// contract:
631
- /// provides:
632
- /// - name: paths_equivalent
633
- /// what: 会触发文件系统 canonicalize;失败则退回原路径继续比
634
- /// boundary:
635
- /// - 父目录等价是刻意放宽的一档:记录 cwd 是 spawn_cwd 的直接子目录也算同 cwd,嵌套 workspace 下会把子目录的存档收进来
636
- /// - 不对称:只查 left 的父等于 right,反向不查
637
- /// - 不解析符号链接之外的等价(如大小写不敏感文件系统的同名不同写)
638
- /// ---
639
- pub(super) fn paths_equivalent(left: &Path, right: &Path) -> bool {
640
- if left == right {
641
- return true;
642
- }
643
- let left = std::fs::canonicalize(left).unwrap_or_else(|_| left.to_path_buf());
644
- let right = std::fs::canonicalize(right).unwrap_or_else(|_| right.to_path_buf());
645
- left == right || left.parent().is_some_and(|parent| parent == right)
646
- }
647
-
648
- fn path_is_under_team_runtime(path: &Path) -> bool {
649
- path.components()
650
- .any(|c| c.as_os_str() == std::ffi::OsStr::new(".team"))
651
- }
652
-
653
- #[cfg(test)]
654
- mod tests;