Package dev.tachyonmcp.core.runtime

Class DefaultChannelContext

java.lang.Object

dev.tachyonmcp.core.runtime.DefaultChannelContext

All Implemented Interfaces:

InteractionContext, ChannelContext

@InternalApi
public class DefaultChannelContext
extends Object
implements ChannelContext

Nested Class Summary

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

InteractionContext.Lifecycle

Constructor Summary

Constructors

Constructor	Description
DefaultChannelContext(Protocol protocol)

Method Summary

Modifier and Type	Method	Description
ClientContext	client()	Returns typed access to the client-facing elicitation and sampling services.
void	enableExtension(String extensionId)	Enables an extension for this channel.
<T> Optional<T>	get(AttributeKey<T> key)	Returns the value stored under key, or empty if never set.
boolean	isExtensionEnabled(String extensionId)	Returns true if the given extension is active for this interaction.
InteractionContext.Lifecycle	lifecycle()	Returns the current lifecycle phase, or null before initialisation.
ContextNotifications	notifications()	Returns the notification sender bound to this interaction.
Protocol	protocol()	Returns the MCP protocol version negotiated for this channel.
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	setSession(@Nullable Session session)	Sets the session for this channel.

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

DefaultChannelContext

public DefaultChannelContext(Protocol protocol)

Method Details

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 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

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

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

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