Struct LlmRequest 

pub struct LlmRequest {
    pub model: String,
    pub system: String,
    pub messages: Vec<LlmMessage>,
    pub temperature: f32,
    pub max_tokens: u32,
    pub json_schema: Option<Value>,
    pub timeout_ms: u64,
}

A single LLM call.

Field shape is frozen by BUILD_SPEC §12. Adapters MUST NOT reorder, rename, or hide fields without bumping cortex_core::SCHEMA_VERSION — the request is part of the audit envelope downstream.

Fields

model: String

Provider-specific model identifier, e.g. claude-3-5-sonnet-20240620.

system: String

System prompt; may be empty.

messages: Vec<LlmMessage>

Conversation history in chronological order.

temperature: f32

Sampling temperature; passed through verbatim.

max_tokens: u32

Hard cap on completion length.

json_schema: Option<Value>

Optional JSON Schema constraint applied to the response (provider may enforce or just inject as guidance).

timeout_ms: u64

Wallclock budget in milliseconds.

Implementations

impl LlmRequest

pub fn prompt_hash(&self) -> String

Stable BLAKE3 hash over the canonical fields used for fixture matching: (system, messages, temperature, max_tokens, json_schema).

Excludes model and timeout_ms so the same prompt can be replayed against multiple models (matching is by (model, prompt_hash) pair) and so transient budget tweaks do not invalidate fixtures.

The hash is over the serialized JSON of a tagged struct so that serde_json field ordering is the deterministic input.

Trait Implementations

impl Clone for LlmRequest

fn clone(&self) -> LlmRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LlmRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for LlmRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for LlmRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.