Package dev.tachyonmcp.api.server.features.tools

Class AbstractToolHandler

java.lang.Object

dev.tachyonmcp.api.server.features.tools.AbstractToolHandler

All Implemented Interfaces:

ToolHandler, ServerFeature<ToolDescriptor>

Direct Known Subclasses:

EchoToolHandler, YouComSearchTool

@ExperimentalApi
public abstract class AbstractToolHandler
extends Object
implements ToolHandler

Experimental base class for class-based tool handlers.

Prefer Tools.register(ToolDescriptor, ToolFn) or Tools.registerAsync(ToolDescriptor, AsyncToolFn). Override exactly one of handle(InteractionContext, ToolRequest) or handleAsync(InteractionContext, ToolRequest).

Nested Class Summary

Nested classes/interfaces inherited from interface dev.tachyonmcp.api.server.ServerFeature

ServerFeature.Descriptor, ServerFeature.Request

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractToolHandler(ToolDescriptor descriptor)	Creates a handler for the given descriptor.

Method Summary

Modifier and Type	Method	Description
final ToolDescriptor	descriptor()	Returns the tool descriptor.
ToolResult	handle(InteractionContext context, ToolRequest request)	Handles a tool request synchronously.
CompletionStage<? extends ToolResult>	handleAsync(InteractionContext context, ToolRequest request)	Handles a tool request asynchronously.

Methods inherited from class java.lang.Object

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

Constructor Details

AbstractToolHandler

protected AbstractToolHandler(ToolDescriptor descriptor)

Creates a handler for the given descriptor.

Parameters:

descriptor - the tool descriptor

Method Details

descriptor

public final ToolDescriptor descriptor()

Returns the tool descriptor.

Specified by:

descriptor in interface ServerFeature<ToolDescriptor>

Specified by:

descriptor in interface ToolHandler

Returns:

the tool descriptor

handleAsync

public CompletionStage<? extends ToolResult> handleAsync(InteractionContext context,
 ToolRequest request)

Handles a tool request asynchronously.

The default implementation delegates to handle(InteractionContext, ToolRequest).

Specified by:

handleAsync in interface ToolHandler

Parameters:

context - the interaction context

request - the tool request

Returns:

the pending tool result

handle

public ToolResult handle(InteractionContext context,
 ToolRequest request)
                  throws Exception

Handles a tool request synchronously.

Parameters:

context - the interaction context

request - the tool request

Returns:

the tool result

Throws:

Exception - when handling fails