macro_rules! impl_jsonrpc_request {
($req:ty, $resp:ty, $method:literal) => {
impl $crate::JsonRpcMessage for $req {
fn matches_method(method: &str) -> bool {
method == $method
}
fn method(&self) -> &str {
$method
}
fn to_untyped_message(&self) -> Result<$crate::UntypedMessage, $crate::Error> {
$crate::UntypedMessage::new($method, self)
}
fn parse_message(
method: &str,
params: &serde_json::Value,
) -> Result<Self, $crate::Error> {
if method != $method {
return Err($crate::Error::method_not_found());
}
$crate::util::json_cast_params(params)
}
}
impl $crate::JsonRpcRequest for $req {
type Response = $resp;
}
impl $crate::JsonRpcResponse for $resp {
fn into_json(self, _method: &str) -> Result<serde_json::Value, $crate::Error> {
serde_json::to_value(self).map_err($crate::Error::into_internal_error)
}
fn from_json(_method: &str, value: serde_json::Value) -> Result<Self, $crate::Error> {
$crate::util::json_cast(&value)
}
}
};
}
macro_rules! impl_jsonrpc_notification {
($notif:ty, $method:literal) => {
impl $crate::JsonRpcMessage for $notif {
fn matches_method(method: &str) -> bool {
method == $method
}
fn method(&self) -> &str {
$method
}
fn to_untyped_message(&self) -> Result<$crate::UntypedMessage, $crate::Error> {
$crate::UntypedMessage::new($method, self)
}
fn parse_message(
method: &str,
params: &serde_json::Value,
) -> Result<Self, $crate::Error> {
if method != $method {
return Err($crate::Error::method_not_found());
}
$crate::util::json_cast_params(params)
}
}
impl $crate::JsonRpcNotification for $notif {}
};
}
macro_rules! impl_jsonrpc_message_enum {
($enum:ty, $matches:expr) => {
impl $crate::JsonRpcMessage for $enum {
fn matches_method(method: &str) -> bool {
($matches)(method)
}
fn method(&self) -> &str {
<$enum>::method(self)
}
fn to_untyped_message(&self) -> Result<$crate::UntypedMessage, $crate::Error> {
$crate::UntypedMessage::new(<$enum>::method(self), self)
}
fn parse_message(
method: &str,
params: &serde_json::Value,
) -> Result<Self, $crate::Error> {
<$enum>::from_method_and_params(method, params).map_err(|error| {
$crate::schema::dispatch_error(
error,
params.clone(),
$crate::Error::invalid_params,
)
})
}
}
};
}
macro_rules! impl_jsonrpc_request_enum {
($enum:ty) => {
impl_jsonrpc_message_enum!($enum, |_| true);
impl $crate::JsonRpcRequest for $enum {
type Response = serde_json::Value;
}
};
}
macro_rules! impl_jsonrpc_notification_enum {
($enum:ty) => {
impl_jsonrpc_message_enum!($enum, |_| true);
impl $crate::JsonRpcNotification for $enum {}
};
}
macro_rules! impl_jsonrpc_protocol_level_notification_enum {
($enum:ty) => {
impl_jsonrpc_message_enum!($enum, <$enum>::supports_method);
impl $crate::JsonRpcNotification for $enum {}
};
}
macro_rules! impl_jsonrpc_response_enum {
($enum:ty) => {
impl $crate::JsonRpcResponse for $enum {
fn into_json(self, _method: &str) -> Result<serde_json::Value, $crate::Error> {
serde_json::to_value(self).map_err($crate::Error::into_internal_error)
}
fn from_json(method: &str, value: serde_json::Value) -> Result<Self, $crate::Error> {
<$enum>::from_method_and_result(method, value.clone()).map_err(|error| {
$crate::schema::dispatch_error(error, value, $crate::Error::parse_error)
})
}
}
};
}
fn dispatch_error(
error: agent_client_protocol_schema::MethodDispatchError,
payload: serde_json::Value,
invalid_payload: fn() -> crate::Error,
) -> crate::Error {
use agent_client_protocol_schema::MethodDispatchError;
match error {
MethodDispatchError::UnknownMethod { .. } => crate::Error::method_not_found(),
MethodDispatchError::InvalidPayload { source, .. } => {
invalid_payload().data(serde_json::json!({
"error": source.to_string(),
"json": payload,
"phase": "deserialization",
}))
}
_ => crate::Error::internal_error(),
}
}
mod agent_to_client;
mod client_to_agent;
mod enum_impls;
#[cfg(feature = "unstable_mcp_over_acp")]
mod mcp;
mod protocol_level;
mod proxy_protocol;
#[cfg(feature = "unstable_protocol_v2")]
mod v2_impls;
pub use agent_client_protocol_schema::{
IndexMap, IntoMaybeUndefined, IntoOption, MaybeUndefined, MethodDispatchError, ProtocolVersion,
};
pub use proxy_protocol::SuccessorMessage;