Skip to main content
INFORMATIVEACTIVEDocumentation Governance
Truth Source: Repository schemas and tests are authoritative.

Multi-Agent Collaboration Flow

1. Overview​

Location: examples/ts-multi-agent-collab/

Related Golden Flows: map-flow-01-single-agent-plan-turn-taking, map-flow-02-single-agent-large-plan-broadcast-fanout

This example demonstrates Multi-Agent Protocol (MAP) patterns:

  • Multiple independent Agents collaborating on a shared Plan
  • Role-based execution (Planner, Executor, Reviewer)
  • Collab object for coordination state
  • Network layer for agent communication

2. Directory Structure​

examples/ts-multi-agent-collab/
 src/    index.ts          # Entry point (skeleton)
 package.json
 tsconfig.json
 README.md

3. Architectural Design​

3.1 Agent Roles​

RoleResponsibility
PlannerAnalyzes context, generates Plan
ExecutorExecutes specific steps
ReviewerValidates outcomes, provides feedback

3.2 Coordination Flow​

1. Network Handshake Agents establish session, exchange Role
2. Plan Creation Planner generates Plan from Context
3. Confirmation Plan submitted for approval
4. Execution Executor runs steps, updates Collab
5. Completion Final state synchronized

3.3 Key Modules​

  • Role: Defines agent capabilities and permissions
  • Collab: Tracks collaboration state and turn-taking
  • Network: Handles inter-agent communication
  • Dialog: Manages message exchange between agents

4. Current Implementation​

// examples/ts-multi-agent-collab/src/index.ts
console.log("Multi-Agent Collaboration Flow - Coming Soon in Phase P7");

5. Running the Skeleton​

cd examples/ts-multi-agent-collab
pnpm install
pnpm start