flymcprust-spec 0.1.1

// @generated by `cargo xtask codegen` from MCP spec revision 2026-07-28 (commit 271ecc9accafdd9b83a3c869fa67c22953b2af80).
// Do not edit by hand: change xtask/ or xtask/overrides/2026-07-28.toml instead.

//! Protocol types for MCP specification revision `2026-07-28`.
//!
//! Generated from the official `schema.json` and `schema.ts` (commit `271ecc9accafdd9b83a3c869fa67c22953b2af80`).
use serde::{Deserialize, Serialize};
/// The protocol revision these types describe.
pub const PROTOCOL_VERSION: &str = "2026-07-28";
/// JSON-RPC error codes defined by the schema.
pub mod error_codes {
    /// Error code of [`HeaderMismatchError`](super::HeaderMismatchError).
    pub const HEADER_MISMATCH_ERROR: i64 = -32020i64;
    /// Error code of [`InternalError`](super::InternalError).
    pub const INTERNAL_ERROR: i64 = -32603i64;
    /// Error code of [`InvalidParamsError`](super::InvalidParamsError).
    pub const INVALID_PARAMS_ERROR: i64 = -32602i64;
    /// Error code of [`InvalidRequestError`](super::InvalidRequestError).
    pub const INVALID_REQUEST_ERROR: i64 = -32600i64;
    /// Error code of [`MethodNotFoundError`](super::MethodNotFoundError).
    pub const METHOD_NOT_FOUND_ERROR: i64 = -32601i64;
    /// Error code of [`MissingRequiredClientCapabilityError`](super::MissingRequiredClientCapabilityError).
    pub const MISSING_REQUIRED_CLIENT_CAPABILITY_ERROR: i64 = -32021i64;
    /// Error code of [`ParseError`](super::ParseError).
    pub const PARSE_ERROR: i64 = -32700i64;
    /// Error code of [`UnsupportedProtocolVersionError`](super::UnsupportedProtocolVersionError).
    pub const UNSUPPORTED_PROTOCOL_VERSION_ERROR: i64 = -32022i64;
}
/// Method names defined by the schema.
pub mod methods {
    /// The `completion/complete` method.
    pub const COMPLETION_COMPLETE: &str = "completion/complete";
    /// The `elicitation/create` method.
    pub const ELICITATION_CREATE: &str = "elicitation/create";
    /// The `notifications/cancelled` method.
    pub const NOTIFICATIONS_CANCELLED: &str = "notifications/cancelled";
    /// The `notifications/message` method.
    pub const NOTIFICATIONS_MESSAGE: &str = "notifications/message";
    /// The `notifications/progress` method.
    pub const NOTIFICATIONS_PROGRESS: &str = "notifications/progress";
    /// The `notifications/prompts/list_changed` method.
    pub const NOTIFICATIONS_PROMPTS_LIST_CHANGED: &str = "notifications/prompts/list_changed";
    /// The `notifications/resources/list_changed` method.
    pub const NOTIFICATIONS_RESOURCES_LIST_CHANGED: &str = "notifications/resources/list_changed";
    /// The `notifications/resources/updated` method.
    pub const NOTIFICATIONS_RESOURCES_UPDATED: &str = "notifications/resources/updated";
    /// The `notifications/subscriptions/acknowledged` method.
    pub const NOTIFICATIONS_SUBSCRIPTIONS_ACKNOWLEDGED: &str =
        "notifications/subscriptions/acknowledged";
    /// The `notifications/tools/list_changed` method.
    pub const NOTIFICATIONS_TOOLS_LIST_CHANGED: &str = "notifications/tools/list_changed";
    /// The `prompts/get` method.
    pub const PROMPTS_GET: &str = "prompts/get";
    /// The `prompts/list` method.
    pub const PROMPTS_LIST: &str = "prompts/list";
    /// The `resources/list` method.
    pub const RESOURCES_LIST: &str = "resources/list";
    /// The `resources/read` method.
    pub const RESOURCES_READ: &str = "resources/read";
    /// The `resources/templates/list` method.
    pub const RESOURCES_TEMPLATES_LIST: &str = "resources/templates/list";
    /// The `roots/list` method.
    pub const ROOTS_LIST: &str = "roots/list";
    /// The `sampling/createMessage` method.
    pub const SAMPLING_CREATE_MESSAGE: &str = "sampling/createMessage";
    /// The `server/discover` method.
    pub const SERVER_DISCOVER: &str = "server/discover";
    /// The `subscriptions/listen` method.
    pub const SUBSCRIPTIONS_LISTEN: &str = "subscriptions/listen";
    /// The `tools/call` method.
    pub const TOOLS_CALL: &str = "tools/call";
    /// The `tools/list` method.
    pub const TOOLS_LIST: &str = "tools/list";
}
/// Optional annotations for the client. The client can use annotations to inform how objects are used or displayed
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct Annotations {
    /// Describes who the intended audience of this object or data is.
    ///
    /// It can include multiple entries to indicate content useful for multiple audiences (e.g., `["user", "assistant"]`).
    #[serde(rename = "audience", default, skip_serializing_if = "Option::is_none")]
    pub audience: Option<Vec<Role>>,
    /// The moment the resource was last modified, as an ISO 8601 formatted string.
    ///
    /// Should be an ISO 8601 formatted string (e.g., "2025-01-12T15:00:58Z").
    ///
    /// Examples: last activity timestamp in an open file, timestamp when the resource
    /// was attached, etc.
    #[serde(
        rename = "lastModified",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub last_modified: Option<String>,
    /// Describes how important this data is for operating the server.
    ///
    /// A value of 1 means "most important," and indicates that the data is
    /// effectively required, while 0 means "least important," and indicates that
    /// the data is entirely optional.
    #[serde(rename = "priority", default, skip_serializing_if = "Option::is_none")]
    pub priority: Option<f64>,
}
/// The constant `"array"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ArrayType {
    /// The constant `"array"`.
    #[default]
    #[serde(rename = "array")]
    Array,
}
impl ArrayType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "array";
}
/// Audio provided to or from an LLM.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct AudioContent {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional annotations for the client.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<Annotations>,
    /// The base64-encoded audio data.
    #[serde(rename = "data")]
    pub data: String,
    /// The MIME type of the audio. Different providers may support different audio types.
    #[serde(rename = "mimeType")]
    pub mime_type: String,
    #[serde(rename = "type")]
    pub r#type: AudioType,
}
impl AudioContent {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(data: String, mime_type: String) -> Self {
        Self {
            meta: None,
            annotations: None,
            data,
            mime_type,
            r#type: Default::default(),
        }
    }
}
/// The constant `"audio"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum AudioType {
    /// The constant `"audio"`.
    #[default]
    #[serde(rename = "audio")]
    Audio,
}
impl AudioType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "audio";
}
/// Base interface for metadata with name (identifier) and title (display name) properties.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct BaseMetadata {
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
}
impl BaseMetadata {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String) -> Self {
        Self { name, title: None }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct BlobResourceContents {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// A base64-encoded string representing the binary data of the item.
    #[serde(rename = "blob")]
    pub blob: String,
    /// The MIME type of this resource, if known.
    #[serde(rename = "mimeType", default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    /// The URI of this resource.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl BlobResourceContents {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(blob: String, uri: String) -> Self {
        Self {
            meta: None,
            blob,
            mime_type: None,
            uri,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct BooleanSchema {
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<bool>,
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: BooleanType,
}
/// The constant `"boolean"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum BooleanType {
    /// The constant `"boolean"`.
    #[default]
    #[serde(rename = "boolean")]
    Boolean,
}
impl BooleanType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "boolean";
}
/// Indicates the intended scope of the cached response, analogous to HTTP
/// `Cache-Control: public` vs `Cache-Control: private`.
///
/// - `"public"`: The response does not contain user-specific data. Any
///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
///  the response and serve it across authorization contexts.
/// - `"private"`: The response MAY be cached and reused only within the
///  same authorization context. Caches MUST NOT be shared across
///  authorization contexts (e.g., a different access token requires a
///  different cache).
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum CacheScope {
    /// `"private"`
    #[serde(rename = "private")]
    Private,
    /// `"public"`
    #[serde(rename = "public")]
    Public,
}
impl CacheScope {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Private => "private",
            Self::Public => "public",
        }
    }
}
/// A result that supports a time-to-live (TTL) hint for client-side caching.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CacheableResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the intended scope of the cached response, analogous to HTTP
    /// `Cache-Control: public` vs `Cache-Control: private`.
    ///
    /// - `"public"`: The response does not contain user-specific data. Any
    ///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
    ///  the response and serve it across authorization contexts.
    /// - `"private"`: The response MAY be cached and reused only within the
    ///  same authorization context. Caches MUST NOT be shared across
    ///  authorization contexts (e.g., a different access token requires a
    ///  different cache).
    #[serde(rename = "cacheScope")]
    pub cache_scope: CacheScope,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// A hint from the server indicating how long (in milliseconds) the
    /// client MAY cache this response before re-fetching. Semantics are
    /// analogous to HTTP Cache-Control max-age.
    ///
    /// - If 0, The response SHOULD be considered immediately stale,
    ///  The client MAY re-fetch every time the result is needed.
    /// - If positive, the client SHOULD consider the result fresh for this many
    ///  milliseconds after receiving the response.
    #[serde(rename = "ttlMs")]
    pub ttl_ms: u64,
}
impl CacheableResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(cache_scope: CacheScope, result_type: String, ttl_ms: u64) -> Self {
        Self {
            meta: None,
            cache_scope,
            result_type,
            ttl_ms,
        }
    }
}
/// Used by the client to invoke a tool provided by the server.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CallToolRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: ToolsCallMethod,
    #[serde(rename = "params")]
    pub params: CallToolRequestParams,
}
impl CallToolRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: CallToolRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `tools/call` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CallToolRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    /// Arguments to use for the tool call.
    #[serde(rename = "arguments", default, skip_serializing_if = "Option::is_none")]
    pub arguments: Option<serde_json::Map<String, serde_json::Value>>,
    #[serde(
        rename = "inputResponses",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub input_responses: Option<InputResponses>,
    /// The name of the tool.
    #[serde(rename = "name")]
    pub name: String,
    #[serde(
        rename = "requestState",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub request_state: Option<String>,
}
impl CallToolRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject, name: String) -> Self {
        Self {
            meta,
            arguments: None,
            input_responses: None,
            name,
            request_state: None,
        }
    }
}
/// The result returned by the server for a `CallToolRequesttools/call` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CallToolResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// A list of content objects that represent the unstructured result of the tool call.
    #[serde(rename = "content")]
    pub content: Vec<ContentBlock>,
    /// Whether the tool call ended in an error.
    ///
    /// If not set, this is assumed to be false (the call was successful).
    ///
    /// Any errors that originate from the tool SHOULD be reported inside the result
    /// object, with `isError` set to true, _not_ as an MCP protocol-level error
    /// response. Otherwise, the LLM would not be able to see that an error occurred
    /// and self-correct.
    ///
    /// However, any errors in _finding_ the tool, an error indicating that the
    /// server does not support tool calls, or any other exceptional conditions,
    /// should be reported as an MCP error response.
    #[serde(rename = "isError", default, skip_serializing_if = "Option::is_none")]
    pub is_error: Option<bool>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// An optional JSON value that represents the structured result of the tool call.
    ///
    /// This can be any JSON value (object, array, string, number, boolean, or null)
    /// that conforms to the tool's outputSchema if one is defined.
    #[serde(
        rename = "structuredContent",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub structured_content: Option<serde_json::Value>,
}
impl CallToolResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(content: Vec<ContentBlock>, result_type: String) -> Self {
        Self {
            meta: None,
            content,
            is_error: None,
            result_type,
            structured_content: None,
        }
    }
}
/// A successful response from the server for a `CallToolRequesttools/call` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CallToolResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: CallToolResultResponseResult,
}
impl CallToolResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: CallToolResultResponseResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum CallToolResultResponseResult {
    /// The [`InputRequiredResult`] variant.
    InputRequired(InputRequiredResult),
    /// The [`CallToolResult`] variant.
    CallTool(CallToolResult),
}
impl From<InputRequiredResult> for CallToolResultResponseResult {
    fn from(v: InputRequiredResult) -> Self {
        Self::InputRequired(v)
    }
}
impl From<CallToolResult> for CallToolResultResponseResult {
    fn from(v: CallToolResult) -> Self {
        Self::CallTool(v)
    }
}
impl<'de> Deserialize<'de> for CallToolResultResponseResult {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("resultType")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("input_required") => serde_json::from_value(value)
                .map(Self::InputRequired)
                .map_err(D::Error::custom),
            _ => serde_json::from_value(value)
                .map(Self::CallTool)
                .map_err(D::Error::custom),
        }
    }
}
/// This notification is sent by the client to indicate that it is cancelling a request it previously issued.
///
/// On stdio, the server also sends this notification, solely to terminate a `SubscriptionsListenRequestsubscriptions/listen` stream: it references the ID of the `subscriptions/listen` request that opened the stream. Servers MUST NOT use this notification to cancel any other request.
///
/// The request SHOULD still be in-flight, but due to communication latency, it is always possible that this notification MAY arrive after the request has already finished.
///
/// This notification indicates that the result will be unused, so any associated processing SHOULD cease.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CancelledNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsCancelledMethod,
    #[serde(rename = "params")]
    pub params: CancelledNotificationParams,
}
impl CancelledNotification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: CancelledNotificationParams) -> Self {
        Self {
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `notifications/cancelled` notification.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CancelledNotificationParams {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<NotificationMetaObject>,
    /// An optional string describing the reason for the cancellation. This MAY be logged or presented to the user.
    #[serde(rename = "reason", default, skip_serializing_if = "Option::is_none")]
    pub reason: Option<String>,
    /// The ID of the request to cancel.
    ///
    /// This MUST correspond to the ID of a request the client previously issued.
    #[serde(rename = "requestId")]
    pub request_id: RequestId,
}
impl CancelledNotificationParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(request_id: RequestId) -> Self {
        Self {
            meta: None,
            reason: None,
            request_id,
        }
    }
}
/// Capabilities a client may support. Known capabilities are defined here, in this schema, but this is not a closed set: any client can define its own, additional capabilities.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ClientCapabilities {
    /// Present if the client supports elicitation from the server.
    #[serde(
        rename = "elicitation",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub elicitation: Option<ClientCapabilitiesElicitation>,
    /// Experimental, non-standard capabilities that the client supports.
    #[serde(
        rename = "experimental",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub experimental:
        Option<std::collections::BTreeMap<String, serde_json::Map<String, serde_json::Value>>>,
    /// Optional MCP extensions that the client supports. Keys are extension identifiers
    /// (e.g., "io.modelcontextprotocol/oauth-client-credentials"), and values are
    /// per-extension settings objects. An empty object indicates support with no settings.
    ///
    /// Keys MUST follow the `MetaObject`_meta``, with a
    /// mandatory prefix.
    #[serde(
        rename = "extensions",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub extensions:
        Option<std::collections::BTreeMap<String, serde_json::Map<String, serde_json::Value>>>,
    /// Present if the client supports listing roots.
    #[deprecated(
        note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
    )]
    #[serde(rename = "roots", default, skip_serializing_if = "Option::is_none")]
    pub roots: Option<ClientCapabilitiesRoots>,
    /// Present if the client supports sampling from an LLM.
    #[deprecated(
        note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
    )]
    #[serde(rename = "sampling", default, skip_serializing_if = "Option::is_none")]
    pub sampling: Option<ClientCapabilitiesSampling>,
}
/// Present if the client supports elicitation from the server.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ClientCapabilitiesElicitation {
    #[serde(rename = "form", default, skip_serializing_if = "Option::is_none")]
    pub form: Option<serde_json::Map<String, serde_json::Value>>,
    #[serde(rename = "url", default, skip_serializing_if = "Option::is_none")]
    pub url: Option<serde_json::Map<String, serde_json::Value>>,
}
/// Present if the client supports listing roots.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ClientCapabilitiesRoots {}
/// Present if the client supports sampling from an LLM.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ClientCapabilitiesSampling {
    /// Whether the client supports context inclusion via `includeContext` parameter.
    /// If not declared, servers SHOULD only use `includeContext: "none"` (or omit it).
    #[serde(rename = "context", default, skip_serializing_if = "Option::is_none")]
    pub context: Option<serde_json::Map<String, serde_json::Value>>,
    /// Whether the client supports tool use via `tools` and `toolChoice` parameters.
    #[serde(rename = "tools", default, skip_serializing_if = "Option::is_none")]
    pub tools: Option<serde_json::Map<String, serde_json::Value>>,
}
/// This notification is sent by the client to indicate that it is cancelling a request it previously issued.
///
/// On stdio, the server also sends this notification, solely to terminate a `SubscriptionsListenRequestsubscriptions/listen` stream: it references the ID of the `subscriptions/listen` request that opened the stream. Servers MUST NOT use this notification to cancel any other request.
///
/// The request SHOULD still be in-flight, but due to communication latency, it is always possible that this notification MAY arrive after the request has already finished.
///
/// This notification indicates that the result will be unused, so any associated processing SHOULD cease.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ClientNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsCancelledMethod,
    #[serde(rename = "params")]
    pub params: CancelledNotificationParams,
}
impl ClientNotification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: CancelledNotificationParams) -> Self {
        Self {
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum ClientRequest {
    /// The [`DiscoverRequest`] variant.
    Discover(DiscoverRequest),
    /// The [`ListResourcesRequest`] variant.
    ListResources(ListResourcesRequest),
    /// The [`ListResourceTemplatesRequest`] variant.
    ListResourceTemplates(ListResourceTemplatesRequest),
    /// The [`ReadResourceRequest`] variant.
    ReadResource(ReadResourceRequest),
    /// The [`SubscriptionsListenRequest`] variant.
    SubscriptionsListen(SubscriptionsListenRequest),
    /// The [`ListPromptsRequest`] variant.
    ListPrompts(ListPromptsRequest),
    /// The [`GetPromptRequest`] variant.
    GetPrompt(GetPromptRequest),
    /// The [`ListToolsRequest`] variant.
    ListTools(ListToolsRequest),
    /// The [`CallToolRequest`] variant.
    CallTool(CallToolRequest),
    /// The [`CompleteRequest`] variant.
    Complete(CompleteRequest),
}
impl From<DiscoverRequest> for ClientRequest {
    fn from(v: DiscoverRequest) -> Self {
        Self::Discover(v)
    }
}
impl From<ListResourcesRequest> for ClientRequest {
    fn from(v: ListResourcesRequest) -> Self {
        Self::ListResources(v)
    }
}
impl From<ListResourceTemplatesRequest> for ClientRequest {
    fn from(v: ListResourceTemplatesRequest) -> Self {
        Self::ListResourceTemplates(v)
    }
}
impl From<ReadResourceRequest> for ClientRequest {
    fn from(v: ReadResourceRequest) -> Self {
        Self::ReadResource(v)
    }
}
impl From<SubscriptionsListenRequest> for ClientRequest {
    fn from(v: SubscriptionsListenRequest) -> Self {
        Self::SubscriptionsListen(v)
    }
}
impl From<ListPromptsRequest> for ClientRequest {
    fn from(v: ListPromptsRequest) -> Self {
        Self::ListPrompts(v)
    }
}
impl From<GetPromptRequest> for ClientRequest {
    fn from(v: GetPromptRequest) -> Self {
        Self::GetPrompt(v)
    }
}
impl From<ListToolsRequest> for ClientRequest {
    fn from(v: ListToolsRequest) -> Self {
        Self::ListTools(v)
    }
}
impl From<CallToolRequest> for ClientRequest {
    fn from(v: CallToolRequest) -> Self {
        Self::CallTool(v)
    }
}
impl From<CompleteRequest> for ClientRequest {
    fn from(v: CompleteRequest) -> Self {
        Self::Complete(v)
    }
}
impl<'de> Deserialize<'de> for ClientRequest {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("method")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("server/discover") => serde_json::from_value(value)
                .map(Self::Discover)
                .map_err(D::Error::custom),
            Some("resources/list") => serde_json::from_value(value)
                .map(Self::ListResources)
                .map_err(D::Error::custom),
            Some("resources/templates/list") => serde_json::from_value(value)
                .map(Self::ListResourceTemplates)
                .map_err(D::Error::custom),
            Some("resources/read") => serde_json::from_value(value)
                .map(Self::ReadResource)
                .map_err(D::Error::custom),
            Some("subscriptions/listen") => serde_json::from_value(value)
                .map(Self::SubscriptionsListen)
                .map_err(D::Error::custom),
            Some("prompts/list") => serde_json::from_value(value)
                .map(Self::ListPrompts)
                .map_err(D::Error::custom),
            Some("prompts/get") => serde_json::from_value(value)
                .map(Self::GetPrompt)
                .map_err(D::Error::custom),
            Some("tools/list") => serde_json::from_value(value)
                .map(Self::ListTools)
                .map_err(D::Error::custom),
            Some("tools/call") => serde_json::from_value(value)
                .map(Self::CallTool)
                .map_err(D::Error::custom),
            Some("completion/complete") => serde_json::from_value(value)
                .map(Self::Complete)
                .map_err(D::Error::custom),
            None => Err(D::Error::missing_field("method")),
            Some(other) => Err(D::Error::unknown_variant(
                other,
                &[
                    "server/discover",
                    "resources/list",
                    "resources/templates/list",
                    "resources/read",
                    "subscriptions/listen",
                    "prompts/list",
                    "prompts/get",
                    "tools/list",
                    "tools/call",
                    "completion/complete",
                ],
            )),
        }
    }
}
/// A request from the client to the server, to ask for completion options.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CompleteRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: CompletionCompleteMethod,
    #[serde(rename = "params")]
    pub params: CompleteRequestParams,
}
impl CompleteRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: CompleteRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `completion/complete` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CompleteRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    /// The argument's information
    #[serde(rename = "argument")]
    pub argument: CompleteRequestParamsArgument,
    /// Additional, optional context for completions
    #[serde(rename = "context", default, skip_serializing_if = "Option::is_none")]
    pub context: Option<CompleteRequestParamsContext>,
    #[serde(rename = "ref")]
    pub r#ref: CompleteRequestParamsRef,
}
impl CompleteRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        meta: RequestMetaObject,
        argument: CompleteRequestParamsArgument,
        r#ref: CompleteRequestParamsRef,
    ) -> Self {
        Self {
            meta,
            argument,
            context: None,
            r#ref,
        }
    }
}
/// The argument's information
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CompleteRequestParamsArgument {
    /// The name of the argument
    #[serde(rename = "name")]
    pub name: String,
    /// The value of the argument to use for completion matching.
    #[serde(rename = "value")]
    pub value: String,
}
impl CompleteRequestParamsArgument {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String, value: String) -> Self {
        Self { name, value }
    }
}
/// Additional, optional context for completions
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct CompleteRequestParamsContext {
    /// Previously-resolved variables in a URI template or prompt.
    #[serde(rename = "arguments", default, skip_serializing_if = "Option::is_none")]
    pub arguments: Option<std::collections::BTreeMap<String, String>>,
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum CompleteRequestParamsRef {
    /// The [`PromptReference`] variant.
    Prompt(PromptReference),
    /// The [`ResourceTemplateReference`] variant.
    ResourceTemplate(ResourceTemplateReference),
}
impl From<PromptReference> for CompleteRequestParamsRef {
    fn from(v: PromptReference) -> Self {
        Self::Prompt(v)
    }
}
impl From<ResourceTemplateReference> for CompleteRequestParamsRef {
    fn from(v: ResourceTemplateReference) -> Self {
        Self::ResourceTemplate(v)
    }
}
impl<'de> Deserialize<'de> for CompleteRequestParamsRef {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("type")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("ref/prompt") => serde_json::from_value(value)
                .map(Self::Prompt)
                .map_err(D::Error::custom),
            Some("ref/resource") => serde_json::from_value(value)
                .map(Self::ResourceTemplate)
                .map_err(D::Error::custom),
            None => Err(D::Error::missing_field("type")),
            Some(other) => Err(D::Error::unknown_variant(
                other,
                &["ref/prompt", "ref/resource"],
            )),
        }
    }
}
/// The result returned by the server for a `CompleteRequestcompletion/complete` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CompleteResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    #[serde(rename = "completion")]
    pub completion: CompleteResultCompletion,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
}
impl CompleteResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(completion: CompleteResultCompletion, result_type: String) -> Self {
        Self {
            meta: None,
            completion,
            result_type,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CompleteResultCompletion {
    /// Indicates whether there are additional completion options beyond those provided in the current response, even if the exact total is unknown.
    #[serde(rename = "hasMore", default, skip_serializing_if = "Option::is_none")]
    pub has_more: Option<bool>,
    /// The total number of completion options available. This can exceed the number of values actually sent in the response.
    #[serde(rename = "total", default, skip_serializing_if = "Option::is_none")]
    pub total: Option<i64>,
    /// An array of completion values. Must not exceed 100 items.
    #[serde(rename = "values")]
    pub values: Vec<String>,
}
impl CompleteResultCompletion {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(values: Vec<String>) -> Self {
        Self {
            has_more: None,
            total: None,
            values,
        }
    }
}
/// A successful response from the server for a `CompleteRequestcompletion/complete` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CompleteResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: CompleteResult,
}
impl CompleteResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: CompleteResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// The constant `"completion/complete"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum CompletionCompleteMethod {
    /// The constant `"completion/complete"`.
    #[default]
    #[serde(rename = "completion/complete")]
    CompletionComplete,
}
impl CompletionCompleteMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "completion/complete";
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum ContentBlock {
    /// The [`TextContent`] variant.
    TextContent(TextContent),
    /// The [`ImageContent`] variant.
    ImageContent(ImageContent),
    /// The [`AudioContent`] variant.
    AudioContent(AudioContent),
    /// The [`ResourceLink`] variant.
    ResourceLink(ResourceLink),
    /// The [`EmbeddedResource`] variant.
    EmbeddedResource(EmbeddedResource),
}
impl From<TextContent> for ContentBlock {
    fn from(v: TextContent) -> Self {
        Self::TextContent(v)
    }
}
impl From<ImageContent> for ContentBlock {
    fn from(v: ImageContent) -> Self {
        Self::ImageContent(v)
    }
}
impl From<AudioContent> for ContentBlock {
    fn from(v: AudioContent) -> Self {
        Self::AudioContent(v)
    }
}
impl From<ResourceLink> for ContentBlock {
    fn from(v: ResourceLink) -> Self {
        Self::ResourceLink(v)
    }
}
impl From<EmbeddedResource> for ContentBlock {
    fn from(v: EmbeddedResource) -> Self {
        Self::EmbeddedResource(v)
    }
}
impl<'de> Deserialize<'de> for ContentBlock {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("type")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("text") => serde_json::from_value(value)
                .map(Self::TextContent)
                .map_err(D::Error::custom),
            Some("image") => serde_json::from_value(value)
                .map(Self::ImageContent)
                .map_err(D::Error::custom),
            Some("audio") => serde_json::from_value(value)
                .map(Self::AudioContent)
                .map_err(D::Error::custom),
            Some("resource_link") => serde_json::from_value(value)
                .map(Self::ResourceLink)
                .map_err(D::Error::custom),
            Some("resource") => serde_json::from_value(value)
                .map(Self::EmbeddedResource)
                .map_err(D::Error::custom),
            None => Err(D::Error::missing_field("type")),
            Some(other) => Err(D::Error::unknown_variant(
                other,
                &["text", "image", "audio", "resource_link", "resource"],
            )),
        }
    }
}
/// A request from the server to sample an LLM via the client. The client has full discretion over which model to select. The client should also inform the user before beginning sampling, to allow them to inspect the request (human in the loop) and decide whether to approve it.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CreateMessageRequest {
    #[serde(rename = "method")]
    pub method: SamplingCreateMessageMethod,
    #[serde(rename = "params")]
    pub params: CreateMessageRequestParams,
}
impl CreateMessageRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: CreateMessageRequestParams) -> Self {
        Self {
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `sampling/createMessage` request.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CreateMessageRequestParams {
    /// A request to include context from one or more MCP servers (including the caller), to be attached to the prompt.
    /// The client MAY ignore this request.
    ///
    /// Default is `"none"`. The values `"thisServer"` and `"allServers"` are deprecated (SEP-2596): servers SHOULD
    /// omit this field or use `"none"`, and SHOULD only use the deprecated values if the client declares
    /// `ClientCapabilities.sampling.context`.
    #[deprecated(
        note = "The `\"thisServer\"` and `\"allServers\"` values are deprecated as of protocol version 2025-11-25 (SEP-2596) and will be removed no later than the Sampling feature itself (SEP-2577). Omit this field or use `\"none\"`."
    )]
    #[serde(
        rename = "includeContext",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub include_context: Option<CreateMessageRequestParamsIncludeContext>,
    /// The requested maximum number of tokens to sample (to prevent runaway completions).
    ///
    /// The client MAY choose to sample fewer tokens than the requested maximum.
    #[serde(rename = "maxTokens")]
    pub max_tokens: i64,
    #[serde(rename = "messages")]
    pub messages: Vec<SamplingMessage>,
    /// Optional metadata to pass through to the LLM provider. The format of this metadata is provider-specific.
    #[serde(rename = "metadata", default, skip_serializing_if = "Option::is_none")]
    pub metadata: Option<serde_json::Map<String, serde_json::Value>>,
    /// The server's preferences for which model to select. The client MAY ignore these preferences.
    #[serde(
        rename = "modelPreferences",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub model_preferences: Option<ModelPreferences>,
    #[serde(
        rename = "stopSequences",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub stop_sequences: Option<Vec<String>>,
    /// An optional system prompt the server wants to use for sampling. The client MAY modify or omit this prompt.
    #[serde(
        rename = "systemPrompt",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub system_prompt: Option<String>,
    #[serde(
        rename = "temperature",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub temperature: Option<f64>,
    /// Controls how the model uses tools.
    /// The client MUST return an error if this field is provided but `ClientCapabilities.sampling.tools` is not declared.
    /// Default is `{ mode: "auto" }`.
    #[serde(
        rename = "toolChoice",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub tool_choice: Option<ToolChoice>,
    /// Tools that the model may use during generation.
    /// The client MUST return an error if this field is provided but `ClientCapabilities.sampling.tools` is not declared.
    #[serde(rename = "tools", default, skip_serializing_if = "Option::is_none")]
    pub tools: Option<Vec<Tool>>,
}
impl CreateMessageRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(max_tokens: i64, messages: Vec<SamplingMessage>) -> Self {
        Self {
            include_context: None,
            max_tokens,
            messages,
            metadata: None,
            model_preferences: None,
            stop_sequences: None,
            system_prompt: None,
            temperature: None,
            tool_choice: None,
            tools: None,
        }
    }
}
/// A request to include context from one or more MCP servers (including the caller), to be attached to the prompt.
/// The client MAY ignore this request.
///
/// Default is `"none"`. The values `"thisServer"` and `"allServers"` are deprecated (SEP-2596): servers SHOULD
/// omit this field or use `"none"`, and SHOULD only use the deprecated values if the client declares
/// `ClientCapabilities.sampling.context`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum CreateMessageRequestParamsIncludeContext {
    /// `"allServers"`
    #[serde(rename = "allServers")]
    AllServers,
    /// `"none"`
    #[serde(rename = "none")]
    None,
    /// `"thisServer"`
    #[serde(rename = "thisServer")]
    ThisServer,
}
impl CreateMessageRequestParamsIncludeContext {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::AllServers => "allServers",
            Self::None => "none",
            Self::ThisServer => "thisServer",
        }
    }
}
/// The result returned by the client for a `CreateMessageRequestsampling/createMessage` request.
/// The client should inform the user before returning the sampled message, to allow them
/// to inspect the response (human in the loop) and decide whether to allow the server to see it.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct CreateMessageResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    #[serde(rename = "content")]
    pub content: CreateMessageResultContent,
    /// The name of the model that generated the message.
    #[serde(rename = "model")]
    pub model: String,
    #[serde(rename = "role")]
    pub role: Role,
    /// The reason why sampling stopped, if known.
    ///
    /// Standard values:
    /// - `"endTurn"`: Natural end of the assistant's turn
    /// - `"stopSequence"`: A stop sequence was encountered
    /// - `"maxTokens"`: Maximum token limit was reached
    /// - `"toolUse"`: The model wants to use one or more tools
    ///
    /// This field is an open string to allow for provider-specific stop reasons.
    #[serde(
        rename = "stopReason",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub stop_reason: Option<String>,
}
impl CreateMessageResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(content: CreateMessageResultContent, model: String, role: Role) -> Self {
        Self {
            meta: None,
            content,
            model,
            role,
            stop_reason: None,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum CreateMessageResultContent {
    /// The [`TextContent`] variant.
    TextContent(TextContent),
    /// The [`ImageContent`] variant.
    ImageContent(ImageContent),
    /// The [`AudioContent`] variant.
    AudioContent(AudioContent),
    /// The [`ToolUseContent`] variant.
    ToolUseContent(ToolUseContent),
    /// The [`ToolResultContent`] variant.
    ToolResultContent(ToolResultContent),
    /// An inline variant.
    List(Vec<SamplingMessageContentBlock>),
}
impl From<TextContent> for CreateMessageResultContent {
    fn from(v: TextContent) -> Self {
        Self::TextContent(v)
    }
}
impl From<ImageContent> for CreateMessageResultContent {
    fn from(v: ImageContent) -> Self {
        Self::ImageContent(v)
    }
}
impl From<AudioContent> for CreateMessageResultContent {
    fn from(v: AudioContent) -> Self {
        Self::AudioContent(v)
    }
}
impl From<ToolUseContent> for CreateMessageResultContent {
    fn from(v: ToolUseContent) -> Self {
        Self::ToolUseContent(v)
    }
}
impl From<ToolResultContent> for CreateMessageResultContent {
    fn from(v: ToolResultContent) -> Self {
        Self::ToolResultContent(v)
    }
}
impl From<Vec<SamplingMessageContentBlock>> for CreateMessageResultContent {
    fn from(v: Vec<SamplingMessageContentBlock>) -> Self {
        Self::List(v)
    }
}
/// An opaque token used to represent a cursor for pagination.
pub type Cursor = String;
/// A request from the client asking the server to advertise its supported
/// protocol versions, capabilities, and other metadata. Servers **MUST**
/// implement `server/discover`. Clients **MAY** call it but are not required
/// to — version negotiation can also happen inline via per-request `_meta`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct DiscoverRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: ServerDiscoverMethod,
    #[serde(rename = "params")]
    pub params: RequestParams,
}
impl DiscoverRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: RequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// The result returned by the server for a `DiscoverRequestserver/discover` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct DiscoverResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the intended scope of the cached response, analogous to HTTP
    /// `Cache-Control: public` vs `Cache-Control: private`.
    ///
    /// - `"public"`: The response does not contain user-specific data. Any
    ///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
    ///  the response and serve it across authorization contexts.
    /// - `"private"`: The response MAY be cached and reused only within the
    ///  same authorization context. Caches MUST NOT be shared across
    ///  authorization contexts (e.g., a different access token requires a
    ///  different cache).
    #[serde(rename = "cacheScope")]
    pub cache_scope: CacheScope,
    /// The capabilities of the server.
    #[serde(rename = "capabilities")]
    pub capabilities: ServerCapabilities,
    /// Natural-language guidance describing the server and its features.
    ///
    /// This can be used by clients to improve an LLM's understanding of
    /// available tools (e.g., by including it in a system prompt). It should
    /// focus on information that helps the model use the server effectively
    /// and should not duplicate information already in tool descriptions.
    #[serde(
        rename = "instructions",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub instructions: Option<String>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// MCP Protocol Versions this server supports. The client should choose a
    /// version from this list for use in subsequent requests.
    #[serde(rename = "supportedVersions")]
    pub supported_versions: Vec<String>,
    /// A hint from the server indicating how long (in milliseconds) the
    /// client MAY cache this response before re-fetching. Semantics are
    /// analogous to HTTP Cache-Control max-age.
    ///
    /// - If 0, The response SHOULD be considered immediately stale,
    ///  The client MAY re-fetch every time the result is needed.
    /// - If positive, the client SHOULD consider the result fresh for this many
    ///  milliseconds after receiving the response.
    #[serde(rename = "ttlMs")]
    pub ttl_ms: u64,
}
impl DiscoverResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        cache_scope: CacheScope,
        capabilities: ServerCapabilities,
        result_type: String,
        supported_versions: Vec<String>,
        ttl_ms: u64,
    ) -> Self {
        Self {
            meta: None,
            cache_scope,
            capabilities,
            instructions: None,
            result_type,
            supported_versions,
            ttl_ms,
        }
    }
}
/// A successful response from the server for a `DiscoverRequestserver/discover` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct DiscoverResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: DiscoverResult,
}
impl DiscoverResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: DiscoverResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// A request from the server to elicit additional information from the user via the client.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ElicitRequest {
    #[serde(rename = "method")]
    pub method: ElicitationCreateMethod,
    #[serde(rename = "params")]
    pub params: ElicitRequestParams,
}
impl ElicitRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: ElicitRequestParams) -> Self {
        Self {
            method: Default::default(),
            params,
        }
    }
}
/// The parameters for a request to elicit non-sensitive information from the user via a form in the client.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ElicitRequestFormParams {
    /// The message to present to the user describing what information is being requested.
    #[serde(rename = "message")]
    pub message: String,
    /// The elicitation mode.
    #[serde(rename = "mode", default, skip_serializing_if = "Option::is_none")]
    pub mode: Option<FormMode>,
    /// A restricted subset of JSON Schema.
    /// Only top-level properties are allowed, without nesting.
    #[serde(rename = "requestedSchema")]
    pub requested_schema: ElicitRequestFormParamsRequestedSchema,
}
impl ElicitRequestFormParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(message: String, requested_schema: ElicitRequestFormParamsRequestedSchema) -> Self {
        Self {
            message,
            mode: None,
            requested_schema,
        }
    }
}
/// A restricted subset of JSON Schema.
/// Only top-level properties are allowed, without nesting.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ElicitRequestFormParamsRequestedSchema {
    #[serde(rename = "$schema", default, skip_serializing_if = "Option::is_none")]
    pub schema: Option<String>,
    #[serde(rename = "properties")]
    pub properties: std::collections::BTreeMap<String, PrimitiveSchemaDefinition>,
    #[serde(rename = "required", default, skip_serializing_if = "Option::is_none")]
    pub required: Option<Vec<String>>,
    #[serde(rename = "type")]
    pub r#type: ObjectType,
}
impl ElicitRequestFormParamsRequestedSchema {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(properties: std::collections::BTreeMap<String, PrimitiveSchemaDefinition>) -> Self {
        Self {
            schema: None,
            properties,
            required: None,
            r#type: Default::default(),
        }
    }
}
/// The parameters for a request to elicit additional information from the user via the client.
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum ElicitRequestParams {
    /// The [`ElicitRequestFormParams`] variant.
    ElicitRequestForm(ElicitRequestFormParams),
    /// The [`ElicitRequestUrlParams`] variant.
    ElicitRequestUrl(ElicitRequestUrlParams),
}
impl From<ElicitRequestFormParams> for ElicitRequestParams {
    fn from(v: ElicitRequestFormParams) -> Self {
        Self::ElicitRequestForm(v)
    }
}
impl From<ElicitRequestUrlParams> for ElicitRequestParams {
    fn from(v: ElicitRequestUrlParams) -> Self {
        Self::ElicitRequestUrl(v)
    }
}
impl<'de> Deserialize<'de> for ElicitRequestParams {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("mode")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("form") => serde_json::from_value(value)
                .map(Self::ElicitRequestForm)
                .map_err(D::Error::custom),
            Some("url") => serde_json::from_value(value)
                .map(Self::ElicitRequestUrl)
                .map_err(D::Error::custom),
            None => serde_json::from_value(value)
                .map(Self::ElicitRequestForm)
                .map_err(D::Error::custom),
            Some(other) => Err(D::Error::unknown_variant(other, &["form", "url"])),
        }
    }
}
/// The parameters for a request to elicit information from the user via a URL in the client.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ElicitRequestUrlParams {
    /// The message to present to the user explaining why the interaction is needed.
    #[serde(rename = "message")]
    pub message: String,
    /// The elicitation mode.
    #[serde(rename = "mode")]
    pub mode: UrlMode,
    /// The URL that the user should navigate to.
    #[serde(rename = "url")]
    pub url: String,
}
impl ElicitRequestUrlParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(message: String, url: String) -> Self {
        Self {
            message,
            mode: Default::default(),
            url,
        }
    }
}
/// The result returned by the client for an `ElicitRequestelicitation/create` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ElicitResult {
    /// The user action in response to the elicitation.
    /// - `"accept"`: User submitted the form/confirmed the action
    /// - `"decline"`: User explicitly declined the action
    /// - `"cancel"`: User dismissed without making an explicit choice
    #[serde(rename = "action")]
    pub action: ElicitResultAction,
    /// The submitted form data, only present when action is `"accept"` and mode was `"form"`.
    /// Contains values matching the requested schema.
    /// Omitted for out-of-band mode responses.
    #[serde(rename = "content", default, skip_serializing_if = "Option::is_none")]
    pub content: Option<std::collections::BTreeMap<String, ElicitResultContentValue>>,
}
impl ElicitResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(action: ElicitResultAction) -> Self {
        Self {
            action,
            content: None,
        }
    }
}
/// The user action in response to the elicitation.
/// - `"accept"`: User submitted the form/confirmed the action
/// - `"decline"`: User explicitly declined the action
/// - `"cancel"`: User dismissed without making an explicit choice
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum ElicitResultAction {
    /// `"accept"`
    #[serde(rename = "accept")]
    Accept,
    /// `"cancel"`
    #[serde(rename = "cancel")]
    Cancel,
    /// `"decline"`
    #[serde(rename = "decline")]
    Decline,
}
impl ElicitResultAction {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Accept => "accept",
            Self::Cancel => "cancel",
            Self::Decline => "decline",
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum ElicitResultContentValue {
    /// An inline variant.
    List(Vec<String>),
    /// The [`ElicitResultContentValueScalar`] variant.
    Scalar(ElicitResultContentValueScalar),
}
impl From<Vec<String>> for ElicitResultContentValue {
    fn from(v: Vec<String>) -> Self {
        Self::List(v)
    }
}
impl From<ElicitResultContentValueScalar> for ElicitResultContentValue {
    fn from(v: ElicitResultContentValueScalar) -> Self {
        Self::Scalar(v)
    }
}
#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize)]
#[serde(untagged)]
pub enum ElicitResultContentValueScalar {
    /// A string value.
    String(String),
    /// An integer value.
    Integer(i64),
    /// A boolean value.
    Boolean(bool),
}
impl From<String> for ElicitResultContentValueScalar {
    fn from(v: String) -> Self {
        Self::String(v)
    }
}
impl From<&str> for ElicitResultContentValueScalar {
    fn from(v: &str) -> Self {
        Self::String(v.to_owned())
    }
}
impl From<i64> for ElicitResultContentValueScalar {
    fn from(v: i64) -> Self {
        Self::Integer(v)
    }
}
impl From<bool> for ElicitResultContentValueScalar {
    fn from(v: bool) -> Self {
        Self::Boolean(v)
    }
}
impl<'de> Deserialize<'de> for ElicitResultContentValueScalar {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        struct Visitor;
        impl serde::de::Visitor<'_> for Visitor {
            type Value = ElicitResultContentValueScalar;
            fn expecting(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
                f.write_str("a string or an integer or a boolean")
            }
            fn visit_str<E: serde::de::Error>(
                self,
                v: &str,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(ElicitResultContentValueScalar::String(v.to_owned()))
            }
            fn visit_string<E: serde::de::Error>(
                self,
                v: String,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(ElicitResultContentValueScalar::String(v))
            }
            fn visit_i64<E: serde::de::Error>(
                self,
                v: i64,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(ElicitResultContentValueScalar::Integer(v))
            }
            fn visit_u64<E: serde::de::Error>(
                self,
                v: u64,
            ) -> ::core::result::Result<Self::Value, E> {
                i64::try_from(v)
                    .map(ElicitResultContentValueScalar::Integer)
                    .map_err(|_| E::invalid_value(serde::de::Unexpected::Unsigned(v), &self))
            }
            #[allow(clippy::cast_possible_truncation, clippy::float_cmp)]
            fn visit_f64<E: serde::de::Error>(
                self,
                v: f64,
            ) -> ::core::result::Result<Self::Value, E> {
                const MAX_SAFE: f64 = 9_007_199_254_740_991.0;
                if v.fract() == 0.0 && (-MAX_SAFE..=MAX_SAFE).contains(&v) {
                    Ok(ElicitResultContentValueScalar::Integer(v as i64))
                } else {
                    Err(E::invalid_type(serde::de::Unexpected::Float(v), &self))
                }
            }
            fn visit_bool<E: serde::de::Error>(
                self,
                v: bool,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(ElicitResultContentValueScalar::Boolean(v))
            }
        }
        deserializer.deserialize_any(Visitor)
    }
}
/// The constant `"elicitation/create"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ElicitationCreateMethod {
    /// The constant `"elicitation/create"`.
    #[default]
    #[serde(rename = "elicitation/create")]
    ElicitationCreate,
}
impl ElicitationCreateMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "elicitation/create";
}
/// The contents of a resource, embedded into a prompt or tool call result.
///
/// It is up to the client how best to render embedded resources for the benefit
/// of the LLM and/or the user.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct EmbeddedResource {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional annotations for the client.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<Annotations>,
    #[serde(rename = "resource")]
    pub resource: EmbeddedResourceResource,
    #[serde(rename = "type")]
    pub r#type: ResourceType,
}
impl EmbeddedResource {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(resource: EmbeddedResourceResource) -> Self {
        Self {
            meta: None,
            annotations: None,
            resource,
            r#type: Default::default(),
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum EmbeddedResourceResource {
    /// The [`TextResourceContents`] variant.
    Text(TextResourceContents),
    /// The [`BlobResourceContents`] variant.
    Blob(BlobResourceContents),
}
impl From<TextResourceContents> for EmbeddedResourceResource {
    fn from(v: TextResourceContents) -> Self {
        Self::Text(v)
    }
}
impl From<BlobResourceContents> for EmbeddedResourceResource {
    fn from(v: BlobResourceContents) -> Self {
        Self::Blob(v)
    }
}
/// Common result fields.
pub type EmptyResult = Result;
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum EnumSchema {
    /// The [`UntitledSingleSelectEnumSchema`] variant.
    UntitledSingleSelect(UntitledSingleSelectEnumSchema),
    /// The [`TitledSingleSelectEnumSchema`] variant.
    TitledSingleSelect(TitledSingleSelectEnumSchema),
    /// The [`UntitledMultiSelectEnumSchema`] variant.
    UntitledMultiSelect(UntitledMultiSelectEnumSchema),
    /// The [`TitledMultiSelectEnumSchema`] variant.
    TitledMultiSelect(TitledMultiSelectEnumSchema),
    /// The [`LegacyTitledEnumSchema`] variant.
    LegacyTitled(LegacyTitledEnumSchema),
}
impl From<UntitledSingleSelectEnumSchema> for EnumSchema {
    fn from(v: UntitledSingleSelectEnumSchema) -> Self {
        Self::UntitledSingleSelect(v)
    }
}
impl From<TitledSingleSelectEnumSchema> for EnumSchema {
    fn from(v: TitledSingleSelectEnumSchema) -> Self {
        Self::TitledSingleSelect(v)
    }
}
impl From<UntitledMultiSelectEnumSchema> for EnumSchema {
    fn from(v: UntitledMultiSelectEnumSchema) -> Self {
        Self::UntitledMultiSelect(v)
    }
}
impl From<TitledMultiSelectEnumSchema> for EnumSchema {
    fn from(v: TitledMultiSelectEnumSchema) -> Self {
        Self::TitledMultiSelect(v)
    }
}
impl From<LegacyTitledEnumSchema> for EnumSchema {
    fn from(v: LegacyTitledEnumSchema) -> Self {
        Self::LegacyTitled(v)
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Error {
    /// The error type that occurred.
    #[serde(rename = "code")]
    pub code: i64,
    /// Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
    #[serde(rename = "data", default, skip_serializing_if = "Option::is_none")]
    pub data: Option<serde_json::Value>,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl Error {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, message: String) -> Self {
        Self {
            code,
            data: None,
            message,
        }
    }
}
/// The constant `"form"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum FormMode {
    /// The constant `"form"`.
    #[default]
    #[serde(rename = "form")]
    Form,
}
impl FormMode {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "form";
}
/// Used by the client to get a prompt provided by the server.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct GetPromptRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: PromptsGetMethod,
    #[serde(rename = "params")]
    pub params: GetPromptRequestParams,
}
impl GetPromptRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: GetPromptRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `prompts/get` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct GetPromptRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    /// Arguments to use for templating the prompt.
    #[serde(rename = "arguments", default, skip_serializing_if = "Option::is_none")]
    pub arguments: Option<std::collections::BTreeMap<String, String>>,
    #[serde(
        rename = "inputResponses",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub input_responses: Option<InputResponses>,
    /// The name of the prompt or prompt template.
    #[serde(rename = "name")]
    pub name: String,
    #[serde(
        rename = "requestState",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub request_state: Option<String>,
}
impl GetPromptRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject, name: String) -> Self {
        Self {
            meta,
            arguments: None,
            input_responses: None,
            name,
            request_state: None,
        }
    }
}
/// The result returned by the server for a `GetPromptRequestprompts/get` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct GetPromptResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// An optional description for the prompt.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    #[serde(rename = "messages")]
    pub messages: Vec<PromptMessage>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
}
impl GetPromptResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(messages: Vec<PromptMessage>, result_type: String) -> Self {
        Self {
            meta: None,
            description: None,
            messages,
            result_type,
        }
    }
}
/// A successful response from the server for a `GetPromptRequestprompts/get` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct GetPromptResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: GetPromptResultResponseResult,
}
impl GetPromptResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: GetPromptResultResponseResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum GetPromptResultResponseResult {
    /// The [`InputRequiredResult`] variant.
    InputRequired(InputRequiredResult),
    /// The [`GetPromptResult`] variant.
    GetPrompt(GetPromptResult),
}
impl From<InputRequiredResult> for GetPromptResultResponseResult {
    fn from(v: InputRequiredResult) -> Self {
        Self::InputRequired(v)
    }
}
impl From<GetPromptResult> for GetPromptResultResponseResult {
    fn from(v: GetPromptResult) -> Self {
        Self::GetPrompt(v)
    }
}
impl<'de> Deserialize<'de> for GetPromptResultResponseResult {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("resultType")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("input_required") => serde_json::from_value(value)
                .map(Self::InputRequired)
                .map_err(D::Error::custom),
            _ => serde_json::from_value(value)
                .map(Self::GetPrompt)
                .map_err(D::Error::custom),
        }
    }
}
/// Returned when a server rejects a request because the values in the HTTP
/// headers do not match the corresponding values in the request body, or
/// because required headers are missing or malformed. For HTTP, the response
/// status code MUST be `400 Bad Request`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct HeaderMismatchError {
    #[serde(rename = "error")]
    pub error: HeaderMismatchErrorObject,
    #[serde(rename = "id", default, skip_serializing_if = "Option::is_none")]
    pub id: Option<RequestId>,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
}
impl HeaderMismatchError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(error: HeaderMismatchErrorObject) -> Self {
        Self {
            error,
            id: None,
            jsonrpc: Default::default(),
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct HeaderMismatchErrorObject {
    #[serde(rename = "code")]
    pub code: i64,
    /// Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
    #[serde(rename = "data", default, skip_serializing_if = "Option::is_none")]
    pub data: Option<serde_json::Value>,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl HeaderMismatchErrorObject {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, message: String) -> Self {
        Self {
            code,
            data: None,
            message,
        }
    }
}
/// An optionally-sized icon that can be displayed in a user interface.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Icon {
    /// Optional MIME type override if the source MIME type is missing or generic.
    /// For example: `"image/png"`, `"image/jpeg"`, or `"image/svg+xml"`.
    #[serde(rename = "mimeType", default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    /// Optional array of strings that specify sizes at which the icon can be used.
    /// Each string should be in WxH format (e.g., `"48x48"`, `"96x96"`) or `"any"` for scalable formats like SVG.
    ///
    /// If not provided, the client should assume that the icon can be used at any size.
    #[serde(rename = "sizes", default, skip_serializing_if = "Option::is_none")]
    pub sizes: Option<Vec<String>>,
    /// A standard URI pointing to an icon resource. May be an HTTP/HTTPS URL or a
    /// `data:` URI with Base64-encoded image data.
    ///
    /// Consumers SHOULD take steps to ensure URLs serving icons are from the
    /// same domain as the client/server or a trusted domain.
    ///
    /// Consumers SHOULD take appropriate precautions when consuming SVGs as they can contain
    /// executable JavaScript.
    #[serde(rename = "src")]
    pub src: String,
    /// Optional specifier for the theme this icon is designed for. `"light"` indicates
    /// the icon is designed to be used with a light background, and `"dark"` indicates
    /// the icon is designed to be used with a dark background.
    ///
    /// If not provided, the client should assume the icon can be used with any theme.
    #[serde(rename = "theme", default, skip_serializing_if = "Option::is_none")]
    pub theme: Option<IconTheme>,
}
impl Icon {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(src: String) -> Self {
        Self {
            mime_type: None,
            sizes: None,
            src,
            theme: None,
        }
    }
}
/// Optional specifier for the theme this icon is designed for. `"light"` indicates
/// the icon is designed to be used with a light background, and `"dark"` indicates
/// the icon is designed to be used with a dark background.
///
/// If not provided, the client should assume the icon can be used with any theme.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum IconTheme {
    /// `"dark"`
    #[serde(rename = "dark")]
    Dark,
    /// `"light"`
    #[serde(rename = "light")]
    Light,
}
impl IconTheme {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Dark => "dark",
            Self::Light => "light",
        }
    }
}
/// Base interface to add `icons` property.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct Icons {
    /// Optional set of sized icons that the client can display in a user interface.
    ///
    /// Clients that support rendering icons MUST support at least the following MIME types:
    /// - `image/png` - PNG images (safe, universal compatibility)
    /// - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
    ///
    /// Clients that support rendering icons SHOULD also support:
    /// - `image/svg+xml` - SVG images (scalable but requires security precautions)
    /// - `image/webp` - WebP images (modern, efficient format)
    #[serde(rename = "icons", default, skip_serializing_if = "Option::is_none")]
    pub icons: Option<Vec<Icon>>,
}
/// An image provided to or from an LLM.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ImageContent {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional annotations for the client.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<Annotations>,
    /// The base64-encoded image data.
    #[serde(rename = "data")]
    pub data: String,
    /// The MIME type of the image. Different providers may support different image types.
    #[serde(rename = "mimeType")]
    pub mime_type: String,
    #[serde(rename = "type")]
    pub r#type: ImageType,
}
impl ImageContent {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(data: String, mime_type: String) -> Self {
        Self {
            meta: None,
            annotations: None,
            data,
            mime_type,
            r#type: Default::default(),
        }
    }
}
/// The constant `"image"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ImageType {
    /// The constant `"image"`.
    #[default]
    #[serde(rename = "image")]
    Image,
}
impl ImageType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "image";
}
/// Describes the MCP implementation.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Implementation {
    /// An optional human-readable description of what this implementation does.
    ///
    /// This can be used by clients or servers to provide context about their purpose
    /// and capabilities. For example, a server might describe the types of resources
    /// or tools it provides, while a client might describe its intended use case.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Optional set of sized icons that the client can display in a user interface.
    ///
    /// Clients that support rendering icons MUST support at least the following MIME types:
    /// - `image/png` - PNG images (safe, universal compatibility)
    /// - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
    ///
    /// Clients that support rendering icons SHOULD also support:
    /// - `image/svg+xml` - SVG images (scalable but requires security precautions)
    /// - `image/webp` - WebP images (modern, efficient format)
    #[serde(rename = "icons", default, skip_serializing_if = "Option::is_none")]
    pub icons: Option<Vec<Icon>>,
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The version of this implementation.
    #[serde(rename = "version")]
    pub version: String,
    /// An optional URL of the website for this implementation.
    #[serde(
        rename = "websiteUrl",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub website_url: Option<String>,
}
impl Implementation {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String, version: String) -> Self {
        Self {
            description: None,
            icons: None,
            name,
            title: None,
            version,
            website_url: None,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum InputRequest {
    /// The [`CreateMessageRequest`] variant.
    CreateMessage(CreateMessageRequest),
    /// The [`ListRootsRequest`] variant.
    ListRoots(ListRootsRequest),
    /// The [`ElicitRequest`] variant.
    Elicit(ElicitRequest),
}
impl From<CreateMessageRequest> for InputRequest {
    fn from(v: CreateMessageRequest) -> Self {
        Self::CreateMessage(v)
    }
}
impl From<ListRootsRequest> for InputRequest {
    fn from(v: ListRootsRequest) -> Self {
        Self::ListRoots(v)
    }
}
impl From<ElicitRequest> for InputRequest {
    fn from(v: ElicitRequest) -> Self {
        Self::Elicit(v)
    }
}
impl<'de> Deserialize<'de> for InputRequest {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("method")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("sampling/createMessage") => serde_json::from_value(value)
                .map(Self::CreateMessage)
                .map_err(D::Error::custom),
            Some("roots/list") => serde_json::from_value(value)
                .map(Self::ListRoots)
                .map_err(D::Error::custom),
            Some("elicitation/create") => serde_json::from_value(value)
                .map(Self::Elicit)
                .map_err(D::Error::custom),
            None => Err(D::Error::missing_field("method")),
            Some(other) => Err(D::Error::unknown_variant(
                other,
                &["sampling/createMessage", "roots/list", "elicitation/create"],
            )),
        }
    }
}
/// A map of server-initiated requests that the client must fulfill.
/// Keys are server-assigned identifiers; values are the request objects.
pub type InputRequests = std::collections::BTreeMap<String, InputRequest>;
/// An InputRequiredResult sent by the server to indicate that additional input is needed
/// before the request can be completed.
///
/// At least one of `inputRequests` or `requestState` MUST be present.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct InputRequiredResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    #[serde(
        rename = "inputRequests",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub input_requests: Option<InputRequests>,
    #[serde(
        rename = "requestState",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub request_state: Option<String>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
}
impl InputRequiredResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(result_type: String) -> Self {
        Self {
            meta: None,
            input_requests: None,
            request_state: None,
            result_type,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum InputResponse {
    /// The [`CreateMessageResult`] variant.
    CreateMessage(CreateMessageResult),
    /// The [`ListRootsResult`] variant.
    ListRoots(ListRootsResult),
    /// The [`ElicitResult`] variant.
    Elicit(ElicitResult),
}
impl From<CreateMessageResult> for InputResponse {
    fn from(v: CreateMessageResult) -> Self {
        Self::CreateMessage(v)
    }
}
impl From<ListRootsResult> for InputResponse {
    fn from(v: ListRootsResult) -> Self {
        Self::ListRoots(v)
    }
}
impl From<ElicitResult> for InputResponse {
    fn from(v: ElicitResult) -> Self {
        Self::Elicit(v)
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct InputResponseRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    #[serde(
        rename = "inputResponses",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub input_responses: Option<InputResponses>,
    #[serde(
        rename = "requestState",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub request_state: Option<String>,
}
impl InputResponseRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject) -> Self {
        Self {
            meta,
            input_responses: None,
            request_state: None,
        }
    }
}
/// A map of client responses to server-initiated requests.
/// Keys correspond to the keys in the `InputRequests` map;
/// values are the client's result for each request.
pub type InputResponses = std::collections::BTreeMap<String, InputResponse>;
/// A JSON-RPC error indicating that an internal error occurred on the receiver. This error is returned when the receiver encounters an unexpected condition that prevents it from fulfilling the request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct InternalError {
    /// The error type that occurred.
    #[serde(rename = "code")]
    pub code: i64,
    /// Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
    #[serde(rename = "data", default, skip_serializing_if = "Option::is_none")]
    pub data: Option<serde_json::Value>,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl InternalError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, message: String) -> Self {
        Self {
            code,
            data: None,
            message,
        }
    }
}
/// A JSON-RPC error indicating that the method parameters are invalid or malformed.
///
/// In MCP, this error is returned in various contexts when request parameters fail validation:
///
/// - **Tools**: Unknown tool name or invalid tool arguments
/// - **Prompts**: Unknown prompt name or missing required arguments
/// - **Pagination**: Invalid or expired cursor values
/// - **Logging**: Invalid log level
/// - **Elicitation**: Server requests an elicitation mode not declared in client capabilities
/// - **Sampling**: Missing tool result or tool results mixed with other content
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct InvalidParamsError {
    /// The error type that occurred.
    #[serde(rename = "code")]
    pub code: i64,
    /// Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
    #[serde(rename = "data", default, skip_serializing_if = "Option::is_none")]
    pub data: Option<serde_json::Value>,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl InvalidParamsError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, message: String) -> Self {
        Self {
            code,
            data: None,
            message,
        }
    }
}
/// A JSON-RPC error indicating that the request is not a valid request object. This error is returned when the message structure does not conform to the JSON-RPC 2.0 specification requirements for a request (e.g., missing required fields like `jsonrpc` or `method`, or using invalid types for these fields).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct InvalidRequestError {
    /// The error type that occurred.
    #[serde(rename = "code")]
    pub code: i64,
    /// Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
    #[serde(rename = "data", default, skip_serializing_if = "Option::is_none")]
    pub data: Option<serde_json::Value>,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl InvalidRequestError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, message: String) -> Self {
        Self {
            code,
            data: None,
            message,
        }
    }
}
/// A response to a request that indicates an error occurred.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct JsonRpcErrorResponse {
    #[serde(rename = "error")]
    pub error: Error,
    #[serde(rename = "id", default, skip_serializing_if = "Option::is_none")]
    pub id: Option<RequestId>,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
}
impl JsonRpcErrorResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(error: Error) -> Self {
        Self {
            error,
            id: None,
            jsonrpc: Default::default(),
        }
    }
}
/// Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum JsonRpcMessage {
    /// The [`JsonRpcRequest`] variant.
    JsonRpcRequest(JsonRpcRequest),
    /// The [`JsonRpcNotification`] variant.
    JsonRpcNotification(JsonRpcNotification),
    /// The [`JsonRpcResultResponse`] variant.
    JsonRpcResultResponse(JsonRpcResultResponse),
    /// The [`JsonRpcErrorResponse`] variant.
    JsonRpcErrorResponse(JsonRpcErrorResponse),
}
impl From<JsonRpcRequest> for JsonRpcMessage {
    fn from(v: JsonRpcRequest) -> Self {
        Self::JsonRpcRequest(v)
    }
}
impl From<JsonRpcNotification> for JsonRpcMessage {
    fn from(v: JsonRpcNotification) -> Self {
        Self::JsonRpcNotification(v)
    }
}
impl From<JsonRpcResultResponse> for JsonRpcMessage {
    fn from(v: JsonRpcResultResponse) -> Self {
        Self::JsonRpcResultResponse(v)
    }
}
impl From<JsonRpcErrorResponse> for JsonRpcMessage {
    fn from(v: JsonRpcErrorResponse) -> Self {
        Self::JsonRpcErrorResponse(v)
    }
}
/// A notification which does not expect a response.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct JsonRpcNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: String,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<serde_json::Map<String, serde_json::Value>>,
}
impl JsonRpcNotification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(method: String) -> Self {
        Self {
            jsonrpc: Default::default(),
            method,
            params: None,
        }
    }
}
/// A request that expects a response.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct JsonRpcRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: String,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<serde_json::Map<String, serde_json::Value>>,
}
impl JsonRpcRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, method: String) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method,
            params: None,
        }
    }
}
/// A response to a request, containing either the result or error.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum JsonRpcResponse {
    /// The [`JsonRpcResultResponse`] variant.
    JsonRpcResult(JsonRpcResultResponse),
    /// The [`JsonRpcErrorResponse`] variant.
    JsonRpcError(JsonRpcErrorResponse),
}
impl From<JsonRpcResultResponse> for JsonRpcResponse {
    fn from(v: JsonRpcResultResponse) -> Self {
        Self::JsonRpcResult(v)
    }
}
impl From<JsonRpcErrorResponse> for JsonRpcResponse {
    fn from(v: JsonRpcErrorResponse) -> Self {
        Self::JsonRpcError(v)
    }
}
/// A successful (non-error) response to a request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct JsonRpcResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: Result,
}
impl JsonRpcResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: Result) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// The constant `"2.0"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum JsonRpcVersion {
    /// The constant `"2.0"`.
    #[default]
    #[serde(rename = "2.0")]
    V20,
}
impl JsonRpcVersion {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "2.0";
}
/// Use `TitledSingleSelectEnumSchema` instead.
/// This interface will be removed in a future version.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct LegacyTitledEnumSchema {
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<String>,
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    #[serde(rename = "enum")]
    pub r#enum: Vec<String>,
    /// (Legacy) Display names for enum values.
    /// Non-standard according to JSON schema 2020-12.
    #[serde(rename = "enumNames", default, skip_serializing_if = "Option::is_none")]
    pub enum_names: Option<Vec<String>>,
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: StringType,
}
impl LegacyTitledEnumSchema {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(r#enum: Vec<String>) -> Self {
        Self {
            default: None,
            description: None,
            r#enum,
            enum_names: None,
            title: None,
            r#type: Default::default(),
        }
    }
}
/// Sent from the client to request a list of prompts and prompt templates the server has.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListPromptsRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: PromptsListMethod,
    #[serde(rename = "params")]
    pub params: PaginatedRequestParams,
}
impl ListPromptsRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: PaginatedRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// The result returned by the server for a `ListPromptsRequestprompts/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListPromptsResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the intended scope of the cached response, analogous to HTTP
    /// `Cache-Control: public` vs `Cache-Control: private`.
    ///
    /// - `"public"`: The response does not contain user-specific data. Any
    ///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
    ///  the response and serve it across authorization contexts.
    /// - `"private"`: The response MAY be cached and reused only within the
    ///  same authorization context. Caches MUST NOT be shared across
    ///  authorization contexts (e.g., a different access token requires a
    ///  different cache).
    #[serde(rename = "cacheScope")]
    pub cache_scope: CacheScope,
    /// An opaque token representing the pagination position after the last returned result.
    /// If present, there may be more results available.
    #[serde(
        rename = "nextCursor",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub next_cursor: Option<String>,
    #[serde(rename = "prompts")]
    pub prompts: Vec<Prompt>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// A hint from the server indicating how long (in milliseconds) the
    /// client MAY cache this response before re-fetching. Semantics are
    /// analogous to HTTP Cache-Control max-age.
    ///
    /// - If 0, The response SHOULD be considered immediately stale,
    ///  The client MAY re-fetch every time the result is needed.
    /// - If positive, the client SHOULD consider the result fresh for this many
    ///  milliseconds after receiving the response.
    #[serde(rename = "ttlMs")]
    pub ttl_ms: u64,
}
impl ListPromptsResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        cache_scope: CacheScope,
        prompts: Vec<Prompt>,
        result_type: String,
        ttl_ms: u64,
    ) -> Self {
        Self {
            meta: None,
            cache_scope,
            next_cursor: None,
            prompts,
            result_type,
            ttl_ms,
        }
    }
}
/// A successful response from the server for a `ListPromptsRequestprompts/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListPromptsResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: ListPromptsResult,
}
impl ListPromptsResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: ListPromptsResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// Sent from the client to request a list of resource templates the server has.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListResourceTemplatesRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: ResourcesTemplatesListMethod,
    #[serde(rename = "params")]
    pub params: PaginatedRequestParams,
}
impl ListResourceTemplatesRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: PaginatedRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// The result returned by the server for a `ListResourceTemplatesRequestresources/templates/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListResourceTemplatesResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the intended scope of the cached response, analogous to HTTP
    /// `Cache-Control: public` vs `Cache-Control: private`.
    ///
    /// - `"public"`: The response does not contain user-specific data. Any
    ///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
    ///  the response and serve it across authorization contexts.
    /// - `"private"`: The response MAY be cached and reused only within the
    ///  same authorization context. Caches MUST NOT be shared across
    ///  authorization contexts (e.g., a different access token requires a
    ///  different cache).
    #[serde(rename = "cacheScope")]
    pub cache_scope: CacheScope,
    /// An opaque token representing the pagination position after the last returned result.
    /// If present, there may be more results available.
    #[serde(
        rename = "nextCursor",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub next_cursor: Option<String>,
    #[serde(rename = "resourceTemplates")]
    pub resource_templates: Vec<ResourceTemplate>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// A hint from the server indicating how long (in milliseconds) the
    /// client MAY cache this response before re-fetching. Semantics are
    /// analogous to HTTP Cache-Control max-age.
    ///
    /// - If 0, The response SHOULD be considered immediately stale,
    ///  The client MAY re-fetch every time the result is needed.
    /// - If positive, the client SHOULD consider the result fresh for this many
    ///  milliseconds after receiving the response.
    #[serde(rename = "ttlMs")]
    pub ttl_ms: u64,
}
impl ListResourceTemplatesResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        cache_scope: CacheScope,
        resource_templates: Vec<ResourceTemplate>,
        result_type: String,
        ttl_ms: u64,
    ) -> Self {
        Self {
            meta: None,
            cache_scope,
            next_cursor: None,
            resource_templates,
            result_type,
            ttl_ms,
        }
    }
}
/// A successful response from the server for a `ListResourceTemplatesRequestresources/templates/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListResourceTemplatesResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: ListResourceTemplatesResult,
}
impl ListResourceTemplatesResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: ListResourceTemplatesResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// Sent from the client to request a list of resources the server has.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListResourcesRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: ResourcesListMethod,
    #[serde(rename = "params")]
    pub params: PaginatedRequestParams,
}
impl ListResourcesRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: PaginatedRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// The result returned by the server for a `ListResourcesRequestresources/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListResourcesResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the intended scope of the cached response, analogous to HTTP
    /// `Cache-Control: public` vs `Cache-Control: private`.
    ///
    /// - `"public"`: The response does not contain user-specific data. Any
    ///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
    ///  the response and serve it across authorization contexts.
    /// - `"private"`: The response MAY be cached and reused only within the
    ///  same authorization context. Caches MUST NOT be shared across
    ///  authorization contexts (e.g., a different access token requires a
    ///  different cache).
    #[serde(rename = "cacheScope")]
    pub cache_scope: CacheScope,
    /// An opaque token representing the pagination position after the last returned result.
    /// If present, there may be more results available.
    #[serde(
        rename = "nextCursor",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub next_cursor: Option<String>,
    #[serde(rename = "resources")]
    pub resources: Vec<Resource>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// A hint from the server indicating how long (in milliseconds) the
    /// client MAY cache this response before re-fetching. Semantics are
    /// analogous to HTTP Cache-Control max-age.
    ///
    /// - If 0, The response SHOULD be considered immediately stale,
    ///  The client MAY re-fetch every time the result is needed.
    /// - If positive, the client SHOULD consider the result fresh for this many
    ///  milliseconds after receiving the response.
    #[serde(rename = "ttlMs")]
    pub ttl_ms: u64,
}
impl ListResourcesResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        cache_scope: CacheScope,
        resources: Vec<Resource>,
        result_type: String,
        ttl_ms: u64,
    ) -> Self {
        Self {
            meta: None,
            cache_scope,
            next_cursor: None,
            resources,
            result_type,
            ttl_ms,
        }
    }
}
/// A successful response from the server for a `ListResourcesRequestresources/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListResourcesResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: ListResourcesResult,
}
impl ListResourcesResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: ListResourcesResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// Sent from the server to request a list of root URIs from the client. Roots allow
/// servers to ask for specific directories or files to operate on. A common example
/// for roots is providing a set of repositories or directories a server should operate
/// on.
///
/// This request is typically used when the server needs to understand the file system
/// structure or access specific locations that the client has permission to read from.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ListRootsRequest {
    #[serde(rename = "method")]
    pub method: RootsListMethod,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<ListRootsRequestParams>,
}
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ListRootsRequestParams {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
}
/// The result returned by the client for a `ListRootsRequestroots/list` request.
/// This result contains an array of `Root` objects, each representing a root directory
/// or file that the server can operate on.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListRootsResult {
    #[serde(rename = "roots")]
    pub roots: Vec<Root>,
}
impl ListRootsResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(roots: Vec<Root>) -> Self {
        Self { roots }
    }
}
/// Sent from the client to request a list of tools the server has.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListToolsRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: ToolsListMethod,
    #[serde(rename = "params")]
    pub params: PaginatedRequestParams,
}
impl ListToolsRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: PaginatedRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// The result returned by the server for a `ListToolsRequesttools/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListToolsResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the intended scope of the cached response, analogous to HTTP
    /// `Cache-Control: public` vs `Cache-Control: private`.
    ///
    /// - `"public"`: The response does not contain user-specific data. Any
    ///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
    ///  the response and serve it across authorization contexts.
    /// - `"private"`: The response MAY be cached and reused only within the
    ///  same authorization context. Caches MUST NOT be shared across
    ///  authorization contexts (e.g., a different access token requires a
    ///  different cache).
    #[serde(rename = "cacheScope")]
    pub cache_scope: CacheScope,
    /// An opaque token representing the pagination position after the last returned result.
    /// If present, there may be more results available.
    #[serde(
        rename = "nextCursor",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub next_cursor: Option<String>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    #[serde(rename = "tools")]
    pub tools: Vec<Tool>,
    /// A hint from the server indicating how long (in milliseconds) the
    /// client MAY cache this response before re-fetching. Semantics are
    /// analogous to HTTP Cache-Control max-age.
    ///
    /// - If 0, The response SHOULD be considered immediately stale,
    ///  The client MAY re-fetch every time the result is needed.
    /// - If positive, the client SHOULD consider the result fresh for this many
    ///  milliseconds after receiving the response.
    #[serde(rename = "ttlMs")]
    pub ttl_ms: u64,
}
impl ListToolsResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        cache_scope: CacheScope,
        result_type: String,
        tools: Vec<Tool>,
        ttl_ms: u64,
    ) -> Self {
        Self {
            meta: None,
            cache_scope,
            next_cursor: None,
            result_type,
            tools,
            ttl_ms,
        }
    }
}
/// A successful response from the server for a `ListToolsRequesttools/list` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ListToolsResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: ListToolsResult,
}
impl ListToolsResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: ListToolsResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// The severity of a log message.
///
/// These map to syslog message severities, as specified in RFC-5424:
/// https://datatracker.ietf.org/doc/html/rfc5424#section-6.2.1
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum LoggingLevel {
    /// `"alert"`
    #[serde(rename = "alert")]
    Alert,
    /// `"critical"`
    #[serde(rename = "critical")]
    Critical,
    /// `"debug"`
    #[serde(rename = "debug")]
    Debug,
    /// `"emergency"`
    #[serde(rename = "emergency")]
    Emergency,
    /// `"error"`
    #[serde(rename = "error")]
    Error,
    /// `"info"`
    #[serde(rename = "info")]
    Info,
    /// `"notice"`
    #[serde(rename = "notice")]
    Notice,
    /// `"warning"`
    #[serde(rename = "warning")]
    Warning,
}
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
impl LoggingLevel {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Alert => "alert",
            Self::Critical => "critical",
            Self::Debug => "debug",
            Self::Emergency => "emergency",
            Self::Error => "error",
            Self::Info => "info",
            Self::Notice => "notice",
            Self::Warning => "warning",
        }
    }
}
/// JSONRPCNotification of a log message passed from server to client. The client opts in by setting `"io.modelcontextprotocol/logLevel"` in a request's `_meta`.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct LoggingMessageNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsMessageMethod,
    #[serde(rename = "params")]
    pub params: LoggingMessageNotificationParams,
}
impl LoggingMessageNotification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: LoggingMessageNotificationParams) -> Self {
        Self {
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `notifications/message` notification.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct LoggingMessageNotificationParams {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<NotificationMetaObject>,
    /// The data to be logged, such as a string message or an object. Any JSON serializable type is allowed here.
    #[serde(rename = "data")]
    pub data: serde_json::Value,
    /// The severity of this log message.
    #[serde(rename = "level")]
    pub level: LoggingLevel,
    /// An optional name of the logger issuing this message.
    #[serde(rename = "logger", default, skip_serializing_if = "Option::is_none")]
    pub logger: Option<String>,
}
impl LoggingMessageNotificationParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(data: serde_json::Value, level: LoggingLevel) -> Self {
        Self {
            meta: None,
            data,
            level,
            logger: None,
        }
    }
}
/// Represents the contents of a `_meta` field, which clients and servers use to attach additional metadata to their interactions.
///
/// Certain key names are reserved by MCP for protocol-level metadata; implementations MUST NOT make assumptions about values at these keys. Additionally, specific schema definitions may reserve particular names for purpose-specific metadata, as declared in those definitions.
///
/// Valid keys have two segments:
///
/// **Prefix:**
/// - Optional — if specified, MUST be a series of _labels_ separated by dots (`.`), followed by a slash (`/`).
/// - Labels MUST start with a letter and end with a letter or digit. Interior characters may be letters, digits, or hyphens (`-`).
/// - Implementations SHOULD use reverse DNS notation (e.g., `com.example/` rather than `example.com/`).
/// - Any prefix where the second label is `modelcontextprotocol` or `mcp` is **reserved** for MCP use. For example: `io.modelcontextprotocol/`, `dev.mcp/`, `org.modelcontextprotocol.api/`, and `com.mcp.tools/` are all reserved. However, `com.example.mcp/` is NOT reserved, as the second label is `example`.
///
/// **Name:**
/// - Unless empty, MUST start and end with an alphanumeric character (`[a-z0-9A-Z]`).
/// - Interior characters may be alphanumeric, hyphens (`-`), underscores (`_`), or dots (`.`).
pub type MetaObject = serde_json::Map<String, serde_json::Value>;
/// A JSON-RPC error indicating that the requested method does not exist or is not available.
///
/// In MCP, a server returns this error when a client invokes a method the server does not implement — either a genuinely unknown method, or one gated behind a server capability the server did not advertise (e.g., calling `prompts/list` when the `prompts` capability was not advertised).
///
/// A request that requires a client capability the client did not declare is signalled instead by `MissingRequiredClientCapabilityError` (`-32021`).
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct MethodNotFoundError {
    /// The error type that occurred.
    #[serde(rename = "code")]
    pub code: i64,
    /// Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
    #[serde(rename = "data", default, skip_serializing_if = "Option::is_none")]
    pub data: Option<serde_json::Value>,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl MethodNotFoundError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, message: String) -> Self {
        Self {
            code,
            data: None,
            message,
        }
    }
}
/// Returned when processing a request requires a capability the client did not
/// declare in `clientCapabilities`. For HTTP, the response status code MUST be
/// `400 Bad Request`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct MissingRequiredClientCapabilityError {
    #[serde(rename = "error")]
    pub error: MissingRequiredClientCapabilityErrorObject,
    #[serde(rename = "id", default, skip_serializing_if = "Option::is_none")]
    pub id: Option<RequestId>,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
}
impl MissingRequiredClientCapabilityError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(error: MissingRequiredClientCapabilityErrorObject) -> Self {
        Self {
            error,
            id: None,
            jsonrpc: Default::default(),
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct MissingRequiredClientCapabilityErrorData {
    /// The capabilities the server requires from the client to process this request.
    #[serde(rename = "requiredCapabilities")]
    pub required_capabilities: ClientCapabilities,
}
impl MissingRequiredClientCapabilityErrorData {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(required_capabilities: ClientCapabilities) -> Self {
        Self {
            required_capabilities,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct MissingRequiredClientCapabilityErrorObject {
    #[serde(rename = "code")]
    pub code: i64,
    #[serde(rename = "data")]
    pub data: MissingRequiredClientCapabilityErrorData,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl MissingRequiredClientCapabilityErrorObject {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, data: MissingRequiredClientCapabilityErrorData, message: String) -> Self {
        Self {
            code,
            data,
            message,
        }
    }
}
/// Hints to use for model selection.
///
/// Keys not declared here are currently left unspecified by the spec and are up
/// to the client to interpret.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ModelHint {
    /// A hint for a model name.
    ///
    /// The client SHOULD treat this as a substring of a model name; for example:
    /// - `claude-3-5-sonnet` should match `claude-3-5-sonnet-20241022`
    /// - `sonnet` should match `claude-3-5-sonnet-20241022`, `claude-3-sonnet-20240229`, etc.
    /// - `claude` should match any Claude model
    ///
    /// The client MAY also map the string to a different provider's model name or a different model family, as long as it fills a similar niche; for example:
    /// - `gemini-1.5-flash` could match `claude-3-haiku-20240307`
    #[serde(rename = "name", default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
}
/// The server's preferences for model selection, requested of the client during sampling.
///
/// Because LLMs can vary along multiple dimensions, choosing the "best" model is
/// rarely straightforward.  Different models excel in different areas—some are
/// faster but less capable, others are more capable but more expensive, and so
/// on. This interface allows servers to express their priorities across multiple
/// dimensions to help clients make an appropriate selection for their use case.
///
/// These preferences are always advisory. The client MAY ignore them. It is also
/// up to the client to decide how to interpret these preferences and how to
/// balance them against other considerations.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ModelPreferences {
    /// How much to prioritize cost when selecting a model. A value of 0 means cost
    /// is not important, while a value of 1 means cost is the most important
    /// factor.
    #[serde(
        rename = "costPriority",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub cost_priority: Option<f64>,
    /// Optional hints to use for model selection.
    ///
    /// If multiple hints are specified, the client MUST evaluate them in order
    /// (such that the first match is taken).
    ///
    /// The client SHOULD prioritize these hints over the numeric priorities, but
    /// MAY still use the priorities to select from ambiguous matches.
    #[serde(rename = "hints", default, skip_serializing_if = "Option::is_none")]
    pub hints: Option<Vec<ModelHint>>,
    /// How much to prioritize intelligence and capabilities when selecting a
    /// model. A value of 0 means intelligence is not important, while a value of 1
    /// means intelligence is the most important factor.
    #[serde(
        rename = "intelligencePriority",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub intelligence_priority: Option<f64>,
    /// How much to prioritize sampling speed (latency) when selecting a model. A
    /// value of 0 means speed is not important, while a value of 1 means speed is
    /// the most important factor.
    #[serde(
        rename = "speedPriority",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub speed_priority: Option<f64>,
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum MultiSelectEnumSchema {
    /// The [`UntitledMultiSelectEnumSchema`] variant.
    Untitled(UntitledMultiSelectEnumSchema),
    /// The [`TitledMultiSelectEnumSchema`] variant.
    Titled(TitledMultiSelectEnumSchema),
}
impl From<UntitledMultiSelectEnumSchema> for MultiSelectEnumSchema {
    fn from(v: UntitledMultiSelectEnumSchema) -> Self {
        Self::Untitled(v)
    }
}
impl From<TitledMultiSelectEnumSchema> for MultiSelectEnumSchema {
    fn from(v: TitledMultiSelectEnumSchema) -> Self {
        Self::Titled(v)
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Notification {
    #[serde(rename = "method")]
    pub method: String,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<serde_json::Map<String, serde_json::Value>>,
}
impl Notification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(method: String) -> Self {
        Self {
            method,
            params: None,
        }
    }
}
/// Extends `MetaObject` with additional notification-specific fields. All key naming rules from `MetaObject` apply.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct NotificationMetaObject {
    /// Identifies the subscription stream a notification was delivered on. The
    /// server MUST include this key on every notification delivered via a
    /// `SubscriptionsListenRequestsubscriptions/listen` stream, so the
    /// client can correlate the notification with the originating subscription.
    /// The key is absent on notifications not delivered via a subscription
    /// stream (e.g. progress notifications for an in-flight request), which is
    /// why it is optional here.
    ///
    /// The value is the JSON-RPC ID of the `subscriptions/listen` request that
    /// opened the stream.
    #[serde(
        rename = "io.modelcontextprotocol/subscriptionId",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub subscription_id: Option<RequestId>,
    /// Additional properties not described by the schema.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}
/// Common params for any notification.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct NotificationParams {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<NotificationMetaObject>,
}
/// The constant `"notifications/cancelled"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsCancelledMethod {
    /// The constant `"notifications/cancelled"`.
    #[default]
    #[serde(rename = "notifications/cancelled")]
    NotificationsCancelled,
}
impl NotificationsCancelledMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/cancelled";
}
/// The constant `"notifications/message"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsMessageMethod {
    /// The constant `"notifications/message"`.
    #[default]
    #[serde(rename = "notifications/message")]
    NotificationsMessage,
}
impl NotificationsMessageMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/message";
}
/// The constant `"notifications/progress"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsProgressMethod {
    /// The constant `"notifications/progress"`.
    #[default]
    #[serde(rename = "notifications/progress")]
    NotificationsProgress,
}
impl NotificationsProgressMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/progress";
}
/// The constant `"notifications/prompts/list_changed"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsPromptsListChangedMethod {
    /// The constant `"notifications/prompts/list_changed"`.
    #[default]
    #[serde(rename = "notifications/prompts/list_changed")]
    NotificationsPromptsListChanged,
}
impl NotificationsPromptsListChangedMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/prompts/list_changed";
}
/// The constant `"notifications/resources/list_changed"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsResourcesListChangedMethod {
    /// The constant `"notifications/resources/list_changed"`.
    #[default]
    #[serde(rename = "notifications/resources/list_changed")]
    NotificationsResourcesListChanged,
}
impl NotificationsResourcesListChangedMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/resources/list_changed";
}
/// The constant `"notifications/resources/updated"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsResourcesUpdatedMethod {
    /// The constant `"notifications/resources/updated"`.
    #[default]
    #[serde(rename = "notifications/resources/updated")]
    NotificationsResourcesUpdated,
}
impl NotificationsResourcesUpdatedMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/resources/updated";
}
/// The constant `"notifications/subscriptions/acknowledged"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsSubscriptionsAcknowledgedMethod {
    /// The constant `"notifications/subscriptions/acknowledged"`.
    #[default]
    #[serde(rename = "notifications/subscriptions/acknowledged")]
    NotificationsSubscriptionsAcknowledged,
}
impl NotificationsSubscriptionsAcknowledgedMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/subscriptions/acknowledged";
}
/// The constant `"notifications/tools/list_changed"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum NotificationsToolsListChangedMethod {
    /// The constant `"notifications/tools/list_changed"`.
    #[default]
    #[serde(rename = "notifications/tools/list_changed")]
    NotificationsToolsListChanged,
}
impl NotificationsToolsListChangedMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "notifications/tools/list_changed";
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct NumberSchema {
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<f64>,
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    #[serde(rename = "maximum", default, skip_serializing_if = "Option::is_none")]
    pub maximum: Option<f64>,
    #[serde(rename = "minimum", default, skip_serializing_if = "Option::is_none")]
    pub minimum: Option<f64>,
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: NumberSchemaType,
}
impl NumberSchema {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(r#type: NumberSchemaType) -> Self {
        Self {
            default: None,
            description: None,
            maximum: None,
            minimum: None,
            title: None,
            r#type,
        }
    }
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum NumberSchemaType {
    /// `"integer"`
    #[serde(rename = "integer")]
    Integer,
    /// `"number"`
    #[serde(rename = "number")]
    Number,
}
impl NumberSchemaType {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Integer => "integer",
            Self::Number => "number",
        }
    }
}
/// The constant `"object"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ObjectType {
    /// The constant `"object"`.
    #[default]
    #[serde(rename = "object")]
    Object,
}
impl ObjectType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "object";
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PaginatedRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: String,
    #[serde(rename = "params")]
    pub params: PaginatedRequestParams,
}
impl PaginatedRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, method: String, params: PaginatedRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method,
            params,
        }
    }
}
/// Common params for paginated requests.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PaginatedRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    /// An opaque token representing the current pagination position.
    /// If provided, the server should return results starting after this cursor.
    #[serde(rename = "cursor", default, skip_serializing_if = "Option::is_none")]
    pub cursor: Option<String>,
}
impl PaginatedRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject) -> Self {
        Self { meta, cursor: None }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PaginatedResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// An opaque token representing the pagination position after the last returned result.
    /// If present, there may be more results available.
    #[serde(
        rename = "nextCursor",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub next_cursor: Option<String>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
}
impl PaginatedResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(result_type: String) -> Self {
        Self {
            meta: None,
            next_cursor: None,
            result_type,
        }
    }
}
/// A JSON-RPC error indicating that invalid JSON was received by the server. This error is returned when the server cannot parse the JSON text of a message.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ParseError {
    /// The error type that occurred.
    #[serde(rename = "code")]
    pub code: i64,
    /// Additional information about the error. The value of this member is defined by the sender (e.g. detailed error information, nested errors etc.).
    #[serde(rename = "data", default, skip_serializing_if = "Option::is_none")]
    pub data: Option<serde_json::Value>,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl ParseError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, message: String) -> Self {
        Self {
            code,
            data: None,
            message,
        }
    }
}
/// Restricted schema definitions that only allow primitive types
/// without nested objects or arrays.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum PrimitiveSchemaDefinition {
    /// The [`StringSchema`] variant.
    String(StringSchema),
    /// The [`NumberSchema`] variant.
    Number(NumberSchema),
    /// The [`BooleanSchema`] variant.
    Boolean(BooleanSchema),
    /// The [`UntitledSingleSelectEnumSchema`] variant.
    UntitledSingleSelectEnum(UntitledSingleSelectEnumSchema),
    /// The [`TitledSingleSelectEnumSchema`] variant.
    TitledSingleSelectEnum(TitledSingleSelectEnumSchema),
    /// The [`UntitledMultiSelectEnumSchema`] variant.
    UntitledMultiSelectEnum(UntitledMultiSelectEnumSchema),
    /// The [`TitledMultiSelectEnumSchema`] variant.
    TitledMultiSelectEnum(TitledMultiSelectEnumSchema),
    /// The [`LegacyTitledEnumSchema`] variant.
    LegacyTitledEnum(LegacyTitledEnumSchema),
}
impl From<StringSchema> for PrimitiveSchemaDefinition {
    fn from(v: StringSchema) -> Self {
        Self::String(v)
    }
}
impl From<NumberSchema> for PrimitiveSchemaDefinition {
    fn from(v: NumberSchema) -> Self {
        Self::Number(v)
    }
}
impl From<BooleanSchema> for PrimitiveSchemaDefinition {
    fn from(v: BooleanSchema) -> Self {
        Self::Boolean(v)
    }
}
impl From<UntitledSingleSelectEnumSchema> for PrimitiveSchemaDefinition {
    fn from(v: UntitledSingleSelectEnumSchema) -> Self {
        Self::UntitledSingleSelectEnum(v)
    }
}
impl From<TitledSingleSelectEnumSchema> for PrimitiveSchemaDefinition {
    fn from(v: TitledSingleSelectEnumSchema) -> Self {
        Self::TitledSingleSelectEnum(v)
    }
}
impl From<UntitledMultiSelectEnumSchema> for PrimitiveSchemaDefinition {
    fn from(v: UntitledMultiSelectEnumSchema) -> Self {
        Self::UntitledMultiSelectEnum(v)
    }
}
impl From<TitledMultiSelectEnumSchema> for PrimitiveSchemaDefinition {
    fn from(v: TitledMultiSelectEnumSchema) -> Self {
        Self::TitledMultiSelectEnum(v)
    }
}
impl From<LegacyTitledEnumSchema> for PrimitiveSchemaDefinition {
    fn from(v: LegacyTitledEnumSchema) -> Self {
        Self::LegacyTitledEnum(v)
    }
}
/// An out-of-band notification used to inform the receiver of a progress update for a long-running request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ProgressNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsProgressMethod,
    #[serde(rename = "params")]
    pub params: ProgressNotificationParams,
}
impl ProgressNotification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: ProgressNotificationParams) -> Self {
        Self {
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `ProgressNotificationnotifications/progress` notification.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ProgressNotificationParams {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<NotificationMetaObject>,
    /// An optional message describing the current progress.
    #[serde(rename = "message", default, skip_serializing_if = "Option::is_none")]
    pub message: Option<String>,
    /// The progress thus far. This should increase every time progress is made, even if the total is unknown.
    #[serde(rename = "progress")]
    pub progress: f64,
    /// The progress token which was given in the initial request, used to associate this notification with the request that is proceeding.
    #[serde(rename = "progressToken")]
    pub progress_token: ProgressToken,
    /// Total number of items to process (or total progress required), if known.
    #[serde(rename = "total", default, skip_serializing_if = "Option::is_none")]
    pub total: Option<f64>,
}
impl ProgressNotificationParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(progress: f64, progress_token: ProgressToken) -> Self {
        Self {
            meta: None,
            message: None,
            progress,
            progress_token,
            total: None,
        }
    }
}
/// A progress token, used to associate progress notifications with the original request.
#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize)]
#[serde(untagged)]
pub enum ProgressToken {
    /// A string value.
    String(String),
    /// An integer value.
    Integer(i64),
}
impl From<String> for ProgressToken {
    fn from(v: String) -> Self {
        Self::String(v)
    }
}
impl From<&str> for ProgressToken {
    fn from(v: &str) -> Self {
        Self::String(v.to_owned())
    }
}
impl From<i64> for ProgressToken {
    fn from(v: i64) -> Self {
        Self::Integer(v)
    }
}
impl<'de> Deserialize<'de> for ProgressToken {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        struct Visitor;
        impl serde::de::Visitor<'_> for Visitor {
            type Value = ProgressToken;
            fn expecting(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
                f.write_str("a string or an integer")
            }
            fn visit_str<E: serde::de::Error>(
                self,
                v: &str,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(ProgressToken::String(v.to_owned()))
            }
            fn visit_string<E: serde::de::Error>(
                self,
                v: String,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(ProgressToken::String(v))
            }
            fn visit_i64<E: serde::de::Error>(
                self,
                v: i64,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(ProgressToken::Integer(v))
            }
            fn visit_u64<E: serde::de::Error>(
                self,
                v: u64,
            ) -> ::core::result::Result<Self::Value, E> {
                i64::try_from(v)
                    .map(ProgressToken::Integer)
                    .map_err(|_| E::invalid_value(serde::de::Unexpected::Unsigned(v), &self))
            }
            #[allow(clippy::cast_possible_truncation, clippy::float_cmp)]
            fn visit_f64<E: serde::de::Error>(
                self,
                v: f64,
            ) -> ::core::result::Result<Self::Value, E> {
                const MAX_SAFE: f64 = 9_007_199_254_740_991.0;
                if v.fract() == 0.0 && (-MAX_SAFE..=MAX_SAFE).contains(&v) {
                    Ok(ProgressToken::Integer(v as i64))
                } else {
                    Err(E::invalid_type(serde::de::Unexpected::Float(v), &self))
                }
            }
        }
        deserializer.deserialize_any(Visitor)
    }
}
/// A prompt or prompt template that the server offers.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Prompt {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// A list of arguments to use for templating the prompt.
    #[serde(rename = "arguments", default, skip_serializing_if = "Option::is_none")]
    pub arguments: Option<Vec<PromptArgument>>,
    /// An optional description of what this prompt provides
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Optional set of sized icons that the client can display in a user interface.
    ///
    /// Clients that support rendering icons MUST support at least the following MIME types:
    /// - `image/png` - PNG images (safe, universal compatibility)
    /// - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
    ///
    /// Clients that support rendering icons SHOULD also support:
    /// - `image/svg+xml` - SVG images (scalable but requires security precautions)
    /// - `image/webp` - WebP images (modern, efficient format)
    #[serde(rename = "icons", default, skip_serializing_if = "Option::is_none")]
    pub icons: Option<Vec<Icon>>,
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
}
impl Prompt {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String) -> Self {
        Self {
            meta: None,
            arguments: None,
            description: None,
            icons: None,
            name,
            title: None,
        }
    }
}
/// Describes an argument that a prompt can accept.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PromptArgument {
    /// A human-readable description of the argument.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// Whether this argument must be provided.
    #[serde(rename = "required", default, skip_serializing_if = "Option::is_none")]
    pub required: Option<bool>,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
}
impl PromptArgument {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String) -> Self {
        Self {
            description: None,
            name,
            required: None,
            title: None,
        }
    }
}
/// An optional notification from the server to the client, informing it that the list of prompts it offers has changed. This is only delivered on a `SubscriptionsListenRequestsubscriptions/listen` stream when the client requested it via the `promptsListChanged` filter field.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct PromptListChangedNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsPromptsListChangedMethod,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<NotificationParams>,
}
/// Describes a message returned as part of a prompt.
///
/// This is similar to `SamplingMessage`, but also supports the embedding of
/// resources from the MCP server.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PromptMessage {
    #[serde(rename = "content")]
    pub content: ContentBlock,
    #[serde(rename = "role")]
    pub role: Role,
}
impl PromptMessage {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(content: ContentBlock, role: Role) -> Self {
        Self { content, role }
    }
}
/// Identifies a prompt.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct PromptReference {
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: RefPromptType,
}
impl PromptReference {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String) -> Self {
        Self {
            name,
            title: None,
            r#type: Default::default(),
        }
    }
}
/// The constant `"prompts/get"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum PromptsGetMethod {
    /// The constant `"prompts/get"`.
    #[default]
    #[serde(rename = "prompts/get")]
    PromptsGet,
}
impl PromptsGetMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "prompts/get";
}
/// The constant `"prompts/list"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum PromptsListMethod {
    /// The constant `"prompts/list"`.
    #[default]
    #[serde(rename = "prompts/list")]
    PromptsList,
}
impl PromptsListMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "prompts/list";
}
/// Sent from the client to the server, to read a specific resource URI.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ReadResourceRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: ResourcesReadMethod,
    #[serde(rename = "params")]
    pub params: ReadResourceRequestParams,
}
impl ReadResourceRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: ReadResourceRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `resources/read` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ReadResourceRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    #[serde(
        rename = "inputResponses",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub input_responses: Option<InputResponses>,
    #[serde(
        rename = "requestState",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub request_state: Option<String>,
    /// The URI of the resource. The URI can use any protocol; it is up to the server how to interpret it.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl ReadResourceRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject, uri: String) -> Self {
        Self {
            meta,
            input_responses: None,
            request_state: None,
            uri,
        }
    }
}
/// The result returned by the server for a `ReadResourceRequestresources/read` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ReadResourceResult {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the intended scope of the cached response, analogous to HTTP
    /// `Cache-Control: public` vs `Cache-Control: private`.
    ///
    /// - `"public"`: The response does not contain user-specific data. Any
    ///  client or intermediary (e.g., shared gateway, caching proxy) MAY cache
    ///  the response and serve it across authorization contexts.
    /// - `"private"`: The response MAY be cached and reused only within the
    ///  same authorization context. Caches MUST NOT be shared across
    ///  authorization contexts (e.g., a different access token requires a
    ///  different cache).
    #[serde(rename = "cacheScope")]
    pub cache_scope: CacheScope,
    #[serde(rename = "contents")]
    pub contents: Vec<ReadResourceResultContentsItem>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// A hint from the server indicating how long (in milliseconds) the
    /// client MAY cache this response before re-fetching. Semantics are
    /// analogous to HTTP Cache-Control max-age.
    ///
    /// - If 0, The response SHOULD be considered immediately stale,
    ///  The client MAY re-fetch every time the result is needed.
    /// - If positive, the client SHOULD consider the result fresh for this many
    ///  milliseconds after receiving the response.
    #[serde(rename = "ttlMs")]
    pub ttl_ms: u64,
}
impl ReadResourceResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        cache_scope: CacheScope,
        contents: Vec<ReadResourceResultContentsItem>,
        result_type: String,
        ttl_ms: u64,
    ) -> Self {
        Self {
            meta: None,
            cache_scope,
            contents,
            result_type,
            ttl_ms,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum ReadResourceResultContentsItem {
    /// The [`TextResourceContents`] variant.
    Text(TextResourceContents),
    /// The [`BlobResourceContents`] variant.
    Blob(BlobResourceContents),
}
impl From<TextResourceContents> for ReadResourceResultContentsItem {
    fn from(v: TextResourceContents) -> Self {
        Self::Text(v)
    }
}
impl From<BlobResourceContents> for ReadResourceResultContentsItem {
    fn from(v: BlobResourceContents) -> Self {
        Self::Blob(v)
    }
}
/// A successful response from the server for a `ReadResourceRequestresources/read` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ReadResourceResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: ReadResourceResultResponseResult,
}
impl ReadResourceResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: ReadResourceResultResponseResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum ReadResourceResultResponseResult {
    /// The [`InputRequiredResult`] variant.
    InputRequired(InputRequiredResult),
    /// The [`ReadResourceResult`] variant.
    ReadResource(ReadResourceResult),
}
impl From<InputRequiredResult> for ReadResourceResultResponseResult {
    fn from(v: InputRequiredResult) -> Self {
        Self::InputRequired(v)
    }
}
impl From<ReadResourceResult> for ReadResourceResultResponseResult {
    fn from(v: ReadResourceResult) -> Self {
        Self::ReadResource(v)
    }
}
impl<'de> Deserialize<'de> for ReadResourceResultResponseResult {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("resultType")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("input_required") => serde_json::from_value(value)
                .map(Self::InputRequired)
                .map_err(D::Error::custom),
            _ => serde_json::from_value(value)
                .map(Self::ReadResource)
                .map_err(D::Error::custom),
        }
    }
}
/// The constant `"ref/prompt"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum RefPromptType {
    /// The constant `"ref/prompt"`.
    #[default]
    #[serde(rename = "ref/prompt")]
    RefPrompt,
}
impl RefPromptType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "ref/prompt";
}
/// The constant `"ref/resource"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum RefResourceType {
    /// The constant `"ref/resource"`.
    #[default]
    #[serde(rename = "ref/resource")]
    RefResource,
}
impl RefResourceType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "ref/resource";
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Request {
    #[serde(rename = "method")]
    pub method: String,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<serde_json::Map<String, serde_json::Value>>,
}
impl Request {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(method: String) -> Self {
        Self {
            method,
            params: None,
        }
    }
}
/// A uniquely identifying ID for a request in JSON-RPC.
#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize)]
#[serde(untagged)]
pub enum RequestId {
    /// A string value.
    String(String),
    /// An integer value.
    Integer(i64),
}
impl From<String> for RequestId {
    fn from(v: String) -> Self {
        Self::String(v)
    }
}
impl From<&str> for RequestId {
    fn from(v: &str) -> Self {
        Self::String(v.to_owned())
    }
}
impl From<i64> for RequestId {
    fn from(v: i64) -> Self {
        Self::Integer(v)
    }
}
impl<'de> Deserialize<'de> for RequestId {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        struct Visitor;
        impl serde::de::Visitor<'_> for Visitor {
            type Value = RequestId;
            fn expecting(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
                f.write_str("a string or an integer")
            }
            fn visit_str<E: serde::de::Error>(
                self,
                v: &str,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(RequestId::String(v.to_owned()))
            }
            fn visit_string<E: serde::de::Error>(
                self,
                v: String,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(RequestId::String(v))
            }
            fn visit_i64<E: serde::de::Error>(
                self,
                v: i64,
            ) -> ::core::result::Result<Self::Value, E> {
                Ok(RequestId::Integer(v))
            }
            fn visit_u64<E: serde::de::Error>(
                self,
                v: u64,
            ) -> ::core::result::Result<Self::Value, E> {
                i64::try_from(v)
                    .map(RequestId::Integer)
                    .map_err(|_| E::invalid_value(serde::de::Unexpected::Unsigned(v), &self))
            }
            #[allow(clippy::cast_possible_truncation, clippy::float_cmp)]
            fn visit_f64<E: serde::de::Error>(
                self,
                v: f64,
            ) -> ::core::result::Result<Self::Value, E> {
                const MAX_SAFE: f64 = 9_007_199_254_740_991.0;
                if v.fract() == 0.0 && (-MAX_SAFE..=MAX_SAFE).contains(&v) {
                    Ok(RequestId::Integer(v as i64))
                } else {
                    Err(E::invalid_type(serde::de::Unexpected::Float(v), &self))
                }
            }
        }
        deserializer.deserialize_any(Visitor)
    }
}
/// Extends `MetaObject` with additional request-specific fields. All key naming rules from `MetaObject` apply.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct RequestMetaObject {
    /// The client's capabilities for this specific request. Required.
    ///
    /// Capabilities are declared per-request rather than once at initialization;
    /// an empty object means the client supports no optional capabilities.
    /// Servers MUST NOT infer capabilities from prior requests.
    #[serde(rename = "io.modelcontextprotocol/clientCapabilities")]
    pub client_capabilities: ClientCapabilities,
    /// Identifies the client software making the request. Clients SHOULD
    /// include this field on every request unless specifically configured not
    /// to do so.
    ///
    /// The `Implementation` schema requires `name` and `version`; other
    /// fields are optional.
    ///
    /// The value is self-reported by the client and is not verified by the
    /// protocol. It is intended for display, logging, and debugging. Servers
    /// SHOULD NOT use it to change their behavior, and SHOULD NOT rely on it for
    /// security decisions.
    #[serde(
        rename = "io.modelcontextprotocol/clientInfo",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub client_info: Option<Implementation>,
    /// The desired log level for this request. Optional.
    ///
    /// If absent, the server MUST NOT send any `LoggingMessageNotificationnotifications/message`
    /// notifications for this request. The client opts in to log messages by
    /// explicitly setting a level. Replaces the former `logging/setLevel` RPC.
    #[deprecated(
        note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
    )]
    #[serde(
        rename = "io.modelcontextprotocol/logLevel",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub log_level: Option<LoggingLevel>,
    /// The MCP Protocol Version being used for this request. Required.
    ///
    /// For the HTTP transport, this value MUST match the `MCP-Protocol-Version`
    /// header; otherwise the server MUST return a `400 Bad Request`. If the
    /// server does not support the requested version, it MUST return an
    /// `UnsupportedProtocolVersionError`.
    #[serde(rename = "io.modelcontextprotocol/protocolVersion")]
    pub protocol_version: String,
    /// If specified, the caller is requesting out-of-band progress notifications for this request (as represented by `ProgressNotificationnotifications/progress`). The value of this parameter is an opaque token that will be attached to any subsequent notifications. The receiver is not obligated to provide these notifications.
    #[serde(
        rename = "progressToken",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub progress_token: Option<ProgressToken>,
    /// Additional properties not described by the schema.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}
