Expand description
Generated RLMesh protobuf bindings and protocol-level constants.
Modules§
- capabilities
- Stable capability names exchanged during handshake.
- core
- env
- model
- spaces
Structs§
- Edition
Defaults - The edition-governed defaults one
Editionpromises: the values a participant would otherwise hardcode, lifted here so a future default change is a new row rather than an edit to a code path a sealed edition already depends on. One row per arm, returned bydefaults; a sealed row is never edited. - Edition
Refusal - No edition satisfies every participant — the negotiation’s clean refusal.
- Endpoint
Phases - The endpoint-local split of
JoinResponse.endpoint_total_ns(ns), plus the pre-handler wait and slot depth a pipelining model endpoint reports. - Peer
Info Override - Advisory runtime identity supplied by a non-Rust host (e.g. the Python SDK)
to enrich the handshake
PeerInfo. - Session
Floor - The reconciled workflow edition produced by
negotiate_session_floor. - Session
Offer - One participant’s bind-time offer: the two sets it brings to negotiation.
- Tier
Offer - One tier’s position in a refused negotiation, for the diagnostic.
- Unknown
Edition - A wire edition name no
Editionarm implements.
Enums§
- Edition
- A workflow semantics edition this build implements.
- Runtime
Cap - Why the runtime capped a session below what its peers would have run at.
Constants§
- BUILD_
COHORT - Build cohort used to spell
CURRENT_WORKFLOW_EDITION. - BUILD_
SOURCE - Source of the build cohort:
release,package, orgit. - CURRENT_
WORKFLOW_ EDITION - Current workflow semantics edition.
- PROTOCOL_
GENERATION - Identity of the frozen wire substrate: the
corehandshake plus thespacesvalue transport the runtime relays between env and model. NOT the package version, NOT the product semver, and NOT a per-service version — it names the one shared byte contract every component is built against, decoupled from all of them. - SUPPORTED_
WORKFLOW_ EDITIONS - Workflow editions this crate can operate under, generated by
build.rsfromrlmesh.toml’s[workflow] supported_editionswithCURRENT_WORKFLOW_EDITIONfirst. Each edition names an immutable behavioral contract documented indocs/editions/<base>.md(the spec file is keyed by the bareYYYY.MMbase, never the suffixed cohort), so a sealed edition is retained here under its bare name for as long as the crate can still drive it. A published crate ships norlmesh.toml; it reads the same list from its shippedsupported_editions.txt. - WORKFLOW_
EDITION_ BASE - Bare
YYYY.MMworkflow edition base for this build.
Functions§
- capability_
map - Return a handshake capability map for the given capability names.
- core_
handshake_ request - The core handshake request this build sends as a gRPC client: its protocol generation, the editions it CAN drive, the edition it declares (WANT), its advertised capabilities, and PeerInfo. Shared by the env and model clients (each wraps it in its service-specific request) so the request shape cannot drift between services.
- declared_
workflow_ edition - The edition a participant declares (its WANT): the explicit declaration, or
CURRENT_WORKFLOW_EDITIONwhen it declares none. Whitespace is trimmed and an empty declaration reads as absent. - defaults
- The defaults row governing a session running at
edition. - edition_
sort_ key - Ordering key for a workflow edition name:
(base, cohort?, suffix). - elapsed_
ns - Nanoseconds elapsed since
started_at, saturating instead of wrapping. - evaluate_
handshake - Whether a client’s handshake offer is compatible with this server: the only handshake-level decision is protocol generation (a hard, full-restart break).
- generation_
mismatch_ message - The human-facing rejection message when a client’s protocol generation does not match this server. Generation is the ONLY handshake-level rejection; an edition mismatch is decided — and diagnosed — by the runtime’s floor, not here. Shared by the env and model servers so the rejection prose cannot drift.
- has_
capability - Whether a peer’s handshake capability map advertises the named capability.
- is_
protocol_ generation_ supported - Whether the given protocol generation is the one this build speaks. Plain equality — there is no support window. Whitespace is trimmed so a padded wire value still matches.
- is_
retained_ edition - Whether this build retains
edition: it has an arm for it ANDSUPPORTED_WORKFLOW_EDITIONS(generated fromrlmesh.toml) still names a spelling of it. - lane_
final_ info - A completing lane’s final info from a step’s
infos,lanebeing its position among thewidthlanes the step covered. An explicitfinal_infoentry wins (masked by_final_info). Otherwise a single-lane step’s info IS the final info, and a vector step’s lane is sliced out of the Gymnasium vector-info layout.Nonewhen the lane has nothing. - lane_
skew_ ns - Straggler skew across a vector env’s lanes for one op: how much longer the slowest lane took than the median lane, in nanoseconds.
- negotiate_
session_ floor - Reconcile the route’s workflow edition across env, model, and this runtime.
- negotiate_
workflow_ edition - Select the workflow edition governing a session between this runtime and one
peer — the co-located floor (
env ∩ self) the in-process /run_localpath runs at, with the model and runtime being the same build. - parse_
declared_ edition - Resolve a declared edition — a participant’s WANT — to the arm it names, or say why this build cannot declare it.
- parse_
retained_ edition - Resolve a wire edition name to the arm this build both implements AND retains, or say why it cannot.
- peer_
info - Build advisory
PeerInfodiagnostics for a handshake. - set_
peer_ info_ override - Install (or replace) the process-wide
PeerInfoOverrideconsulted bypeer_info. Intended for non-Rust hosts (the Python SDK) to report their real runtime. Idempotent and thread-safe; passing the value again overwrites. - supported_
workflow_ editions - Return supported workflow editions as owned strings for protobuf messages.
- want_
admits - Whether a declared WANT admits
editionas the session’s edition.