kotlin-sdk-core/io.modelcontextprotocol.kotlin.sdk.shared/RequestHandlerExtra

RequestHandlerExtra

class RequestHandlerExtra : AbstractCoroutineContextElement(source)

Extra data given to request handlers.

One instance exists per in-flight inbound request. It is passed as the second parameter to low-level handlers registered via Protocol.setRequestHandler and installed into the handler coroutine's CoroutineContext, so code nested anywhere under the handler can reach it via currentRequestHandlerExtra without parameter plumbing.

Types

Key

object Key : CoroutineContext.Key<RequestHandlerExtra>

Context key for retrieving the extra from a handler coroutine's context.

Properties

key

open override val key: CoroutineContext.Key<*>

method

val method: Method

the request's method

requestId

val requestId: RequestId

the JSON-RPC id of the request being handled

Functions

fold

open override fun <R> fold(initial: R, operation: (R, CoroutineContext.Element) -> R): R

get

open operator override fun <E : CoroutineContext.Element> get(key: CoroutineContext.Key<E>): E?

minusKey

open override fun minusKey(key: CoroutineContext.Key<*>): CoroutineContext

plus

open operator fun plus(context: CoroutineContext): CoroutineContext

sendNotification

suspend fun sendNotification(notification: Notification)

Sends a notification tagged with relatedRequestId = requestId, letting transports associate it with the request being handled (e.g. route it onto the request's SSE stream).

sendRequest

suspend fun <T : RequestResult> sendRequest(request: Request, options: RequestOptions? = null): T

Sends a request to the peer tagged with relatedRequestId = requestId.