Struct RemoteEngines 

pub struct RemoteEngines {
    pub engines: BTreeMap<String, EngineCard>,
}

Collection of remote engines.

Fields

engines: BTreeMap<String, EngineCard>

Registered engine cards keyed by their lowercase handle.

Implementations

impl RemoteEngines

pub fn new() -> Self

Creates an empty remote-engine registry.

pub async fn register( &mut self, ctx: impl HttpFeatures, args: RemoteEngineArgs, ) -> Result<(), BoxError>

Registers a remote engine with the given arguments.

pub fn get_tool_endpoint( &self, name: &str, ) -> Option<(Principal, String, String)>

Retrieves a remote tool endpoint and name from a prefixed name.

pub fn get_agent_endpoint( &self, name: &str, ) -> Option<(Principal, String, String)>

Retrieves a remote agent endpoint and name from a prefixed name.

pub fn get_id_by_endpoint(&self, endpoint: &str) -> Option<Principal>

Retrieves a remote engine ID by endpoint.

pub fn get_endpoint_by_id(&self, id: &Principal) -> Option<String>

Retrieves a remote engine endpoint by ID.

pub fn tool_definitions( &self, endpoint: Option<&str>, names: Option<&[String]>, ) -> Vec<FunctionDefinition>

Retrieves definitions for available tools in the remote engines.

Arguments

• endpoint - Optional filter for specific remote engine endpoint
• names - Optional filter for specific tool names

Returns

Vector of function definitions for the requested tools

pub fn select_tool_resources( &self, prefixed_name: &str, resources: &mut Vec<Resource>, ) -> Vec<Resource>

Extracts resources from the provided list based on the tool’s supported tags.

pub fn agent_definitions( &self, endpoint: Option<&str>, names: Option<&[String]>, ) -> Vec<FunctionDefinition>

Retrieves definitions for available agents in the remote engines.

Arguments

• endpoint - Optional filter for specific remote engine endpoint
• names - Optional filter for specific agent names

Returns

Vector of function definitions for the requested agents

pub fn select_agent_resources( &self, name: &str, resources: &mut Vec<Resource>, ) -> Vec<Resource>

Extracts resources from the provided list based on the agent’s supported tags.

Trait Implementations

impl Clone for RemoteEngines

fn clone(&self) -> RemoteEngines

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RemoteEngines

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RemoteEngines

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RemoteEngines

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RemoteEngines

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.