Struct RuntimeHandles 

pub struct RuntimeHandles {
    pub workspace_manager: Option<Arc<RwLock<WorkspaceManager>>>,
    pub channel_map: Option<ChannelMapHandle>,
    pub reaction_channels: Option<ChannelMapHandle>,
    pub ask_user_channels: Option<ChannelMapHandle>,
    pub escalate_channels: Option<ChannelMapHandle>,
    pub discord_memory: Option<Arc<dyn Memory>>,
    pub session_store: Option<Arc<dyn SessionBackend>>,
    pub agent_config: Option<Arc<HashMap<String, DelegateAgentConfig>>>,
    pub provider_runtime_options: Option<Arc<ProviderRuntimeOptions>>,
    pub fallback_api_key: Option<Arc<str>>,
    pub pre_built_tools: Option<Vec<Arc<dyn Tool>>>,
}

Aggregates Arc-clones of everything the previously-skipped MCP tools need.

The gateway builds this after its AppState is fully constructed, then hands it to build_tools_with_runtime.

All fields are optional; the registry gracefully skips a tool whenever its required handle is None.

Fields

workspace_manager: Option<Arc<RwLock<WorkspaceManager>>>

Workspace manager for the workspace tool.

channel_map: Option<ChannelMapHandle>

Shared channel map (platform name → Arc<dyn Channel>) used by the poll, reaction, ask_user, and escalate tools.

The same Arc<RwLock<_>> is threaded into every tool that needs it; when the channel supervisor populates it, all tools see the update.

reaction_channels: Option<ChannelMapHandle>

Dedicated channel map handle for the reaction tool (it keeps its own handle so the gateway-facing tool and the MCP-facing tool share it).

ask_user_channels: Option<ChannelMapHandle>

Dedicated channel map handle for the ask_user tool.

escalate_channels: Option<ChannelMapHandle>

Dedicated channel map handle for the escalate tool.

discord_memory: Option<Arc<dyn Memory>>

Memory backend for discord_search (historically a separate SQLite store; currently unwired — pending a Kumiho-backed reimplementation).

session_store: Option<Arc<dyn SessionBackend>>

Session backend used by the sessions_list, sessions_history, and sessions_send tools.

agent_config: Option<Arc<HashMap<String, DelegateAgentConfig>>>

Agent configurations for delegate and swarm. Cloned out of Config.agents.

provider_runtime_options: Option<Arc<ProviderRuntimeOptions>>

Provider runtime options — supplies the credentials/url/reasoning preferences delegate sub-agents need when invoking LLMs.

fallback_api_key: Option<Arc<str>>

Fallback API key for delegate sub-agents when the per-agent config doesn’t supply one (same value passed to all_tools_with_runtime).

pre_built_tools: Option<Vec<Arc<dyn Tool>>>

Escape hatch: pre-built tools constructed by the caller (e.g. the gateway’s all_tools_with_runtime list) that the MCP registry should merge in wholesale.

When present, each entry is folded in after the baseline — if a name collides, the pre-built tool wins. This lets the gateway forward its full live tool registry to MCP clients without the registry having to re-invoke every tool’s constructor.

Implementations

impl RuntimeHandles

pub fn empty() -> Self

Create an empty RuntimeHandles where every field is None.

Used by tests and by the degraded boot path if AppState construction failed before the MCP task spawned.

Trait Implementations

impl Clone for RuntimeHandles

fn clone(&self) -> RuntimeHandles

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for RuntimeHandles

fn default() -> RuntimeHandles

Returns the “default value” for a type.