Skip to main content

Module orchestration

Module orchestration 

Source
Expand description

Multi-agent orchestration — roster agents, blackboard wiring, governance gates.

Connects the agent_runtime planner, DAG executor, blackboard bus, and deontic governance into a single orchestration layer that can be driven from VibeScript.

The orchestration flow:

  1. Register agents in a roster with their capabilities and DID.
  2. Create an orchestration session with a task description.
  3. The planner produces a DAG from the task + available capabilities.
  4. The DAG executor runs nodes in topological order, wiring blackboard I/O.
  5. Governance gates check capabilities before each node executes.
  6. Results are collected and returned as a structured record.

Structs§

AgentRoster
The agent roster — a collection of agents available for orchestration.
NodeExecutionResult
Result of executing a single node in the orchestration.
OrchestrationSession
An orchestration session — a task to be executed by the roster.
RosterAgent
An agent in the roster.

Enums§

AgentRole
Functional role a roster agent plays in an orchestration.
OrchestrationStatus
Lifecycle state of an orchestration session.

Functions§

assign_agents
Assign agents to planned steps based on capability matching.
create_blackboard
Create a blackboard bus for an orchestration session.
create_phase_leaser
Create a phase leaser for governance gating, seeded from the roster’s capabilities. The leaser is registered with a single “execution” phase that allows all roster capabilities.
create_session
Create a new orchestration session.
execute_session
Execute the orchestration session — run the planned DAG through the real dag_executor::execute_pipeline with blackboard I/O, phase lease gating, and deontic interrupt handling.
plan_session
Plan the orchestration — use the planner to produce a DAG from the task and the roster’s combined capabilities.
session_summary
Summarise the orchestration session as a structured record.
session_to_pipeline
Build a DAG pipeline from an orchestration session’s plan.