impl RequestMetaObject {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(client_capabilities: ClientCapabilities, protocol_version: String) -> Self {
        Self {
            client_capabilities,
            client_info: None,
            log_level: None,
            protocol_version,
            progress_token: None,
            extra: serde_json::Map::new(),
        }
    }
}
/// Common params for any request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct RequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
}
impl RequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject) -> Self {
        Self { meta }
    }
}
/// A known resource that the server is capable of reading.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Resource {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional annotations for the client.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<Annotations>,
    /// A description of what this resource represents.
    ///
    /// This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a "hint" to the model.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Optional set of sized icons that the client can display in a user interface.
    ///
    /// Clients that support rendering icons MUST support at least the following MIME types:
    /// - `image/png` - PNG images (safe, universal compatibility)
    /// - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
    ///
    /// Clients that support rendering icons SHOULD also support:
    /// - `image/svg+xml` - SVG images (scalable but requires security precautions)
    /// - `image/webp` - WebP images (modern, efficient format)
    #[serde(rename = "icons", default, skip_serializing_if = "Option::is_none")]
    pub icons: Option<Vec<Icon>>,
    /// The MIME type of this resource, if known.
    #[serde(rename = "mimeType", default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// The size of the raw resource content, in bytes (i.e., before base64 encoding or any tokenization), if known.
    ///
    /// This can be used by Hosts to display file sizes and estimate context window usage.
    #[serde(rename = "size", default, skip_serializing_if = "Option::is_none")]
    pub size: Option<i64>,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// The URI of this resource.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl Resource {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String, uri: String) -> Self {
        Self {
            meta: None,
            annotations: None,
            description: None,
            icons: None,
            mime_type: None,
            name,
            size: None,
            title: None,
            uri,
        }
    }
}
/// The contents of a specific resource or sub-resource.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ResourceContents {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// The MIME type of this resource, if known.
    #[serde(rename = "mimeType", default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    /// The URI of this resource.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl ResourceContents {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(uri: String) -> Self {
        Self {
            meta: None,
            mime_type: None,
            uri,
        }
    }
}
/// A resource that the server is capable of reading, included in a prompt or tool call result.
///
/// Note: resource links returned by tools are not guaranteed to appear in the results of `ListResourcesRequestresources/list` requests.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ResourceLink {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional annotations for the client.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<Annotations>,
    /// A description of what this resource represents.
    ///
    /// This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a "hint" to the model.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Optional set of sized icons that the client can display in a user interface.
    ///
    /// Clients that support rendering icons MUST support at least the following MIME types:
    /// - `image/png` - PNG images (safe, universal compatibility)
    /// - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
    ///
    /// Clients that support rendering icons SHOULD also support:
    /// - `image/svg+xml` - SVG images (scalable but requires security precautions)
    /// - `image/webp` - WebP images (modern, efficient format)
    #[serde(rename = "icons", default, skip_serializing_if = "Option::is_none")]
    pub icons: Option<Vec<Icon>>,
    /// The MIME type of this resource, if known.
    #[serde(rename = "mimeType", default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// The size of the raw resource content, in bytes (i.e., before base64 encoding or any tokenization), if known.
    ///
    /// This can be used by Hosts to display file sizes and estimate context window usage.
    #[serde(rename = "size", default, skip_serializing_if = "Option::is_none")]
    pub size: Option<i64>,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: ResourceLinkType,
    /// The URI of this resource.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl ResourceLink {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String, uri: String) -> Self {
        Self {
            meta: None,
            annotations: None,
            description: None,
            icons: None,
            mime_type: None,
            name,
            size: None,
            title: None,
            r#type: Default::default(),
            uri,
        }
    }
}
/// The constant `"resource_link"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ResourceLinkType {
    /// The constant `"resource_link"`.
    #[default]
    #[serde(rename = "resource_link")]
    ResourceLink,
}
impl ResourceLinkType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "resource_link";
}
/// An optional notification from the server to the client, informing it that the list of resources it can read from has changed. This is only delivered on a `SubscriptionsListenRequestsubscriptions/listen` stream when the client requested it via the `resourcesListChanged` filter field.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ResourceListChangedNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsResourcesListChangedMethod,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<NotificationParams>,
}
/// Common params for resource-related requests.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ResourceRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    /// The URI of the resource. The URI can use any protocol; it is up to the server how to interpret it.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl ResourceRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject, uri: String) -> Self {
        Self { meta, uri }
    }
}
/// A template description for resources available on the server.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ResourceTemplate {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional annotations for the client.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<Annotations>,
    /// A description of what this template is for.
    ///
    /// This can be used by clients to improve the LLM's understanding of available resources. It can be thought of like a "hint" to the model.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Optional set of sized icons that the client can display in a user interface.
    ///
    /// Clients that support rendering icons MUST support at least the following MIME types:
    /// - `image/png` - PNG images (safe, universal compatibility)
    /// - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
    ///
    /// Clients that support rendering icons SHOULD also support:
    /// - `image/svg+xml` - SVG images (scalable but requires security precautions)
    /// - `image/webp` - WebP images (modern, efficient format)
    #[serde(rename = "icons", default, skip_serializing_if = "Option::is_none")]
    pub icons: Option<Vec<Icon>>,
    /// The MIME type for all resources that match this template. This should only be included if all resources matching this template have the same type.
    #[serde(rename = "mimeType", default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    /// A URI template (according to RFC 6570) that can be used to construct resource URIs.
    #[serde(rename = "uriTemplate")]
    pub uri_template: String,
}
impl ResourceTemplate {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(name: String, uri_template: String) -> Self {
        Self {
            meta: None,
            annotations: None,
            description: None,
            icons: None,
            mime_type: None,
            name,
            title: None,
            uri_template,
        }
    }
}
/// A reference to a resource or resource template definition.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ResourceTemplateReference {
    #[serde(rename = "type")]
    pub r#type: RefResourceType,
    /// The URI or URI template of the resource.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl ResourceTemplateReference {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(uri: String) -> Self {
        Self {
            r#type: Default::default(),
            uri,
        }
    }
}
/// The constant `"resource"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ResourceType {
    /// The constant `"resource"`.
    #[default]
    #[serde(rename = "resource")]
    Resource,
}
impl ResourceType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "resource";
}
/// A notification from the server to the client, informing it that a resource has changed and may need to be read again. This is only sent for resources the client opted in to via the `resourceSubscriptions` field of a `SubscriptionsListenRequestsubscriptions/listen` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ResourceUpdatedNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsResourcesUpdatedMethod,
    #[serde(rename = "params")]
    pub params: ResourceUpdatedNotificationParams,
}
impl ResourceUpdatedNotification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: ResourceUpdatedNotificationParams) -> Self {
        Self {
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `notifications/resources/updated` notification.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ResourceUpdatedNotificationParams {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<NotificationMetaObject>,
    /// The URI of the resource that has been updated. This might be a sub-resource of the one that the client actually subscribed to.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl ResourceUpdatedNotificationParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(uri: String) -> Self {
        Self { meta: None, uri }
    }
}
/// The constant `"resources/list"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ResourcesListMethod {
    /// The constant `"resources/list"`.
    #[default]
    #[serde(rename = "resources/list")]
    ResourcesList,
}
impl ResourcesListMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "resources/list";
}
/// The constant `"resources/read"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ResourcesReadMethod {
    /// The constant `"resources/read"`.
    #[default]
    #[serde(rename = "resources/read")]
    ResourcesRead,
}
impl ResourcesReadMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "resources/read";
}
/// The constant `"resources/templates/list"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ResourcesTemplatesListMethod {
    /// The constant `"resources/templates/list"`.
    #[default]
    #[serde(rename = "resources/templates/list")]
    ResourcesTemplatesList,
}
impl ResourcesTemplatesListMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "resources/templates/list";
}
/// Common result fields.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Result {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<ResultMetaObject>,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
    /// Additional properties not described by the schema.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}
