agents.supervisor.utils.compatibility_bridge¶

Compatibility Bridge for Dynamic Supervisor with Existing Multi-Agent Architecture.

This module provides integration between the new dynamic supervisor system and the existing multi-agent base classes, ensuring seamless interoperability.

Classes¶

`DynamicMultiAgentSupervisor`	Multi-agent system with dynamic supervisor capabilities.
`ReactMultiAgentSupervisor`	Multi-agent supervisor with ReactAgent-style capabilities.

Functions¶

`create_compatible_supervisor`(agents[, name, ...])	Factory function to create compatible supervisor based on requirements.
`migrate_from_multi_agent`(multi_agent)	Migrate existing MultiAgent to dynamic supervisor version.

Module Contents¶

class agents.supervisor.utils.compatibility_bridge.DynamicMultiAgentSupervisor¶

Bases: haive.agents.multi.compatibility.MultiAgent

Multi-agent system with dynamic supervisor capabilities.

This class bridges the gap between the existing MultiAgent architecture and the new dynamic supervisor system, providing:

Compatibility with existing MultiAgent patterns
Dynamic agent addition/removal during runtime
Integration with AgentSchemaComposer
Support for all existing execution modes + dynamic supervision

build_graph()¶

Build graph with dynamic supervisor integration.

Return type:: haive.core.graph.state_graph.base_graph2.BaseGraph

get_dynamic_status()¶

Get status of dynamic supervisor capabilities.

Return type:: dict[str, Any]

async register_agent_dynamically(agent, capability=None)¶

Parameters:

agent (haive.agents.base.agent.Agent)
capability (str | None)

Return type:

bool

setup_agent()¶

Enhanced setup with dynamic supervisor integration.

Return type:: None

setup_dynamic_supervisor()¶

Set up the dynamic supervisor if needed.

Return type:: DynamicMultiAgentSupervisor

async unregister_agent_dynamically(agent_name)¶

Unregister an agent dynamically at runtime.

Parameters:: agent_name (str)
Return type:: bool

class agents.supervisor.utils.compatibility_bridge.ReactMultiAgentSupervisor¶

Bases: DynamicMultiAgentSupervisor

Multi-agent supervisor with ReactAgent-style capabilities.

Combines ReactAgent looping behavior with multi-agent coordination and dynamic supervisor capabilities.

build_graph()¶

Build graph with React-style looping and multi-agent coordination.

Return type:: haive.core.graph.state_graph.base_graph2.BaseGraph

agents.supervisor.utils.compatibility_bridge.create_compatible_supervisor(agents, name='Compatible Supervisor', enable_dynamic=True, supervisor_engine=None)¶

Factory function to create compatible supervisor based on requirements.

Parameters:

agents (collections.abc.Sequence[haive.agents.base.agent.Agent]) – List of agents to manage
name (str) – Name of the supervisor system
enable_dynamic (bool) – Whether to enable dynamic capabilities
supervisor_engine (Any) – Engine for supervisor decisions

Returns:

Either DynamicMultiAgentSupervisor or standard MultiAgent

Return type:

DynamicMultiAgentSupervisor | haive.agents.multi.compatibility.MultiAgent

agents.supervisor.utils.compatibility_bridge.migrate_from_multi_agent(multi_agent)¶

Migrate existing MultiAgent to dynamic supervisor version.

Parameters:: multi_agent (haive.agents.multi.compatibility.MultiAgent) – Existing MultiAgent instance
Returns:: DynamicMultiAgentSupervisor with same configuration
Return type:: DynamicMultiAgentSupervisor