Nous.Plugins.TeamTools (nous v0.16.0)

Plugin that provides team communication and coordination tools for agents.

When an agent is part of a team, this plugin adds tools for peer messaging, broadcasting, sharing discoveries, listing team members, and claiming file regions for editing.

Capabilities

Direct messaging between team agents
Team-wide broadcasts
Shared discovery board
File region claiming to prevent edit conflicts
Team member listing

Usage

agent = Agent.new("openai:gpt-4",
  plugins: [Nous.Plugins.TeamTools],
  deps: %{
    team_id: "team_1",
    agent_name: "alice",
    shared_state_pid: shared_state_pid
  }
)

Configuration

The plugin reads the following keys from ctx.deps:

:team_id — the team identifier (required)
:agent_name — this agent's name in the team (required)
:shared_state_pid — pid of the team's SharedState process
:team_coordinator_pid — pid of the team's Coordinator process

Tools Provided

Tool	Description
`peer_message`	Send a direct message to a named agent
`broadcast_message`	Broadcast a message to all team agents
`share_discovery`	Store a finding in SharedState and broadcast
`list_team`	List team members and their status
`claim_region`	Claim file lines before editing

PubSub Events

{:peer_message, from, to, content} — sent on agent's direct topic
{:team_broadcast, from, content} — sent on team-wide topic
{:discovery, from, discovery} — sent on team-wide topic