#[non_exhaustive]pub enum CapabilityName {
UserShell,
SessionMcp,
SessionListStream,
Feedback,
ComputerUseSetup,
ComputerUseHostSetup,
SessionRename,
PeerMessaging,
RawLog,
RawLogPhysical,
DaemonVacate,
Unknown(String),
}Expand description
A grantable capability name. Open: the experimental-only rawLog entry
joins the stable domain as an additive open-enum extension when it graduates
— closed would make that a retype.
Variants (Non-exhaustive)§
This enum is marked as non-exhaustive
UserShell
session/userShell.
SessionMcp
Native MCP definitions supplied at session construction.
SessionListStream
The opt-in session/listChanged row change stream: granted-by-default
delivery preference — the stream is emitted only on connections holding
this grant.
Feedback
First-party feedback submission through the host: the host-policy gate
for feedback/submit — granted at initialize only when feedback is
allowed on the install, never by client identity.
ComputerUseSetup
Settings-driven computer-use setup: the gate for computerUseSetup/* —
granted at initialize only when computer use is offered on this host.
ComputerUseHostSetup
Computer-use setup with no chat: computerUseSetup/read and /start
without sessionId, computerUseSetup/check, and the host’s
computerUseSetup/changed — granted at initialize only when computer
use is offered and the host composes host setup.
SessionRename
Whether this host can rename sessions: granted on request where the
session-name store exists (macOS, Linux; not the ephemeral profile),
never on Windows. Advisory: session/rename is not gated by it.
PeerMessaging
Cross-session peer messaging and admission: the one gate for peer/*
and admission/* — granted at initialize iff the host serves the
plane (unix platform with registry access over a spawner-is-client or
same-user transport), refused on beyond-same-user transports.
Experimental-tier only: the per-variant stability strips it from the
stable render, like rawLog below.
RawLog
The raw-log altitude: the log/* record methods and projection/*; the
log/physical* export has its own rawLogPhysical grant.
Experimental-tier only: granted solely on connections that opted into
experimentalApi; a v1 host never grants it as a stable surface. The
per-variant stability strips it from the stable render, so the stable
bundle names it only in reserved tables.
RawLogPhysical
The physical export: log/physicalSubscribe, log/physicalFiles,
log/physicalUnsubscribe. Experimental-tier only and independent of
rawLog: either can be withheld alone.
DaemonVacate
The socket daemon’s vacate contract, revision 1: a client that requests
it re-resumes its sessions on the canonical socket after vacated, and
a granted connection counts as one that follows a vacate.
Experimental-tier only, because the contract’s own words are; only the
socket daemon acts on it. A later revision of the contract takes a new
name.
Unknown(String)
A value from a newer host, kept verbatim so an older client decodes the rest of the message. Never construct it with a known word.