Module directory 

Directory API - contract for service discovery and instance resolution

Structs

DirectoryInvalidArgument

Sentinel error wrapped via anyhow::Error to signal “client-supplied argument is malformed” (e.g. invalid UUID) through the DirectoryClient trait. Allows the gRPC server boundary to return Status::invalid_argument instead of mislabeling a client bug as an internal failure.

DirectoryNotFound

Sentinel error wrapped via anyhow::Error to signal “the requested gear or service is not registered (or has no live instance)” through the DirectoryClient trait. Consumers downcast to this type to distinguish a not-ready provider (eventual readiness) from a directory-backend failure — see toolkit::discovery::DirectoryEndpointResolver.

GrpcServiceInfo

A resolved gRPC service and the endpoint it is reachable at.

LabelSelector

Label-equality selector over instance labels (k8s matchLabels style).

LocalDirectoryClient

Local implementation of DirectoryClient that delegates to GearManager

RegisterInstanceInfo

Information for registering a new gear instance

ServiceEndpoint

Represents an endpoint where a service can be reached

ServiceInstanceInfo

Information about a service instance

Enums

InstanceState

Serving state of a directory instance, projected from the directory’s live registration/heartbeat tracking.

Traits

DirectoryClient

Directory API trait for service discovery and instance management