impl Result {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(result_type: String) -> Self {
        Self {
            meta: None,
            result_type,
            extra: serde_json::Map::new(),
        }
    }
}
/// Extends `MetaObject` with additional result-specific fields. All key naming rules from `MetaObject` apply.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ResultMetaObject {
    /// Identifies the server software producing the response. Servers SHOULD
    /// include this field on every response unless specifically configured not
    /// to do so.
    ///
    /// The `Implementation` schema requires `name` and `version`; other
    /// fields are optional.
    ///
    /// The value is self-reported by the server and is not verified by the
    /// protocol. It is intended for display, logging, and debugging. Clients
    /// SHOULD NOT use it to change their behavior, and SHOULD NOT rely on it for
    /// security decisions.
    #[serde(
        rename = "io.modelcontextprotocol/serverInfo",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub server_info: Option<Implementation>,
    /// Additional properties not described by the schema.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}
/// Indicates the type of a `Result` object, allowing the client to
/// determine how to parse the response.
///
/// complete - the request completed successfully and the result contains the final content.
/// input_required - the request requires additional input and the result contains an `InputRequiredResult` object with instructions for the client to provide additional input before retrying the original request.
pub type ResultType = String;
/// The sender or recipient of messages and data in a conversation.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum Role {
    /// `"assistant"`
    #[serde(rename = "assistant")]
    Assistant,
    /// `"user"`
    #[serde(rename = "user")]
    User,
}
impl Role {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Assistant => "assistant",
            Self::User => "user",
        }
    }
}
/// Represents a root directory or file that the server can operate on.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Root {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// An optional name for the root. This can be used to provide a human-readable
    /// identifier for the root, which may be useful for display purposes or for
    /// referencing the root in other parts of the application.
    #[serde(rename = "name", default, skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// The URI identifying the root. This *must* start with `file://` for now.
    /// This restriction may be relaxed in future versions of the protocol to allow
    /// other URI schemes.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl Root {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(uri: String) -> Self {
        Self {
            meta: None,
            name: None,
            uri,
        }
    }
}
/// The constant `"roots/list"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum RootsListMethod {
    /// The constant `"roots/list"`.
    #[default]
    #[serde(rename = "roots/list")]
    RootsList,
}
impl RootsListMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "roots/list";
}
/// The constant `"sampling/createMessage"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum SamplingCreateMessageMethod {
    /// The constant `"sampling/createMessage"`.
    #[default]
    #[serde(rename = "sampling/createMessage")]
    SamplingCreateMessage,
}
impl SamplingCreateMessageMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "sampling/createMessage";
}
/// Describes a message issued to or received from an LLM API.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SamplingMessage {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    #[serde(rename = "content")]
    pub content: SamplingMessageContent,
    #[serde(rename = "role")]
    pub role: Role,
}
impl SamplingMessage {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(content: SamplingMessageContent, role: Role) -> Self {
        Self {
            meta: None,
            content,
            role,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum SamplingMessageContent {
    /// The [`TextContent`] variant.
    TextContent(TextContent),
    /// The [`ImageContent`] variant.
    ImageContent(ImageContent),
    /// The [`AudioContent`] variant.
    AudioContent(AudioContent),
    /// The [`ToolUseContent`] variant.
    ToolUseContent(ToolUseContent),
    /// The [`ToolResultContent`] variant.
    ToolResultContent(ToolResultContent),
    /// An inline variant.
    List(Vec<SamplingMessageContentBlock>),
}
impl From<TextContent> for SamplingMessageContent {
    fn from(v: TextContent) -> Self {
        Self::TextContent(v)
    }
}
impl From<ImageContent> for SamplingMessageContent {
    fn from(v: ImageContent) -> Self {
        Self::ImageContent(v)
    }
}
impl From<AudioContent> for SamplingMessageContent {
    fn from(v: AudioContent) -> Self {
        Self::AudioContent(v)
    }
}
impl From<ToolUseContent> for SamplingMessageContent {
    fn from(v: ToolUseContent) -> Self {
        Self::ToolUseContent(v)
    }
}
impl From<ToolResultContent> for SamplingMessageContent {
    fn from(v: ToolResultContent) -> Self {
        Self::ToolResultContent(v)
    }
}
impl From<Vec<SamplingMessageContentBlock>> for SamplingMessageContent {
    fn from(v: Vec<SamplingMessageContentBlock>) -> Self {
        Self::List(v)
    }
}
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum SamplingMessageContentBlock {
    /// The [`TextContent`] variant.
    Text(TextContent),
    /// The [`ImageContent`] variant.
    Image(ImageContent),
    /// The [`AudioContent`] variant.
    Audio(AudioContent),
    /// The [`ToolUseContent`] variant.
    ToolUse(ToolUseContent),
    /// The [`ToolResultContent`] variant.
    ToolResult(ToolResultContent),
}
impl From<TextContent> for SamplingMessageContentBlock {
    fn from(v: TextContent) -> Self {
        Self::Text(v)
    }
}
impl From<ImageContent> for SamplingMessageContentBlock {
    fn from(v: ImageContent) -> Self {
        Self::Image(v)
    }
}
impl From<AudioContent> for SamplingMessageContentBlock {
    fn from(v: AudioContent) -> Self {
        Self::Audio(v)
    }
}
impl From<ToolUseContent> for SamplingMessageContentBlock {
    fn from(v: ToolUseContent) -> Self {
        Self::ToolUse(v)
    }
}
impl From<ToolResultContent> for SamplingMessageContentBlock {
    fn from(v: ToolResultContent) -> Self {
        Self::ToolResult(v)
    }
}
impl<'de> Deserialize<'de> for SamplingMessageContentBlock {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("type")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("text") => serde_json::from_value(value)
                .map(Self::Text)
                .map_err(D::Error::custom),
            Some("image") => serde_json::from_value(value)
                .map(Self::Image)
                .map_err(D::Error::custom),
            Some("audio") => serde_json::from_value(value)
                .map(Self::Audio)
                .map_err(D::Error::custom),
            Some("tool_use") => serde_json::from_value(value)
                .map(Self::ToolUse)
                .map_err(D::Error::custom),
            Some("tool_result") => serde_json::from_value(value)
                .map(Self::ToolResult)
                .map_err(D::Error::custom),
            None => Err(D::Error::missing_field("type")),
            Some(other) => Err(D::Error::unknown_variant(
                other,
                &["text", "image", "audio", "tool_use", "tool_result"],
            )),
        }
    }
}
/// Capabilities that a server may support. Known capabilities are defined here, in this schema, but this is not a closed set: any server can define its own, additional capabilities.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ServerCapabilities {
    /// Present if the server supports argument autocompletion suggestions.
    #[serde(
        rename = "completions",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub completions: Option<serde_json::Map<String, serde_json::Value>>,
    /// Experimental, non-standard capabilities that the server supports.
    #[serde(
        rename = "experimental",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub experimental:
        Option<std::collections::BTreeMap<String, serde_json::Map<String, serde_json::Value>>>,
    /// Optional MCP extensions that the server supports. Keys are extension identifiers
    /// (e.g., "io.modelcontextprotocol/tasks"), and values are per-extension settings
    /// objects. An empty object indicates support with no settings.
    ///
    /// Keys MUST follow the `MetaObject`_meta``, with a
    /// mandatory prefix.
    #[serde(
        rename = "extensions",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub extensions:
        Option<std::collections::BTreeMap<String, serde_json::Map<String, serde_json::Value>>>,
    /// Present if the server supports sending log messages to the client.
    #[deprecated(
        note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
    )]
    #[serde(rename = "logging", default, skip_serializing_if = "Option::is_none")]
    pub logging: Option<serde_json::Map<String, serde_json::Value>>,
    /// Present if the server offers any prompt templates.
    #[serde(rename = "prompts", default, skip_serializing_if = "Option::is_none")]
    pub prompts: Option<ServerCapabilitiesPrompts>,
    /// Present if the server offers any resources to read.
    #[serde(rename = "resources", default, skip_serializing_if = "Option::is_none")]
    pub resources: Option<ServerCapabilitiesResources>,
    /// Present if the server offers any tools to call.
    #[serde(rename = "tools", default, skip_serializing_if = "Option::is_none")]
    pub tools: Option<ServerCapabilitiesTools>,
}
/// Present if the server offers any prompt templates.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ServerCapabilitiesPrompts {
    /// Whether this server supports notifications for changes to the prompt list.
    #[serde(
        rename = "listChanged",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub list_changed: Option<bool>,
}
/// Present if the server offers any resources to read.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ServerCapabilitiesResources {
    /// Whether this server supports notifications for changes to the resource list.
    #[serde(
        rename = "listChanged",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub list_changed: Option<bool>,
    /// Whether this server supports subscribing to resource updates.
    #[serde(rename = "subscribe", default, skip_serializing_if = "Option::is_none")]
    pub subscribe: Option<bool>,
}
/// Present if the server offers any tools to call.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ServerCapabilitiesTools {
    /// Whether this server supports notifications for changes to the tool list.
    #[serde(
        rename = "listChanged",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub list_changed: Option<bool>,
}
/// The constant `"server/discover"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ServerDiscoverMethod {
    /// The constant `"server/discover"`.
    #[default]
    #[serde(rename = "server/discover")]
    ServerDiscover,
}
impl ServerDiscoverMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "server/discover";
}
#[derive(Debug, Clone, PartialEq, Serialize)]
#[serde(untagged)]
pub enum ServerNotification {
    /// The [`CancelledNotification`] variant.
    Cancelled(CancelledNotification),
    /// The [`ProgressNotification`] variant.
    Progress(ProgressNotification),
    /// The [`ResourceListChangedNotification`] variant.
    ResourceListChanged(ResourceListChangedNotification),
    /// The [`SubscriptionsAcknowledgedNotification`] variant.
    SubscriptionsAcknowledged(SubscriptionsAcknowledgedNotification),
    /// The [`ResourceUpdatedNotification`] variant.
    ResourceUpdated(ResourceUpdatedNotification),
    /// The [`PromptListChangedNotification`] variant.
    PromptListChanged(PromptListChangedNotification),
    /// The [`ToolListChangedNotification`] variant.
    ToolListChanged(ToolListChangedNotification),
    /// The [`LoggingMessageNotification`] variant.
    LoggingMessage(LoggingMessageNotification),
}
impl From<CancelledNotification> for ServerNotification {
    fn from(v: CancelledNotification) -> Self {
        Self::Cancelled(v)
    }
}
impl From<ProgressNotification> for ServerNotification {
    fn from(v: ProgressNotification) -> Self {
        Self::Progress(v)
    }
}
impl From<ResourceListChangedNotification> for ServerNotification {
    fn from(v: ResourceListChangedNotification) -> Self {
        Self::ResourceListChanged(v)
    }
}
impl From<SubscriptionsAcknowledgedNotification> for ServerNotification {
    fn from(v: SubscriptionsAcknowledgedNotification) -> Self {
        Self::SubscriptionsAcknowledged(v)
    }
}
impl From<ResourceUpdatedNotification> for ServerNotification {
    fn from(v: ResourceUpdatedNotification) -> Self {
        Self::ResourceUpdated(v)
    }
}
impl From<PromptListChangedNotification> for ServerNotification {
    fn from(v: PromptListChangedNotification) -> Self {
        Self::PromptListChanged(v)
    }
}
impl From<ToolListChangedNotification> for ServerNotification {
    fn from(v: ToolListChangedNotification) -> Self {
        Self::ToolListChanged(v)
    }
}
impl From<LoggingMessageNotification> for ServerNotification {
    fn from(v: LoggingMessageNotification) -> Self {
        Self::LoggingMessage(v)
    }
}
impl<'de> Deserialize<'de> for ServerNotification {
    fn deserialize<D: serde::Deserializer<'de>>(
        deserializer: D,
    ) -> ::core::result::Result<Self, D::Error> {
        use serde::de::Error as _;
        let value = serde_json::Value::deserialize(deserializer)?;
        let tag = value
            .get("method")
            .and_then(serde_json::Value::as_str)
            .map(str::to_owned);
        match tag.as_deref() {
            Some("notifications/cancelled") => serde_json::from_value(value)
                .map(Self::Cancelled)
                .map_err(D::Error::custom),
            Some("notifications/progress") => serde_json::from_value(value)
                .map(Self::Progress)
                .map_err(D::Error::custom),
            Some("notifications/resources/list_changed") => serde_json::from_value(value)
                .map(Self::ResourceListChanged)
                .map_err(D::Error::custom),
            Some("notifications/subscriptions/acknowledged") => serde_json::from_value(value)
                .map(Self::SubscriptionsAcknowledged)
                .map_err(D::Error::custom),
            Some("notifications/resources/updated") => serde_json::from_value(value)
                .map(Self::ResourceUpdated)
                .map_err(D::Error::custom),
            Some("notifications/prompts/list_changed") => serde_json::from_value(value)
                .map(Self::PromptListChanged)
                .map_err(D::Error::custom),
            Some("notifications/tools/list_changed") => serde_json::from_value(value)
                .map(Self::ToolListChanged)
                .map_err(D::Error::custom),
            Some("notifications/message") => serde_json::from_value(value)
                .map(Self::LoggingMessage)
                .map_err(D::Error::custom),
            None => Err(D::Error::missing_field("method")),
            Some(other) => Err(D::Error::unknown_variant(
                other,
                &[
                    "notifications/cancelled",
                    "notifications/progress",
                    "notifications/resources/list_changed",
                    "notifications/subscriptions/acknowledged",
                    "notifications/resources/updated",
                    "notifications/prompts/list_changed",
                    "notifications/tools/list_changed",
                    "notifications/message",
                ],
            )),
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
#[serde(untagged)]
pub enum SingleSelectEnumSchema {
    /// The [`UntitledSingleSelectEnumSchema`] variant.
    Untitled(UntitledSingleSelectEnumSchema),
    /// The [`TitledSingleSelectEnumSchema`] variant.
    Titled(TitledSingleSelectEnumSchema),
}
impl From<UntitledSingleSelectEnumSchema> for SingleSelectEnumSchema {
    fn from(v: UntitledSingleSelectEnumSchema) -> Self {
        Self::Untitled(v)
    }
}
impl From<TitledSingleSelectEnumSchema> for SingleSelectEnumSchema {
    fn from(v: TitledSingleSelectEnumSchema) -> Self {
        Self::Titled(v)
    }
}
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct StringSchema {
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<String>,
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    #[serde(rename = "format", default, skip_serializing_if = "Option::is_none")]
    pub format: Option<StringSchemaFormat>,
    #[serde(rename = "maxLength", default, skip_serializing_if = "Option::is_none")]
    pub max_length: Option<i64>,
    #[serde(rename = "minLength", default, skip_serializing_if = "Option::is_none")]
    pub min_length: Option<i64>,
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: StringType,
}
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum StringSchemaFormat {
    /// `"date"`
    #[serde(rename = "date")]
    Date,
    /// `"date-time"`
    #[serde(rename = "date-time")]
    DateTime,
    /// `"email"`
    #[serde(rename = "email")]
    Email,
    /// `"uri"`
    #[serde(rename = "uri")]
    Uri,
}
impl StringSchemaFormat {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Date => "date",
            Self::DateTime => "date-time",
            Self::Email => "email",
            Self::Uri => "uri",
        }
    }
}
/// The constant `"string"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum StringType {
    /// The constant `"string"`.
    #[default]
    #[serde(rename = "string")]
    String,
}
impl StringType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "string";
}
/// The set of notification types a client may opt in to on a
/// `SubscriptionsListenRequestsubscriptions/listen` request.
///
/// Each notification type is **opt-in**; the server **MUST NOT** send
/// notification types the client has not explicitly requested here.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct SubscriptionFilter {
    /// If true, receive `PromptListChangedNotificationnotifications/prompts/list_changed`.
    #[serde(
        rename = "promptsListChanged",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub prompts_list_changed: Option<bool>,
    /// Subscribe to `ResourceUpdatedNotificationnotifications/resources/updated` for these resource URIs.
    /// Replaces the former `resources/subscribe` RPC.
    #[serde(
        rename = "resourceSubscriptions",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub resource_subscriptions: Option<Vec<String>>,
    /// If true, receive `ResourceListChangedNotificationnotifications/resources/list_changed`.
    #[serde(
        rename = "resourcesListChanged",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub resources_list_changed: Option<bool>,
    /// If true, receive `ToolListChangedNotificationnotifications/tools/list_changed`.
    #[serde(
        rename = "toolsListChanged",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub tools_list_changed: Option<bool>,
}
/// Sent by the server to acknowledge that a
/// `SubscriptionsListenRequestsubscriptions/listen` subscription has been
/// established and to report which notification types it agreed to honor.
///
/// This notification MUST be the first message the server sends carrying the
/// subscription's ID in `io.modelcontextprotocol/subscriptionId`. The server MUST
/// NOT send any notification on the subscription before acknowledging it. On
/// stdio, where every subscription shares one channel, this ordering is defined
/// per subscription ID and not per channel: messages belonging to other
/// subscriptions MAY be interleaved before it.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SubscriptionsAcknowledgedNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsSubscriptionsAcknowledgedMethod,
    #[serde(rename = "params")]
    pub params: SubscriptionsAcknowledgedNotificationParams,
}
impl SubscriptionsAcknowledgedNotification {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(params: SubscriptionsAcknowledgedNotificationParams) -> Self {
        Self {
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `SubscriptionsAcknowledgedNotificationnotifications/subscriptions/acknowledged` notification.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SubscriptionsAcknowledgedNotificationParams {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<NotificationMetaObject>,
    /// The subset of requested notification types the server agreed to honor.
    /// Only includes notification types the server actually supports; if the
    /// client requested an unsupported type (e.g., `promptsListChanged` when
    /// the server has no prompts), it is omitted from this set.
    #[serde(rename = "notifications")]
    pub notifications: SubscriptionFilter,
}
impl SubscriptionsAcknowledgedNotificationParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(notifications: SubscriptionFilter) -> Self {
        Self {
            meta: None,
            notifications,
        }
    }
}
/// The constant `"subscriptions/listen"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum SubscriptionsListenMethod {
    /// The constant `"subscriptions/listen"`.
    #[default]
    #[serde(rename = "subscriptions/listen")]
    SubscriptionsListen,
}
impl SubscriptionsListenMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "subscriptions/listen";
}
/// Sent from the client to open a long-lived channel for receiving notifications
/// outside the context of a specific request. Replaces the previous HTTP GET
/// endpoint and ensures consistent behavior between HTTP and STDIO.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SubscriptionsListenRequest {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: SubscriptionsListenMethod,
    #[serde(rename = "params")]
    pub params: SubscriptionsListenRequestParams,
}
impl SubscriptionsListenRequest {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, params: SubscriptionsListenRequestParams) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            method: Default::default(),
            params,
        }
    }
}
/// Parameters for a `SubscriptionsListenRequestsubscriptions/listen` request.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SubscriptionsListenRequestParams {
    #[serde(rename = "_meta")]
    pub meta: RequestMetaObject,
    /// The notifications the client opts in to on this stream. The server
    /// **MUST NOT** send notification types the client has not explicitly
    /// requested.
    #[serde(rename = "notifications")]
    pub notifications: SubscriptionFilter,
}
impl SubscriptionsListenRequestParams {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: RequestMetaObject, notifications: SubscriptionFilter) -> Self {
        Self {
            meta,
            notifications,
        }
    }
}
/// The response to a `SubscriptionsListenRequestsubscriptions/listen`
/// request, signalling that the subscription has ended gracefully (for example,
/// during server shutdown). Because the listen stream is long-lived, this result
/// is sent only when the server tears the subscription down; an abrupt transport
/// close carries no response. The result body is otherwise empty.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SubscriptionsListenResult {
    #[serde(rename = "_meta")]
    pub meta: SubscriptionsListenResultMetaObject,
    /// Indicates the type of the result, which allows the client to determine
    /// how to parse the result object.
    ///
    /// Servers implementing this protocol version MUST include this field.
    /// For backward compatibility, when a client receives a result from a
    /// server implementing an earlier protocol version (which does not include
    /// `resultType`), the client MUST treat the absent field as `"complete"`.
    #[serde(rename = "resultType")]
    pub result_type: String,
}
impl SubscriptionsListenResult {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(meta: SubscriptionsListenResultMetaObject, result_type: String) -> Self {
        Self { meta, result_type }
    }
}
/// Extends `ResultMetaObject` with the subscription-stream identifier carried by a
/// `SubscriptionsListenResult`. All key naming rules from `MetaObject` apply.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SubscriptionsListenResultMetaObject {
    /// Identifies the server software producing the response. Servers SHOULD
    /// include this field on every response unless specifically configured not
    /// to do so.
    ///
    /// The `Implementation` schema requires `name` and `version`; other
    /// fields are optional.
    ///
    /// The value is self-reported by the server and is not verified by the
    /// protocol. It is intended for display, logging, and debugging. Clients
    /// SHOULD NOT use it to change their behavior, and SHOULD NOT rely on it for
    /// security decisions.
    #[serde(
        rename = "io.modelcontextprotocol/serverInfo",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub server_info: Option<Implementation>,
    /// Identifies the subscription stream this response closes, so the client can
    /// correlate it with the originating subscription — mirroring the same key on
    /// the stream's notifications. The value is the JSON-RPC ID of the
    /// `subscriptions/listen` request that opened the stream (and equals this
    /// response's `id`).
    #[serde(rename = "io.modelcontextprotocol/subscriptionId")]
    pub subscription_id: RequestId,
    /// Additional properties not described by the schema.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}
