Skip to main content

AgentRequest

Enum AgentRequest 

Source
#[non_exhaustive]
pub enum AgentRequest { RequestPermissionRequest(Box<RequestPermissionRequest>), CreateElicitationRequest(Box<CreateElicitationRequest>), MessageMcpRequest(Box<MessageMcpRequest>), ExtMethodRequest(Box<ExtRequest>), }
Available on crate feature unstable_protocol_v2 only.
Expand description

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)§

This enum is marked as 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(Box<RequestPermissionRequest>)

Requests permission from the user for an operation.

Called by the Agent when it needs user authorization before executing a potentially sensitive operation. The Client presents the options to the user and returns their decision.

After session/cancel, the Agent stops waiting for requests of the cancelled foreground work and MUST cancel them with $/cancel_request. The Client answers a cancelled request with the cancelled outcome.

If the selected option has kind reject_once or reject_always, the Agent MUST NOT perform the requested operation.

An error response is not approval, and neither is a connection that ends before the Client answers. The Agent MUST NOT treat either as approval.

See protocol docs: Requesting Permission

§

CreateElicitationRequest(Box<CreateElicitationRequest>)

Requests structured user input via a form or URL.

See protocol docs: Elicitation

§

MessageMcpRequest(Box<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.

§

ExtMethodRequest(Box<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 are custom methods that are not part of the ACP spec.

See protocol docs: Extensibility

Implementations§

Source§

impl AgentRequest

Source

pub fn method(&self) -> &str

Returns the corresponding method name.

Source

pub fn supports_method(method: &str) -> bool

Whether this enum recognizes the method with the enabled Cargo features, including extensions when it has an extension variant.

This does not check the peer’s advertised capabilities.

Source

pub fn from_method_and_params( method: &str, params: &Value, ) -> Result<AgentRequest, MethodDispatchError>

Parses parameters selected by the JSON-RPC method name.

Use this instead of the enum’s untagged Deserialize implementation. Untagged deserialization selects by payload shape, which can silently select an unrelated variant.

The payload is passed unchanged to the selected type’s deserializer. In particular, null is not converted to {}. Extension payloads retain their JSON value and method name.

§Errors

Returns crate::MethodDispatchError::UnknownMethod for an unsupported method, or crate::MethodDispatchError::InvalidPayload for a malformed payload.

Trait Implementations§

Source§

impl Clone for AgentRequest

Source§

fn clone(&self) -> AgentRequest

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for AgentRequest

Source§

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

Formats the value using the given formatter. Read more
Source§

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

Source§

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

Deserialize this value from the given Serde deserializer. Read more
Source§

impl JsonRpcMessage for AgentRequest

Source§

fn matches_method(method: &str) -> bool

Check if this message type matches the given method name.
Source§

fn method(&self) -> &str

The method name for the message.
Source§

fn to_untyped_message(&self) -> Result<UntypedMessage, Error>

Convert this message into an untyped message. Read more
Source§

fn parse_message(method: &str, params: &Value) -> Result<Self, Error>

Parse this type from a method name and the message’s JSON params. Read more
Source§

impl JsonRpcRequest for AgentRequest

Source§

type Response = Value

The type of data expected in response.
Source§

impl JsonSchema for AgentRequest

Source§

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

The name of the generated JSON Schema. Read more
Source§

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

Returns a string that uniquely identifies the schema produced by this type. Read more
Source§

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

Generates a JSON Schema for this type. Read more
Source§

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. Read more
Source§

impl Serialize for AgentRequest

Source§

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

Serialize this value into the given Serde serializer. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoMaybeUndefined<T> for T

Source§

fn into_maybe_undefined(self) -> MaybeUndefined<T>

Converts this value into a three-state builder argument.
Source§

impl<T> IntoOption<T> for T

Source§

fn into_option(self) -> Option<T>

Converts this value into an optional builder argument.
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more