Struct AgentRequestBuilder

pub struct AgentRequestBuilder { /* private fields */ }

Builder for AgentRequest with type-safe setters.

Examples

use agentguard_core::{AgentRequestBuilder, Principal, AgentAction, Resource, AgentContext};
let req = AgentRequestBuilder::new(Principal::user("alice"))
    .action(AgentAction::tool("send_email"))
    .resource(Resource::new("Mailbox", "alice@acme"))
    .context(AgentContext::new())
    .build();

Implementations

impl AgentRequestBuilder

pub fn new(principal: impl Into<Principal>) -> Self

Start building a request for the given principal.

pub fn action(self, a: impl Into<AgentAction>) -> Self

Set the action (tool call).

pub fn resource(self, r: impl Into<Resource>) -> Self

Set the resource.

pub fn context(self, c: impl Into<AgentContext>) -> Self

Set the context.

pub fn request_id(self, id: impl Into<String>) -> Self

Override the auto-generated request id.

pub fn trace(self, trace: TraceContext) -> Self

Attach a W3C Trace Context.

pub fn traceparent(self, tp: &str) -> Result<Self>

Attach a trace by parsing a traceparent string.

Errors

Returns Error::Other (or a parse error) if the traceparent string is malformed.

pub fn tenant_id(self, tid: impl Into<String>) -> Self

Set the tenant ID. Whitespace is trimmed; empty/whitespace-only values become None. No other format constraint.

pub fn build(self) -> Result<AgentRequest>

Finalize the request. Returns an error if action or resource is missing.

Trait Implementations

impl Clone for AgentRequestBuilder

fn clone(&self) -> AgentRequestBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentRequestBuilder

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

Formats the value using the given formatter.