pi-multi-agent-collaboration

npm version License: MIT

Enterprise-grade multi-agent collaboration system for pi coding agents

WebSocket-based agent-to-agent communication with distributed context synchronization, cryptographic authentication, and task delegation.

• Ed25519 digital signatures for agent authentication
• Self-signed identity verification
• Automatic key generation and secure storage

• Server Mode: Listen on port 9999 (configurable)
• Client Mode: Connect to remote agents
• Federation: Server-to-server agent network
• Heartbeat mechanism for connection health

• MessagePack binary serialization (efficient & compact)
• Signed message envelopes (tamper-proof)
• 15+ message types (HELLO, PING, TASK_REQUEST, etc.)
• Priority-based message handling

• Vector clocks for causal consistency
• CRDT-style merge strategies
• Automatic conflict resolution
• Session management with metadata

# Via npm
npm install pi-multi-agent-collaboration
# Or install directly in pi
pi install npm:pi-multi-agent-collaboration

pi --agent-server --agent-name "Coordinator"

pi --agent-client ws://192.168.1.50:9999 --agent-name "Worker1"

• /agents - List connected agents
• /agent-broadcast <message> - Send to all agents
• /agent-session-create - Create shared workspace
• /agent-status - Show system status

• send_to_agent - Send messages between agents
• delegate_task - Delegate coding tasks to capable agents
• list_agents - Find agents by capability

• Node.js >= 18.0.0
• pi coding agent >= 0.60.0

1. Agent Identity: Each agent gets a unique Ed25519 keypair for signing messages
2. Discovery: Agents register on WebSocket server or connect to existing servers
3. Communication: Signed messages flow between agents via WebSocket
4. Context Sync: Vector clocks ensure causal consistency of shared state
5. Task Delegation: LLM can delegate tasks to agents with matching capabilities

• --agent-server - Start WebSocket server
• --agent-port 9999 - Server port (default: 9999)
• --agent-host 0.0.0.0 - Server host
• --agent-client ws://host:port - Connect to server
• --agent-name "MyAgent" - Agent identity name
• --agent-capabilities "coding,review" - Comma-separated capabilities
• --agent-federation - Enable server-to-server federation

┌─────────────────────────────────────────────┐
│ pi Multi-Agent System │
├─────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────────┐ ┌─────────┐│
│ │ Identity │ │ Protocol │ │ Context ││
│ │ Manager │ │ Handler │ │ Sync ││
│ └────┬─────┘ └────┬─────┘ └────┬────┘│
│ │ │ │ │
│ ┌────┴─────┐ ┌────┴─────┐ ┌────┴────┐│
│ │ Server │ │ Client │ │ State ││
│ │(Port 9999)│ │(WS Conn) │ │ Manager ││
│ └──────────┘ └──────────┘ └─────────┘│
└─────────────────────────────────────────────┘

• npm: https://www.npmjs.com/package/pi-multi-agent-collaboration
• Repository: https://github.com/DrOlu/pi-multi-agent-collaboration
• Issues: https://github.com/DrOlu/pi-multi-agent-collaboration/issues

MIT License - See LICENSE file for details.

Author: Dr. Olu (Seyi Akin)
Version: 1.0.0