Struct GuardrailRequest 

pub struct GuardrailRequest {
    pub id: Uuid,
    pub received_at: SystemTime,
    pub messages: Vec<ChatMessage>,
    pub provider: Provider,
    pub model: String,
    pub stream: bool,
    pub extra: Value,
}

The normalized, provider-agnostic representation of an LLM request.

Constructed from a raw HTTP body regardless of provider (OpenAI, Anthropic, etc.). This is the primary type passed through every pipeline stage.

Fields

id: Uuid

Unique ID for this request, generated at ingress.

received_at: SystemTime

Wall-clock time the request arrived at the proxy.

messages: Vec<ChatMessage>

The full message list, including system prompt.

provider: Provider

Original provider (parsed from Host header or config).

model: String

Model identifier as sent by the caller.

stream: bool

Whether the caller requested streaming.

extra: Value

All other fields from the original payload, preserved verbatim.

Implementations

impl GuardrailRequest

pub fn new( messages: Vec<ChatMessage>, model: String, provider: Provider, ) -> Self

Create a new request with the given messages and model.

Examples

use guardrail_core::request::{GuardrailRequest, ChatMessage, Role, MessageContent, Provider};

let req = GuardrailRequest::new(
    vec![ChatMessage { role: Role::User, content: MessageContent::Text("Hello".into()) }],
    "gpt-4o".into(),
    Provider::OpenAI,
);
assert_eq!(req.model, "gpt-4o");

pub fn user_text(&self) -> String

Extract all text content from user-role messages as a single string.

Useful for classifiers that operate on the combined user input.

pub fn text_for_roles(&self, roles: &[Role]) -> String

Extract the text of every message whose role is in roles, joined with newlines, in message order.

Examples

use guardrail_core::request::{ChatMessage, GuardrailRequest, MessageContent, Provider, Role};

let req = GuardrailRequest::new(
    vec![
        ChatMessage { role: Role::System, content: MessageContent::Text("be nice".into()) },
        ChatMessage { role: Role::User, content: MessageContent::Text("hi".into()) },
    ],
    "gpt-4o".into(),
    Provider::OpenAI,
);
assert_eq!(req.text_for_roles(&[Role::User]), "hi");
assert_eq!(req.text_for_roles(&[Role::System, Role::User]), "be nice\nhi");

pub fn all_text(&self) -> String

Extract all text content from all messages.

Trait Implementations

impl Clone for GuardrailRequest

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GuardrailRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GuardrailRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for GuardrailRequest

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for GuardrailRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for GuardrailRequest