Module communication 

Opaque groups, routes, and capability contracts for distributed mechanisms. Opaque communication manifests projected from semantic parallel topology.

This module is the ownership seam between neutral topology planning and a concrete communication implementation. Projection may inspect semantic axes, but the descriptors handed to a backend contain only ordered world ranks, opaque identities, operations, and mechanical limits.

Structs

BoundaryRoleContract

One exact ordered tensor role on a boundary route.

CommunicationCapabilities

Backend capability limits for exact opaque communication mechanisms.

CommunicationCompletionCapabilities

Backend support for bounded completion and safe timeout disposition.

CommunicationCompletionPolicy

Selected deadline and safe disposition for exact communication completion.

CommunicationGroupDescriptor

Ordered membership and exact requirements for one opaque group.

CommunicationGroupRequirements

Exact operations required on one opaque group.

CommunicationManifest

Complete opaque communication description as viewed by one world rank.

CommunicationOperationRequirement

Fine-grained operation, dtype, limit, and completion requirement.

CommunicationPeerCounts

Exact rank-local send and receive element counts for a variable exchange.

CommunicationRouteDescriptor

Directed route with exact mechanical transfer requirements.

CommunicationRouteId

Stable opaque identity of one directed communication route.

CommunicationTensorLimits

Maximum tensor and per-peer counts admitted for one operation.

PreparedCommunicationRealization

Communication descriptors and world-wave proofs validated before native subgroup or route resources are created.

RoleExactBoundaryContract

Architecture-selected role/schema contract embedded in a route manifest.

TopologyCommunicationPlan

Semantic inputs used only while projecting opaque communication descriptors.

Enums

BoundaryDimensionContract

One manifest-selected boundary dimension constraint.

BoundaryFramingProtocol

Versioned in-band framing protocol selected for a boundary route.

CommunicationCapabilityError

Missing or insufficient generic communication mechanism capability.

CommunicationManifestConsensusError

Failure while exchanging or validating complete rank-local manifests.

CommunicationManifestError

Invalid opaque communication manifest or topology projection.

CommunicationOperation

One exact mechanism required by a communication group or route.

CommunicationRealizationError

Failure while converting compatible manifests into a native-resource-free communication realization.

CommunicationTopologyCapabilities

Backend support for realizing logical groups and directed routes over one already-created world communicator.

Functions

compatible_group_world_wave_proofs

Returns complete-world collective-wave proofs for each compatible group order.

prepare_communication_realization

Validates capability and reachability once, before any native subgroup or directed-route resource is created.

project_all_communication_manifests

Projects and cross-validates compatible opaque descriptors for every rank.

project_communication_manifest

Projects one rank’s semantic Cartesian topology into opaque descriptors.

route_world_wave_proofs

Returns complete-world collective-wave proofs for each route submission order.

validate_communication_manifest_consensus

Gathers and cross-validates one complete opaque manifest from every world rank.

validate_compatible_communication_manifests

Proves that all ranks derived identical global descriptors and exact local indices.