Package dev.tachyonmcp.core.server.session

Class DefaultDispatchContext

java.lang.Object

dev.tachyonmcp.core.server.session.DefaultDispatchContext

All Implemented Interfaces:

InteractionContext, ChannelContext, DispatchContext

@InternalApi
public class DefaultDispatchContext
extends Object
implements DispatchContext

Nested Class Summary

Nested classes/interfaces inherited from interface dev.tachyonmcp.api.runtime.InteractionContext

InteractionContext.Lifecycle

Constructor Summary

Constructors

Constructor	Description
DefaultDispatchContext(ChannelContext channel, ServerEngine server)

Method Summary

Modifier and Type	Method	Description
ClientContext	client()	Returns typed access to the client-facing elicitation and sampling services.
static DispatchContext	create(Protocol protocol, ServerEngine server)
void	enableExtension(String extensionId)	Enables an extension for this channel.
ServerEngine	engine()	Returns the owning ServerEngine.
<T> Optional<T>	get(AttributeKey<T> key)	Returns the value stored under key, or empty if never set.
@Nullable LoggingLevel	getLoggingLevel()	Returns the logging level for the current session, or null when unset or session-less.
@Nullable LoggingLevel	getPermittedLogLevel()	Returns the log level this specific request permits, or null if it set none.
boolean	isExtensionEnabled(String extensionId)	Returns true if the given extension is active for this interaction.
@Nullable InteractionContext.Lifecycle	lifecycle()	Returns the current lifecycle phase, or null before initialisation.
static DispatchContext	noop()
ContextNotifications	notifications()	Returns the notification sender bound to this interaction.
@Nullable OutboundSseStream	outboundStream()	Returns the outbound SSE stream, or null if not yet upgraded.
Protocol	protocol()	Returns the MCP protocol version negotiated for this channel.
ProtocolRequestMapper	requestMapper()	Returns the protocol request mapper for the current protocol version.
ProtocolResponseMapper	responseMapper()	Returns the protocol response mapper for the current protocol version.
CompletableFuture<String>	sendRequest(String method, Object params)	Sends a request to the client and returns a future that completes with the raw JSON response.
@Nullable Session	session()	Returns the current session, or null if not yet established.
<T> void	set(AttributeKey<T> key, T value)	Stores value under key, visible to later InteractionContext.get(AttributeKey) calls — see InteractionContext.get(AttributeKey) for scope and thread-safety.
void	setLifecycle(InteractionContext.Lifecycle lifecycle)	Sets the lifecycle state for this channel.
void	setLoggingLevel(LoggingLevel level)	Sets the logging level for the current session; no-op when no session is bound.
void	setOutboundStream(@Nullable OutboundSseStream stream)	Sets the outbound SSE stream for this dispatch.
void	setPermittedLogLevel(@Nullable LoggingLevel level)	Sets the log level this specific request permits (from _meta.../logLevel, protocols without sessions).
void	setSession(@Nullable Session session)	Sets the session for this channel.
static DispatchContext	stateless(ServerEngine server)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface dev.tachyonmcp.core.runtime.ChannelContext

protocolVersion, sessionId

Constructor Details

DefaultDispatchContext

public DefaultDispatchContext(ChannelContext channel,
 ServerEngine server)

Method Details

create

public static DispatchContext create(Protocol protocol,
 ServerEngine server)

stateless

public static DispatchContext stateless(ServerEngine server)

noop

public static DispatchContext noop()

protocol

public Protocol protocol()

Description copied from interface: ChannelContext

Returns the MCP protocol version negotiated for this channel.

Specified by:

protocol in interface ChannelContext

Returns:

the protocol

lifecycle

public @Nullable InteractionContext.Lifecycle lifecycle()

Description copied from interface: InteractionContext

Returns the current lifecycle phase, or null before initialisation.

Specified by:

lifecycle in interface InteractionContext

Returns:

the lifecycle phase, or null

setLifecycle

public void setLifecycle(InteractionContext.Lifecycle lifecycle)

Description copied from interface: ChannelContext

Sets the lifecycle state for this channel.

Specified by:

setLifecycle in interface ChannelContext

Parameters:

lifecycle - the new lifecycle state

session

public @Nullable Session session()

Description copied from interface: ChannelContext

Returns the current session, or null if not yet established.

Specified by:

session in interface ChannelContext

Returns:

the session, or null

setSession

public void setSession(@Nullable Session session)

Description copied from interface: ChannelContext

Sets the session for this channel.

Specified by:

setSession in interface ChannelContext

Parameters:

session - the session, or null to clear

