Struct AppleFMClient 

pub struct AppleFMClient { /* private fields */ }

Client for the Apple Intelligence on-device foundation model.

There is no model slug and no API key: the OS owns the (one) model. What varies per client is the configuration — a LoRA adapter and decoding defaults.

The client holds a live session across turns: append-only conversations prefill only the newest message, which is what makes multi-turn chat fast. Clones share that session, so use one client per concurrent conversation.

Implementations

impl AppleFMClient

pub fn model_slug(&self) -> String

Identifier used as the response model_slug: the base model name, plus the adapter file stem when a LoRA is loaded.

pub fn provider_meta(&self) -> &ProviderMeta

pub fn prewarm(&self)

Hint the OS to stage model resources for an upcoming turn.

The runtime stages the model down between requests, so a turn that follows an idle pause (a user typing, say) pays seconds of warm-up. Call this when you can predict a turn is coming — on input focus, when the user starts typing — and the warm-up overlaps the wait.

Fire-and-forget and cheap: returns immediately, never fails, and is skipped entirely if a turn is already in flight (the model is active then anyway). Works before the first turn too.

Trait Implementations

impl Clone for AppleFMClient

fn clone(&self) -> AppleFMClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl CompletionProvider for AppleFMClient

fn complete<'life0, 'life1, 'life2, 'life3, 'life4, 'async_trait>( &'life0 mut self, messages: &'life1 mut Messages, tool_declarations: Option<&'life2 dyn ToolDeclarations>, options: Option<&'life3 ChatOptions>, structured_output: Option<&'life4 Schema>, ) -> Pin<Box<dyn Future<Output = Result<ChatResponse, ChatFailure>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait, 'life3: 'async_trait, 'life4: 'async_trait,

Run one completion step.

fn metadata(&self) -> Option<&ProviderMeta>

impl Debug for AppleFMClient

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

Formats the value using the given formatter.