Struct AgentSurface 

pub struct AgentSurface {
    pub command: Option<String>,
    pub select: Vec<String>,
    pub filters: Vec<FilterExpr>,
    pub sort: Option<String>,
    pub dedupe_by: Option<String>,
    pub max_items: usize,
    pub count_only: bool,
    pub truncate_content: usize,
    pub max_output_bytes: usize,
}

Resolved output-shaping request for the current process.

Fields

command: Option<String>

Subcommand that emitted the envelope, as crate::cli::Commands::agent_surface_slug reports it.

CONTEXT, never a knob: it tells alias suppression which subcommand’s contract applies, and therefore takes no part in Self::is_noop. A surface carrying only a command name still changes nothing.

select: Vec<String>

Keys kept by --select / --fields, in the requested order.

filters: Vec<FilterExpr>

Predicates from --filter, conjoined with AND.

sort: Option<String>

Sort key from --sort.

dedupe_by: Option<String>

Dedup key from --dedupe-by.

max_items: usize

Cap on emitted result elements (--max-items); 0 disables it.

count_only: bool

Replace the payload with a count (--count-only).

truncate_content: usize

Cap on string length in characters (--truncate-content); 0 disables it.

max_output_bytes: usize

Cap on the serialized envelope in bytes (--max-output-bytes); 0 disables it.

Implementations

impl AgentSurface

pub fn is_noop(&self) -> bool

true when no knob is set and apply must be a no-op.

Trait Implementations

impl Clone for AgentSurface

fn clone(&self) -> AgentSurface

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentSurface

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

Formats the value using the given formatter.

impl Default for AgentSurface

fn default() -> AgentSurface

Returns the “default value” for a type.