Struct ModelRef 

pub struct ModelRef<D: ?Sized>(/* private fields */);

A reference to a model: either a resolved instance or a provider:model id that the application layer resolves through its registry.

D is the object-safe trait object type (dyn DynLanguageModel, …). Provider implementations always return resolved references; the id form exists so that entry points can accept impl Into<LanguageModelRef> for both model instances and strings.

Implementations

impl<D: ?Sized> ModelRef<D>

pub fn from_arc(model: Arc<D>) -> Self

Wraps a resolved model.

pub fn from_id(id: impl Into<String>) -> Self

Creates an unresolved reference by id (for example openai:gpt-5).

pub fn model(&self) -> Option<&Arc<D>>

Returns the model when the reference is resolved.

pub fn unresolved_id(&self) -> Option<&str>

Returns the id when the reference is unresolved.

pub fn is_resolved(&self) -> bool

Returns true when the reference holds a model instance.

pub fn into_model(self) -> Result<Arc<D>, String>

Unwraps the model, or returns the unresolved id as the error.

Errors

Returns the id when the reference was created with ModelRef::from_id.

Trait Implementations

impl<D: ?Sized> Clone for ModelRef<D>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<D: ?Sized> Debug for ModelRef<D>

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

Formats the value using the given formatter.

impl<D: ?Sized> From<&str> for ModelRef<D>

fn from(id: &str) -> Self

Converts to this type from the input type.

impl<D: ?Sized> From<Arc<D>> for ModelRef<D>

fn from(model: Arc<D>) -> Self

Converts to this type from the input type.

impl<D: ?Sized> From<String> for ModelRef<D>

fn from(id: String) -> Self

Converts to this type from the input type.