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 experimental `journal/*` surface: lets a client act as the
54    /// durable store for the host's session journal. Experimental tier
55    /// only, behind `experimentalApi`; not granted by default.
56    Journal,
57    /// The socket daemon's vacate contract, revision 1: a client that requests
58    /// it re-resumes its sessions on the canonical socket after `vacated`, and
59    /// a granted connection counts as one that follows a vacate.
60    /// Experimental-tier only, because the contract's own words are; only the
61    /// socket daemon acts on it. A later revision of the contract takes a new
62    /// name.
63    DaemonVacate,
64    /// The serve process's launcher context in `InitializeResult`: a client
65    /// that requests it is told the invocation id and context the launcher
66    /// started this process with. Experimental-tier only; gates no method.
67    LaunchContext,
68    /// The Skill Provider: named only as `-32010`'s `data.capability` when a
69    /// connection without the effective `initialize` member `skillProvider`
70    /// sends `skillProvider/updated`. Never granted through
71    /// `requestedCapabilities`: the client declares it in
72    /// `capabilities.skillProvider` instead, so it is in no grantable list.
73    SkillProvider,
74    /// A value from a newer host, kept verbatim so an older client decodes the
75    /// rest of the message. Never construct it with a known word.
76    Unknown(String),
77}