Skip to content
Developer Preview

SessionConfig

The open configuration extension object shared by session/start and session/resume (ADR 32760 D1).

Unknown keys are ignored on the wire, never rejected: the live decoder tolerates them, and no exported bundle carries additionalProperties: false. The Rust typed model’s deny_unknown_fields is internal and never exported — the closedness export applies nowhere, and the x-msp-closed opt-in mechanism stays inert. Recognized mcpServers values are typed and validated before they leave the wire boundary.

  • mcpServers
  • modelEndpointTransportOverride — Experimental
  • settingsOverrides — Experimental
Source

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

{
"description": "The open configuration extension object shared by `session/start` and\n`session/resume` (ADR 32760 D1).\n\nUnknown keys are ignored on the wire, never rejected: the live decoder\ntolerates them, and no exported bundle carries `additionalProperties:\nfalse`. The Rust typed model's `deny_unknown_fields` is internal and never\nexported — the closedness export applies nowhere, and the `x-msp-closed`\nopt-in mechanism stays inert. Recognized `mcpServers` values are typed and\nvalidated before they leave the wire boundary.",
"properties": {
"mcpServers": {
"additionalProperties": {
"$ref": "#/$defs/SessionMcpServerConfig"
},
"description": "Native MCP servers added only to this session runtime.",
"type": "object"
},
"modelEndpointTransportOverride": {
"$ref": "#/$defs/SessionModelEndpointTransportOverride",
"description": "Experimental: the model endpoint transport\nthis session's model consumers resolve against at load.",
"x-msp-descriptor": "SessionConfig.modelEndpointTransportOverride",
"x-msp-stability": "experimental"
},
"settingsOverrides": {
"$ref": "#/$defs/SessionSettingsOverrides",
"description": "Experimental: a flat settings patch composing\nfor this session's loads only. Secret-shaped keys fail the decode.",
"x-msp-descriptor": "SessionConfig.settingsOverrides",
"x-msp-stability": "experimental"
}
},
"type": "object"
}