pub struct SessionConfig {
pub mcp_servers: BTreeMap<String, SessionMcpServerConfig>,
pub settings_overrides: Option<SessionSettingsOverrides>,
pub model_endpoint_transport_override: Option<SessionModelEndpointTransportOverride>,
pub max_tool_output_bytes: Option<u64>,
pub allowed_built_in_tools: Option<Vec<String>>,
pub admit_session_mcp_servers: Option<bool>,
pub developer_prompt: Option<String>,
}Expand description
The open configuration extension object shared by session/start and
session/resume.
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.
Fields§
§mcp_servers: BTreeMap<String, SessionMcpServerConfig>Native MCP servers added only to this session runtime.
settings_overrides: Option<SessionSettingsOverrides>Experimental: a flat settings patch composing for this session’s loads only. Secret-shaped keys fail the decode.
model_endpoint_transport_override: Option<SessionModelEndpointTransportOverride>Experimental: the model endpoint transport this session’s model consumers resolve against at load.
max_tool_output_bytes: Option<u64>Experimental: this session’s tool-output byte budget, as muse exec --max-tool-output-bytes sets it for a headless run. 0 means no limit;
a positive value must be at least 9. The budget applies only on a host
whose default-off tool_output_budget gate serves it: there, each
model-visible tool result, from workspace and MCP tools alike, is
bounded at this many bytes from the runtime’s construction. Other hosts
accept a valid value and ignore it.
allowed_built_in_tools: Option<Vec<String>>Experimental (owner decision: build tools and MCP first, design kt-2n1z):
the per-session built-in tool restriction on session/start and
session/resume: omitted = no restriction, [] = no built-in
tools, a non-empty list = exactly those tools. Names are exact,
case-sensitive built-in names; order is insignificant. This
decoder checks the SHAPE only. Until the last enforcing piece
lands, a host refuses any spelled member (P5, kt-kqr8).
admit_session_mcp_servers: Option<bool>Experimental: per-session admission of this session’s
config.mcpServers roster. Spelled true admits exactly that
roster; spelled false is withheld, spelled. Omitted keeps
today’s withheld behaviour. Explicit null and any non-boolean
fail the decode. Until the admission gate and its enforcing
pieces land, the doors refuse every spelled value
unconditionally, so no host can believe a roster was admitted.
developer_prompt: Option<String>Developer instructions for this session only, on session/start and
session/resume. The text is trimmed. A nonblank value replaces the
settings-derived developer instructions; an omitted member is no
override and keeps the full developer context. Explicit null and blank
text are the explicit clear (the Rust value is an empty string): no
override, and on a host that serves developer instructions they also
turn off the session’s suppressible developer context (the agent catalog
and the memory snapshot). Any other type fails the decode. A host that
does not serve developer instructions ignores a valid member.