Struct IpcClient 

pub struct IpcClient { /* private fields */ }

IPC client for daemon communication

A client becomes poisoned after a timeout or IO error, because the underlying stream may contain partial data from the failed exchange. Poisoned clients reject further send() calls with IpcError::ClientPoisoned. Use send_with_retry for automatic reconnection.

Implementations

impl IpcClient

pub fn connect(endpoint: &str) -> Result<Self, IpcError>

Connect to a daemon at the given endpoint (Unix socket path)

pub fn connect_with_timeout( endpoint: &str, timeout_ms: u64, ) -> Result<Self, IpcError>

Connect with a custom timeout

pub fn endpoint(&self) -> &str

Get the endpoint this client is connected to

pub fn timeout_ms(&self) -> u64

Get the configured timeout in milliseconds

pub fn send(&mut self, request: &IpcRequest) -> Result<IpcResponse, IpcError>

Send a request and wait for a response

Returns IpcError::ClientPoisoned if this client was poisoned by a previous timeout or IO error.

pub fn send_with_retry( &mut self, request: &IpcRequest, max_retries: u32, ) -> Result<IpcResponse, IpcError>

Send a request with retries using exponential backoff

Each retry creates a fresh connection to avoid stale stream state. If reconnection fails, that attempt is consumed but the retry loop continues (with backoff) rather than silently burning all retries.