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 doctorenvironment diagnostics (#354, v1.x-5 from #228). - fs_
health - Filesystem-health probes for status/doctor visibility (#390).
- get_
http_ endpoint_ dispatch GetBrokerHttpEndpointRPC dispatch (slice 6 of #488).- get_
session_ token_ dispatch GetSessionTokenRPC 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 v1Frameenvelope 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_BUFso 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.