Struct SamplingRequest 

#[non_exhaustive]
pub struct SamplingRequest {
    pub messages: Vec<SamplingMessage>,
    pub model_preferences: Option<ModelPreferences>,
    pub system_prompt: Option<String>,
    pub max_tokens: u32,
    pub temperature: Option<f32>,
    pub stop_sequences: Option<Vec<String>>,
}

One sampling/createMessage request envelope sent from a klieo MCP server to its client. Carries the message history plus optional model preferences, a system prompt, sampling controls, and an upper bound on the number of tokens the client may generate.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

messages: Vec<SamplingMessage>

Conversation history the client should complete. Ordered oldest-first; the client’s reply continues from the last entry.

model_preferences: Option<ModelPreferences>

Optional hints to the client about which model family / cost / latency / intelligence profile to use. Clients MAY ignore these and pick their own model.

system_prompt: Option<String>

Optional system prompt to prepend to the conversation. When None, the client uses its own default (or no system prompt).

max_tokens: u32

Upper bound on the number of tokens the client may generate. Required by the MCP spec; clients MUST honour it.

temperature: Option<f32>

Optional sampling temperature. Range and default are client-defined; common practice is 0.0–2.0 with 1.0 as default.

stop_sequences: Option<Vec<String>>

Optional list of stop sequences. Generation halts as soon as the model emits any of these strings.

Implementations

impl SamplingRequest

pub fn new(messages: Vec<SamplingMessage>, max_tokens: u32) -> Self

Constructs a new SamplingRequest with required fields. Optional fields default to None.

Trait Implementations

impl Clone for SamplingRequest

fn clone(&self) -> SamplingRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SamplingRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SamplingRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SamplingRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.