Crate appcore_control_plane 

Generic control-plane contracts for distributed AppCore deployments.

The control plane stores presence, leases, and routing metadata. It must not transport business payloads or contain tenant-specific business rules.

Modules

v1

Stable control-plane wire and provider contracts.

Structs

BearerHttpTransport

HTTP transport that authenticates requests with a zeroizing bearer token.

CancellationToken

Cloneable cooperative cancellation flag.

ControlPlaneCoordinator

Coordinates heartbeat results with the runtime operational mode.

ControlPlaneHttpConfig

Configuration for the generic HTTP control-plane client.

CorePresence

Presence record acknowledged by a control-plane provider.

CoreRegistration

Registration submitted by one running core.

FileControlPlane

Durable control-plane implementation for one shared deployment directory.

HeartbeatPolicy

Policy applied when a heartbeat cannot reach the control plane.

HeartbeatRequest

Heartbeat submitted by one running core.

HeartbeatResponse

Heartbeat acknowledgement.

HttpControlPlaneClient

Control-plane client that maps stable contracts onto an HTTP transport.

HttpControlPlaneRequest

Transport request produced by HttpControlPlaneClient.

HttpControlPlaneResponse

Bounded response returned by an HttpTransport.

InMemoryControlPlane

Deterministic in-memory control plane for embedded hosts and tests.

OfflineControlPlaneClient

Client that explicitly reports the control plane as unavailable.

PeerDirectory

Compatible peers discovered for a tenant and cluster.

PeerRecord

Generic routing record for one distributed core.

RetryPolicy

Retry limits and exponential backoff bounds for control-plane requests.

SecretString

Redacted bearer material that is zeroized when released.

ServiceLeaderLease

Leadership lease scoped to one independently coordinated service.

StaticServiceLeadershipGuard

In-memory service lease guard for embedded hosts and tests.

StdHttpTransport

Shared bounded HTTP transport for unauthenticated deployment-local calls.

Enums

ControlPlaneError

Provider-independent control-plane failure.

LeadershipDecision

Result of a leadership fencing check.

Traits

ControlPlaneProvider

Provider contract for presence, discovery and leadership coordination.

DiscoveryProvider

Provider contract limited to compatible peer discovery.

HttpTransport

Adapter contract used by the control-plane HTTP client.

ServiceLeadershipGuard

Checks leadership for an independently coordinated service.

Functions

require_secure_remote_endpoint

Rejects plain HTTP for non-loopback control-plane endpoints.

Type Aliases

ControlPlaneFuture

Sendable future returned by a control-plane provider.

ControlPlaneResult

Result returned by control-plane contracts.