Package dev.tachyonmcp.core.protocol

Interface ProtocolRequestMapper

All Known Implementing Classes:

McpRequestMapper, McpRequestMapper

public interface ProtocolRequestMapper

Maps protocol-specific request parameters to protocol-neutral domain requests.

Each protocol version (e.g. MCP 2025-11-25) provides its own implementation, mirroring ProtocolResponseMapper on the response side.

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	ProtocolRequestMapper.CancellationRequest	A cancellation notification.
static final record	ProtocolRequestMapper.CompletionCallRequest	A completion request.
static interface	ProtocolRequestMapper.CompletionReference	Identifies what a completion request is completing against.
static final record	ProtocolRequestMapper.InitializeRequest	An initialize request.
static final record	ProtocolRequestMapper.PageRequest	A page request.
static final record	ProtocolRequestMapper.PromptCallRequest	A prompt call request.
static final record	ProtocolRequestMapper.TaskStatusRequest	A task status update.
static final record	ProtocolRequestMapper.ToolCallRequest	A tool call request.

Method Summary

Modifier and Type	Method	Description
ProtocolRequestMapper.ToolCallRequest	callTool(@Nullable Object params, PayloadDeserializer payloadDeserializer)	Maps tools/call params, deserializing arguments with the given PayloadDeserializer.
@Nullable ProtocolRequestMapper.CancellationRequest	cancellation(@Nullable Object params)	Maps notifications/cancelled params, or null if the request cannot be identified.
ProtocolRequestMapper.CompletionCallRequest	complete(@Nullable Object params)	Maps completion/complete params into a completion reference and its request.
ProtocolRequestMapper.PromptCallRequest	getPrompt(@Nullable Object params)	Maps prompts/get params into a prompt name and its argument request.
boolean	hasMetaKey(@Nullable Object params, String key)	Returns true when params carry a _meta entry under the given key.
ProtocolRequestMapper.InitializeRequest	initialize(@Nullable Object params)	Maps initialize params into the client's requested extensions.
LoggingLevel	loggingLevel(@Nullable Object params)	Extracts the requested LoggingLevel from logging/setLevel params.
ProtocolRequestMapper.PageRequest	page(@Nullable Object params)	Maps pagination params (cursor, and an optional limit) into a ProtocolRequestMapper.PageRequest.
@Nullable LoggingLevel	permittedLogLevel(@Nullable Object params)	Extracts the client's permitted LoggingLevel, or null if unset.
ResourceRequest	readResource(@Nullable Object params)	Maps resources/read params into a resource request.
String	resourceUri(@Nullable Object params)	Extracts the resource uri from params.
String	taskId(@Nullable Object params)	Extracts the taskId from params.
@Nullable ProtocolRequestMapper.TaskStatusRequest	taskStatus(@Nullable Object params)	Maps tasks/status notification params, or null if unparseable.

Method Details

page

ProtocolRequestMapper.PageRequest page(@Nullable Object params)

Maps pagination params (cursor, and an optional limit) into a ProtocolRequestMapper.PageRequest.

callTool

ProtocolRequestMapper.ToolCallRequest callTool(@Nullable Object params,
 PayloadDeserializer payloadDeserializer)

Maps tools/call params, deserializing arguments with the given PayloadDeserializer.

getPrompt

ProtocolRequestMapper.PromptCallRequest getPrompt(@Nullable Object params)

Maps prompts/get params into a prompt name and its argument request.

readResource

ResourceRequest readResource(@Nullable Object params)

Maps resources/read params into a resource request.

complete

ProtocolRequestMapper.CompletionCallRequest complete(@Nullable Object params)

Maps completion/complete params into a completion reference and its request.

resourceUri

String resourceUri(@Nullable Object params)

Extracts the resource uri from params.

taskId

String taskId(@Nullable Object params)

Extracts the taskId from params.

loggingLevel

LoggingLevel loggingLevel(@Nullable Object params)

Extracts the requested LoggingLevel from logging/setLevel params.

initialize

ProtocolRequestMapper.InitializeRequest initialize(@Nullable Object params)

Maps initialize params into the client's requested extensions.

permittedLogLevel

@Nullable LoggingLevel permittedLogLevel(@Nullable Object params)

Extracts the client's permitted LoggingLevel, or null if unset.

hasMetaKey

boolean hasMetaKey(@Nullable Object params,
 String key)

Returns true when params carry a _meta entry under the given key.

cancellation

@Nullable ProtocolRequestMapper.CancellationRequest cancellation(@Nullable Object params)

Maps notifications/cancelled params, or null if the request cannot be identified.

taskStatus

@Nullable ProtocolRequestMapper.TaskStatusRequest taskStatus(@Nullable Object params)

Maps tasks/status notification params, or null if unparseable.