Struct SessionCapabilities 

#[non_exhaustive]
pub struct SessionCapabilities {
    pub prompt: Option<PromptCapabilities>,
    pub mcp: Option<McpCapabilities>,
    pub load: Option<SessionLoadCapabilities>,
    pub list: Option<SessionListCapabilities>,
    pub delete: Option<SessionDeleteCapabilities>,
    pub additional_directories: Option<SessionAdditionalDirectoriesCapabilities>,
    pub fork: Option<SessionForkCapabilities>,
    pub resume: Option<SessionResumeCapabilities>,
    pub close: Option<SessionCloseCapabilities>,
    pub meta: Option<Map<String, Value>>,
}

Available on crate feature unstable_protocol_v2 only.

Session capabilities supported by the agent.

Supplying {} means the agent supports the baseline session methods: session/new, session/prompt, session/cancel, and session/update.

Agents that support sessions MAY support additional session methods, prompt content types, and MCP transports by specifying additional capabilities.

See protocol docs: Session Capabilities

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

prompt: Option<PromptCapabilities>

Prompt capabilities supported by the agent in session/prompt requests.

Optional. Omitted or null both mean the agent does not advertise any prompt extensions beyond the baseline text and resource-link content required by session/prompt.

mcp: Option<McpCapabilities>

MCP capabilities supported by the agent for session lifecycle requests.

Optional. Omitted or null both mean the agent does not advertise MCP server transport support for sessions.

load: Option<SessionLoadCapabilities>

Whether the agent supports session/load.

Optional. Omitted or null both mean the agent does not advertise support. Supplying {} means the agent supports loading sessions.

list: Option<SessionListCapabilities>

Whether the agent supports session/list.

delete: Option<SessionDeleteCapabilities>

Whether the agent supports session/delete.

Optional. Omitted or null both mean the agent does not advertise support. Supplying {} means the agent supports deleting sessions from session/list.

additional_directories: Option<SessionAdditionalDirectoriesCapabilities>

Whether the agent supports additionalDirectories on supported session lifecycle requests.

Agents that also support session/list may return SessionInfo.additionalDirectories to report the complete ordered additional-root list associated with a listed session.

fork: Option<SessionForkCapabilities>

Available on crate feature unstable_session_fork only.

UNSTABLE

This capability is not part of the spec yet, and may be removed or changed at any point.

Whether the agent supports session/fork.

resume: Option<SessionResumeCapabilities>

Whether the agent supports session/resume.

close: Option<SessionCloseCapabilities>

Whether the agent supports session/close.

meta: Option<Map<String, Value>>

The _meta property is reserved by ACP to allow clients and agents to attach additional metadata to their interactions. Implementations MUST NOT make assumptions about values at these keys.

See protocol docs: Extensibility

Implementations

impl SessionCapabilities

pub fn new() -> SessionCapabilities

Builds an empty SessionCapabilities; use builder methods to advertise supported sub-capabilities.

pub fn prompt( self, prompt: impl IntoOption<PromptCapabilities>, ) -> SessionCapabilities

Prompt capabilities supported by the agent in session/prompt requests.

Omitted or null both mean the agent does not advertise any prompt extensions beyond the baseline text and resource-link content required by session/prompt.

pub fn mcp(self, mcp: impl IntoOption<McpCapabilities>) -> SessionCapabilities

MCP capabilities supported by the agent for session lifecycle requests.

Omitted or null both mean the agent does not advertise MCP server transport support for sessions.

pub fn load( self, load: impl IntoOption<SessionLoadCapabilities>, ) -> SessionCapabilities

Whether the agent supports session/load.

Omitted or null both mean the agent does not advertise support. Supplying {} means the agent supports loading sessions.

pub fn list( self, list: impl IntoOption<SessionListCapabilities>, ) -> SessionCapabilities

Whether the agent supports session/list.

pub fn delete( self, delete: impl IntoOption<SessionDeleteCapabilities>, ) -> SessionCapabilities

Whether the agent supports session/delete.

Omitted or null both mean the agent does not advertise support. Supplying {} means the agent supports deleting sessions from session/list.

pub fn additional_directories( self, additional_directories: impl IntoOption<SessionAdditionalDirectoriesCapabilities>, ) -> SessionCapabilities

Whether the agent supports additionalDirectories on supported session lifecycle requests.

Agents that also support session/list may return SessionInfo.additionalDirectories to report the complete ordered additional-root list associated with a listed session.

pub fn fork( self, fork: impl IntoOption<SessionForkCapabilities>, ) -> SessionCapabilities

Available on crate feature unstable_session_fork only.

Whether the agent supports session/fork.

pub fn resume( self, resume: impl IntoOption<SessionResumeCapabilities>, ) -> SessionCapabilities

Whether the agent supports session/resume.

pub fn close( self, close: impl IntoOption<SessionCloseCapabilities>, ) -> SessionCapabilities

Whether the agent supports session/close.

pub fn meta( self, meta: impl IntoOption<Map<String, Value>>, ) -> SessionCapabilities

The _meta property is reserved by ACP to allow clients and agents to attach additional metadata to their interactions. Implementations MUST NOT make assumptions about values at these keys.

See protocol docs: Extensibility

impl SessionCapabilities

pub fn into_v1( self, ) -> Result<V1SessionCapabilityParts, ProtocolConversionError>

Converts these v2 draft session capabilities into the v1 capability fields they represent.

Errors

Returns ProtocolConversionError when any contained capability field cannot be represented in v1.

pub fn from_v1( session_capabilities: SessionCapabilities, prompt_capabilities: PromptCapabilities, load_session: bool, mcp_capabilities: McpCapabilities, ) -> Result<SessionCapabilities, ProtocolConversionError>

Builds v2 draft session capabilities from the v1 agent capability fields that now live under session in v2.

Errors

Returns ProtocolConversionError when any of the supplied v1 capability fields cannot be represented in v2.

Trait Implementations

impl Clone for SessionCapabilities

fn clone(&self) -> SessionCapabilities

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SessionCapabilities

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for SessionCapabilities

fn default() -> SessionCapabilities

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SessionCapabilities

fn deserialize<__D>( __deserializer: __D, ) -> Result<SessionCapabilities, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for SessionCapabilities

impl JsonSchema for SessionCapabilities

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for SessionCapabilities

fn eq(&self, other: &SessionCapabilities) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SessionCapabilities

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for SessionCapabilities