get

public <T> Optional<T> get(AttributeKey<T> key)

Description copied from interface: InteractionContext

Returns the value stored under key, or empty if never set.

Scoped to the underlying channel/session, not the current request — a value set on one request is visible to later requests on the same connection. Backed by a concurrent map: safe to call from multiple handler threads without external synchronization.

Specified by:

get in interface InteractionContext

Type Parameters:

T - the type of value

Parameters:

key - the attribute key

Returns:

the value, or empty if not set

set

public <T> void set(AttributeKey<T> key,
 T value)

Description copied from interface: InteractionContext

Stores value under key, visible to later InteractionContext.get(AttributeKey) calls — see InteractionContext.get(AttributeKey) for scope and thread-safety.

Specified by:

set in interface InteractionContext

Type Parameters:

T - the type of value

Parameters:

key - the attribute key

value - the value to store

enableExtension

public void enableExtension(String extensionId)

Description copied from interface: ChannelContext

Enables an extension for this channel.

Specified by:

enableExtension in interface ChannelContext

Parameters:

extensionId - the extension identifier

isExtensionEnabled

public boolean isExtensionEnabled(String extensionId)

Description copied from interface: InteractionContext

Returns true if the given extension is active for this interaction.

Specified by:

isExtensionEnabled in interface InteractionContext

Parameters:

extensionId - the extension identifier

Returns:

true if the extension is active

engine

public ServerEngine engine()

Description copied from interface: DispatchContext

Returns the owning ServerEngine.

Specified by:

engine in interface DispatchContext

setLoggingLevel

public void setLoggingLevel(LoggingLevel level)

Description copied from interface: DispatchContext

Sets the logging level for the current session; no-op when no session is bound.

Specified by:

setLoggingLevel in interface DispatchContext

getLoggingLevel

public @Nullable LoggingLevel getLoggingLevel()

Description copied from interface: DispatchContext

Returns the logging level for the current session, or null when unset or session-less.

Specified by:

getLoggingLevel in interface DispatchContext

setPermittedLogLevel

public void setPermittedLogLevel(@Nullable LoggingLevel level)

Description copied from interface: DispatchContext

Sets the log level this specific request permits (from _meta.../logLevel, protocols without sessions). Unlike DispatchContext.setLoggingLevel(dev.tachyonmcp.api.server.domain.LoggingLevel), this is request-scoped, not session-scoped.

Specified by:

setPermittedLogLevel in interface DispatchContext

getPermittedLogLevel

public @Nullable LoggingLevel getPermittedLogLevel()

Description copied from interface: DispatchContext

Returns the log level this specific request permits, or null if it set none.

Specified by:

getPermittedLogLevel in interface DispatchContext

notifications

public ContextNotifications notifications()

Description copied from interface: InteractionContext

Returns the notification sender bound to this interaction.

Specified by:

notifications in interface InteractionContext

Returns:

the notification sender

sendRequest

public CompletableFuture<String> sendRequest(String method,
 Object params)

Description copied from interface: InteractionContext

Sends a request to the client and returns a future that completes with the raw JSON response.

Experimental escape hatch for client requests not covered by InteractionContext.client(), such as URL-mode elicitation or sampling parameters beyond what SamplingService models.

Specified by:

sendRequest in interface InteractionContext

Parameters:

method - the request method name

params - the request parameters

Returns:

a future that completes with the raw JSON response

client

public ClientContext client()

Description copied from interface: InteractionContext

Returns typed access to the client-facing elicitation and sampling services.

Prefer this over InteractionContext.sendRequest(String, Object) for sampling/elicitation round-trips — it returns domain results instead of raw JSON.

Specified by:

client in interface InteractionContext

Returns:

the client context

outboundStream

public @Nullable OutboundSseStream outboundStream()

Description copied from interface: DispatchContext

Returns the outbound SSE stream, or null if not yet upgraded.

Specified by:

outboundStream in interface DispatchContext

setOutboundStream

public void setOutboundStream(@Nullable OutboundSseStream stream)

Description copied from interface: DispatchContext

Sets the outbound SSE stream for this dispatch.

Specified by:

setOutboundStream in interface DispatchContext

responseMapper

public ProtocolResponseMapper responseMapper()

Description copied from interface: DispatchContext

Returns the protocol response mapper for the current protocol version.

Specified by:

responseMapper in interface DispatchContext

requestMapper

public ProtocolRequestMapper requestMapper()

Description copied from interface: DispatchContext

Returns the protocol request mapper for the current protocol version.

Specified by:

requestMapper in interface DispatchContext