Struct Capabilities 

#[non_exhaustive]
pub struct Capabilities {
    pub managed: bool,
    pub query: QueryCapsView,
    pub kv: KvCapsView,
    pub graph: bool,
    pub fork: bool,
    pub agent_workflow: bool,
    pub watch: bool,
    pub authz: bool,
    pub versions: OpVersions,
    pub backends: Vec<BackendDescriptor>,
    pub topology: Option<WireTopology>,
}

GET /agdx/capabilities reply: what the /agdx/* surface offers on this server, so a browser client can feature-detect before showing the projections / query / KV / fork views. Richer than the binary AGDX_HELLO probe (per-surface flags plus the wire op versions the JSON bodies must match), and it answers truthfully even when the managed backend is disabled (200 with managed: false).

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

managed: bool

Connected to a managed plane at all (the root: with no plane every managed surface below is off, and the reply still answers 200 with managed: false).

query: QueryCapsView

The managed query surface, its registry browse views, and the strongest read-consistency it serves.

kv: KvCapsView

The managed key-value surface and its conditional-write support.

graph: bool

Whether the knowledge-graph ops (traversal, neighbors) are served. The agentic-memory API composes the query and graph surfaces, so it has no flag of its own: a client reads query and graph.

fork: bool

Whether copy-on-write forks are served.

agent_workflow: bool

Whether the agent and workflow control band is served. Off until the plane serves it (the engine is a later phase).

watch: bool

Whether the change feed is published (one change record per committed notifying projector batch on the changes topic). Off by default: a client that waits on an unpublished feed would wait forever.

authz: bool

Whether the authorization control band (AGDX_AUTHZ_*) is served, so a console can show its roles and bindings surface. Off by default.

versions: OpVersions

backends: Vec<BackendDescriptor>

Materialization backends the server currently exposes, so a client can show what it may route to. Identity only (id + engine kind), no settings or secrets. Empty (the default) is skipped on encode, so a pre-backends capabilities reply stays byte-identical.

topology: Option<WireTopology>

The stream/topic names this deployment uses, mirroring crate::hello::BackendAnnounce::topology. Absent (the default) is skipped on encode, so a pre-topology capabilities reply stays byte-identical and an older reader falls back to WireTopology::default.

Implementations

impl Capabilities

pub fn new(enabled: bool, versions: OpVersions) -> Self

Constructor for the non-exhaustive wire struct. The core surfaces track enabled, the way the binary AGDX_HELLO probe answers. The per-surface sub-features (kv.cas, query.consistency above eventual, graph) all start off: a server must opt into each, never over-advertising (which would turn a clean unsupported error into a silent wrong answer). Build them with from_versions or the setters.

pub fn with_graph(self, value: bool) -> Self

Advertise that the knowledge-graph ops are served. Off by default: a server sets it only when a backend implements the graph surface.

pub fn with_agent_workflow(self, value: bool) -> Self

Advertise that the agent and workflow control band is served. Off by default: a server sets it only when it serves the band.

pub fn with_query_keyword(self, value: bool) -> Self

Set whether lexical keyword search is served on the query surface.

pub fn with_watch(self, value: bool) -> Self

Advertise that the change feed is published. Only a deployment whose projector emits change records may set it.

pub fn with_authz(self, value: bool) -> Self

Advertise that the authorization control band is served.

pub fn with_backends(self, backends: Vec<BackendDescriptor>) -> Self

Advertise the materialization backends the server exposes. The wire pins no engine, so a server lists whatever it has open by id and kind.

pub fn with_topology(self, topology: WireTopology) -> Self

Advertise the deployment’s topology, mirroring crate::hello::BackendAnnounce::with_topology.

pub fn with_kv_cas(self, on: bool) -> Self

Advertise compare-and-swap on the KV surface (AGDX_KV_CAS). Only a backend that does a genuine conditional write may set it.

pub fn with_kv_cas_fenced(self, on: bool) -> Self

Advertise fenced compare-and-swap on the KV surface (AGDX_KV_CAS_FENCED). Only a backend that gates a write on a live fence sequence may set it.

pub fn with_query_consistency(self, level: Consistency) -> Self

Advertise the strongest read-consistency the query surface serves.

pub fn from_versions(enabled: bool, versions: OpVersions) -> Self

Build the HTTP capabilities from the same OpVersions the binary AGDX_HELLO probe answers with, reading the per-surface sub-features straight off its features bitset and graph op version. A server SHOULD use this so its two capability carriages (the binary features bits and these HTTP fields) cannot disagree: the one source drives both.

Trait Implementations

impl Clone for Capabilities

fn clone(&self) -> Capabilities

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Capabilities

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Capabilities

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Capabilities

impl PartialEq for Capabilities

fn eq(&self, other: &Capabilities) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Capabilities

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Capabilities