CapabilityName

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.

Fields and variants

• "computerUseHostSetup"
• "computerUseSetup"
• "feedback"
• "sessionListStream"
• "sessionMcp"
• "sessionRename"
• "userShell"

Source

schema/msp/experimental/msp.schema.json#/types/CapabilityName

{
  "description": "A grantable capability name. Open: the experimental-only `rawLog` entry\njoins the stable domain as an additive open-enum extension when it graduates\n— closed would make that a retype.",
  "oneOf": [
    {
      "enum": [
        "userShell",
        "sessionMcp",
        "sessionListStream",
        "feedback",
        "computerUseSetup",
        "computerUseHostSetup",
        "sessionRename"
      ],
      "type": "string",
      "x-msp-openness": "open"
    },
    {
      "const": "peerMessaging",
      "description": "Cross-session peer messaging and admission:\nthe one gate for `peer/*` and `admission/*` — granted at\n`initialize` iff the host serves the plane (unix platform with\nregistry access over a spawner-is-client or same-user transport),\nrefused on beyond-same-user transports. Experimental-tier only: the per-variant stability strips it\nfrom the stable render, like `rawLog` below.",
      "type": "string",
      "x-msp-descriptor": "CapabilityName.peerMessaging",
      "x-msp-stability": "experimental"
    },
    {
      "const": "rawLog",
      "description": "The raw-log altitude: the `log/*` record methods and\n`projection/*`; the `log/physical*` export has its own\n`rawLogPhysical` grant (ADR 58371 D3). Experimental-tier only: granted\nsolely on connections that opted into `experimentalApi`; a v1 host\nnever grants it as a stable surface. The per-variant stability strips\nit from the stable render, so the stable bundle names it only in\nreserved tables.",
      "type": "string",
      "x-msp-descriptor": "CapabilityName.rawLog",
      "x-msp-stability": "experimental"
    },
    {
      "const": "rawLogPhysical",
      "description": "The physical export (ADR 58371 D3): `log/physicalSubscribe`,\n`log/physicalFiles`, `log/physicalUnsubscribe`. Experimental-tier\nonly and independent of `rawLog`: either can be withheld alone.",
      "type": "string",
      "x-msp-descriptor": "CapabilityName.rawLogPhysical",
      "x-msp-stability": "experimental"
    },
    {
      "const": "journal",
      "description": "The experimental `journal/*` surface: lets a client act as the\ndurable store for the host's session journal. Experimental tier\nonly, behind `experimentalApi`; not granted by default.",
      "type": "string",
      "x-msp-descriptor": "CapabilityName.journal",
      "x-msp-stability": "experimental"
    },
    {
      "const": "daemonVacate",
      "description": "The socket daemon's vacate contract, revision 1: a client that requests it re-resumes\nits sessions on the canonical socket after `vacated`, and a granted\nconnection counts as one that follows a vacate. Experimental-tier\nonly, because the contract's own words are (ADR 59770 D9); only the\nsocket daemon acts on it. A later revision of the contract takes a\nnew name.",
      "type": "string",
      "x-msp-descriptor": "CapabilityName.daemonVacate",
      "x-msp-stability": "experimental"
    }
  ],
  "x-msp-openness": "open"
}