Struct Capabilities 

pub struct Capabilities {
    pub schema_version: String,
    pub tier: String,
    pub version: String,
    pub features: CapabilityFeatures,
    pub models: CapabilityModels,
    pub permissions: CapabilityPermissions,
    pub hooks: CapabilityHooks,
    pub compaction: CapabilityCompaction,
    pub approval: CapabilityApproval,
    pub transcripts: CapabilityTranscripts,
    pub hnsw: CapabilityHnsw,
}

Top-level capabilities report for a running instance.

Schema versions:

• v1 (legacy, pre-v0.6.3.1): tier, version, features, models. Reachable via Accept-Capabilities: v1 (HTTP) or the MCP accept argument set to "v1". See CapabilitiesV1.
• v2 (v0.6.3.1 honesty patch): schema_version="2" plus the permissions, hooks, compaction, approval, transcripts blocks. v1 fields preserved at the same top-level paths — old clients that read v2 by name continue to work for the un-dropped fields. Default response shape.

v2 honesty patch (P1, v0.6.3.1):

• features.recall_mode_active and features.reranker_active are runtime state, not config-derived flags.
• features.memory_reflection is now a {planned, version, enabled} object, not a bool.
• compaction and transcripts carry the same planned-feature shape so operators can distinguish “disabled but built” from “not in this build.”
• permissions.mode = "advisory" until the enforcement gate ships in P4. Was "ask", which implied an active interactive loop.
• The following fields were removed because no backing implementation exists: permissions.rule_summary, hooks.by_event, approval.subscribers, approval.default_timeout_seconds.

Fields

schema_version: String

Schema-version discriminator. Always "2" since v0.6.3.

tier: String

version: String

features: CapabilityFeatures

models: CapabilityModels

permissions: CapabilityPermissions

Active permission/governance rules. Pre-P4 reports the count of namespaces that have a metadata.governance policy attached to their standard memory; the underlying permission system itself is P4 work.

hooks: CapabilityHooks

Registered hooks. Pre-v0.7 reports webhook subscriptions as a proxy (hook system itself is v0.7 Bucket 0).

compaction: CapabilityCompaction

Compaction state. v0.8 work — reports {planned, version, enabled} until the subsystem ships.

approval: CapabilityApproval

Approval API state. Reports the live count of pending actions from the existing pending_actions table.

transcripts: CapabilityTranscripts

Sidechain-transcript state. v0.7 Bucket 1.7 work — reports {planned, version, enabled} until the subsystem ships.

hnsw: CapabilityHnsw

v0.6.3.1 (P3, G2): HNSW vector-index health. Defaults to a quiet zero-state report; the MCP/HTTP capabilities wrapper overwrites with live process counters when the index module has run an eviction.

Implementations

impl Capabilities

pub fn to_v1(&self) -> CapabilitiesV1

Project the v2 report down to the legacy v1 shape. Used to honour Accept-Capabilities: v1 from older clients.

memory_reflection collapses from {planned, enabled} to a single bool (enabled value). All v2-only fields (recall_mode_active, reranker_active, permissions, hooks, compaction, approval, transcripts) are dropped.

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 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.