impl SubscriptionsListenResultMetaObject {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(subscription_id: RequestId) -> Self {
        Self {
            server_info: None,
            subscription_id,
            extra: serde_json::Map::new(),
        }
    }
}
/// A successful response from the server for a `SubscriptionsListenRequestsubscriptions/listen`
/// request, sent when the server tears the subscription down gracefully.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct SubscriptionsListenResultResponse {
    #[serde(rename = "id")]
    pub id: RequestId,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "result")]
    pub result: SubscriptionsListenResult,
}
impl SubscriptionsListenResultResponse {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(id: RequestId, result: SubscriptionsListenResult) -> Self {
        Self {
            id,
            jsonrpc: Default::default(),
            result,
        }
    }
}
/// Text provided to or from an LLM.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TextContent {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional annotations for the client.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<Annotations>,
    /// The text content of the message.
    #[serde(rename = "text")]
    pub text: String,
    #[serde(rename = "type")]
    pub r#type: TextType,
}
impl TextContent {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(text: String) -> Self {
        Self {
            meta: None,
            annotations: None,
            text,
            r#type: Default::default(),
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TextResourceContents {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// The MIME type of this resource, if known.
    #[serde(rename = "mimeType", default, skip_serializing_if = "Option::is_none")]
    pub mime_type: Option<String>,
    /// The text of the item. This must only be set if the item can actually be represented as text (not binary data).
    #[serde(rename = "text")]
    pub text: String,
    /// The URI of this resource.
    #[serde(rename = "uri")]
    pub uri: String,
}
impl TextResourceContents {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(text: String, uri: String) -> Self {
        Self {
            meta: None,
            mime_type: None,
            text,
            uri,
        }
    }
}
/// The constant `"text"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum TextType {
    /// The constant `"text"`.
    #[default]
    #[serde(rename = "text")]
    Text,
}
impl TextType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "text";
}
/// Schema for multiple-selection enumeration with display titles for each option.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TitledMultiSelectEnumSchema {
    /// Optional default value.
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<Vec<String>>,
    /// Optional description for the enum field.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Schema for array items with enum options and display labels.
    #[serde(rename = "items")]
    pub items: TitledMultiSelectEnumSchemaItems,
    /// Maximum number of items to select.
    #[serde(rename = "maxItems", default, skip_serializing_if = "Option::is_none")]
    pub max_items: Option<i64>,
    /// Minimum number of items to select.
    #[serde(rename = "minItems", default, skip_serializing_if = "Option::is_none")]
    pub min_items: Option<i64>,
    /// Optional title for the enum field.
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: ArrayType,
}
impl TitledMultiSelectEnumSchema {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(items: TitledMultiSelectEnumSchemaItems) -> Self {
        Self {
            default: None,
            description: None,
            items,
            max_items: None,
            min_items: None,
            title: None,
            r#type: Default::default(),
        }
    }
}
/// Schema for array items with enum options and display labels.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TitledMultiSelectEnumSchemaItems {
    /// Array of enum options with values and display labels.
    #[serde(rename = "anyOf")]
    pub any_of: Vec<TitledMultiSelectEnumSchemaItemsAnyOfItem>,
}
impl TitledMultiSelectEnumSchemaItems {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(any_of: Vec<TitledMultiSelectEnumSchemaItemsAnyOfItem>) -> Self {
        Self { any_of }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TitledMultiSelectEnumSchemaItemsAnyOfItem {
    /// The constant enum value.
    #[serde(rename = "const")]
    pub r#const: String,
    /// Display title for this option.
    #[serde(rename = "title")]
    pub title: String,
}
impl TitledMultiSelectEnumSchemaItemsAnyOfItem {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(r#const: String, title: String) -> Self {
        Self { r#const, title }
    }
}
/// Schema for single-selection enumeration with display titles for each option.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TitledSingleSelectEnumSchema {
    /// Optional default value.
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<String>,
    /// Optional description for the enum field.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Array of enum options with values and display labels.
    #[serde(rename = "oneOf")]
    pub one_of: Vec<TitledSingleSelectEnumSchemaOneOfItem>,
    /// Optional title for the enum field.
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: StringType,
}
impl TitledSingleSelectEnumSchema {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(one_of: Vec<TitledSingleSelectEnumSchemaOneOfItem>) -> Self {
        Self {
            default: None,
            description: None,
            one_of,
            title: None,
            r#type: Default::default(),
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct TitledSingleSelectEnumSchemaOneOfItem {
    /// The enum value.
    #[serde(rename = "const")]
    pub r#const: String,
    /// Display label for this option.
    #[serde(rename = "title")]
    pub title: String,
}
impl TitledSingleSelectEnumSchemaOneOfItem {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(r#const: String, title: String) -> Self {
        Self { r#const, title }
    }
}
/// Definition for a tool the client can call.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct Tool {
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// Optional additional tool information.
    ///
    /// Display name precedence order is: `title`, `annotations.title`, then `name`.
    #[serde(
        rename = "annotations",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub annotations: Option<ToolAnnotations>,
    /// A human-readable description of the tool.
    ///
    /// This can be used by clients to improve the LLM's understanding of available tools. It can be thought of like a "hint" to the model.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Optional set of sized icons that the client can display in a user interface.
    ///
    /// Clients that support rendering icons MUST support at least the following MIME types:
    /// - `image/png` - PNG images (safe, universal compatibility)
    /// - `image/jpeg` (and `image/jpg`) - JPEG images (safe, universal compatibility)
    ///
    /// Clients that support rendering icons SHOULD also support:
    /// - `image/svg+xml` - SVG images (scalable but requires security precautions)
    /// - `image/webp` - WebP images (modern, efficient format)
    #[serde(rename = "icons", default, skip_serializing_if = "Option::is_none")]
    pub icons: Option<Vec<Icon>>,
    /// A JSON Schema object defining the expected parameters for the tool.
    ///
    /// Tool arguments are always JSON objects, so `type: "object"` is required at the root.
    /// Beyond that, any JSON Schema 2020-12 keyword may appear alongside `type` — including
    /// composition keywords (`oneOf`, `anyOf`, `allOf`, `not`), conditional keywords
    /// (`if`/`then`/`else`), reference keywords (`$ref`, `$defs`, `$anchor`), and any other
    /// standard validation or annotation keywords.
    ///
    /// Property schemas may carry an `x-mcp-header` annotation to mirror the
    /// argument value into an HTTP header on the Streamable HTTP transport. See
    /// the Streamable HTTP transport specification for the validity and
    /// extraction rules.
    ///
    /// Defaults to JSON Schema 2020-12 when no explicit `$schema` is provided.
    #[serde(rename = "inputSchema")]
    pub input_schema: ToolInputSchema,
    /// Intended for programmatic or logical use, but used as a display name in past specs or fallback (if title isn't present).
    #[serde(rename = "name")]
    pub name: String,
    /// An optional JSON Schema object defining the structure of the tool's output returned in
    /// the structuredContent field of a `CallToolResult`. This can be any valid JSON Schema 2020-12.
    ///
    /// Defaults to JSON Schema 2020-12 when no explicit `$schema` is provided.
    #[serde(
        rename = "outputSchema",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub output_schema: Option<ToolOutputSchema>,
    /// Intended for UI and end-user contexts — optimized to be human-readable and easily understood,
    /// even by those unfamiliar with domain-specific terminology.
    ///
    /// If not provided, the name should be used for display (except for `Tool`,
    /// where `annotations.title` should be given precedence over using `name`,
    /// if present).
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
}
impl Tool {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(input_schema: ToolInputSchema, name: String) -> Self {
        Self {
            meta: None,
            annotations: None,
            description: None,
            icons: None,
            input_schema,
            name,
            output_schema: None,
            title: None,
        }
    }
}
/// Additional properties describing a `Tool` to clients.
///
/// NOTE: all properties in `ToolAnnotations` are **hints**.
/// They are not guaranteed to provide a faithful description of
/// tool behavior (including descriptive properties like `title`).
///
/// Clients should never make tool use decisions based on `ToolAnnotations`
/// received from untrusted servers.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ToolAnnotations {
    /// If true, the tool may perform destructive updates to its environment.
    /// If false, the tool performs only additive updates.
    ///
    /// (This property is meaningful only when `readOnlyHint == false`)
    ///
    /// Default: true
    #[serde(
        rename = "destructiveHint",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub destructive_hint: Option<bool>,
    /// If true, calling the tool repeatedly with the same arguments
    /// will have no additional effect on its environment.
    ///
    /// (This property is meaningful only when `readOnlyHint == false`)
    ///
    /// Default: false
    #[serde(
        rename = "idempotentHint",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub idempotent_hint: Option<bool>,
    /// If true, this tool may interact with an "open world" of external
    /// entities. If false, the tool's domain of interaction is closed.
    /// For example, the world of a web search tool is open, whereas that
    /// of a memory tool is not.
    ///
    /// Default: true
    #[serde(
        rename = "openWorldHint",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub open_world_hint: Option<bool>,
    /// If true, the tool does not modify its environment.
    ///
    /// Default: false
    #[serde(
        rename = "readOnlyHint",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub read_only_hint: Option<bool>,
    /// A human-readable title for the tool.
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
}
/// Controls tool selection behavior for sampling requests.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ToolChoice {
    /// Controls the tool use ability of the model:
    /// - `"auto"`: Model decides whether to use tools (default)
    /// - `"required"`: Model MUST use at least one tool before completing
    /// - `"none"`: Model MUST NOT use any tools
    #[serde(rename = "mode", default, skip_serializing_if = "Option::is_none")]
    pub mode: Option<ToolChoiceMode>,
}
/// Controls the tool use ability of the model:
/// - `"auto"`: Model decides whether to use tools (default)
/// - `"required"`: Model MUST use at least one tool before completing
/// - `"none"`: Model MUST NOT use any tools
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Serialize, Deserialize)]
pub enum ToolChoiceMode {
    /// `"auto"`
    #[serde(rename = "auto")]
    Auto,
    /// `"none"`
    #[serde(rename = "none")]
    None,
    /// `"required"`
    #[serde(rename = "required")]
    Required,
}
impl ToolChoiceMode {
    /// The wire representation of this value.
    #[must_use]
    pub const fn as_str(self) -> &'static str {
        match self {
            Self::Auto => "auto",
            Self::None => "none",
            Self::Required => "required",
        }
    }
}
/// A JSON Schema object defining the expected parameters for the tool.
///
/// Tool arguments are always JSON objects, so `type: "object"` is required at the root.
/// Beyond that, any JSON Schema 2020-12 keyword may appear alongside `type` — including
/// composition keywords (`oneOf`, `anyOf`, `allOf`, `not`), conditional keywords
/// (`if`/`then`/`else`), reference keywords (`$ref`, `$defs`, `$anchor`), and any other
/// standard validation or annotation keywords.
///
/// Property schemas may carry an `x-mcp-header` annotation to mirror the
/// argument value into an HTTP header on the Streamable HTTP transport. See
/// the Streamable HTTP transport specification for the validity and
/// extraction rules.
///
/// Defaults to JSON Schema 2020-12 when no explicit `$schema` is provided.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ToolInputSchema {
    #[serde(rename = "$schema", default, skip_serializing_if = "Option::is_none")]
    pub schema: Option<String>,
    #[serde(rename = "type")]
    pub r#type: ObjectType,
    /// Additional properties not described by the schema.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}
