agentic 0.0.4

Support library for building Agentic MCP and Agent2Agent based systems
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use crate::mcp::{GenericMeta, IntoMcpNotification, IntoMcpRequest, McpNotification, RequestMeta};
use serde::{Deserialize, Serialize};
use serde_json::Value;

/// The severity of a log message.
///
/// These map to syslog message severities, as specified in RFC-5424:
/// <https://datatracker.ietf.org/doc/html/rfc5424#section-6.2.1>
#[derive(Debug, Clone, Serialize, Deserialize, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum LoggingLevel {
	Debug,
	Info,
	Notice,
	Warning,
	Error,
	Critical,
	Alert,
	Emergency,
}

// region:    --- SetLevelRequest

/// A request from the client to the server, to enable or adjust logging.
///
/// TS Ref: `SetLevelRequest`
#[serde_with::skip_serializing_none]
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "camelCase")]
pub struct SetLevelParams {
	#[serde(rename = "_meta")]
	pub meta: Option<RequestMeta>,

	/// The level of logging that the client wants to receive from the server.
	/// The server should send all logs at this level and higher (i.e., more severe) to the client as notifications/message.
	pub level: LoggingLevel,
}

/// Builders
impl SetLevelParams {
	pub fn new(level: LoggingLevel) -> Self {
		Self { meta: None, level }
	}

	pub fn with_meta(mut self, meta: RequestMeta) -> Self {
		self.meta = Some(meta);
		self
	}
}

impl IntoMcpRequest<SetLevelParams> for SetLevelParams {
	const METHOD: &'static str = "logging/setLevel";
	type McpResult = ();
}

// Note: The result for SetLevelRequest is `EmptyResult`, which translates to a standard JSON-RPC success response
// with an empty `result` object (potentially containing only `_meta`).
// No specific struct is needed for `EmptyResult` itself beyond standard result handling.

// endregion: --- SetLevelRequest

// region:    --- LoggingMessageNotification

/// Notification of a log message passed from server to client.
/// If no logging/setLevel request has been sent from the client, the server MAY decide which messages to send automatically.
///
/// TS Ref: `LoggingMessageNotification`
#[serde_with::skip_serializing_none]
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LoggingMessageNotificationParams {
	#[serde(rename = "_meta")]
	pub meta: Option<GenericMeta>,

	/// The severity of this log message.
	pub level: LoggingLevel,

	/// An optional name of the logger issuing this message.
	pub logger: Option<String>,
	/// The data to be logged, such as a string message or an object. Any JSON serializable type is allowed here.
	pub data: Value,
}

/// Builders
impl LoggingMessageNotificationParams {
	pub fn new(level: LoggingLevel, data: impl Into<Value>) -> Self {
		Self {
			meta: None,
			level,
			logger: None,
			data: data.into(),
		}
	}

	pub fn with_meta(mut self, meta: GenericMeta) -> Self {
		self.meta = Some(meta);
		self
	}

	pub fn with_logger(mut self, logger: impl Into<String>) -> Self {
		self.logger = Some(logger.into());
		self
	}
}

impl IntoMcpNotification for LoggingMessageNotificationParams {
	const METHOD: &'static str = "notifications/message";
}

pub type LoggingMessageNotification = McpNotification<LoggingMessageNotificationParams>;

// endregion: --- LoggingMessageNotification