Initial implementation
This commit is contained in:
parent
cc603d35fe
commit
be1e9583f8
1 changed files with 4304 additions and 884 deletions
332
Sources/MCP/Base/Messages.swift
Normal file
332
Sources/MCP/Base/Messages.swift
Normal file
|
|
@ -0,0 +1,332 @@
|
|||
import Foundation
|
||||
|
||||
private let jsonrpc = "2.0"
|
||||
|
||||
public struct Empty: Hashable, Codable, Sendable {}
|
||||
|
||||
// MARK: -
|
||||
|
||||
/// A method that can be used to send requests and receive responses.
|
||||
public protocol Method {
|
||||
/// The parameters of the method.
|
||||
associatedtype Parameters: Codable, Hashable, Sendable = Empty
|
||||
/// The result of the method.
|
||||
associatedtype Result: Codable, Hashable, Sendable = Empty
|
||||
/// The name of the method.
|
||||
static var name: String { get }
|
||||
}
|
||||
|
||||
/// Type-erased method for request/response handling
|
||||
struct AnyMethod: Method {
|
||||
static var name: String { "" }
|
||||
typealias Parameters = Value
|
||||
typealias Result = Value
|
||||
}
|
||||
|
||||
extension Method where Parameters == Empty {
|
||||
public static func request(id: ID = .random) -> Request<Self> {
|
||||
Request(id: id, method: name, params: Empty())
|
||||
}
|
||||
}
|
||||
|
||||
extension Method where Result == Empty {
|
||||
public static func response(id: ID) -> Response<Self> {
|
||||
Response(id: id, result: Empty())
|
||||
}
|
||||
}
|
||||
|
||||
extension Method {
|
||||
/// Create a request with the given parameters.
|
||||
public static func request(id: ID = .random, _ parameters: Self.Parameters) -> Request<Self> {
|
||||
Request(id: id, method: name, params: parameters)
|
||||
}
|
||||
|
||||
/// Create a response with the given result.
|
||||
public static func response(id: ID, result: Self.Result) -> Response<Self> {
|
||||
Response(id: id, result: result)
|
||||
}
|
||||
|
||||
/// Create a response with the given error.
|
||||
public static func response(id: ID, error: Error) -> Response<Self> {
|
||||
Response(id: id, error: error)
|
||||
}
|
||||
}
|
||||
|
||||
// MARK: -
|
||||
|
||||
/// A request message.
|
||||
public struct Request<M: Method>: Hashable, Identifiable, Codable, Sendable {
|
||||
/// The request ID.
|
||||
public let id: ID
|
||||
/// The method name.
|
||||
public let method: String
|
||||
/// The request parameters.
|
||||
public let params: M.Parameters
|
||||
|
||||
init(id: ID = .random, method: String, params: M.Parameters) {
|
||||
self.id = id
|
||||
self.method = method
|
||||
self.params = params
|
||||
}
|
||||
|
||||
private enum CodingKeys: String, CodingKey {
|
||||
case jsonrpc, id, method, params
|
||||
}
|
||||
|
||||
public func encode(to encoder: Encoder) throws {
|
||||
var container = encoder.container(keyedBy: CodingKeys.self)
|
||||
try container.encode(jsonrpc, forKey: .jsonrpc)
|
||||
try container.encode(id, forKey: .id)
|
||||
try container.encode(method, forKey: .method)
|
||||
if M.Parameters.self != Empty.self {
|
||||
try container.encode(params, forKey: .params)
|
||||
} else {
|
||||
// Encode empty object for Empty parameters
|
||||
try container.encode(Empty(), forKey: .params)
|
||||
}
|
||||
}
|
||||
|
||||
public init(from decoder: Decoder) throws {
|
||||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||||
let version = try container.decode(String.self, forKey: .jsonrpc)
|
||||
guard version == jsonrpc else {
|
||||
throw DecodingError.dataCorruptedError(
|
||||
forKey: .jsonrpc, in: container, debugDescription: "Invalid JSON-RPC version")
|
||||
}
|
||||
id = try container.decode(ID.self, forKey: .id)
|
||||
method = try container.decode(String.self, forKey: .method)
|
||||
if M.Parameters.self == Empty.self {
|
||||
if (try? container.decodeNil(forKey: .params)) != nil {
|
||||
params = Empty() as! M.Parameters
|
||||
} else if (try? container.decode(Empty.self, forKey: .params)) != nil {
|
||||
params = Empty() as! M.Parameters
|
||||
} else {
|
||||
// If params field is missing, use Empty
|
||||
params = Empty() as! M.Parameters
|
||||
}
|
||||
} else {
|
||||
params = try container.decode(M.Parameters.self, forKey: .params)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// A type-erased request for request/response handling
|
||||
typealias AnyRequest = Request<AnyMethod>
|
||||
|
||||
/// A box for request handlers that can be type-erased
|
||||
class RequestHandlerBox: @unchecked Sendable {
|
||||
func callAsFunction(_ request: Request<AnyMethod>) async throws -> Response<AnyMethod> {
|
||||
fatalError("Must override")
|
||||
}
|
||||
}
|
||||
|
||||
/// A typed request handler that can be used to handle requests of a specific type
|
||||
final class TypedRequestHandler<M: Method>: RequestHandlerBox, @unchecked Sendable {
|
||||
private let _handle: @Sendable (Request<M>) async throws -> Response<M>
|
||||
|
||||
init(_ handler: @escaping @Sendable (Request<M>) async throws -> Response<M>) {
|
||||
self._handle = handler
|
||||
super.init()
|
||||
}
|
||||
|
||||
override func callAsFunction(_ request: Request<AnyMethod>) async throws -> Response<AnyMethod>
|
||||
{
|
||||
// Create a concrete request from the type-erased one
|
||||
let data = try JSONEncoder().encode(request.params)
|
||||
let params = try JSONDecoder().decode(M.Parameters.self, from: data)
|
||||
let typedRequest = Request<M>(id: request.id, method: M.name, params: params)
|
||||
|
||||
// Handle with concrete type
|
||||
let response = try await _handle(typedRequest)
|
||||
|
||||
// Convert result to AnyMethod response
|
||||
switch response.result {
|
||||
case .success(let result):
|
||||
let resultData = try JSONEncoder().encode(result)
|
||||
let resultValue = try JSONDecoder().decode(Value.self, from: resultData)
|
||||
return Response(id: response.id, result: resultValue)
|
||||
case .failure(let error):
|
||||
return Response(id: response.id, error: error)
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// MARK: -
|
||||
|
||||
/// A response message.
|
||||
public struct Response<M: Method>: Hashable, Identifiable, Codable, Sendable {
|
||||
/// The response ID.
|
||||
public let id: ID
|
||||
/// The response result.
|
||||
public let result: Swift.Result<M.Result, Error>
|
||||
|
||||
public init(id: ID, result: M.Result) {
|
||||
self.id = id
|
||||
self.result = .success(result)
|
||||
}
|
||||
|
||||
public init(id: ID, error: Error) {
|
||||
self.id = id
|
||||
self.result = .failure(error)
|
||||
}
|
||||
|
||||
private enum CodingKeys: String, CodingKey {
|
||||
case jsonrpc, id, result, error
|
||||
}
|
||||
|
||||
public func encode(to encoder: Encoder) throws {
|
||||
var container = encoder.container(keyedBy: CodingKeys.self)
|
||||
try container.encode(jsonrpc, forKey: .jsonrpc)
|
||||
try container.encode(id, forKey: .id)
|
||||
switch result {
|
||||
case .success(let result):
|
||||
try container.encode(result, forKey: .result)
|
||||
case .failure(let error):
|
||||
try container.encode(error, forKey: .error)
|
||||
}
|
||||
}
|
||||
|
||||
public init(from decoder: Decoder) throws {
|
||||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||||
let version = try container.decode(String.self, forKey: .jsonrpc)
|
||||
guard version == jsonrpc else {
|
||||
throw DecodingError.dataCorruptedError(
|
||||
forKey: .jsonrpc, in: container, debugDescription: "Invalid JSON-RPC version")
|
||||
}
|
||||
id = try container.decode(ID.self, forKey: .id)
|
||||
if let result = try? container.decode(M.Result.self, forKey: .result) {
|
||||
self.result = .success(result)
|
||||
} else if let error = try? container.decode(Error.self, forKey: .error) {
|
||||
self.result = .failure(error)
|
||||
} else {
|
||||
throw DecodingError.dataCorrupted(
|
||||
DecodingError.Context(
|
||||
codingPath: container.codingPath,
|
||||
debugDescription: "Invalid response"))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// A type-erased response for request/response handling
|
||||
typealias AnyResponse = Response<AnyMethod>
|
||||
|
||||
// MARK: -
|
||||
|
||||
/// A notification message.
|
||||
public protocol Notification {
|
||||
/// The parameters of the notification.
|
||||
associatedtype Parameters: Hashable, Codable, Sendable = Empty
|
||||
/// The name of the notification.
|
||||
static var name: String { get }
|
||||
}
|
||||
|
||||
/// A type-erased notification for message handling
|
||||
struct AnyNotification: Notification {
|
||||
static var name: String { "" }
|
||||
typealias Parameters = Empty
|
||||
}
|
||||
|
||||
/// A message that can be used to send notifications.
|
||||
public struct Message<N: Notification>: Hashable, Codable, Sendable {
|
||||
/// The method name.
|
||||
public let method: String
|
||||
/// The notification parameters.
|
||||
public let params: N.Parameters
|
||||
|
||||
public init(method: String, params: N.Parameters) {
|
||||
self.method = method
|
||||
self.params = params
|
||||
}
|
||||
|
||||
private enum CodingKeys: String, CodingKey {
|
||||
case jsonrpc, method, params
|
||||
}
|
||||
|
||||
public func encode(to encoder: Encoder) throws {
|
||||
var container = encoder.container(keyedBy: CodingKeys.self)
|
||||
try container.encode(jsonrpc, forKey: .jsonrpc)
|
||||
try container.encode(method, forKey: .method)
|
||||
if N.Parameters.self != Empty.self {
|
||||
try container.encode(params, forKey: .params)
|
||||
}
|
||||
}
|
||||
|
||||
public init(from decoder: Decoder) throws {
|
||||
let container = try decoder.container(keyedBy: CodingKeys.self)
|
||||
let version = try container.decode(String.self, forKey: .jsonrpc)
|
||||
guard version == jsonrpc else {
|
||||
throw DecodingError.dataCorruptedError(
|
||||
forKey: .jsonrpc, in: container, debugDescription: "Invalid JSON-RPC version")
|
||||
}
|
||||
method = try container.decode(String.self, forKey: .method)
|
||||
|
||||
// Handle params field being optional
|
||||
if N.Parameters.self == Empty.self {
|
||||
// For Empty parameters, use Empty() if params is missing or null
|
||||
params = Empty() as! N.Parameters
|
||||
} else if let value = try? container.decode(N.Parameters.self, forKey: .params) {
|
||||
// If params exists and can be decoded, use it
|
||||
params = value
|
||||
} else if !container.contains(.params)
|
||||
|| (try? container.decodeNil(forKey: .params)) == true
|
||||
{
|
||||
// If params is missing or explicitly null, use Empty for Empty parameters
|
||||
// or throw for non-Empty parameters
|
||||
if N.Parameters.self == Empty.self {
|
||||
params = Empty() as! N.Parameters
|
||||
} else {
|
||||
throw DecodingError.dataCorrupted(
|
||||
DecodingError.Context(
|
||||
codingPath: container.codingPath,
|
||||
debugDescription: "Missing required params field"))
|
||||
}
|
||||
} else {
|
||||
throw DecodingError.dataCorrupted(
|
||||
DecodingError.Context(
|
||||
codingPath: container.codingPath,
|
||||
debugDescription: "Invalid params field"))
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/// A type-erased message for message handling
|
||||
typealias AnyMessage = Message<AnyNotification>
|
||||
|
||||
extension Notification where Parameters == Empty {
|
||||
/// Create a message with empty parameters.
|
||||
public static func message() -> Message<Self> {
|
||||
Message(method: name, params: Empty())
|
||||
}
|
||||
}
|
||||
|
||||
extension Notification {
|
||||
/// Create a message with the given parameters.
|
||||
public static func message(_ parameters: Parameters) -> Message<Self> {
|
||||
Message(method: name, params: parameters)
|
||||
}
|
||||
}
|
||||
|
||||
/// A box for notification handlers that can be type-erased
|
||||
class NotificationHandlerBox: @unchecked Sendable {
|
||||
func callAsFunction(_ notification: Message<AnyNotification>) async throws {}
|
||||
}
|
||||
|
||||
/// A typed notification handler that can be used to handle notifications of a specific type
|
||||
final class TypedNotificationHandler<N: Notification>: NotificationHandlerBox,
|
||||
@unchecked Sendable
|
||||
{
|
||||
private let _handle: @Sendable (Message<N>) async throws -> Void
|
||||
|
||||
init(_ handler: @escaping @Sendable (Message<N>) async throws -> Void) {
|
||||
self._handle = handler
|
||||
super.init()
|
||||
}
|
||||
|
||||
override func callAsFunction(_ notification: Message<AnyNotification>) async throws {
|
||||
// Create a concrete notification from the type-erased one
|
||||
let data = try JSONEncoder().encode(notification)
|
||||
let typedNotification = try JSONDecoder().decode(Message<N>.self, from: data)
|
||||
|
||||
try await _handle(typedNotification)
|
||||
}
|
||||
}
|
||||
Loading…
Reference in a new issue