@team-agent/installer 0.5.128 → 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.
- package/README.md +4 -4
- package/README.zh.md +1 -1
- package/package.json +4 -8
- package/skills/team-agent/SKILL.md +37 -20
- package/skills/team-agent/command-coverage.json +169 -183
- package/skills/team-agent/docs/reference/team-agent-operator.md +64 -30
- package/skills/team-agent/references/recovery-runbook.md +1 -1
- package/skills/team-agent/references/team-agent-operator.md +64 -30
- package/templates/team_state.md +1 -1
- package/Cargo.lock +0 -1063
- package/Cargo.toml +0 -36
- package/crates/team-agent/Cargo.toml +0 -69
- package/crates/team-agent/src/app_server_test_support.rs +0 -258
- package/crates/team-agent/src/cli/adapters.rs +0 -1288
- package/crates/team-agent/src/cli/arguments.rs +0 -405
- package/crates/team-agent/src/cli/attach_app_server_leader.rs +0 -98
- package/crates/team-agent/src/cli/diagnose.rs +0 -1721
- package/crates/team-agent/src/cli/emit.rs +0 -2930
- package/crates/team-agent/src/cli/grok_slot.rs +0 -384
- package/crates/team-agent/src/cli/helpers.rs +0 -91
- package/crates/team-agent/src/cli/intent/runtime.rs +0 -1216
- package/crates/team-agent/src/cli/intent/runtime_tests.rs +0 -912
- package/crates/team-agent/src/cli/intent/tests.rs +0 -689
- package/crates/team-agent/src/cli/intent.rs +0 -664
- package/crates/team-agent/src/cli/leader.rs +0 -300
- package/crates/team-agent/src/cli/leader_prompt.rs +0 -261
- package/crates/team-agent/src/cli/leaders.rs +0 -418
- package/crates/team-agent/src/cli/mod.rs +0 -6545
- package/crates/team-agent/src/cli/models.rs +0 -1206
- package/crates/team-agent/src/cli/named_address.rs +0 -1651
- package/crates/team-agent/src/cli/profile.rs +0 -342
- package/crates/team-agent/src/cli/route.rs +0 -212
- package/crates/team-agent/src/cli/schedule.rs +0 -175
- package/crates/team-agent/src/cli/send/coordinator.rs +0 -164
- package/crates/team-agent/src/cli/send/mailbox.rs +0 -145
- package/crates/team-agent/src/cli/send/persist.rs +0 -156
- package/crates/team-agent/src/cli/send/presentation.rs +0 -370
- package/crates/team-agent/src/cli/send/resolve.rs +0 -573
- package/crates/team-agent/src/cli/send.rs +0 -199
- package/crates/team-agent/src/cli/shutdown_socket.rs +0 -288
- package/crates/team-agent/src/cli/spec.rs +0 -165
- package/crates/team-agent/src/cli/status.rs +0 -280
- package/crates/team-agent/src/cli/status_port/agents.rs +0 -358
- package/crates/team-agent/src/cli/status_port/approvals.rs +0 -79
- package/crates/team-agent/src/cli/status_port/brief.rs +0 -1981
- package/crates/team-agent/src/cli/status_port/compact.rs +0 -240
- package/crates/team-agent/src/cli/status_port/format.rs +0 -146
- package/crates/team-agent/src/cli/status_port/inbox.rs +0 -62
- package/crates/team-agent/src/cli/status_port/runtime.rs +0 -197
- package/crates/team-agent/src/cli/status_port/snapshot.rs +0 -208
- package/crates/team-agent/src/cli/status_port/store.rs +0 -416
- package/crates/team-agent/src/cli/status_port/tests.rs +0 -90
- package/crates/team-agent/src/cli/status_port.rs +0 -92
- package/crates/team-agent/src/cli/tests/base.rs +0 -885
- package/crates/team-agent/src/cli/tests/divergence.rs +0 -518
- package/crates/team-agent/src/cli/tests/lane_c.rs +0 -453
- package/crates/team-agent/src/cli/tests/leader_watch.rs +0 -322
- package/crates/team-agent/src/cli/tests/main_preserved.rs +0 -430
- package/crates/team-agent/src/cli/tests/missing_subcommands.rs +0 -336
- package/crates/team-agent/src/cli/tests/mod.rs +0 -137
- package/crates/team-agent/src/cli/tests/named_address.rs +0 -761
- package/crates/team-agent/src/cli/tests/parser_safety.rs +0 -383
- package/crates/team-agent/src/cli/tests/run_delegation.rs +0 -484
- package/crates/team-agent/src/cli/tests/shutdown_kill_plan.rs +0 -2179
- package/crates/team-agent/src/cli/tests/status_brief.rs +0 -1514
- package/crates/team-agent/src/cli/tests/status_send.rs +0 -888
- package/crates/team-agent/src/cli/tests/verb_install_skill.rs +0 -93
- package/crates/team-agent/src/cli/tests/verb_profile.rs +0 -392
- package/crates/team-agent/src/cli/triage.rs +0 -234
- package/crates/team-agent/src/cli/types.rs +0 -591
- package/crates/team-agent/src/codex_app_server.rs +0 -546
- package/crates/team-agent/src/communication_mode/mod.rs +0 -56
- package/crates/team-agent/src/compiler/tests.rs +0 -827
- package/crates/team-agent/src/compiler.rs +0 -890
- package/crates/team-agent/src/conpty/backend.rs +0 -829
- package/crates/team-agent/src/conpty/mod.rs +0 -33
- package/crates/team-agent/src/contract_runtime/backend.rs +0 -1744
- package/crates/team-agent/src/contract_runtime/commands.rs +0 -671
- package/crates/team-agent/src/contract_runtime/config.rs +0 -364
- package/crates/team-agent/src/contract_runtime/config_tests.rs +0 -76
- package/crates/team-agent/src/contract_runtime/discovery.rs +0 -449
- package/crates/team-agent/src/contract_runtime/fork.rs +0 -361
- package/crates/team-agent/src/contract_runtime/forward.rs +0 -288
- package/crates/team-agent/src/contract_runtime/framework.rs +0 -367
- package/crates/team-agent/src/contract_runtime/mcp.rs +0 -394
- package/crates/team-agent/src/contract_runtime/mod.rs +0 -17
- package/crates/team-agent/src/contract_runtime/prompt.rs +0 -216
- package/crates/team-agent/src/contract_runtime/pump.rs +0 -271
- package/crates/team-agent/src/contract_runtime/registry.rs +0 -553
- package/crates/team-agent/src/contract_runtime/workspace.rs +0 -228
- package/crates/team-agent/src/coordinator/backoff.rs +0 -741
- package/crates/team-agent/src/coordinator/conpty_shim.rs +0 -805
- package/crates/team-agent/src/coordinator/health.rs +0 -1185
- package/crates/team-agent/src/coordinator/mod.rs +0 -119
- package/crates/team-agent/src/coordinator/orphan.rs +0 -110
- package/crates/team-agent/src/coordinator/runtime_detectors.rs +0 -798
- package/crates/team-agent/src/coordinator/runtime_observation.rs +0 -84
- package/crates/team-agent/src/coordinator/steps/abnormal.rs +0 -2309
- package/crates/team-agent/src/coordinator/steps/delivery.rs +0 -15
- package/crates/team-agent/src/coordinator/steps/health_sync.rs +0 -15
- package/crates/team-agent/src/coordinator/steps/mod.rs +0 -126
- package/crates/team-agent/src/coordinator/steps/persist.rs +0 -15
- package/crates/team-agent/src/coordinator/steps/runtime_prompts.rs +0 -15
- package/crates/team-agent/src/coordinator/steps/session_gate.rs +0 -16
- package/crates/team-agent/src/coordinator/tests/a0_lostupdate.rs +0 -158
- package/crates/team-agent/src/coordinator/tests/abnormal.rs +0 -312
- package/crates/team-agent/src/coordinator/tests/api_error_recovery.rs +0 -300
- package/crates/team-agent/src/coordinator/tests/basics.rs +0 -211
- package/crates/team-agent/src/coordinator/tests/daemon.rs +0 -514
- package/crates/team-agent/src/coordinator/tests/energy.rs +0 -549
- package/crates/team-agent/src/coordinator/tests/health_sync.rs +0 -503
- package/crates/team-agent/src/coordinator/tests/main_preserved.rs +0 -186
- package/crates/team-agent/src/coordinator/tests/mod.rs +0 -295
- package/crates/team-agent/src/coordinator/tests/s3_bounded.rs +0 -207
- package/crates/team-agent/src/coordinator/tests/spine.rs +0 -308
- package/crates/team-agent/src/coordinator/tests/takeover.rs +0 -286
- package/crates/team-agent/src/coordinator/tests/tick_core.rs +0 -237
- package/crates/team-agent/src/coordinator/tick.rs +0 -3024
- package/crates/team-agent/src/coordinator/types.rs +0 -540
- package/crates/team-agent/src/db/agent_health_capture.rs +0 -126
- package/crates/team-agent/src/db/message_store.rs +0 -1527
- package/crates/team-agent/src/db/migration.rs +0 -984
- package/crates/team-agent/src/db/mod.rs +0 -26
- package/crates/team-agent/src/db/schema.rs +0 -663
- package/crates/team-agent/src/diagnose/comms.rs +0 -242
- package/crates/team-agent/src/diagnose/mod.rs +0 -44
- package/crates/team-agent/src/diagnose/orphans.rs +0 -889
- package/crates/team-agent/src/direct_delivery.rs +0 -368
- package/crates/team-agent/src/event_log.rs +0 -502
- package/crates/team-agent/src/fake_worker.rs +0 -303
- package/crates/team-agent/src/inbox_store.rs +0 -169
- package/crates/team-agent/src/kill_audit.rs +0 -106
- package/crates/team-agent/src/layout/manager.rs +0 -248
- package/crates/team-agent/src/layout/mod.rs +0 -36
- package/crates/team-agent/src/layout/overlay.rs +0 -134
- package/crates/team-agent/src/layout/placement.rs +0 -52
- package/crates/team-agent/src/layout/recovery.rs +0 -106
- package/crates/team-agent/src/layout/runtime_sessions.rs +0 -317
- package/crates/team-agent/src/layout/sessions.rs +0 -294
- package/crates/team-agent/src/layout/tmux_endpoint.rs +0 -165
- package/crates/team-agent/src/layout/worker_env.rs +0 -721
- package/crates/team-agent/src/layout/worker_window_helpers.rs +0 -37
- package/crates/team-agent/src/leader/helpers.rs +0 -178
- package/crates/team-agent/src/leader/incident.rs +0 -6
- package/crates/team-agent/src/leader/lease.rs +0 -3356
- package/crates/team-agent/src/leader/mod.rs +0 -104
- package/crates/team-agent/src/leader/owner_bind.rs +0 -400
- package/crates/team-agent/src/leader/prompt.rs +0 -905
- package/crates/team-agent/src/leader/provider_attribution.rs +0 -247
- package/crates/team-agent/src/leader/rediscover/tests.rs +0 -689
- package/crates/team-agent/src/leader/rediscover.rs +0 -1192
- package/crates/team-agent/src/leader/registry.rs +0 -888
- package/crates/team-agent/src/leader/start.rs +0 -4501
- package/crates/team-agent/src/leader/takeover.rs +0 -65
- package/crates/team-agent/src/leader/tests/basics.rs +0 -337
- package/crates/team-agent/src/leader/tests/byte_findings.rs +0 -355
- package/crates/team-agent/src/leader/tests/claim_leader_mailbox_flush_contract.rs +0 -544
- package/crates/team-agent/src/leader/tests/historical_inventory_upgrade_gate_red.rs +0 -624
- package/crates/team-agent/src/leader/tests/identity.rs +0 -465
- package/crates/team-agent/src/leader/tests/identity_session_names.rs +0 -42
- package/crates/team-agent/src/leader/tests/idle.rs +0 -113
- package/crates/team-agent/src/leader/tests/lease_api.rs +0 -520
- package/crates/team-agent/src/leader/tests/lease_claim.rs +0 -629
- package/crates/team-agent/src/leader/tests/mod.rs +0 -106
- package/crates/team-agent/src/leader/tests/prompt_contract.rs +0 -268
- package/crates/team-agent/src/leader/tests/rediscover.rs +0 -403
- package/crates/team-agent/src/leader/tests/rehomed_env.rs +0 -83
- package/crates/team-agent/src/leader/tests/team_in_team_state_scope_red.rs +0 -1273
- package/crates/team-agent/src/leader/tests/terminal_and_replay_vs_rerender_invariants_red.rs +0 -417
- package/crates/team-agent/src/leader/tests/wake_start_owner.rs +0 -168
- package/crates/team-agent/src/leader/types.rs +0 -534
- package/crates/team-agent/src/lib.rs +0 -147
- package/crates/team-agent/src/lifecycle/helpers.rs +0 -212
- package/crates/team-agent/src/lifecycle/launch/add_agent.rs +0 -881
- package/crates/team-agent/src/lifecycle/launch/add_agent_state.rs +0 -598
- package/crates/team-agent/src/lifecycle/launch/agent_state.rs +0 -332
- package/crates/team-agent/src/lifecycle/launch/clone_agent.rs +0 -204
- package/crates/team-agent/src/lifecycle/launch/fork_agent.rs +0 -107
- package/crates/team-agent/src/lifecycle/launch/fork_entry.rs +0 -144
- package/crates/team-agent/src/lifecycle/launch/identity.rs +0 -674
- package/crates/team-agent/src/lifecycle/launch/layout.rs +0 -350
- package/crates/team-agent/src/lifecycle/launch/leader_context.rs +0 -589
- package/crates/team-agent/src/lifecycle/launch/mcp_config.rs +0 -160
- package/crates/team-agent/src/lifecycle/launch/ownership.rs +0 -105
- package/crates/team-agent/src/lifecycle/launch/pi_mcp.rs +0 -899
- package/crates/team-agent/src/lifecycle/launch/pi_mcp_extension.js +0 -225
- package/crates/team-agent/src/lifecycle/launch/plan.rs +0 -269
- package/crates/team-agent/src/lifecycle/launch/quick_start.rs +0 -5200
- package/crates/team-agent/src/lifecycle/launch/quick_start_transport.rs +0 -368
- package/crates/team-agent/src/lifecycle/launch/readiness.rs +0 -519
- package/crates/team-agent/src/lifecycle/launch/role_source.rs +0 -287
- package/crates/team-agent/src/lifecycle/launch/spawn.rs +0 -473
- package/crates/team-agent/src/lifecycle/launch/spec_state.rs +0 -801
- package/crates/team-agent/src/lifecycle/launch/state_projection.rs +0 -624
- package/crates/team-agent/src/lifecycle/launch/worker_env.rs +0 -558
- package/crates/team-agent/src/lifecycle/launch.rs +0 -557
- package/crates/team-agent/src/lifecycle/lock.rs +0 -350
- package/crates/team-agent/src/lifecycle/mod.rs +0 -79
- package/crates/team-agent/src/lifecycle/pane_input_lock.rs +0 -239
- package/crates/team-agent/src/lifecycle/profile_launch.rs +0 -1067
- package/crates/team-agent/src/lifecycle/profile_smoke.rs +0 -557
- package/crates/team-agent/src/lifecycle/restart/agent.rs +0 -2199
- package/crates/team-agent/src/lifecycle/restart/avatar.rs +0 -1798
- package/crates/team-agent/src/lifecycle/restart/claude_fork.rs +0 -163
- package/crates/team-agent/src/lifecycle/restart/common.rs +0 -2362
- package/crates/team-agent/src/lifecycle/restart/orchestrator.rs +0 -65
- package/crates/team-agent/src/lifecycle/restart/preflight.rs +0 -113
- package/crates/team-agent/src/lifecycle/restart/rebuild.rs +0 -5135
- package/crates/team-agent/src/lifecycle/restart/remove.rs +0 -1504
- package/crates/team-agent/src/lifecycle/restart/selection.rs +0 -559
- package/crates/team-agent/src/lifecycle/restart/team_state.rs +0 -329
- package/crates/team-agent/src/lifecycle/restart.rs +0 -227
- package/crates/team-agent/src/lifecycle/role_config.rs +0 -1230
- package/crates/team-agent/src/lifecycle/tests/acceptance_b_batch_red.rs +0 -1021
- package/crates/team-agent/src/lifecycle/tests/agent_ops.rs +0 -1205
- package/crates/team-agent/src/lifecycle/tests/b0_legacy_snapshot_nonauthority_contract.rs +0 -265
- package/crates/team-agent/src/lifecycle/tests/b0_reader_hideone_audit_contract.rs +0 -490
- package/crates/team-agent/src/lifecycle/tests/behavioral_diff_264_red.rs +0 -656
- package/crates/team-agent/src/lifecycle/tests/claude_compatible_config_red.rs +0 -325
- package/crates/team-agent/src/lifecycle/tests/claude_profile_launch_red.rs +0 -447
- package/crates/team-agent/src/lifecycle/tests/cli_argv_routing_red.rs +0 -1638
- package/crates/team-agent/src/lifecycle/tests/clone_agent_preserves_source_tools.rs +0 -427
- package/crates/team-agent/src/lifecycle/tests/clone_fork_copilot_perms_red.rs +0 -770
- package/crates/team-agent/src/lifecycle/tests/communication_mode_runtime_contract_red.rs +0 -419
- package/crates/team-agent/src/lifecycle/tests/copilot_provider_red.rs +0 -2035
- package/crates/team-agent/src/lifecycle/tests/core.rs +0 -1327
- package/crates/team-agent/src/lifecycle/tests/f032_startup_prompt_best_effort_red.rs +0 -315
- package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_g0.stdout.txt +0 -222
- package/crates/team-agent/src/lifecycle/tests/fixtures/pi_list_models_spaced_ids.stdout.txt +0 -9
- package/crates/team-agent/src/lifecycle/tests/fixtures/pi_native_mcp_host.mjs +0 -72
- package/crates/team-agent/src/lifecycle/tests/gate_fixtures.rs +0 -562
- package/crates/team-agent/src/lifecycle/tests/grok_require_explicit_model_red.rs +0 -110
- package/crates/team-agent/src/lifecycle/tests/harvest2_a_batch_red.rs +0 -512
- package/crates/team-agent/src/lifecycle/tests/host_cotenant_death_p0_contract.rs +0 -921
- package/crates/team-agent/src/lifecycle/tests/issue238_codex_effort_contract.rs +0 -68
- package/crates/team-agent/src/lifecycle/tests/lane_ops.rs +0 -1851
- package/crates/team-agent/src/lifecycle/tests/launch_spawn.rs +0 -3983
- package/crates/team-agent/src/lifecycle/tests/lifecycle_lock.rs +0 -339
- package/crates/team-agent/src/lifecycle/tests/lifecycle_rollback_red.rs +0 -596
- package/crates/team-agent/src/lifecycle/tests/main_preserved.rs +0 -513
- package/crates/team-agent/src/lifecycle/tests/mcp_tool_name_format_red.rs +0 -69
- package/crates/team-agent/src/lifecycle/tests/phase_b_contracts.rs +0 -824
- package/crates/team-agent/src/lifecycle/tests/phase_golden.rs +0 -723
- package/crates/team-agent/src/lifecycle/tests/pi_catalog_red.rs +0 -164
- package/crates/team-agent/src/lifecycle/tests/pi_command_red.rs +0 -200
- package/crates/team-agent/src/lifecycle/tests/pi_compiler_red.rs +0 -210
- package/crates/team-agent/src/lifecycle/tests/pi_dual_entry_red.rs +0 -527
- package/crates/team-agent/src/lifecycle/tests/pi_executable_mcp_red.rs +0 -1062
- package/crates/team-agent/src/lifecycle/tests/pi_fork_session_inheritance_red.rs +0 -1419
- package/crates/team-agent/src/lifecycle/tests/pi_lifecycle_doctor_red.rs +0 -98
- package/crates/team-agent/src/lifecycle/tests/pi_native_mcp_capability_red.rs +0 -550
- package/crates/team-agent/src/lifecycle/tests/pi_session_delivery_red.rs +0 -226
- package/crates/team-agent/src/lifecycle/tests/quick_start_worker_readiness_red.rs +0 -332
- package/crates/team-agent/src/lifecycle/tests/realmachine_clusters_1_6_red.rs +0 -786
- package/crates/team-agent/src/lifecycle/tests/realmachine_residual_g1_g4_red.rs +0 -648
- package/crates/team-agent/src/lifecycle/tests/restart.rs +0 -185
- package/crates/team-agent/src/lifecycle/tests/restart_build_before_destroy_0540_contract.rs +0 -1053
- package/crates/team-agent/src/lifecycle/tests/restart_liveness_red.rs +0 -679
- package/crates/team-agent/src/lifecycle/tests/restart_rebind_hotfix_252_red.rs +0 -1126
- package/crates/team-agent/src/lifecycle/tests/restart_session_capture_red.rs +0 -153
- package/crates/team-agent/src/lifecycle/tests/resume_recover_red.rs +0 -427
- package/crates/team-agent/src/lifecycle/tests/stale_team_saveconflict_contract.rs +0 -431
- package/crates/team-agent/src/lifecycle/tests/startup_latency_contract.rs +0 -1066
- package/crates/team-agent/src/lifecycle/tests/status_credential_redaction_contract.rs +0 -876
- package/crates/team-agent/src/lifecycle/tests/subprep_codex_trust_roundtrip_red.rs +0 -1026
- package/crates/team-agent/src/lifecycle/tests/swallow_batch4_semantics_red.rs +0 -342
- package/crates/team-agent/src/lifecycle/tests/team_in_team_identity_scope_red.rs +0 -543
- package/crates/team-agent/src/lifecycle/tests/team_in_team_sibling_quick_start_red.rs +0 -1103
- package/crates/team-agent/src/lifecycle/tests/team_in_team_state_scope_red.rs +0 -1276
- package/crates/team-agent/src/lifecycle/tests/team_key_retirement_roster_red.rs +0 -145
- package/crates/team-agent/src/lifecycle/tests/team_key_retirement_txn_red.rs +0 -603
- package/crates/team-agent/src/lifecycle/tests/test_isolation_escape_contract.rs +0 -936
- package/crates/team-agent/src/lifecycle/tests/upgrade_compat_0211_red.rs +0 -970
- package/crates/team-agent/src/lifecycle/tests/verify_rs031_window_consistency_red.rs +0 -995
- package/crates/team-agent/src/lifecycle/tests/worker_spawn_env_red.rs +0 -836
- package/crates/team-agent/src/lifecycle/tests.rs +0 -105
- package/crates/team-agent/src/lifecycle/types.rs +0 -877
- package/crates/team-agent/src/lifecycle/worker_command_context.rs +0 -363
- package/crates/team-agent/src/main.rs +0 -52
- package/crates/team-agent/src/mcp_server/helpers.rs +0 -510
- package/crates/team-agent/src/mcp_server/lifecycle_tools/mod.rs +0 -6
- package/crates/team-agent/src/mcp_server/lifecycle_tools/state_status.rs +0 -43
- package/crates/team-agent/src/mcp_server/mod.rs +0 -119
- package/crates/team-agent/src/mcp_server/normalize.rs +0 -485
- package/crates/team-agent/src/mcp_server/readiness.rs +0 -527
- package/crates/team-agent/src/mcp_server/readiness_tests.rs +0 -348
- package/crates/team-agent/src/mcp_server/tests/golden.rs +0 -285
- package/crates/team-agent/src/mcp_server/tests/normalize.rs +0 -247
- package/crates/team-agent/src/mcp_server/tests/scoped.rs +0 -158
- package/crates/team-agent/src/mcp_server/tests/send.rs +0 -353
- package/crates/team-agent/src/mcp_server/tests/tools.rs +0 -341
- package/crates/team-agent/src/mcp_server/tests/wire.rs +0 -254
- package/crates/team-agent/src/mcp_server/tests.rs +0 -43
- package/crates/team-agent/src/mcp_server/tools.rs +0 -889
- package/crates/team-agent/src/mcp_server/types.rs +0 -396
- package/crates/team-agent/src/mcp_server/wire.rs +0 -867
- package/crates/team-agent/src/messaging/activity.rs +0 -461
- package/crates/team-agent/src/messaging/address.rs +0 -87
- package/crates/team-agent/src/messaging/delivery.rs +0 -3727
- package/crates/team-agent/src/messaging/delivery_consumption_tests.rs +0 -234
- package/crates/team-agent/src/messaging/enter_rescue.rs +0 -362
- package/crates/team-agent/src/messaging/enter_rescue_tests.rs +0 -633
- package/crates/team-agent/src/messaging/helpers.rs +0 -336
- package/crates/team-agent/src/messaging/leader_channel.rs +0 -287
- package/crates/team-agent/src/messaging/leader_receiver.rs +0 -786
- package/crates/team-agent/src/messaging/mod.rs +0 -167
- package/crates/team-agent/src/messaging/persist.rs +0 -377
- package/crates/team-agent/src/messaging/presentation.rs +0 -417
- package/crates/team-agent/src/messaging/reminders.rs +0 -316
- package/crates/team-agent/src/messaging/results/collection_tests.rs +0 -719
- package/crates/team-agent/src/messaging/results.rs +0 -1415
- package/crates/team-agent/src/messaging/scheduler.rs +0 -223
- package/crates/team-agent/src/messaging/selftest.rs +0 -315
- package/crates/team-agent/src/messaging/send.rs +0 -981
- package/crates/team-agent/src/messaging/tests/basic.rs +0 -346
- package/crates/team-agent/src/messaging/tests/dup_inject.rs +0 -657
- package/crates/team-agent/src/messaging/tests/e23.rs +0 -49
- package/crates/team-agent/src/messaging/tests/leader_channel.rs +0 -169
- package/crates/team-agent/src/messaging/tests/leader_inject_acceptance.rs +0 -817
- package/crates/team-agent/src/messaging/tests/main_preserved.rs +0 -85
- package/crates/team-agent/src/messaging/tests/mod.rs +0 -306
- package/crates/team-agent/src/messaging/tests/runtime.rs +0 -3549
- package/crates/team-agent/src/messaging/tests/spine.rs +0 -853
- package/crates/team-agent/src/messaging/tests/wave2.rs +0 -381
- package/crates/team-agent/src/messaging/trust.rs +0 -215
- package/crates/team-agent/src/messaging/types.rs +0 -472
- package/crates/team-agent/src/messaging/wait.rs +0 -366
- package/crates/team-agent/src/messaging/watchers.rs +0 -916
- package/crates/team-agent/src/model/enums.rs +0 -356
- package/crates/team-agent/src/model/errors.rs +0 -18
- package/crates/team-agent/src/model/ids.rs +0 -165
- package/crates/team-agent/src/model/mod.rs +0 -29
- package/crates/team-agent/src/model/name_similarity.rs +0 -252
- package/crates/team-agent/src/model/pane_authority_refusal.rs +0 -359
- package/crates/team-agent/src/model/paths.rs +0 -257
- package/crates/team-agent/src/model/routing.rs +0 -387
- package/crates/team-agent/src/model/spec.rs +0 -1184
- package/crates/team-agent/src/model/task_graph.rs +0 -321
- package/crates/team-agent/src/model/testdata/fuzz.golden.yaml +0 -43
- package/crates/team-agent/src/model/testdata/fuzz.yaml +0 -43
- package/crates/team-agent/src/model/testdata/spec_invalid_a.yaml +0 -209
- package/crates/team-agent/src/model/testdata/team.spec.golden.yaml +0 -208
- package/crates/team-agent/src/model/testdata/team.spec.yaml +0 -208
- package/crates/team-agent/src/model/yaml/tests.rs +0 -188
- package/crates/team-agent/src/model/yaml.rs +0 -802
- package/crates/team-agent/src/os_probe.rs +0 -280
- package/crates/team-agent/src/packaging/install.rs +0 -219
- package/crates/team-agent/src/packaging/migrate.rs +0 -38
- package/crates/team-agent/src/packaging/mod.rs +0 -91
- package/crates/team-agent/src/packaging/repair.rs +0 -33
- package/crates/team-agent/src/packaging/tests.rs +0 -822
- package/crates/team-agent/src/packaging/types.rs +0 -417
- package/crates/team-agent/src/platform/argv.rs +0 -331
- package/crates/team-agent/src/platform/errors.rs +0 -104
- package/crates/team-agent/src/platform/file_lock.rs +0 -279
- package/crates/team-agent/src/platform/mod.rs +0 -5
- package/crates/team-agent/src/platform/process.rs +0 -545
- package/crates/team-agent/src/provider/adapter.rs +0 -1150
- package/crates/team-agent/src/provider/adapters/claude.rs +0 -78
- package/crates/team-agent/src/provider/adapters/claude_fork.rs +0 -131
- package/crates/team-agent/src/provider/adapters/copilot.rs +0 -75
- package/crates/team-agent/src/provider/adapters/copilot_fork.rs +0 -307
- package/crates/team-agent/src/provider/adapters/fake.rs +0 -18
- package/crates/team-agent/src/provider/adapters/mod.rs +0 -30
- package/crates/team-agent/src/provider/adapters/pi.rs +0 -106
- package/crates/team-agent/src/provider/approvals/mod.rs +0 -3
- package/crates/team-agent/src/provider/approvals/parsing.rs +0 -586
- package/crates/team-agent/src/provider/approvals/runtime_prompts.rs +0 -205
- package/crates/team-agent/src/provider/argv_route.rs +0 -405
- package/crates/team-agent/src/provider/bypass_flags.rs +0 -116
- package/crates/team-agent/src/provider/classify.rs +0 -708
- package/crates/team-agent/src/provider/command_helpers.rs +0 -45
- package/crates/team-agent/src/provider/faults.rs +0 -165
- package/crates/team-agent/src/provider/helpers.rs +0 -52
- package/crates/team-agent/src/provider/mod.rs +0 -78
- package/crates/team-agent/src/provider/model_catalog.rs +0 -910
- package/crates/team-agent/src/provider/session/capture.rs +0 -2731
- package/crates/team-agent/src/provider/session/context_fork/claude.rs +0 -123
- package/crates/team-agent/src/provider/session/context_fork/outcome.rs +0 -172
- package/crates/team-agent/src/provider/session/context_fork.rs +0 -396
- package/crates/team-agent/src/provider/session/mod.rs +0 -36
- package/crates/team-agent/src/provider/session/resume.rs +0 -269
- package/crates/team-agent/src/provider/session_scan/claude.rs +0 -523
- package/crates/team-agent/src/provider/session_scan/common/tests.rs +0 -316
- package/crates/team-agent/src/provider/session_scan/common.rs +0 -654
- package/crates/team-agent/src/provider/session_scan/copilot.rs +0 -280
- package/crates/team-agent/src/provider/session_scan/pi.rs +0 -185
- package/crates/team-agent/src/provider/session_scan.rs +0 -71
- package/crates/team-agent/src/provider/startup_prompt.rs +0 -757
- package/crates/team-agent/src/provider/submit_now.rs +0 -71
- package/crates/team-agent/src/provider/testdata/copilot-ready-marker.txt +0 -5
- package/crates/team-agent/src/provider/testdata/copilot-trust-prompt.txt +0 -19
- package/crates/team-agent/src/provider/testdata/grok-models-authenticated.stdout +0 -9
- package/crates/team-agent/src/provider/testdata/grok-models-unauthenticated.stdout +0 -7
- package/crates/team-agent/src/provider/tests/adapter.rs +0 -441
- package/crates/team-agent/src/provider/tests/classify.rs +0 -148
- package/crates/team-agent/src/provider/tests/command_helpers.rs +0 -35
- package/crates/team-agent/src/provider/tests/copilot_fork.rs +0 -191
- package/crates/team-agent/src/provider/tests/faults.rs +0 -200
- package/crates/team-agent/src/provider/tests/idle.rs +0 -177
- package/crates/team-agent/src/provider/tests/wire.rs +0 -213
- package/crates/team-agent/src/provider/tests.rs +0 -32
- package/crates/team-agent/src/provider/types.rs +0 -529
- package/crates/team-agent/src/provider/wire.rs +0 -394
- package/crates/team-agent/src/redaction.rs +0 -259
- package/crates/team-agent/src/state/abnormal_watch/tests/mod.rs +0 -248
- package/crates/team-agent/src/state/abnormal_watch.rs +0 -144
- package/crates/team-agent/src/state/identity.rs +0 -914
- package/crates/team-agent/src/state/identity_keys.rs +0 -132
- package/crates/team-agent/src/state/mod.rs +0 -74
- package/crates/team-agent/src/state/owner_gate.rs +0 -482
- package/crates/team-agent/src/state/ownership.rs +0 -563
- package/crates/team-agent/src/state/paths.rs +0 -395
- package/crates/team-agent/src/state/persist.rs +0 -3811
- package/crates/team-agent/src/state/projection.rs +0 -1508
- package/crates/team-agent/src/state/repository/intent.rs +0 -14
- package/crates/team-agent/src/state/repository/tests.rs +0 -184
- package/crates/team-agent/src/state/repository.rs +0 -866
- package/crates/team-agent/src/state/selector.rs +0 -160
- package/crates/team-agent/src/state/testdata/state-rich.canonical.json +0 -133
- package/crates/team-agent/src/test_support/models_timeout_fixture.rs +0 -144
- package/crates/team-agent/src/tmux_backend/enter_rescue.rs +0 -325
- package/crates/team-agent/src/tmux_backend/enter_rescue_tests.rs +0 -432
- package/crates/team-agent/src/tmux_backend/native_input.rs +0 -513
- package/crates/team-agent/src/tmux_backend/native_input_tests.rs +0 -742
- package/crates/team-agent/src/tmux_backend/tests.rs +0 -4103
- package/crates/team-agent/src/tmux_backend.rs +0 -4492
- package/crates/team-agent/src/topology.rs +0 -537
- package/crates/team-agent/src/transport/enter_rescue.rs +0 -166
- package/crates/team-agent/src/transport/native_input.rs +0 -491
- package/crates/team-agent/src/transport/test_support.rs +0 -743
- package/crates/team-agent/src/transport/tests/behavior.rs +0 -326
- package/crates/team-agent/src/transport/tests/mod.rs +0 -194
- package/crates/team-agent/src/transport/tests/wire.rs +0 -574
- package/crates/team-agent/src/transport.rs +0 -1655
- package/crates/team-agent/src/transport_factory.rs +0 -819
|
@@ -1,199 +0,0 @@
|
|
|
1
|
-
//!
|
|
2
|
-
//! cli · send — `cmd_send` + target 解析(`_send_target`)+ `SendArgs`→`SendOptions` 翻译
|
|
3
|
-
//! (`send_options_from_args`,旗标取反语义)。
|
|
4
|
-
|
|
5
|
-
use super::*;
|
|
6
|
-
use crate::messaging::{DeliveryOutcome, DeliveryRefusal, DeliveryStage, DeliveryStatus};
|
|
7
|
-
|
|
8
|
-
mod coordinator;
|
|
9
|
-
mod mailbox;
|
|
10
|
-
mod persist;
|
|
11
|
-
mod presentation;
|
|
12
|
-
mod resolve;
|
|
13
|
-
|
|
14
|
-
use coordinator::{
|
|
15
|
-
append_loud_ensure_fields, dirty_topology_refusal_value, loud_ensure_coordinator,
|
|
16
|
-
target_has_known_worker,
|
|
17
|
-
};
|
|
18
|
-
pub use persist::send_options_from_args;
|
|
19
|
-
use persist::{
|
|
20
|
-
initial_delivery_allows_watch, observe_initial_delivery_for_watch,
|
|
21
|
-
routing_ambiguous_value,
|
|
22
|
-
};
|
|
23
|
-
use presentation::{
|
|
24
|
-
add_send_reminder_if_ok, attach_positional_typo_suggestions, cmd_send_result,
|
|
25
|
-
delivery_outcome_json, watch_notice_json,
|
|
26
|
-
};
|
|
27
|
-
use resolve::{
|
|
28
|
-
decorate_host_leader_alias, logical_to_from_args, resolve_host_leader_alias,
|
|
29
|
-
send_to_logical_to, warn_send_alias,
|
|
30
|
-
};
|
|
31
|
-
|
|
32
|
-
/// `cmd_send`(`commands.py:164`)。解析 target(`--to` fanout / 单 target / `*`)→ [`MessageTarget`],
|
|
33
|
-
/// 拼 [`SendOptions`](no_ack→requires_ack 取反、no_wait→wait_visible 取反等)→ `messaging::send_message`。
|
|
34
|
-
pub fn cmd_send(args: &SendArgs) -> Result<CmdResult, CliError> {
|
|
35
|
-
if args.pane.is_some() {
|
|
36
|
-
if args.target.is_some() || args.targets.is_some() || args.to_name.is_some() || args.to_leader.is_some() {
|
|
37
|
-
return Err(CliError::Usage("An agent name cannot be combined with --to-name/--pane/--to/--to-leader/--targets; choose one addressing mode".into()));
|
|
38
|
-
}
|
|
39
|
-
if args.message.join(" ").trim().is_empty() {
|
|
40
|
-
return Err(CliError::Usage("Provide a task message; --pane cannot send an empty message".into()));
|
|
41
|
-
}
|
|
42
|
-
return Err(CliError::Usage("raw pane delivery requires --socket and --dialect".into()));
|
|
43
|
-
}
|
|
44
|
-
logical_to_from_args(args, args.to_leader.as_deref())?;
|
|
45
|
-
let alias = args.to_leader.as_deref().map(read_host_leader_alias).transpose()?;
|
|
46
|
-
let logical_to = logical_to_from_args(args, alias.as_ref().map(|_| "leader"))?;
|
|
47
|
-
let content = args.message.join(" ");
|
|
48
|
-
if content.is_empty() { return Err(CliError::Usage("empty_message: send requires a nonempty message".into())); }
|
|
49
|
-
let requested = logical_to.split(',').map(str::trim).filter(|target| !target.is_empty());
|
|
50
|
-
let mailbox = args.presentation.sink != crate::messaging::presentation::PresentationSink::Leader;
|
|
51
|
-
let mut results = Vec::new();
|
|
52
|
-
let mut destinations = Vec::new();
|
|
53
|
-
for target in requested {
|
|
54
|
-
let (workspace, team, agent) = if let Some(entry) = &alias {
|
|
55
|
-
(entry.workspace.clone(), Some(entry.team_key.clone()), "leader".to_string())
|
|
56
|
-
} else if target == "*" {
|
|
57
|
-
(args.workspace.clone(), args.team.clone(), target.to_string())
|
|
58
|
-
} else {
|
|
59
|
-
// A qualified address carries its own scope; only a bare name consumes --team.
|
|
60
|
-
let Ok(address) = crate::messaging::parse_logical_address(target) else {
|
|
61
|
-
return refuse(args, target, format!("invalid recipient name: {target}"));
|
|
62
|
-
};
|
|
63
|
-
let team = if address.workspace.is_some() { None } else { args.team.clone() };
|
|
64
|
-
let workspace = address.workspace.unwrap_or_else(|| args.workspace.clone());
|
|
65
|
-
match address.target {
|
|
66
|
-
crate::messaging::LogicalAddressTarget::Worker(agent) => (workspace, team, agent),
|
|
67
|
-
crate::messaging::LogicalAddressTarget::TeamEntity { team, entity } => (workspace, Some(team), entity),
|
|
68
|
-
crate::messaging::LogicalAddressTarget::SessionWindow { .. } => return Err(CliError::Usage(
|
|
69
|
-
"Terminal-window addressing is no longer supported; use an agent name or leader, with --workspace/--team to select scope".into(),
|
|
70
|
-
)),
|
|
71
|
-
}
|
|
72
|
-
};
|
|
73
|
-
let directory = match crate::direct_delivery::directory(&workspace, team.as_deref()) {
|
|
74
|
-
Ok(directory) => directory,
|
|
75
|
-
Err(error) => return refuse(args, target, error),
|
|
76
|
-
};
|
|
77
|
-
let agents: Vec<String> = if agent == "*" {
|
|
78
|
-
directory.agents().into_iter().filter(|agent| agent != args.sender.as_str()).collect()
|
|
79
|
-
} else { vec![agent] };
|
|
80
|
-
for agent in agents {
|
|
81
|
-
let raw = if target == "*" { agent.as_str() } else { target };
|
|
82
|
-
if agent != "leader" && !directory.agents().contains(&agent) {
|
|
83
|
-
return refuse(args, raw, format!("unknown recipient: {agent}"));
|
|
84
|
-
}
|
|
85
|
-
let endpoint = directory.endpoint(&agent);
|
|
86
|
-
if let (false, Err(error)) = (mailbox, &endpoint) {
|
|
87
|
-
if alias.is_some() { return Err(CliError::Runtime(error.clone())); }
|
|
88
|
-
return refuse(args, raw, error.clone());
|
|
89
|
-
}
|
|
90
|
-
let key = (directory.workspace.clone(), directory.team.clone(), agent);
|
|
91
|
-
if !destinations.iter().any(|(existing, _)| existing == &key) {
|
|
92
|
-
destinations.push((key, endpoint));
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
}
|
|
96
|
-
if destinations.is_empty() { return Err(CliError::Runtime("send has no recipients".into())); }
|
|
97
|
-
for ((workspace, team, agent), _endpoint) in destinations {
|
|
98
|
-
let mut inbox_id = None;
|
|
99
|
-
if mailbox || (agent == "leader" && !matches!(args.sender.as_str(), "human" | "leader")) {
|
|
100
|
-
let record = crate::inbox_store::record(args.sender.as_str(), &agent, &content, team.as_deref(), "message");
|
|
101
|
-
crate::inbox_store::append(&workspace, &agent, &record).map_err(CliError::Runtime)?;
|
|
102
|
-
inbox_id = Some(record["message_id"].clone());
|
|
103
|
-
}
|
|
104
|
-
let mut value = if mailbox {
|
|
105
|
-
serde_json::json!({"status": "stored", "recipient": agent, "mailbox": true})
|
|
106
|
-
} else {
|
|
107
|
-
let text = format!("Team Agent message from {}:\n\n{content}", args.sender.as_str());
|
|
108
|
-
crate::direct_delivery::directory(&workspace, team.as_deref())
|
|
109
|
-
.and_then(|directory| directory.send(&agent, &text)).map_err(CliError::Runtime)?
|
|
110
|
-
};
|
|
111
|
-
if let Some(id) = inbox_id { value["message_id"] = id; }
|
|
112
|
-
results.push(value);
|
|
113
|
-
}
|
|
114
|
-
let mut value = if results.len() == 1 { results.remove(0) } else { serde_json::json!({"status": "sent", "results": results}) };
|
|
115
|
-
value["ok"] = serde_json::json!(true);
|
|
116
|
-
Ok(CmdResult::from_json(value, args.json))
|
|
117
|
-
}
|
|
118
|
-
|
|
119
|
-
/// Refuse an unroutable recipient. The read-only named-address diagnosis only
|
|
120
|
-
/// explains the refusal (reason, scoped spelling suggestions); it never routes.
|
|
121
|
-
fn refuse(args: &SendArgs, raw: &str, cause: String) -> Result<CmdResult, CliError> {
|
|
122
|
-
let Err(mut error) = crate::cli::named_address::resolve_name_for_cli(&args.workspace, raw, args.team.as_deref()) else {
|
|
123
|
-
return Err(CliError::Runtime(cause));
|
|
124
|
-
};
|
|
125
|
-
resolve::adapt_positional_bare_error(args, raw, &mut error);
|
|
126
|
-
if args.json {
|
|
127
|
-
return Ok(CmdResult::from_json(error.to_json(), true));
|
|
128
|
-
}
|
|
129
|
-
let (message, action) = error.human_guidance(raw);
|
|
130
|
-
Err(CliError::AddressRefusal { audit: error.n38_message(), error: message, action })
|
|
131
|
-
}
|
|
132
|
-
|
|
133
|
-
fn read_host_leader_alias(name: &str) -> Result<crate::leader::registry::LeaderRegistryEntry, CliError> {
|
|
134
|
-
let candidates: Vec<_> = crate::leader::registry::snapshots().into_iter()
|
|
135
|
-
.filter(|entry| entry.delivery_name == name || entry.qualified_name == name
|
|
136
|
-
|| entry.stable_qualified_name == name || entry.aliases.iter().any(|alias| alias == name)).collect();
|
|
137
|
-
if candidates.len() != 1 {
|
|
138
|
-
return Err(CliError::Runtime(format!(
|
|
139
|
-
"leader name is unknown or ambiguous: {name}; refused, nothing was sent. List attached leader names with team-agent leaders; to leave the message for later, resend with --mailbox and read it with team-agent inbox leader"
|
|
140
|
-
)));
|
|
141
|
-
}
|
|
142
|
-
Ok(candidates.into_iter().next().unwrap())
|
|
143
|
-
}
|
|
144
|
-
|
|
145
|
-
/// Resolve a host-leader alias, send through the canonical persisted funnel,
|
|
146
|
-
/// then decorate the already-produced result for the host-leader surface.
|
|
147
|
-
pub fn send_to_canonical_leader_target(
|
|
148
|
-
_sender_workspace: &std::path::Path,
|
|
149
|
-
name: &str,
|
|
150
|
-
content: &str,
|
|
151
|
-
sender: &TrustedSender,
|
|
152
|
-
task_id: Option<&str>,
|
|
153
|
-
) -> Result<serde_json::Value, CliError> {
|
|
154
|
-
let entry = read_host_leader_alias(name)?;
|
|
155
|
-
let args = SendArgs {
|
|
156
|
-
target: Some("leader".to_string()),
|
|
157
|
-
message: vec![content.to_string()],
|
|
158
|
-
targets: None,
|
|
159
|
-
workspace: entry.workspace.clone(),
|
|
160
|
-
team: Some(entry.team_key.clone()),
|
|
161
|
-
task: task_id.map(str::to_string),
|
|
162
|
-
sender: sender.clone(),
|
|
163
|
-
no_ack: false,
|
|
164
|
-
no_wait: true,
|
|
165
|
-
watch_result: false,
|
|
166
|
-
timeout: 0.0,
|
|
167
|
-
confirm_human: false,
|
|
168
|
-
json: true,
|
|
169
|
-
message_id: None,
|
|
170
|
-
presentation: crate::messaging::presentation::PresentationRequest::default(),
|
|
171
|
-
pane: None,
|
|
172
|
-
to_name: None,
|
|
173
|
-
to_leader: None,
|
|
174
|
-
};
|
|
175
|
-
let mut value = match cmd_send(&args)?.output {
|
|
176
|
-
CmdOutput::Json(value) => value,
|
|
177
|
-
_ => unreachable!("JSON send requested"),
|
|
178
|
-
};
|
|
179
|
-
decorate_host_leader_alias(&mut value, &entry);
|
|
180
|
-
Ok(value)
|
|
181
|
-
}
|
|
182
|
-
|
|
183
|
-
/// `_send_target`(`commands.py:181-184`):`--to` comma-split fanout / `target` 单值 / None。
|
|
184
|
-
pub(super) fn send_target(targets: Option<&str>, target: Option<&str>) -> MessageTarget {
|
|
185
|
-
if let Some(targets) = targets.filter(|s| !s.is_empty()) {
|
|
186
|
-
let recipients: Vec<String> = targets
|
|
187
|
-
.split(',')
|
|
188
|
-
.map(str::trim)
|
|
189
|
-
.filter(|s| !s.is_empty())
|
|
190
|
-
.map(ToString::to_string)
|
|
191
|
-
.collect();
|
|
192
|
-
return MessageTarget::Fanout(recipients);
|
|
193
|
-
}
|
|
194
|
-
match target {
|
|
195
|
-
Some("*") => MessageTarget::Broadcast,
|
|
196
|
-
Some(target) => MessageTarget::Single(target.to_string()),
|
|
197
|
-
None => MessageTarget::Single(String::new()),
|
|
198
|
-
}
|
|
199
|
-
}
|
|
@@ -1,288 +0,0 @@
|
|
|
1
|
-
//! Remove only a positively dead, owned Unix socket; never stop its server.
|
|
2
|
-
use std::ffi::CString;
|
|
3
|
-
use std::fs::{File, Metadata, OpenOptions};
|
|
4
|
-
use std::io;
|
|
5
|
-
use std::os::fd::{AsRawFd, FromRawFd, OwnedFd};
|
|
6
|
-
use std::os::unix::ffi::OsStrExt;
|
|
7
|
-
use std::os::unix::fs::{FileTypeExt, MetadataExt, OpenOptionsExt};
|
|
8
|
-
use std::path::Path;
|
|
9
|
-
|
|
10
|
-
#[derive(Debug, PartialEq, Eq)]
|
|
11
|
-
pub(super) enum SocketCleanup {
|
|
12
|
-
Absent,
|
|
13
|
-
Removed,
|
|
14
|
-
Preserved,
|
|
15
|
-
}
|
|
16
|
-
|
|
17
|
-
pub(super) fn remove_dead_socket(path: &Path) -> io::Result<SocketCleanup> {
|
|
18
|
-
remove_with_probe(path, listener_refused)
|
|
19
|
-
}
|
|
20
|
-
|
|
21
|
-
fn identity(metadata: &Metadata) -> (u64, u64, u32, u32, u64) {
|
|
22
|
-
(
|
|
23
|
-
metadata.dev(),
|
|
24
|
-
metadata.ino(),
|
|
25
|
-
metadata.mode(),
|
|
26
|
-
metadata.uid(),
|
|
27
|
-
metadata.nlink(),
|
|
28
|
-
)
|
|
29
|
-
}
|
|
30
|
-
|
|
31
|
-
fn invalid(reason: &str) -> io::Error {
|
|
32
|
-
io::Error::new(io::ErrorKind::PermissionDenied, reason)
|
|
33
|
-
}
|
|
34
|
-
|
|
35
|
-
fn remove_with_probe(
|
|
36
|
-
path: &Path,
|
|
37
|
-
probe: impl FnOnce(&Path) -> io::Result<bool>,
|
|
38
|
-
) -> io::Result<SocketCleanup> {
|
|
39
|
-
let socket = match std::fs::symlink_metadata(path) {
|
|
40
|
-
Ok(metadata) => metadata,
|
|
41
|
-
Err(error) if error.kind() == io::ErrorKind::NotFound => return Ok(SocketCleanup::Absent),
|
|
42
|
-
Err(error) => return Err(error),
|
|
43
|
-
};
|
|
44
|
-
// SAFETY: geteuid has no pointer arguments or ownership effects.
|
|
45
|
-
let uid = unsafe { libc::geteuid() };
|
|
46
|
-
if !socket.file_type().is_socket() || socket.uid() != uid || socket.nlink() != 1 {
|
|
47
|
-
return Err(invalid("shutdown socket is not an owned single-link socket"));
|
|
48
|
-
}
|
|
49
|
-
let parent = path
|
|
50
|
-
.parent()
|
|
51
|
-
.ok_or_else(|| invalid("socket parent missing"))?;
|
|
52
|
-
let metadata = std::fs::symlink_metadata(parent)?;
|
|
53
|
-
if !metadata.is_dir()
|
|
54
|
-
|| metadata.uid() != uid
|
|
55
|
-
|| metadata.mode() & 0o077 != 0
|
|
56
|
-
|| parent.canonicalize()? != parent
|
|
57
|
-
{
|
|
58
|
-
return Err(invalid(
|
|
59
|
-
"shutdown socket parent is not a canonical private owned directory",
|
|
60
|
-
));
|
|
61
|
-
}
|
|
62
|
-
let directory: File = OpenOptions::new()
|
|
63
|
-
.read(true)
|
|
64
|
-
.custom_flags(libc::O_DIRECTORY | libc::O_NOFOLLOW)
|
|
65
|
-
.open(parent)?;
|
|
66
|
-
if identity(&directory.metadata()?) != identity(&metadata) {
|
|
67
|
-
return Err(invalid("shutdown socket parent changed"));
|
|
68
|
-
}
|
|
69
|
-
if !probe(path)? {
|
|
70
|
-
return Ok(SocketCleanup::Preserved);
|
|
71
|
-
}
|
|
72
|
-
if identity(&std::fs::symlink_metadata(parent)?) != identity(&metadata) {
|
|
73
|
-
return Err(invalid("shutdown socket parent changed after death probe"));
|
|
74
|
-
}
|
|
75
|
-
let name = CString::new(
|
|
76
|
-
path.file_name()
|
|
77
|
-
.ok_or_else(|| invalid("socket name missing"))?
|
|
78
|
-
.as_bytes(),
|
|
79
|
-
)
|
|
80
|
-
.map_err(|_| invalid("socket name contains NUL"))?;
|
|
81
|
-
// SAFETY: stat is an all-integer C record; directory/name are valid for the call.
|
|
82
|
-
let mut fresh: libc::stat = unsafe { std::mem::zeroed() };
|
|
83
|
-
let result = unsafe {
|
|
84
|
-
libc::fstatat(
|
|
85
|
-
directory.as_raw_fd(),
|
|
86
|
-
name.as_ptr(),
|
|
87
|
-
&mut fresh,
|
|
88
|
-
libc::AT_SYMLINK_NOFOLLOW,
|
|
89
|
-
)
|
|
90
|
-
};
|
|
91
|
-
if result != 0 {
|
|
92
|
-
let error = io::Error::last_os_error();
|
|
93
|
-
return if error.kind() == io::ErrorKind::NotFound {
|
|
94
|
-
Ok(SocketCleanup::Absent)
|
|
95
|
-
} else {
|
|
96
|
-
Err(error)
|
|
97
|
-
};
|
|
98
|
-
}
|
|
99
|
-
if fresh.st_dev as u64 != socket.dev()
|
|
100
|
-
|| fresh.st_ino as u64 != socket.ino()
|
|
101
|
-
|| fresh.st_mode as u32 != socket.mode()
|
|
102
|
-
|| fresh.st_uid != socket.uid()
|
|
103
|
-
|| fresh.st_nlink as u64 != socket.nlink()
|
|
104
|
-
{
|
|
105
|
-
return Err(invalid("shutdown socket identity changed after death probe"));
|
|
106
|
-
}
|
|
107
|
-
// SAFETY: unlink is relative to the pinned owned directory and freshly fenced socket.
|
|
108
|
-
if unsafe { libc::unlinkat(directory.as_raw_fd(), name.as_ptr(), 0) } != 0 {
|
|
109
|
-
return Err(io::Error::last_os_error());
|
|
110
|
-
}
|
|
111
|
-
Ok(SocketCleanup::Removed)
|
|
112
|
-
}
|
|
113
|
-
|
|
114
|
-
fn listener_refused(path: &Path) -> io::Result<bool> {
|
|
115
|
-
// SAFETY: socket has no borrowed pointer arguments; successful fd ownership moves below.
|
|
116
|
-
let fd = unsafe { libc::socket(libc::AF_UNIX, libc::SOCK_STREAM, 0) };
|
|
117
|
-
if fd < 0 {
|
|
118
|
-
return Err(io::Error::last_os_error());
|
|
119
|
-
}
|
|
120
|
-
// SAFETY: fd is newly created and exclusively owned here.
|
|
121
|
-
let fd = unsafe { OwnedFd::from_raw_fd(fd) };
|
|
122
|
-
// SAFETY: fcntl acts on our owned fd; no pointer arguments.
|
|
123
|
-
if unsafe { libc::fcntl(fd.as_raw_fd(), libc::F_SETFD, libc::FD_CLOEXEC) } < 0 {
|
|
124
|
-
return Err(io::Error::last_os_error());
|
|
125
|
-
}
|
|
126
|
-
let flags = unsafe { libc::fcntl(fd.as_raw_fd(), libc::F_GETFL) };
|
|
127
|
-
if flags < 0 || unsafe { libc::fcntl(fd.as_raw_fd(), libc::F_SETFL, flags | libc::O_NONBLOCK) } < 0 {
|
|
128
|
-
return Err(io::Error::last_os_error());
|
|
129
|
-
}
|
|
130
|
-
// SAFETY: sockaddr_un is a C integer/byte record; zero initializes all fields/padding.
|
|
131
|
-
let mut address: libc::sockaddr_un = unsafe { std::mem::zeroed() };
|
|
132
|
-
address.sun_family = libc::AF_UNIX as libc::sa_family_t;
|
|
133
|
-
let bytes = path.as_os_str().as_bytes();
|
|
134
|
-
if bytes.len() >= address.sun_path.len() || bytes.contains(&0) {
|
|
135
|
-
return Err(io::Error::new(
|
|
136
|
-
io::ErrorKind::InvalidInput,
|
|
137
|
-
"shutdown socket path exceeds Unix address bounds",
|
|
138
|
-
));
|
|
139
|
-
}
|
|
140
|
-
for (target, byte) in address.sun_path.iter_mut().zip(bytes) {
|
|
141
|
-
*target = *byte as libc::c_char;
|
|
142
|
-
}
|
|
143
|
-
#[cfg(any(
|
|
144
|
-
target_os = "macos",
|
|
145
|
-
target_os = "ios",
|
|
146
|
-
target_os = "freebsd",
|
|
147
|
-
target_os = "openbsd",
|
|
148
|
-
target_os = "netbsd",
|
|
149
|
-
target_os = "dragonfly"
|
|
150
|
-
))]
|
|
151
|
-
{
|
|
152
|
-
address.sun_len = std::mem::size_of_val(&address) as u8;
|
|
153
|
-
}
|
|
154
|
-
// SAFETY: address points to the fully initialized sockaddr_un of the supplied size.
|
|
155
|
-
let result = unsafe {
|
|
156
|
-
libc::connect(
|
|
157
|
-
fd.as_raw_fd(),
|
|
158
|
-
(&address as *const libc::sockaddr_un).cast(),
|
|
159
|
-
std::mem::size_of_val(&address) as libc::socklen_t,
|
|
160
|
-
)
|
|
161
|
-
};
|
|
162
|
-
if result == 0 {
|
|
163
|
-
return Ok(false);
|
|
164
|
-
}
|
|
165
|
-
match io::Error::last_os_error().raw_os_error() {
|
|
166
|
-
Some(libc::ECONNREFUSED) => Ok(true),
|
|
167
|
-
Some(libc::EINPROGRESS | libc::EAGAIN | libc::ENOENT) => Ok(false),
|
|
168
|
-
_ => Err(io::Error::last_os_error()),
|
|
169
|
-
}
|
|
170
|
-
}
|
|
171
|
-
|
|
172
|
-
#[cfg(test)]
|
|
173
|
-
#[allow(clippy::unwrap_used, clippy::expect_used, clippy::panic)]
|
|
174
|
-
mod tests {
|
|
175
|
-
use super::*;
|
|
176
|
-
use std::os::unix::fs::{symlink, PermissionsExt};
|
|
177
|
-
use std::os::unix::net::UnixListener;
|
|
178
|
-
|
|
179
|
-
struct Fixture(std::path::PathBuf);
|
|
180
|
-
impl Fixture {
|
|
181
|
-
fn new() -> Self {
|
|
182
|
-
let path = Path::new("/tmp").join(format!(
|
|
183
|
-
"ta-shutdown-{}-{}",
|
|
184
|
-
std::process::id(),
|
|
185
|
-
std::time::SystemTime::now()
|
|
186
|
-
.duration_since(std::time::UNIX_EPOCH)
|
|
187
|
-
.unwrap()
|
|
188
|
-
.as_nanos()
|
|
189
|
-
));
|
|
190
|
-
std::fs::create_dir(&path).unwrap();
|
|
191
|
-
std::fs::set_permissions(&path, std::fs::Permissions::from_mode(0o700)).unwrap();
|
|
192
|
-
Self(path.canonicalize().unwrap())
|
|
193
|
-
}
|
|
194
|
-
fn socket(&self) -> std::path::PathBuf {
|
|
195
|
-
self.0.join("owned.sock")
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
impl Drop for Fixture {
|
|
199
|
-
fn drop(&mut self) {
|
|
200
|
-
let _ = std::fs::remove_dir_all(&self.0);
|
|
201
|
-
}
|
|
202
|
-
}
|
|
203
|
-
|
|
204
|
-
#[test]
|
|
205
|
-
fn shutdown_socket_removes_dead_inode_and_repeated_cleanup_is_absent() {
|
|
206
|
-
let fixture = Fixture::new();
|
|
207
|
-
let path = fixture.socket();
|
|
208
|
-
drop(UnixListener::bind(&path).unwrap());
|
|
209
|
-
assert_eq!(remove_dead_socket(&path).unwrap(), SocketCleanup::Removed);
|
|
210
|
-
assert!(!path.exists());
|
|
211
|
-
assert_eq!(remove_dead_socket(&path).unwrap(), SocketCleanup::Absent);
|
|
212
|
-
}
|
|
213
|
-
|
|
214
|
-
#[test]
|
|
215
|
-
fn shutdown_socket_preserves_live_listener_and_unsafe_objects() {
|
|
216
|
-
let fixture = Fixture::new();
|
|
217
|
-
let path = fixture.socket();
|
|
218
|
-
let listener = UnixListener::bind(&path).unwrap();
|
|
219
|
-
assert_eq!(remove_dead_socket(&path).unwrap(), SocketCleanup::Preserved);
|
|
220
|
-
assert!(path.exists());
|
|
221
|
-
drop(listener);
|
|
222
|
-
std::fs::remove_file(&path).unwrap();
|
|
223
|
-
std::fs::write(&path, b"not a socket").unwrap();
|
|
224
|
-
assert!(remove_dead_socket(&path).is_err());
|
|
225
|
-
std::fs::remove_file(&path).unwrap();
|
|
226
|
-
std::fs::create_dir(&path).unwrap();
|
|
227
|
-
assert!(remove_dead_socket(&path).is_err());
|
|
228
|
-
std::fs::remove_dir(&path).unwrap();
|
|
229
|
-
let target = fixture.0.join("target.sock");
|
|
230
|
-
drop(UnixListener::bind(&target).unwrap());
|
|
231
|
-
symlink(&target, &path).unwrap();
|
|
232
|
-
assert!(remove_dead_socket(&path).is_err());
|
|
233
|
-
assert!(target.exists());
|
|
234
|
-
std::fs::remove_file(&path).unwrap();
|
|
235
|
-
std::fs::hard_link(&target, &path).unwrap();
|
|
236
|
-
assert!(remove_dead_socket(&path).is_err());
|
|
237
|
-
std::fs::remove_file(&path).unwrap();
|
|
238
|
-
std::fs::set_permissions(&fixture.0, std::fs::Permissions::from_mode(0o755)).unwrap();
|
|
239
|
-
assert!(remove_dead_socket(&target).is_err());
|
|
240
|
-
assert!(target.exists());
|
|
241
|
-
}
|
|
242
|
-
|
|
243
|
-
#[test]
|
|
244
|
-
fn shutdown_socket_refuses_failed_probe_and_inode_or_parent_replacement() {
|
|
245
|
-
let fixture = Fixture::new();
|
|
246
|
-
let path = fixture.socket();
|
|
247
|
-
drop(UnixListener::bind(&path).unwrap());
|
|
248
|
-
assert!(remove_with_probe(&path, |_| Err(io::Error::new(
|
|
249
|
-
io::ErrorKind::PermissionDenied,
|
|
250
|
-
"probe failed"
|
|
251
|
-
)))
|
|
252
|
-
.is_err());
|
|
253
|
-
assert!(path.exists());
|
|
254
|
-
let original = fixture.0.join("original.sock");
|
|
255
|
-
assert!(remove_with_probe(&path, |_| {
|
|
256
|
-
std::fs::rename(&path, &original)?;
|
|
257
|
-
drop(UnixListener::bind(&path)?);
|
|
258
|
-
Ok(true)
|
|
259
|
-
})
|
|
260
|
-
.is_err());
|
|
261
|
-
assert!(path.exists());
|
|
262
|
-
assert_ne!(
|
|
263
|
-
std::fs::symlink_metadata(&path).unwrap().ino(),
|
|
264
|
-
std::fs::symlink_metadata(&original).unwrap().ino()
|
|
265
|
-
);
|
|
266
|
-
std::fs::remove_file(&path).unwrap();
|
|
267
|
-
drop(UnixListener::bind(&path).unwrap());
|
|
268
|
-
assert!(remove_with_probe(&path, |_| {
|
|
269
|
-
std::fs::remove_file(&path)?;
|
|
270
|
-
std::fs::write(&path, b"replacement")?;
|
|
271
|
-
Ok(true)
|
|
272
|
-
})
|
|
273
|
-
.is_err());
|
|
274
|
-
assert_eq!(std::fs::read(&path).unwrap(), b"replacement");
|
|
275
|
-
std::fs::remove_file(&path).unwrap();
|
|
276
|
-
drop(UnixListener::bind(&path).unwrap());
|
|
277
|
-
let moved = fixture.0.with_extension("old");
|
|
278
|
-
assert!(remove_with_probe(&path, |_| {
|
|
279
|
-
std::fs::rename(&fixture.0, &moved)?;
|
|
280
|
-
std::fs::create_dir(&fixture.0)?;
|
|
281
|
-
std::fs::set_permissions(&fixture.0, std::fs::Permissions::from_mode(0o700))?;
|
|
282
|
-
Ok(true)
|
|
283
|
-
})
|
|
284
|
-
.is_err());
|
|
285
|
-
assert!(moved.join("owned.sock").exists());
|
|
286
|
-
std::fs::remove_dir_all(moved).unwrap();
|
|
287
|
-
}
|
|
288
|
-
}
|
|
@@ -1,165 +0,0 @@
|
|
|
1
|
-
//! Human command catalog: help, spelling suggestions, and public dispatch guards.
|
|
2
|
-
#![allow(dead_code)]
|
|
3
|
-
|
|
4
|
-
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
|
5
|
-
pub(crate) enum CommandTier {
|
|
6
|
-
Core,
|
|
7
|
-
Guided,
|
|
8
|
-
Secondary,
|
|
9
|
-
DevInternal,
|
|
10
|
-
}
|
|
11
|
-
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
|
12
|
-
pub(crate) enum CommandCategory {
|
|
13
|
-
Start,
|
|
14
|
-
Daily,
|
|
15
|
-
TeamLifecycle,
|
|
16
|
-
WorkerLifecycle,
|
|
17
|
-
GuidedRecovery,
|
|
18
|
-
Setup,
|
|
19
|
-
Observe,
|
|
20
|
-
Dev,
|
|
21
|
-
}
|
|
22
|
-
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
|
23
|
-
pub(crate) enum CommandKind {
|
|
24
|
-
Dispatch(DispatchKind),
|
|
25
|
-
LeaderPassthrough { provider: &'static str },
|
|
26
|
-
}
|
|
27
|
-
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
|
28
|
-
pub(crate) enum TokenUsage {
|
|
29
|
-
No,
|
|
30
|
-
Yes,
|
|
31
|
-
Conditional,
|
|
32
|
-
}
|
|
33
|
-
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
|
34
|
-
pub(crate) enum DispatchKind {
|
|
35
|
-
Start,
|
|
36
|
-
Stop,
|
|
37
|
-
Team,
|
|
38
|
-
Agent,
|
|
39
|
-
QuickStart,
|
|
40
|
-
Send,
|
|
41
|
-
Schedule,
|
|
42
|
-
Status,
|
|
43
|
-
Models,
|
|
44
|
-
KiroLeader,
|
|
45
|
-
Inbox,
|
|
46
|
-
Locate,
|
|
47
|
-
Restart,
|
|
48
|
-
Shutdown,
|
|
49
|
-
AddAgent,
|
|
50
|
-
StartAgent,
|
|
51
|
-
StopAgent,
|
|
52
|
-
ResetAgent,
|
|
53
|
-
CloneAgent,
|
|
54
|
-
ForkAgent,
|
|
55
|
-
RemoveAgent,
|
|
56
|
-
Leaders,
|
|
57
|
-
Doctor,
|
|
58
|
-
Approvals,
|
|
59
|
-
Route,
|
|
60
|
-
LeaderPrompt,
|
|
61
|
-
Profile,
|
|
62
|
-
InstallSkill,
|
|
63
|
-
ClaimLeader,
|
|
64
|
-
Takeover,
|
|
65
|
-
AttachLeader,
|
|
66
|
-
}
|
|
67
|
-
pub(crate) const ALL_DISPATCH_KINDS: &[DispatchKind] = &[
|
|
68
|
-
DispatchKind::Start,
|
|
69
|
-
DispatchKind::Stop,
|
|
70
|
-
DispatchKind::Team,
|
|
71
|
-
DispatchKind::Agent,
|
|
72
|
-
DispatchKind::QuickStart,
|
|
73
|
-
DispatchKind::Send,
|
|
74
|
-
DispatchKind::Schedule,
|
|
75
|
-
DispatchKind::Status,
|
|
76
|
-
DispatchKind::Models,
|
|
77
|
-
DispatchKind::KiroLeader,
|
|
78
|
-
DispatchKind::Inbox,
|
|
79
|
-
DispatchKind::Locate,
|
|
80
|
-
DispatchKind::Restart,
|
|
81
|
-
DispatchKind::Shutdown,
|
|
82
|
-
DispatchKind::AddAgent,
|
|
83
|
-
DispatchKind::StartAgent,
|
|
84
|
-
DispatchKind::StopAgent,
|
|
85
|
-
DispatchKind::ResetAgent,
|
|
86
|
-
DispatchKind::CloneAgent,
|
|
87
|
-
DispatchKind::ForkAgent,
|
|
88
|
-
DispatchKind::RemoveAgent,
|
|
89
|
-
DispatchKind::Leaders,
|
|
90
|
-
DispatchKind::Doctor,
|
|
91
|
-
DispatchKind::Approvals,
|
|
92
|
-
DispatchKind::Route,
|
|
93
|
-
DispatchKind::LeaderPrompt,
|
|
94
|
-
DispatchKind::Profile,
|
|
95
|
-
DispatchKind::InstallSkill,
|
|
96
|
-
DispatchKind::ClaimLeader,
|
|
97
|
-
DispatchKind::Takeover,
|
|
98
|
-
DispatchKind::AttachLeader,
|
|
99
|
-
];
|
|
100
|
-
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
|
101
|
-
pub(crate) struct GovernanceNote {
|
|
102
|
-
pub(crate) decision: &'static str,
|
|
103
|
-
pub(crate) reason: &'static str,
|
|
104
|
-
}
|
|
105
|
-
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
|
|
106
|
-
pub(crate) struct CommandSpec {
|
|
107
|
-
pub(crate) name: &'static str,
|
|
108
|
-
pub(crate) tier: CommandTier,
|
|
109
|
-
pub(crate) category: CommandCategory,
|
|
110
|
-
pub(crate) kind: CommandKind,
|
|
111
|
-
pub(crate) summary: &'static str,
|
|
112
|
-
pub(crate) usage: &'static str,
|
|
113
|
-
pub(crate) default_help: bool,
|
|
114
|
-
pub(crate) command_help: bool,
|
|
115
|
-
pub(crate) suggestion_index: bool,
|
|
116
|
-
pub(crate) token_usage: TokenUsage,
|
|
117
|
-
pub(crate) sunset: Option<&'static str>,
|
|
118
|
-
pub(crate) action: Option<&'static str>,
|
|
119
|
-
pub(crate) governance: Option<GovernanceNote>,
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
// Only human operations belong here. Compatibility commands are private in emit.rs.
|
|
123
|
-
#[rustfmt::skip]
|
|
124
|
-
pub(crate) const COMMAND_SPECS: &[CommandSpec] = &[
|
|
125
|
-
CommandSpec { name: "start", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Start), summary: "Start a team or agent; verified live instances stay unchanged", usage: "team-agent start [AGENT|./TEAMDIR] [--from TEAMDIR] [--workspace PATH] [--team KEY] [--session preserve|auto] [--dry-run] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
126
|
-
CommandSpec { name: "stop", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Stop), summary: "Stop the selected team or one agent, retaining session associations", usage: "team-agent stop [AGENT] [--workspace PATH] [--team KEY] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
127
|
-
CommandSpec { name: "team", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Team), summary: "Explicit team start, stop, restart or status", usage: "team-agent team <start|stop|restart|status> [OPTIONS]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
128
|
-
CommandSpec { name: "agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::Agent), summary: "Explicit agent lifecycle operations", usage: "team-agent agent <start|stop|restart|add|remove|reset|clone|fork> AGENT [OPTIONS]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
129
|
-
CommandSpec { name: "quick-start", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::QuickStart), summary: "Compatibility creation bridge; prefer start for daily activation", usage: "team-agent quick-start [TEAMDIR] [--workspace WORKSPACE] [--team TEAM] [--name NAME] [--team-id TEAM] [--yes] [--backend tmux|conpty] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
130
|
-
CommandSpec { name: "send", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Send), summary: "Send a task to a specified agent", usage: "team-agent send <agent> MESSAGE... [--workspace WORKSPACE] [--team TEAM] [--mailbox] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: Some("a future compatibility release"), action: Some("Use team-agent send <agent> 'task message'; select scope with --workspace and --team"), governance: None },
|
|
131
|
-
CommandSpec { name: "schedule", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Schedule), summary: "Add, list or cancel durable leader reminders (durations: ms/s/m/h/d)", usage: "team-agent schedule add (--in DURATION | --every DURATION) --text MESSAGE [--workspace PATH] [--team KEY] [--json]\n team-agent schedule list [--workspace PATH] [--team KEY] [--json]\n team-agent schedule cancel sched_<hex> [--workspace PATH] [--team KEY] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
132
|
-
CommandSpec { name: "status", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Status), summary: "Check agent status without reading conversation content", usage: "team-agent status [<agent>] [--workspace WORKSPACE] [--team TEAM] [--json] [--summary|--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
133
|
-
CommandSpec { name: "models", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Models), summary: "Discover model names supported by the native provider", usage: "team-agent models [--provider pi|cursor|codex|claude|claude_code|grok|kiro] [QUERY|--search TEXT] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
134
|
-
CommandSpec { name: "locate", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Locate), summary: "List live endpoints from the read-only snapshot", usage: "team-agent locate [--workspace DIR] [--team NAME] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
135
|
-
CommandSpec { name: "inbox", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::Inbox), summary: "Read agent replies", usage: "team-agent inbox <agent> [-n N|--limit N] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
136
|
-
CommandSpec { name: "restart", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Restart), summary: "Restart one agent, or use the frozen bare/path team bridge", usage: "team-agent restart [AGENT|./WORKSPACE] [--workspace WORKSPACE] [--team TEAM] [--session auto|preserve] [--dry-run] [--allow-fresh] [--session-converge-deadline SECONDS] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
137
|
-
CommandSpec { name: "shutdown", tier: CommandTier::Core, category: CommandCategory::TeamLifecycle, kind: CommandKind::Dispatch(DispatchKind::Shutdown), summary: "Compatibility: shut down the selected team; prefer stop", usage: "team-agent shutdown [--workspace WORKSPACE] [--team TEAM] [--keep-logs] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
138
|
-
CommandSpec { name: "add-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::AddAgent), summary: "Compatibility: strict add-and-start; prefer agent add or start AGENT", usage: "team-agent add-agent <agent> [--role-file FILE] [--provider TOOL] [--model MODEL] [--effort LEVEL] [--bypass true|false] [--prompt TEXT] [--profile NAME] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
139
|
-
CommandSpec { name: "start-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::StartAgent), summary: "Compatibility: start an existing stopped agent; prefer start AGENT", usage: "team-agent start-agent <agent> [--provider TOOL] [--model MODEL] [--effort LEVEL] [--bypass true|false] [--prompt TEXT] [--profile NAME] [--workspace WORKSPACE] [--team TEAM] [--allow-fresh] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
140
|
-
CommandSpec { name: "stop-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::StopAgent), summary: "Compatibility: stop an agent; prefer stop AGENT", usage: "team-agent stop-agent <agent> [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
141
|
-
CommandSpec { name: "reset-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::ResetAgent), summary: "Compatibility: discard session only with approval; prefer agent reset", usage: "team-agent reset-agent <agent> --discard-session [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
142
|
-
CommandSpec { name: "clone-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::CloneAgent), summary: "Compatibility: copy agent configuration; prefer agent clone", usage: "team-agent clone-agent <agent> --as NEW_AGENT [--label LABEL] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
143
|
-
CommandSpec { name: "fork-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::ForkAgent), summary: "Compatibility: admitted new-seat continuation; prefer agent fork", usage: "team-agent fork-agent <agent> --as NEW_AGENT [--label LABEL] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
144
|
-
CommandSpec { name: "remove-agent", tier: CommandTier::Core, category: CommandCategory::WorkerLifecycle, kind: CommandKind::Dispatch(DispatchKind::RemoveAgent), summary: "Compatibility: confirmed removal; prefer agent remove", usage: "team-agent remove-agent <agent> --confirm [--workspace WORKSPACE] [--team TEAM] [--from-spec] [--force] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
145
|
-
CommandSpec { name: "leaders", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Leaders), summary: "List local leaders and their team scopes", usage: "team-agent leaders [QUERY|--search TEXT] [--all|--stale] [--json] | --prune [--dry-run] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
146
|
-
CommandSpec { name: "doctor", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Doctor), summary: "Diagnose a team and suggest recovery; read-only by default", usage: "team-agent doctor [SPEC] [--workspace WORKSPACE] [--team TEAM] [--comms] [--gate orphans|comms] [--fix] [--fix-schema] [--cleanup-orphans] [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
147
|
-
CommandSpec { name: "approvals", tier: CommandTier::Core, category: CommandCategory::Observe, kind: CommandKind::Dispatch(DispatchKind::Approvals), summary: "List pending agent approvals", usage: "team-agent approvals [<agent>] [--workspace WORKSPACE] [--team TEAM] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
148
|
-
CommandSpec { name: "route", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::Route), summary: "Configure additional provider launch arguments", usage: "team-agent route [status|enable|disable|show [TOOL]|set TOOL -- ARG...|add TOOL -- ARG...|clear TOOL] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
149
|
-
CommandSpec { name: "leader-prompt", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::LeaderPrompt), summary: "Persist supplemental instructions for new Leaders only", usage: "team-agent leader-prompt [show|set|append|clear] [--json] [--file PATH | -- TEXT]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
150
|
-
CommandSpec { name: "profile", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::Profile), summary: "Manage authentication and proxy profiles", usage: "team-agent profile init|doctor|show NAME [--workspace WORKSPACE] [--team TEAM] [--auth-mode MODE] [--proxy-mode direct|inherit] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
151
|
-
CommandSpec { name: "install-skill", tier: CommandTier::Core, category: CommandCategory::Setup, kind: CommandKind::Dispatch(DispatchKind::InstallSkill), summary: "Optionally install an existing public operation skill", usage: "team-agent install-skill (--source DIR|--uninstall) [--target codex|claude|copilot|all] [--dest DIR] [--dry-run] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
152
|
-
CommandSpec { name: "claim-leader", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::ClaimLeader), summary: "Register the current terminal as leader only when diagnosis recommends it", usage: "team-agent claim-leader [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json] [--detail]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
153
|
-
CommandSpec { name: "takeover", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::Takeover), summary: "Take over an existing team only after diagnosis and confirmation", usage: "team-agent takeover [--workspace WORKSPACE] [--team TEAM] [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
154
|
-
CommandSpec { name: "attach-leader", tier: CommandTier::Guided, category: CommandCategory::GuidedRecovery, kind: CommandKind::Dispatch(DispatchKind::AttachLeader), summary: "Attach a verified leader terminal only when diagnosis recommends it", usage: "team-agent attach-leader [--workspace WORKSPACE] [--team TEAM] --pane PANE --provider TOOL [--confirm] [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
155
|
-
CommandSpec { name: "kiro", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::Dispatch(DispatchKind::KiroLeader), summary: "Check Kiro leader launch admission (currently refused)", usage: "team-agent kiro [--json]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::No, sunset: None, action: None, governance: None },
|
|
156
|
-
CommandSpec { name: "pi", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "pi" }, summary: "Open a leader session with Pi", usage: "team-agent pi [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
157
|
-
CommandSpec { name: "codex", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "codex" }, summary: "Open a leader session with Codex", usage: "team-agent codex [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
158
|
-
CommandSpec { name: "claude", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "claude" }, summary: "Open a leader session with Claude Code", usage: "team-agent claude [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
159
|
-
CommandSpec { name: "copilot", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "copilot" }, summary: "Open a leader session with Copilot", usage: "team-agent copilot [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
160
|
-
CommandSpec { name: "grok", tier: CommandTier::Core, category: CommandCategory::Start, kind: CommandKind::LeaderPassthrough { provider: "grok" }, summary: "Open a leader session with Grok", usage: "team-agent grok [--attach-existing] [--confirm] [--attach-session SESSION] [--external-leader] [--allow-nested-attach] [--json] [-- TOOL_ARGS...]", default_help: true, command_help: true, suggestion_index: true, token_usage: TokenUsage::Conditional, sunset: None, action: None, governance: None },
|
|
161
|
-
];
|
|
162
|
-
|
|
163
|
-
pub(crate) fn command_spec(name: &str) -> Option<&'static CommandSpec> {
|
|
164
|
-
COMMAND_SPECS.iter().find(|spec| spec.name == name)
|
|
165
|
-
}
|