Struct Request 

pub struct Request<'a> {
    pub model: &'a ModelId,
    pub prompt: &'a Value,
    pub max_output_tokens: u32,
    pub reasoning_effort: Option<ReasoningEffort>,
    pub schema: Option<&'a Value>,
    pub tools: &'a [ToolDeclaration],
    pub exchanges: &'a [ToolExchange],
    pub continuation: Option<&'a ProviderContinuation>,
    pub stream: Option<(&'a dyn ModelStreamObserver, &'a Label)>,
}

One request to a provider.

A struct rather than a widening argument list, because what a model call carries is the part of this seam most likely to grow — and every growth would otherwise be a breaking change to every driver.

Fields

model: &'a ModelId

prompt: &'a Value

max_output_tokens: u32

Maximum tokens the provider may generate for this call.

Provider-neutral because both shipped APIs expose the same control, and per-call because a manifest declares it per model role. Keeping it on a driver silently discarded that declaration and kept the real request limit out of the effect key.

reasoning_effort: Option<ReasoningEffort>

How much internal reasoning to request, when explicitly configured.

schema: Option<&'a Value>

A JSON Schema the answer must conform to, if one was declared.

Passed straight through to the provider’s own structured-output mode — text.format on OpenAI Responses, output_config.format on Anthropic — where the constraint is enforced during generation rather than checked afterwards. That is the whole reason to use it: a schema applied after the fact rejects a bad answer you have already paid for.

tools: &'a [ToolDeclaration]

The tools the model may ask for.

Empty means the model is told of none, which is not the same as being forbidden: authorization happens when a call comes back, against the operator’s grants. Declaring nothing simply gives it nothing to choose.

exchanges: &'a [ToolExchange]

Tools already run this turn, and what they returned.

continuation: Option<&'a ProviderContinuation>

Exact provider-native state emitted beside those tool calls.

stream: Option<(&'a dyn ModelStreamObserver, &'a Label)>

Live observer. Not provider-visible and therefore not effect identity. Strict replay never calls it because replay never performs the provider.

Trait Implementations

impl<'a> Clone for Request<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Request<'a>

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

Formats the value using the given formatter.