Struct Request 

pub struct Request<'a, C: ?Sized> { /* private fields */ }

A fluent request being built against a client. Created via RequestExt.

Implementations

impl<'a, C: ?Sized> Request<'a, C>

pub fn system(self, system: impl Into<String>) -> Self

Attach system/context instructions.

Built-in provider clients send this through the provider’s first-class system field or message role for every terminal. This keeps the static instruction prefix separate from the dynamic user prompt, which also improves provider prompt-cache reuse. Custom LLMClient implementations inherit a backwards-compatible concatenation fallback unless they override the request hooks on that trait.

pub fn media(self, media: impl Into<Vec<MediaFile>>) -> Self

Attach media (images, or PDFs where the provider supports them) to the request. Used by materialize, generate, and run. Streaming terminals reject attached media because their client APIs are text-only.

impl<C: LLMClient + Sync + ?Sized> Request<'_, C>

pub async fn materialize<T>(self, prompt: &str) -> Result<T>

where T: Instructor + DeserializeOwned + Send + 'static,

Materialize a structured T, applying any attached system context and media.

pub async fn materialize_with_attempts<T>( self, prompt: &str, ) -> Result<MaterializeReport<T>, MaterializeFailure>

where T: Instructor + DeserializeOwned + Send + 'static,

Materialize a structured T with cumulative usage and every provider attempt.

pub async fn generate(self, prompt: &str) -> Result<String>

Generate raw text, applying any attached system context and media.