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/