Struct ModelRequest 

pub struct ModelRequest { /* private fields */ }

Immutable provider-neutral snapshot for one model request.

Implementations

impl ModelRequest

pub fn new( model_id: ModelId, messages: Vec<CanonicalMessage>, ) -> Result<Self, ModelRequestError>

Creates a request for a non-empty canonical transcript.

Errors

Returns an error when messages are empty, too numerous, or invalid at the canonical protocol wire boundary.

pub fn with_system_prompt( self, system_prompt: impl Into<String>, ) -> Result<Self, ModelRequestError>

Adds a bounded non-empty system prompt.

Errors

Returns an error when the prompt is empty, oversized, or contains a null character.

pub fn with_tools( self, tools: Vec<ModelToolDefinition>, allow_parallel: bool, ) -> Result<Self, ModelRequestError>

Adds model-visible tools in deterministic source order.

Errors

Returns an error for an oversized list or duplicate tool names.

pub const fn with_reasoning(self, reasoning: ReasoningOptions) -> Self

Adds provider-neutral reasoning options.

pub const fn with_max_output_tokens(self, max_output_tokens: TokenCount) -> Self

Adds a requested output-token limit.

pub fn with_metadata(self, metadata: ProtocolMetadata) -> Self

Adds bounded namespaced request metadata.

pub fn validate_for(&self, model: &ModelSpec) -> Result<(), ModelRequestError>

Validates this request against one advertised model.

Errors

Returns an error when model identity, capability, or output limits do not satisfy the request.

pub const fn model_id(&self) -> &ModelId

Returns the selected model.

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

Returns the optional system prompt.

pub fn messages(&self) -> &[CanonicalMessage]

Returns canonical messages in source order.

pub fn tools(&self) -> &[ModelToolDefinition]

Returns model-visible tools in source order.

pub const fn allow_parallel_tool_calls(&self) -> bool

Returns whether the model may request several tools in one response.

pub const fn reasoning(&self) -> Option<ReasoningOptions>

Returns reasoning options.

pub const fn max_output_tokens(&self) -> Option<TokenCount>

Returns the request-specific output limit.

pub const fn metadata(&self) -> &ProtocolMetadata

Returns bounded request metadata.

Trait Implementations

impl Clone for ModelRequest

fn clone(&self) -> ModelRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ModelRequest

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

Formats the value using the given formatter.

impl PartialEq for ModelRequest

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ModelRequest