Enum Request 

pub enum Request {
    Ping,
    Hello {
        client_id: Option<String>,
        requested_capabilities: Vec<String>,
        ucan_tokens: Vec<String>,
    },
    ToolList,
    ToolSchema {
        tool_id: String,
    },
    RunTool {
        tool_id: String,
        args: Value,
        dry_run: bool,
    },
    RunToolContinue {
        tool_id: String,
        cursor: String,
    },
}

Request frames sent from client → server.

Variants

Ping

Hello

SP-12 Hello handshake. Optional: pre-SP-12 servers do not recognize it; AtdClient::hello tolerates that and returns an empty granted set so callers can treat “no capabilities” and “server too old” identically.

SP-capability-v2 (2026-05-11) adds the optional ucan_tokens field. When non-empty, each element is a UCAN-lite JWT compact form (alg=EdDSA, typ=ucan/1.0+jwt); the server’s verifier produces granted = granted_strings ∪ granted_ucan. Pre-SP-capability-v2 servers omit the field via serde default; their behaviour is byte- identical to SP-12. Spec §4.2 + §5.2.

Fields

client_id: Option<String>

requested_capabilities: Vec<String>

ucan_tokens: Vec<String>

ToolList

ToolSchema

Fields

tool_id: String

RunTool

Fields

tool_id: String

args: Value

dry_run: bool

RunToolContinue

Fetch the next page of a paginated tool result. The cursor is the server-issued opaque string from a prior Response::ToolResultResponse.next_cursor. tool_id must match the cursor’s embedded tool_id (server validates). SP-pagination-v1 §4.1.

Fields

tool_id: String

cursor: String

Trait Implementations

impl Clone for Request

fn clone(&self) -> Request

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Request

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Request

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

where __S: Serializer,

Serialize this value into the given Serde serializer.