Agentica Infrastructure Reference

Complete API specification for Agentica multi-agent coordination infrastructure.

When to Use Building multi-agent workflows with Agentica patterns Need exact constructor signatures for pattern classes Want to understand coordination database schema Implementing custom patterns using primitives Debugging agent tracking or orphan detection Quick Reference 11 Pattern Classes Pattern Purpose Key Method Swarm Parallel perspectives .execute(query) Pipeline Sequential stages .run(initial_state) Hierarchical Coordinator + specialists .execute(task) Jury Voting consensus .decide(return_type, question) GeneratorCritic Iterative refinement .run(task) CircuitBreaker Failure fallback .execute(query) Adversarial Debate + judge .resolve(question) ChainOfResponsibility Route to handler .process(query) MapReduce Fan out + reduce .execute(query, chunks) Blackboard Shared state .solve(query) EventDriven Event bus .publish(event) Core Infrastructure Component File Purpose CoordinationDB coordination.py SQLite tracking tracked_spawn tracked_agent.py Agent with tracking HandoffAtom handoff_atom.py Universal handoff format BlackboardCache blackboard.py Hot tier communication MemoryService memory_service.py Core + Archival memory create_claude_scope claude_scope.py Scope with file ops Primitives Primitive Purpose Consensus Voting (MAJORITY, UNANIMOUS, THRESHOLD) Aggregator Combine results (MERGE, CONCAT, BEST) HandoffState Structured agent handoff build_premise Structured premise builder gather_fail_fast TaskGroup-based parallel execution Full API Spec

See: API_SPEC.md in this skill directory

Usage Example from scripts.agentica_patterns.patterns import Swarm, Jury from scripts.agentica_patterns.primitives import ConsensusMode from scripts.agentica_patterns.coordination import CoordinationDB from scripts.agentica_patterns.tracked_agent import tracked_spawn

Create tracking database

db = CoordinationDB(session_id="my-session")

Swarm with tracking

swarm = Swarm( perspectives=["Security expert", "Performance expert"], db=db ) result = await swarm.execute("Review this code")

Jury with consensus

jury = Jury( num_jurors=3, consensus_mode=ConsensusMode.MAJORITY, premise="You evaluate code quality", db=db ) verdict = await jury.decide(bool, "Is this code production ready?")

Location

API spec: .claude/skills/agentica-infrastructure/API_SPEC.md Source: scripts/agentica_patterns/