Struct RealmConnectionSet 

pub struct RealmConnectionSet {
    pub realm_id: String,
    pub backends: BTreeMap<String, BackendProfile>,
    pub auth_profiles: BTreeMap<String, AuthProfile>,
    pub bindings: BTreeMap<String, ProviderBinding>,
    pub default_binding: Option<String>,
}

Realm-scoped set of backends, auth profiles, and bindings.

Produced by RealmConnectionSet::from_config from a RealmConfigSection ingested from TOML.

Fields

realm_id: String

backends: BTreeMap<String, BackendProfile>

auth_profiles: BTreeMap<String, AuthProfile>

bindings: BTreeMap<String, ProviderBinding>

default_binding: Option<String>

Implementations

impl RealmConnectionSet

pub fn from_config( realm_id: &str, section: &RealmConfigSection, ) -> Result<Self, ProviderBindingError>

Validate and materialize a realm connection set from its config section. Normalizes provider strings into the typed Provider enum and verifies that every binding references existing backend and auth profiles whose providers agree.

pub fn synthesize_env_default(provider: Provider) -> Self

Synthesize a default RealmConnectionSet for a given provider, sourcing credentials from a well-known env var. Used by surface factories when no explicit realm config exists but the user has set ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY in the environment. OpenAI also supports an Azure env envelope: AZURE_OPENAI_API_KEY plus AZURE_OPENAI_ENDPOINT synthesizes the azure_openai backend instead of public OpenAI when no public OpenAI key is present. The synthesized realm is consumed by the same ProviderRuntimeRegistry path as explicit realms, so env-var auth and realm-config auth share one resolution pipeline.

Returns a realm with id "env_default" containing one binding "default" pointing at:

• BackendProfile "default" with the provider’s default backend_kind and base_url=None (provider client uses its default).
• AuthProfile "default" with source = Env { env: <ENV_VAR> } and the provider-specific env auth method.

The ENV_VAR name is per-provider:

• Anthropic: ANTHROPIC_API_KEY
• OpenAI: OPENAI_API_KEY
• Azure OpenAI: AZURE_OPENAI_API_KEY + AZURE_OPENAI_ENDPOINT
• Google: GEMINI_API_KEY

Callers should also honor RKAT_*-prefixed overrides via ResolverEnvironment::with_process_env(); that lookup is applied inside the registry’s resolve path when it reads the env source.

pub fn synthesize_env_default_from_lookup<F>( provider: Provider, env_lookup: F, ) -> Self

where F: Fn(&str) -> Option<String>,

Testable variant of Self::synthesize_env_default that lets callers inject the env lookup used to select the OpenAI public-vs-Azure default.

pub fn synthesize_inline_default(provider: Provider, secret: String) -> Self

Synthesize a default realm with an inline secret instead of an env lookup. Used when callers have already read the api key from a config file (legacy credential-map path).

pub fn lookup_binding( &self, id: &str, ) -> Result<(&ProviderBinding, &BackendProfile, &AuthProfile), ProviderBindingError>

Resolve a binding by id. Returns the binding plus its referenced backend and auth profiles.

pub fn lookup_auth_binding( &self, auth_binding: &AuthBindingRef, ) -> Result<(&ProviderBinding, &BackendProfile, &AuthProfile), ProviderBindingError>

Resolve a typed auth binding reference. AuthBindingRef.profile, when present, overrides the binding’s configured auth profile while keeping the binding’s backend and policy authoritative.

Trait Implementations

impl Clone for RealmConnectionSet

fn clone(&self) -> RealmConnectionSet

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RealmConnectionSet

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RealmConnectionSet

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for RealmConnectionSet

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for RealmConnectionSet

fn eq(&self, other: &RealmConnectionSet) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for RealmConnectionSet

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for RealmConnectionSet

impl StructuralPartialEq for RealmConnectionSet