Skip to main content

Module v2

Module v2 

Source
Expand description

Protocol v2 types with bidirectional streaming, capabilities, and flow control Protocol v2 types for Agent Protocol 2.0

This module provides the v2 protocol types including:

  • Capability negotiation
  • Health reporting
  • Flow control
  • Metrics export
  • Bidirectional streaming
  • v2 server and client implementations

Re-exports§

pub use client::AgentClientV2;
pub use client::CancelReason;
pub use client::ConfigUpdateCallback;
pub use client::FlowState;
pub use client::MetricsCallback;
pub use observability::AgentConnection;
pub use observability::ConfigPusher;
pub use observability::ConfigPusherConfig;
pub use observability::ConfigUpdateHandler;
pub use observability::MetricsCollector;
pub use observability::MetricsCollectorConfig;
pub use observability::MetricsSnapshot;
pub use observability::PushResult;
pub use observability::PushStatus;
pub use observability::UnifiedMetricsAggregator;
pub use pool::AgentPool;
pub use pool::AgentPoolConfig;
pub use pool::AgentPoolStats;
pub use pool::LoadBalanceStrategy;
pub use pool::V2Transport;
pub use protocol_metrics::HistogramMetric;
pub use protocol_metrics::HistogramSnapshot;
pub use protocol_metrics::ProtocolMetrics;
pub use protocol_metrics::ProtocolMetricsSnapshot;
pub use reverse::RegistrationRequest;
pub use reverse::RegistrationResponse;
pub use reverse::ReverseConnectionClient;
pub use reverse::ReverseConnectionConfig;
pub use reverse::ReverseConnectionListener;
pub use server::AgentHandlerV2;
pub use server::DrainReason;
pub use server::GrpcAgentHandlerV2;
pub use server::GrpcAgentServerV2;
pub use server::ShutdownReason;
pub use uds::AgentClientV2Uds;
pub use uds::MessageType;
pub use uds::UdsCapabilities;
pub use uds::UdsEncoding;
pub use uds::UdsFeatures;
pub use uds::UdsHandshakeRequest;
pub use uds::UdsHandshakeResponse;
pub use uds::UdsLimits;
pub use uds::MAX_UDS_MESSAGE_SIZE;
pub use uds_server::UdsAgentServerV2;

Modules§

client
Agent client implementation for Protocol v2.
observability
Observability infrastructure for Protocol v2.
pool
Agent connection pool for Protocol v2.
protocol_metrics
Protocol-level metrics for Agent Protocol v2.
reverse
Reverse connection support for Agent Protocol v2.
server
Agent server implementation for Protocol v2.
standard
Standard metric names.
uds
Unix Domain Socket transport for Agent Protocol v2.
uds_server
Unix Domain Socket server for Agent Protocol v2.

Structs§

AgentCapabilities
Agent capabilities declared during handshake.
AgentFeatures
Features this agent supports.
AgentLimits
Resource limits.
AgentResponse
Agent response to a processing event.
BodyChunkEventV2
Body chunk event with flow control support.
CancelRequest
Request to cancel an in-flight request.
ConfigUpdateRequest
Configuration update request.
ConfigUpdateResponse
Response to a configuration update request.
CounterMetric
A counter metric.
DrainRequest
Drain request.
FlowControlSignal
Flow control signal for backpressure.
GaugeMetric
A gauge metric.
HandshakeRequest
Handshake request from proxy to agent.
HandshakeResponse
Handshake response from agent to proxy.
HealthConfig
Health check configuration.
HealthStatus
Health status reported by agent.
HistogramBucket
A histogram bucket.
LoadMetrics
Load metrics.
LogMessage
Log message from agent to proxy.
MetricsReport
Metrics report from an agent.
ResourceMetrics
Resource metrics.
RuleDefinition
A rule definition.
ShutdownRequest
Shutdown request.

Enums§

ConfigUpdateType
Type of configuration update.
FlowAction
Flow control action.
HealthState
Health state.
LogLevel
Log level.
StreamState
Stream state tracking.

Constants§

PROTOCOL_VERSION_2
Protocol version 2

Functions§

supports_version
Check if a version is supported by v2.