Skip to main content

muse_code_sdk/msp/
capability.rs

1// @generated from the MSP stable schema and protocol sources; do not edit by hand.
2
3mod catch_all;
4
5/// A grantable capability name. Open: the experimental-only `rawLog` entry
6/// joins the stable domain as an additive open-enum extension when it graduates
7/// — closed would make that a retype.
8#[derive(Debug, Clone, PartialEq, Eq)]
9#[non_exhaustive]
10pub enum CapabilityName {
11    /// `session/userShell`.
12    UserShell,
13    /// Native MCP definitions supplied at session construction.
14    SessionMcp,
15    /// The opt-in `session/listChanged` row change stream: granted-by-default
16    /// delivery preference — the stream is emitted only on connections holding
17    /// this grant.
18    SessionListStream,
19    /// First-party feedback submission through the host: the host-policy gate
20    /// for `feedback/submit` — granted at `initialize` only when feedback is
21    /// allowed on the install, never by client identity.
22    Feedback,
23    /// Settings-driven computer-use setup: the gate for `computerUseSetup/*` —
24    /// granted at `initialize` only when computer use is offered on this host.
25    ComputerUseSetup,
26    /// Computer-use setup with no chat: `computerUseSetup/read` and `/start`
27    /// without `sessionId`, `computerUseSetup/check`, and the host's
28    /// `computerUseSetup/changed` — granted at `initialize` only when computer
29    /// use is offered and the host composes host setup.
30    ComputerUseHostSetup,
31    /// Whether this host can rename sessions: granted on request where the
32    /// session-name store exists (macOS, Linux; not the ephemeral profile),
33    /// never on Windows. Advisory: `session/rename` is not gated by it.
34    SessionRename,
35    /// Cross-session peer messaging and admission: the one gate for `peer/*`
36    /// and `admission/*` — granted at `initialize` iff the host serves the
37    /// plane (unix platform with registry access over a spawner-is-client or
38    /// same-user transport), refused on beyond-same-user transports.
39    /// Experimental-tier only: the per-variant stability strips it from the
40    /// stable render, like `rawLog` below.
41    PeerMessaging,
42    /// The raw-log altitude: the `log/*` record methods and `projection/*`; the
43    /// `log/physical*` export has its own `rawLogPhysical` grant.
44    /// Experimental-tier only: granted solely on connections that opted into
45    /// `experimentalApi`; a v1 host never grants it as a stable surface. The
46    /// per-variant stability strips it from the stable render, so the stable
47    /// bundle names it only in reserved tables.
48    RawLog,
49    /// The physical export: `log/physicalSubscribe`, `log/physicalFiles`,
50    /// `log/physicalUnsubscribe`. Experimental-tier only and independent of
51    /// `rawLog`: either can be withheld alone.
52    RawLogPhysical,
53    /// The socket daemon's vacate contract, revision 1: a client that requests
54    /// it re-resumes its sessions on the canonical socket after `vacated`, and
55    /// a granted connection counts as one that follows a vacate.
56    /// Experimental-tier only, because the contract's own words are; only the
57    /// socket daemon acts on it. A later revision of the contract takes a new
58    /// name.
59    DaemonVacate,
60    /// A value from a newer host, kept verbatim so an older client decodes the
61    /// rest of the message. Never construct it with a known word.
62    Unknown(String),
63}