Module pb 

Modules

atlas_client

Generated client implementations.

atlas_server

Generated server implementations.

transport_params

Nested message and enum types in TransportParams.

Structs

Capability

Public view of one declared Capability – what shows up inside CapabilityProvider.capabilities returned by Query. Mirrors the fields of DeclareCapabilityRequest EXCEPT endpoint is OMITTED: endpoint disclosure is gated behind ConnectCapability so Atlas records the consumer->provider edge before any traffic flows. Consumers MUST call ConnectCapability to obtain the dial-able endpoint.

CapabilityProvider

One registered CapabilityProvider (Primitive / Service / Skill) and the Capabilities it currently offers. The shape is the same for all three kinds – the kind is carried in the kind field, redundant when the caller used Query with a kind filter but cheap and lets consumers demultiplex when Query(kind=UNSPECIFIED) was used. capabilities is metadata only – endpoint strings + TransportParams are revealed only via ConnectCapability.

ConnectCapabilityRequest

ConnectCapability – open a channel. gRPC errors:

ConnectCapabilityResponse

ContractDescriptor

DeclareCapabilityRequest

DeclareCapabilityResponse

DisconnectCapabilityRequest

DisconnectCapability – release a channel. Idempotent: unknown channel_id returns was_open = false, NOT a gRPC error (Atlas may have already dropped it due to provider eviction or takeover; that’s expected and the caller has nothing to do).

DisconnectCapabilityResponse

FieldSpec

GrpcParams

HeartbeatRequest

Liveness signal. Atlas may evict CapabilityProviders whose heartbeat lapses.

HeartbeatResponse

InspectAtlasRequest

InspectAtlasResponse

ListContractsRequest

ListContractsResponse

McpParams

QueryContractRequest

QueryContractResponse

QueryRequest

Discovery – one Query RPC with a Kind filter. Python wrappers expose typed query_primitives / query_services / query_skills methods by setting kind accordingly. Filters AND together.

QueryResponse

RegisterRequest

RegisterResponse

Ros2Params

SetLifecycleStateRequest

Push a state transition. CapabilityProviders call this after their on_init / on_activate / on_deactivate handler returns; rbnx and the executor use the result to gate follow-up Driver(CMD_*) calls without polling.

SetLifecycleStateResponse

TransportParams

UnregisterRequest

Unregister any CapabilityProvider (id is unique across kinds). Idempotent: an unknown id returns was_present = false, NOT a gRPC error.

UnregisterResponse

Enums

Kind

Closed set of CapabilityProvider kinds – exactly three. Used in:

LifecycleState

– CapabilityProvider lifecycle ––––––––––––––––––––––

Transport

Closed set of wire transports Atlas understands.