Enum AgentRequest 

#[non_exhaustive]
pub enum AgentRequest {
    RequestPermissionRequest(RequestPermissionRequest),
    CreateElicitationRequest(CreateElicitationRequest),
    ConnectMcpRequest(ConnectMcpRequest),
    MessageMcpRequest(MessageMcpRequest),
    DisconnectMcpRequest(DisconnectMcpRequest),
    ExtMethodRequest(ExtRequest),
}

Available on crate feature unstable_protocol_v2 only.

All possible requests that an agent can send to a client.

This enum is used internally for routing RPC requests. You typically won’t need to use this directly.

This enum encompasses all method calls from agent to client.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

RequestPermissionRequest(RequestPermissionRequest)

Requests permission from the user for a tool call operation.

Called by the agent when it needs user authorization before executing a potentially sensitive operation. The client should present the options to the user and return their decision.

If the client cancels the prompt turn via session/cancel, it MUST respond to this request with RequestPermissionOutcome::Cancelled.

See protocol docs: Requesting Permission

CreateElicitationRequest(CreateElicitationRequest)

Available on crate feature unstable_elicitation only.

UNSTABLE

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

Requests structured user input via a form or URL.

ConnectMcpRequest(ConnectMcpRequest)

Available on crate feature unstable_mcp_over_acp only.

UNSTABLE

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

Opens an MCP-over-ACP connection.

MessageMcpRequest(MessageMcpRequest)

Available on crate feature unstable_mcp_over_acp only.

UNSTABLE

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

Exchanges an MCP-over-ACP message.

DisconnectMcpRequest(DisconnectMcpRequest)

Available on crate feature unstable_mcp_over_acp only.

UNSTABLE

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

Closes an MCP-over-ACP connection.

ExtMethodRequest(ExtRequest)

Handles extension method requests from the agent.

Allows the Agent to send an arbitrary request that is not part of the ACP spec. Extension methods provide a way to add custom functionality while maintaining protocol compatibility.

See protocol docs: Extensibility

Implementations

impl AgentRequest

pub fn method(&self) -> &str

Returns the corresponding method name of the request.

Trait Implementations

impl Clone for AgentRequest

fn clone(&self) -> AgentRequest

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AgentRequest

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentRequest

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl IntoV1 for AgentRequest

type Output = AgentRequest

The corresponding v1 type.

fn into_v1(self) -> Result<Self::Output>

Converts this value into the corresponding v1 type.

impl JsonSchema for AgentRequest

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

The name of the generated JSON Schema.

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

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

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

Generates a JSON Schema for this type.

fn inline_schema() -> bool

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

impl Serialize for AgentRequest

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

where __S: Serializer,

Serialize this value into the given Serde serializer.