brainwires-network 0.11.0

Agent-to-agent networking — IPC, remote bridge, mesh networking, routing, and discovery for Brainwires
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

#![deny(missing_docs)]
//! # Brainwires Agent Network
//!
//! Agent-to-agent networking layer for the Brainwires Agent Framework.
//!
//! Provides IPC, remote bridge, mesh networking, routing, discovery,
//! and pluggable transports for agent communication.
//!
//! ## Protocol-Layer Stack
//!
//! The networking layer is organized as a 5-layer protocol stack:
//!
//! 1. **Identity** — agent identity, capability advertisement, credentials
//! 2. **Transport** — how bytes move (IPC, Remote, TCP, A2A, Pub/Sub)
//! 3. **Routing** — where messages go (direct, topology, broadcast, content)
//! 4. **Discovery** — how agents find each other (mDNS, registry, manual)
//! 5. **Application** — user-facing API (NetworkManager, events)

/// Networking transport layer — pluggable transports for agent communication.
pub mod transport;

// ============================================================================
// Agent Communication Backbone (IPC, Auth, Remote)
// ============================================================================
/// Authentication for agent network connections.
pub mod auth;
/// IPC (inter-process communication) socket protocol.
pub mod ipc;
/// Remote bridge and realtime protocol.
pub mod remote;
/// Common agent network traits.
pub mod traits;

// ============================================================================
// Client
// ============================================================================
/// Client for connecting to a remote agent network server.
#[cfg(feature = "client")]
pub mod client;

#[cfg(feature = "client")]
pub use client::{AgentConfig, AgentNetworkClient, AgentNetworkClientError};

// ============================================================================
// Mesh Networking (topology, routing, discovery, federation)
// ============================================================================
/// Distributed agent mesh networking — topology, routing, discovery, federation.
#[cfg(feature = "mesh")]
pub mod mesh;

// ============================================================================
// Protocol-Layer Stack (Identity, Network Core)
// ============================================================================
/// Peer discovery — how agents find each other on the network.
pub mod discovery;
/// Agent identity, capability advertisement, and credentials.
pub mod identity;
/// Message routing — direct, broadcast, and content-based routing.
pub mod routing;

/// Message envelopes and payload types exchanged across the network.
pub mod envelope;
/// Network lifecycle events and connection state.
pub mod event;
/// Application-layer entry point: `NetworkManager` + builder.
pub mod manager;
/// Errors emitted by the protocol-stack layers (identity / transport / routing / discovery / application).
pub mod network_error;

/// Universal messaging channels (absorbed from brainwires-channels).
pub mod channels;

/// LAN inspection tooling — NIC enumeration, IP config, ARP discovery, port scanning.
///
/// These are **operator** tools (akin to `ip`, `ifconfig`, `arp`, `nmap`), distinct
/// from the agent-discovery primitives in [`mod@discovery`]. Originally lived in
/// `brainwires-hardware::network`.
#[cfg(feature = "lan")]
pub mod lan;

pub use envelope::{MessageEnvelope, MessageTarget, Payload};
pub use event::{ConnectionState, NetworkEvent, TransportType};
pub use identity::{AgentCard, AgentIdentity, ProtocolId};
pub use manager::{NetworkManager, NetworkManagerBuilder};
pub use network_error::NetworkError;
pub use transport::{Transport, TransportAddress};

#[cfg(feature = "ipc-transport")]
pub use transport::IpcTransport;
#[cfg(feature = "pubsub-transport")]
pub use transport::PubSubTransport;
#[cfg(feature = "remote-transport")]
pub use transport::RemoteTransport;
#[cfg(feature = "tcp-transport")]
pub use transport::TcpTransport;
#[cfg(feature = "a2a-transport")]
pub use transport::{A2aTransport, a2a_message_to_envelope};