/// An optional notification from the server to the client, informing it that the list of tools it offers has changed. This is only delivered on a `SubscriptionsListenRequestsubscriptions/listen` stream when the client requested it via the `toolsListChanged` filter field.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ToolListChangedNotification {
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
    #[serde(rename = "method")]
    pub method: NotificationsToolsListChangedMethod,
    #[serde(rename = "params", default, skip_serializing_if = "Option::is_none")]
    pub params: Option<NotificationParams>,
}
/// An optional JSON Schema object defining the structure of the tool's output returned in
/// the structuredContent field of a `CallToolResult`. This can be any valid JSON Schema 2020-12.
///
/// Defaults to JSON Schema 2020-12 when no explicit `$schema` is provided.
#[derive(Debug, Clone, PartialEq, Default, Serialize, Deserialize)]
pub struct ToolOutputSchema {
    #[serde(rename = "$schema", default, skip_serializing_if = "Option::is_none")]
    pub schema: Option<String>,
    /// Additional properties not described by the schema.
    #[serde(flatten)]
    pub extra: serde_json::Map<String, serde_json::Value>,
}
/// The result of a tool use, provided by the user back to the assistant.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ToolResultContent {
    /// Optional metadata about the tool result. Clients SHOULD preserve this field when
    /// including tool results in subsequent sampling requests to enable caching optimizations.
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// The unstructured result content of the tool use.
    ///
    /// This has the same format as `CallToolResult.content` and can include text, images,
    /// audio, resource links, and embedded resources.
    #[serde(rename = "content")]
    pub content: Vec<ContentBlock>,
    /// Whether the tool use resulted in an error.
    ///
    /// If true, the content typically describes the error that occurred.
    /// Default: false
    #[serde(rename = "isError", default, skip_serializing_if = "Option::is_none")]
    pub is_error: Option<bool>,
    /// An optional structured result value.
    ///
    /// This can be any JSON value (object, array, string, number, boolean, or null).
    /// If the tool defined an `Tool.outputSchema`, this SHOULD conform to that schema.
    #[serde(
        rename = "structuredContent",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub structured_content: Option<serde_json::Value>,
    /// The ID of the tool use this result corresponds to.
    ///
    /// This MUST match the ID from a previous `ToolUseContent`.
    #[serde(rename = "toolUseId")]
    pub tool_use_id: String,
    #[serde(rename = "type")]
    pub r#type: ToolResultType,
}
impl ToolResultContent {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(content: Vec<ContentBlock>, tool_use_id: String) -> Self {
        Self {
            meta: None,
            content,
            is_error: None,
            structured_content: None,
            tool_use_id,
            r#type: Default::default(),
        }
    }
}
/// The constant `"tool_result"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ToolResultType {
    /// The constant `"tool_result"`.
    #[default]
    #[serde(rename = "tool_result")]
    ToolResult,
}
impl ToolResultType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "tool_result";
}
/// A request from the assistant to call a tool.
#[deprecated(
    note = "Deprecated as of protocol version 2026-07-28 (SEP-2577). Remains in the specification for at least twelve months; see the deprecated features registry."
)]
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct ToolUseContent {
    /// Optional metadata about the tool use. Clients SHOULD preserve this field when
    /// including tool uses in subsequent sampling requests to enable caching optimizations.
    #[serde(rename = "_meta", default, skip_serializing_if = "Option::is_none")]
    pub meta: Option<MetaObject>,
    /// A unique identifier for this tool use.
    ///
    /// This ID is used to match tool results to their corresponding tool uses.
    #[serde(rename = "id")]
    pub id: String,
    /// The arguments to pass to the tool, conforming to the tool's input schema.
    #[serde(rename = "input")]
    pub input: serde_json::Map<String, serde_json::Value>,
    /// The name of the tool to call.
    #[serde(rename = "name")]
    pub name: String,
    #[serde(rename = "type")]
    pub r#type: ToolUseType,
}
impl ToolUseContent {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(
        id: String,
        input: serde_json::Map<String, serde_json::Value>,
        name: String,
    ) -> Self {
        Self {
            meta: None,
            id,
            input,
            name,
            r#type: Default::default(),
        }
    }
}
/// The constant `"tool_use"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ToolUseType {
    /// The constant `"tool_use"`.
    #[default]
    #[serde(rename = "tool_use")]
    ToolUse,
}
impl ToolUseType {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "tool_use";
}
/// The constant `"tools/call"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ToolsCallMethod {
    /// The constant `"tools/call"`.
    #[default]
    #[serde(rename = "tools/call")]
    ToolsCall,
}
impl ToolsCallMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "tools/call";
}
/// The constant `"tools/list"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum ToolsListMethod {
    /// The constant `"tools/list"`.
    #[default]
    #[serde(rename = "tools/list")]
    ToolsList,
}
impl ToolsListMethod {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "tools/list";
}
/// Returned when the request's protocol version is unknown to the server or
/// unsupported (e.g., a known experimental or draft version the server has
/// chosen not to implement). For HTTP, the response status code MUST be
/// `400 Bad Request`.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct UnsupportedProtocolVersionError {
    #[serde(rename = "error")]
    pub error: UnsupportedProtocolVersionErrorObject,
    #[serde(rename = "id", default, skip_serializing_if = "Option::is_none")]
    pub id: Option<RequestId>,
    #[serde(rename = "jsonrpc")]
    pub jsonrpc: JsonRpcVersion,
}
impl UnsupportedProtocolVersionError {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(error: UnsupportedProtocolVersionErrorObject) -> Self {
        Self {
            error,
            id: None,
            jsonrpc: Default::default(),
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct UnsupportedProtocolVersionErrorData {
    /// The protocol version that was requested by the client.
    #[serde(rename = "requested")]
    pub requested: String,
    /// Protocol versions the server supports. The client should choose a
    /// mutually supported version from this list and retry.
    #[serde(rename = "supported")]
    pub supported: Vec<String>,
}
impl UnsupportedProtocolVersionErrorData {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(requested: String, supported: Vec<String>) -> Self {
        Self {
            requested,
            supported,
        }
    }
}
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct UnsupportedProtocolVersionErrorObject {
    #[serde(rename = "code")]
    pub code: i64,
    #[serde(rename = "data")]
    pub data: UnsupportedProtocolVersionErrorData,
    /// A short description of the error. The message SHOULD be limited to a concise single sentence.
    #[serde(rename = "message")]
    pub message: String,
}
impl UnsupportedProtocolVersionErrorObject {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(code: i64, data: UnsupportedProtocolVersionErrorData, message: String) -> Self {
        Self {
            code,
            data,
            message,
        }
    }
}
/// Schema for multiple-selection enumeration without display titles for options.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct UntitledMultiSelectEnumSchema {
    /// Optional default value.
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<Vec<String>>,
    /// Optional description for the enum field.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Schema for the array items.
    #[serde(rename = "items")]
    pub items: UntitledMultiSelectEnumSchemaItems,
    /// Maximum number of items to select.
    #[serde(rename = "maxItems", default, skip_serializing_if = "Option::is_none")]
    pub max_items: Option<i64>,
    /// Minimum number of items to select.
    #[serde(rename = "minItems", default, skip_serializing_if = "Option::is_none")]
    pub min_items: Option<i64>,
    /// Optional title for the enum field.
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: ArrayType,
}
impl UntitledMultiSelectEnumSchema {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(items: UntitledMultiSelectEnumSchemaItems) -> Self {
        Self {
            default: None,
            description: None,
            items,
            max_items: None,
            min_items: None,
            title: None,
            r#type: Default::default(),
        }
    }
}
/// Schema for the array items.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct UntitledMultiSelectEnumSchemaItems {
    /// Array of enum values to choose from.
    #[serde(rename = "enum")]
    pub r#enum: Vec<String>,
    #[serde(rename = "type")]
    pub r#type: StringType,
}
impl UntitledMultiSelectEnumSchemaItems {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(r#enum: Vec<String>) -> Self {
        Self {
            r#enum,
            r#type: Default::default(),
        }
    }
}
/// Schema for single-selection enumeration without display titles for options.
#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
pub struct UntitledSingleSelectEnumSchema {
    /// Optional default value.
    #[serde(rename = "default", default, skip_serializing_if = "Option::is_none")]
    pub default: Option<String>,
    /// Optional description for the enum field.
    #[serde(
        rename = "description",
        default,
        skip_serializing_if = "Option::is_none"
    )]
    pub description: Option<String>,
    /// Array of enum values to choose from.
    #[serde(rename = "enum")]
    pub r#enum: Vec<String>,
    /// Optional title for the enum field.
    #[serde(rename = "title", default, skip_serializing_if = "Option::is_none")]
    pub title: Option<String>,
    #[serde(rename = "type")]
    pub r#type: StringType,
}
impl UntitledSingleSelectEnumSchema {
    /// Creates a value from its required fields; optional fields are `None`.
    #[must_use]
    pub fn new(r#enum: Vec<String>) -> Self {
        Self {
            default: None,
            description: None,
            r#enum,
            title: None,
            r#type: Default::default(),
        }
    }
}
/// The constant `"url"`.
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash, Default, Serialize, Deserialize)]
pub enum UrlMode {
    /// The constant `"url"`.
    #[default]
    #[serde(rename = "url")]
    Url,
}
impl UrlMode {
    /// The wire representation of this constant.
    pub const VALUE: &'static str = "url";
}