Crate vox_core 

Core implementations for the vox connectivity layer.

This crate provides concrete implementations of the traits defined in vox_types. The only conduit shape is BareConduit: wraps a raw Link with postcard serialization. No reconnect, no reliability — reconnect was removed (StableConduit deleted) because the abstraction had no real users.

Modules

testing

Test utilities for vox-core. Publicly exported for use by integration tests in downstream crates.

Structs

AcceptorFn

Wrapper that turns a closure into a ConnectionAcceptor.

Attachment

One transport attachment consumed by LinkSource::next_link.

BareConduit

Wraps a Link with postcard serialization. No reconnect, no reliability.

BareConduitRx

BareConduitTx

Caller

Concrete caller type wrapping a DriverCaller with optional middleware.

ConnectionHandle

ConnectionRequest

Metadata wrapper with typed getters for well-known vox-* keys.

ConnectionState

Static data for one active connection.

Driver

Per-connection driver. Tracks in-flight request attempts, dispatches incoming requests to a Handler, and manages channel state / flow control.

DriverCaller

Allocates a request ID, registers a response slot, sends one request attempt through the connection, and awaits the corresponding response.

DriverChannelSink

Concrete ChannelSink backed by a ConnectionSender.

DriverReplySink

Concrete ReplySink implementation for the driver.

InMemoryOperationStore

Default in-memory operation store.

MemoryLink

In-process Link backed by tokio mpsc channels.

MemoryLinkRx

Receiving half of a MemoryLink.

MemoryLinkRxError

MemoryLink never fails on recv — the only “error” is channel closed (returns None).

MemoryLinkTx

Sending half of a MemoryLink.

MessagePlan

Pre-built translation plan for deserializing the Message wire type.

NoopClient

Liveness-only client for a connection root.

PendingConnection

A connection that has been opened but not yet accepted.

PreparedFrame

A serialized message plus the file descriptors collected while encoding it. The descriptors travel out-of-band via SCM_RIGHTS; off-Unix FrameFds is ().

SealedResponse

A sealed response stored in the operation store.

Session

Session state machine.

SessionAcceptorBuilder

SessionConfig

Shared configuration for all session builders.

SessionHandle

Cloneable handle for opening and closing virtual connections.

SessionInitiatorBuilder

SessionKeepaliveConfig

Session-level protocol keepalive configuration.

SessionRegistry

SessionSourceInitiatorBuilder

SessionTransportAcceptorBuilder

SessionTransportInitiatorBuilder

SingleAttachmentSource

One-shot link source: hands out its single attachment, then errors on every subsequent call.

Enums

BareConduitError

HandshakeError

OperationState

State of an operation in the store.

SessionAcceptOutcome

SessionError

Errors that can occur during session establishment or operation.

TransportMode

Requested conduit mode for the transport prologue.

TransportPrologueError

TransportRejectReason

Constants

VOX_SERVICE_METADATA_KEY

Well-known metadata key for service name routing.

Traits

ConnectionAcceptor

DynConduitRx

DynConduitTx

ErasedHandler

Object-safe version of Handler<DriverReplySink>.

FromVoxSession

Trait for constructing a typed client from a vox session.

IntoConduit

Converts a value into a vox_types::Conduit.

LinkSource

Source of transport links. With reconnect machinery removed there’s only ever one call to next_link per session, but the trait remains so existing code paths don’t have to special-case the single-link case.

OperationStore

Operation state backing for exactly-once delivery across session resumption within a single process.

OutboundSendFuture

Functions

accept_transport

acceptor_conduit

acceptor_fn

Create a ConnectionAcceptor from a closure.

acceptor_on

acceptor_on_link

Convenience: perform CBOR handshake as acceptor on a raw link, then return a builder with the conduit ready to go.

acceptor_transport

handshake_as_acceptor

Perform the CBOR handshake as the acceptor.

handshake_as_initiator

Perform the CBOR handshake as the initiator.

initiate_transport

initiator

initiator_conduit

initiator_on

initiator_on_link

Convenience: perform CBOR handshake as initiator on a raw link, then return a builder with the conduit ready to go.

initiator_transport

memory_link_pair

Create a pair of connected MemoryLinks.

proxy_connections

Forward all request/channel traffic between two connections.

reject_transport

single_attachment_source

single_link_source

Type Aliases

BoxSessionFuture

A pinned, boxed session future. On non-WASM this is Send + 'static; on WASM it’s 'static only (no Send requirement).