Struct EndpointRegistry 

pub struct EndpointRegistry { /* private fields */ }

Registry of all configured endpoints with routing logic.

Implementations

impl EndpointRegistry

pub fn from_config( endpoints: &HashMap<String, EndpointConfig>, fallback_llm: Option<&LlmConfig>, defaults: EndpointDefaults, ) -> Self

Builds a registry from the endpoint definitions in scenario config.

Falls back to a default LLM endpoint derived from fallback_llm (the runner’s effective config — CLI arguments merged over env vars and scenario fields) when no [config.endpoints] are defined, so --llm-url / --llm-model / --llm-api-key are honored even for scenarios without an explicit endpoint table. Without a fallback, environment variables are used.

pub fn get(&self, name: &str) -> Option<&ResolvedEndpoint>

Resolves an endpoint by explicit name.

Returns None if no endpoint with the given name exists.

pub fn resolve_for_task(&self, task: TaskType) -> &ResolvedEndpoint

Resolves the best endpoint for a given task type.

Checks for a default_for mapping first, then falls back to any LLM endpoint, then panics (config error).

pub fn resolve(&self, name: Option<&str>, task: TaskType) -> &ResolvedEndpoint

Resolves an endpoint: explicit name takes priority, then task-type routing, then first LLM endpoint.

pub fn resolve_chain( &self, name: Option<&str>, task: TaskType, ) -> Vec<&ResolvedEndpoint>

Resolves the ordered call chain for a task: the primary endpoint followed by its fallbacks (LLM endpoints only, deduplicated, cycle-guarded, max 8 hops). Every LLM call goes through this chain — the primary endpoint gets its own max_attempts retry budget, then each fallback in turn, until one answers.

Example: a cheap primary (default) with a more powerful fallback (pro) can be declared as fallbacks = ["pro"] on the default endpoint.

pub fn len(&self) -> usize

Returns the number of configured endpoints.

pub fn is_empty(&self) -> bool

Returns true if no endpoints are configured.

Trait Implementations

impl Clone for EndpointRegistry

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EndpointRegistry

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

Formats the value using the given formatter.