Enum RpcOutcome 

pub enum RpcOutcome {
    Single(JsonRpcResponse),
    Batch(Vec<JsonRpcResponse>),
}

A dispatched JSON-RPC result, ready to be inspected or rendered.

Returned by McpServer::handle_message. A None from that method means there is nothing to send (a notification, or a batch of only notifications); a Some is either a Single response object or a Batch array.

RpcOutcome implements Serialize and Display, both rendering a Single as a JSON object and a Batch as a JSON array. Use to_wire (or .to_string()) for a String, or write_json to append directly to a byte buffer — each serializes in a single pass with no intermediate serde_json::Value.

Variants

Single(JsonRpcResponse)

A single JSON-RPC response object.

Batch(Vec<JsonRpcResponse>)

A JSON-RPC batch response array (always non-empty).

Implementations

impl RpcOutcome

pub fn to_wire(&self) -> String

Render this outcome to a single JSON wire string.

Panics

Panics only if a well-formed MCP response fails to serialize, which would indicate a bug in this crate.

pub fn write_json(&self, buf: &mut Vec<u8>)

Render this outcome’s JSON wire form by appending it to buf.

Lets callers reuse a single buffer across many responses, avoiding a fresh allocation per message.

Panics

Panics only if a well-formed MCP response fails to serialize, which would indicate a bug in this crate.

pub const fn is_batch(&self) -> bool

Returns true if this is a Batch of responses.

pub fn into_responses(self) -> Vec<JsonRpcResponse>

Consume the outcome into a flat list of responses.

A Single yields a one-element Vec; a Batch yields its responses unchanged.

Trait Implementations

impl Clone for RpcOutcome

fn clone(&self) -> RpcOutcome

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RpcOutcome

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

Formats the value using the given formatter.

impl Display for RpcOutcome

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

Renders the JSON wire form (object for Single, array for Batch).

impl Eq for RpcOutcome

impl PartialEq for RpcOutcome

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RpcOutcome

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RpcOutcome