Skip to main content

Module broker

Module broker 

Source
Expand description

v1 broker module — schemas are FROZEN FOREVER once v1.0 ships.

Phase 0 of #228: this module exposes the prost-generated wire types (envelope, manifest, service definition) for every later phase to depend on. No consumers ship yet — Phases 1+ wire them in.

See proto/broker_v1_*.proto and the parent issue for the rationale behind every field number and reserved range.

Re-exports§

pub use crate::frame_v1::FRAMING_VERSION_V1;
pub use crate::frame_v1::MAX_FRAME_SIZE_BYTES;
pub use crate::frame_v1::MAX_HELLO_SIZE_BYTES;

Modules§

adopt
One-call broker adoption: negotiate → dial → ready-to-talk client (#433 R1).
backend_handle
backend_lib
Backend-facing helpers for v1 broker consumers.
backend_lifecycle
Shared backend lifecycle primitives used by broker and direct clients.
backend_sdk
Backend integration SDK (#412).
broker_http_discovery
Publishing the broker’s HTTP port so callers can find it (#483).
broker_http_port
v2 broker HTTP port mode resolution (slice 9 of #488).
broker_http_server
Broker HTTP server scaffold (slice 7 of #488).
broker_owned_bind
Broker-owned listener handoff policy.
brokered_backend
Structurally-enforced fast-bind contract for v2 brokered daemons (#497).
builders
Legacy client-path aliases for the canonical v1 registration builders.
capabilities
Shared capability bitmap constants for the v1 Hello/Negotiated exchange.
client
Client-side helpers for the v1 broker Hello path.
client_v2
v2 broker client (slice 4 of #488).
connect_watchdog
Fail-fast connect guard for the broker client (running-process#894).
doctor
Read-only broker doctor environment diagnostics (#354, v1.x-5 from #228).
fs_health
Filesystem-health probes for status/doctor visibility (#390).
get_http_endpoint_dispatch
GetBrokerHttpEndpoint RPC dispatch (slice 6 of #488).
get_session_token_dispatch
GetSessionToken RPC dispatch (zackees/soldr#2361 Phase 2, #2363).
host_identity
Legacy broker-path aliases for the shared host identity implementation.
http_endpoint_registry
Per-backend HTTP endpoint registry for the v2 broker (slice 5 of #488).
lifecycle
Per-user, per-machine derivations for broker pipe naming and SID hashing.
manifest
Legacy client-path aliases for canonical v1 manifest persistence.
protocol
v1 broker protocol module.
protocol_v2
v2 broker protocol module.
secure_dir
Legacy client-path aliases for registration’s private-directory helpers.
server
Broker server foundation for running-process-broker-v1.
session_codec
Phase 3 SESSION-lane codec (soldr#2365, slice 3a): bridge the proxy pump’s SessionFrames onto the v1 Frame envelope and back.
session_pump
Phase 3 proxy pump (soldr#2365, slice 2b): drive a child process as a broker-proxied compile session.
session_server
Phase 3 session server (soldr#2365, slice 3b): run a contained child as a broker-proxied session over a byte transport.

Constants§

LIFECYCLE_EVENT_PIPE_BUF_FLOOR
Upper bound on a LifecycleEvent’s prost-encoded size, set to the minimum POSIX PIPE_BUF so atomic-append into the event log is guaranteed on every platform. Linux raises this to 4096 in practice, but the cross-platform floor is 512.