Struct PhyTraceAgent 

pub struct PhyTraceAgent { /* private fields */ }

The main PhyTrace SDK agent.

Manages the complete event lifecycle:

• License validation
• Event building and validation
• Provenance signing (optional)
• Batching and buffering
• Transport with retry logic

Implementations

impl PhyTraceAgent

pub async fn from_config(config: PhyTraceConfig) -> PhyTraceResult<Self>

Create an agent from configuration.

pub async fn with_transport( config: PhyTraceConfig, transport: Box<dyn Transport>, ) -> PhyTraceResult<Self>

Create an agent with a custom transport.

pub async fn from_file<P: AsRef<Path>>(path: P) -> PhyTraceResult<Self>

Load configuration from a YAML file and create agent.

pub async fn start(&self) -> PhyTraceResult<()>

Start the agent.

pub async fn shutdown(&self) -> PhyTraceResult<()>

Stop the agent gracefully.

pub fn emit(&self) -> AgentEventBuilder<'_>

Create an event builder for fluent emission.

pub async fn send(&self, event: UdmEvent) -> PhyTraceResult<()>

Send a pre-built event.

pub async fn flush(&self) -> PhyTraceResult<()>

Flush buffered events immediately.

pub async fn stats(&self) -> TransportStats

Get transport statistics.

pub fn is_running(&self) -> bool

Check if the agent is running.

pub fn config(&self) -> &PhyTraceConfig

Get a reference to the configuration.

pub fn set_validation_level(&mut self, level: ValidationLevel)

Set the validation level.