orchestrata_ultimate.core.protocols
Reference › orchestrata_ultimate › core › protocols
Core component protocols for Orchestrata Ultimate.
The contracts that let the subsystems of orchestrata talk to each other without importing each other's implementations. They are Protocol classes, satisfied structurally. The curated core narrative describes this as the layer that keeps the single-package port from becoming a tangle.
By role:
- Vocabulary and lifecycle: base (component types, health, scope, events,
ComponentProtocol,EventBusProtocol). - Subsystem contracts: components (kernel, postman, orchestrator, state manager) and agent (
VolkProtocol). - Cycle breakers: decoupling (governance bridge, volk registry, audit trail, Redis state), volk_health and session.
- Services: memory (SPEC-010) and providers (SPEC-011).
There is no runtime flow here; callers import a protocol, and a concrete class elsewhere satisfies it. The package root re-exports everything, and core.interfaces keeps the older names. Start with base, then components.
9 modules, 1,779 lines of code.
Modules
| Module | Summary | LOC |
|---|---|---|
__init__ |
Core component protocols for Orchestrata Ultimate. | 173 |
agent |
Volk protocol — the contract every Volk agent must satisfy. | 45 |
base |
Base component protocol types for Orchestrata Ultimate. | 248 |
components |
Core component protocols for Orchestrata Ultimate. | 371 |
decoupling |
Decoupling protocols for Orchestrata Ultimate (Phase 1 - Cycle Breaking). | 280 |
memory |
Memory engine protocol types for Orchestrata Ultimate (SPEC-010). | 262 |
providers |
Provider manager protocol types for Orchestrata Ultimate (SPEC-011). | 324 |
session |
Session context-store protocol — the layer-0 seam for session persistence. | 43 |
volk_health |
Volk health probe protocol — the narrow SPEC-001 health seam. | 33 |
Dependency diagram
