Module team 

Team collaboration — persistent multi-agent project coordination.

A Team is a named group of agents that share a task list and communicate via a mailbox. Teams persist on disk at ~/.telos/teams/{name}/config.json.

Key concepts:

• Team = Project = TaskList (1:1 mapping to shared task directories)
• Lead — the agent that created the team, coordinates work
• Members — agents spawned to help with specific tasks
• Mailbox — async message passing between team members

Lifecycle

1. Lead calls TeamCreate → team file written, shared task list initialized
2. Lead creates tasks via TaskCreate/TodoWrite
3. Lead spawns teammates via SubagentTool with team context
4. Teammates claim tasks, work, and SendUserMessage to coordinate
5. TeamDelete when work is complete (fails if members still active)

Structs

TeamConfig

On-disk team configuration.

TeamMember

A team member record.

Functions

cleanup_team

Delete a team from disk (config + tasks directory).

has_active_members

Check if a team has any active (non-lead) members, which would prevent deletion.

lead_agent_id

Deterministic lead agent ID.

load_team_config

Load a team config from disk.

save_team_config

Save a team config to disk.

team_config_path

Path to a team’s config file.

team_tasks_dir

Path to a team’s shared task directory.

teams_root

Team root directory under the user’s home.