Struct ChatRequest 

pub struct ChatRequest<'a> {
    pub model: String,
    pub max_tokens: Option<Ceiling>,
    pub system: Vec<SystemBlock>,
    pub messages: Cow<'a, [ChatMessage]>,
    pub tools: Cow<'a, [ToolDef]>,
    pub breakpoint: MessageBreakpoint,
    pub effort: Option<Effort>,
}

The canonical request conversation (city dialect = Anthropic Messages). Both production dialects and the scripted model consume this one shape — the seam carries it so replay, citysim and the real gateway argue about the same object.

messages and tools are borrowed on the turn’s path, because a request lives for one call; a holder that keeps a request past the call (the keep-warm renewal) owns a ChatRequest<'static>.

Fields

model: String

max_tokens: Option<Ceiling>

Absent when no catalogue row states this model’s ceiling. The OpenAI wire then omits the field and takes the provider’s own default; the Anthropic wire, which requires it, refuses.

system: Vec<SystemBlock>

messages: Cow<'a, [ChatMessage]>

tools: Cow<'a, [ToolDef]>

breakpoint: MessageBreakpoint

Outside serde, like every request-side annotation: the bytes a ledger or a transcript records are the same with and without it.

effort: Option<Effort>

Frozen at run start: changing it mid-run would start a new cached prompt prefix, so the value rides in from crate::FrozenConfig.

Implementations

impl ChatRequest<'_>

pub fn empty(model: &str, max_tokens: Ceiling) -> ChatRequest<'static>

An empty conversation shell for adapters and tests that argue about hashes, not content.

pub fn carries_breakpoint(&self, index: usize) -> bool

Whether the message at index carries this request’s breakpoint. The one reading of MessageBreakpoint; a dialect only spells the answer on its wire.

pub fn into_owned(self) -> ChatRequest<'static>

The same request, owning what it borrowed: for a holder that keeps it past the call it was assembled for.

Trait Implementations

impl<'a> Clone for ChatRequest<'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 ChatRequest<'a>

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

Formats the value using the given formatter.

impl<'de, 'a> Deserialize<'de> for ChatRequest<'a>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> PartialEq for ChatRequest<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> Serialize for ChatRequest<'a>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> StructuralPartialEq for ChatRequest<'a>