Struct CoreCommsConfig 

pub struct CoreCommsConfig {

    pub enabled: bool,
    pub name: String,
    pub inproc_namespace: Option<String>,
    pub listen_uds: Option<PathBuf>,
    pub listen_tcp: Option<SocketAddr>,
    pub advertise_address: Option<String>,
    pub event_listen_tcp: Option<SocketAddr>,
    pub event_listen_uds: Option<PathBuf>,
    pub identity_dir: PathBuf,
    pub trusted_peers_path: PathBuf,
    pub ack_timeout_secs: u64,
    pub max_message_bytes: u32,
    pub auth: CommsAuthMode,
    pub require_peer_auth: bool,
    pub allow_external_unauthenticated: bool,
    pub pairing_password: Option<String>,
}

Core configuration for agent-to-agent communication.

The listen_tcp/listen_uds addresses are for signed (CBOR+Ed25519) agent-to-agent communication. The event_listen_tcp/event_listen_uds addresses are for the plain-text external event listener (when auth=Open).

Both listeners can run simultaneously — the signed listener handles peer agents, while the plain listener accepts external events.

Fields

enabled: bool

name: String

inproc_namespace: Option<String>

Optional namespace for in-process registry isolation.

Agents in different namespaces cannot see or send to each other via inproc:// unless they explicitly share this value.

listen_uds: Option<PathBuf>

Address for signed (Ed25519) agent-to-agent listener.

listen_tcp: Option<SocketAddr>

Address for signed (Ed25519) agent-to-agent listener.

advertise_address: Option<String>

Runtime peer address advertised to other signed-comms participants.

When absent, the runtime advertises its bound listener address. Set this when binding to a wildcard/NAT/interface-local address that peers cannot dial directly.

event_listen_tcp: Option<SocketAddr>

Address for plain-text external event listener. Only active when auth=Open.

event_listen_uds: Option<PathBuf>

Path for plain-text external event listener (UDS). Only active when auth=Open.

identity_dir: PathBuf

trusted_peers_path: PathBuf

ack_timeout_secs: u64

max_message_bytes: u32

auth: CommsAuthMode

require_peer_auth: bool

allow_external_unauthenticated: bool

Allow binding plain event listener to non-loopback addresses. This is a prompt injection vector — only enable with explicit intent.

pairing_password: Option<String>

Runtime-only pairing password for initial signed-comms enrollment.

Implementations

impl CoreCommsConfig

pub fn with_name(name: &str) -> Self

pub fn resolve_paths(&self, base_dir: &Path) -> ResolvedCommsConfig

Trait Implementations

impl Clone for CoreCommsConfig

fn clone(&self) -> CoreCommsConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CoreCommsConfig

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

Formats the value using the given formatter.

impl Default for CoreCommsConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CoreCommsConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for CoreCommsConfig

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CoreCommsConfig

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 CoreCommsConfig