Class McpToolRegistration.CompleteHandlerStage<A,R>

java.lang.Object

com.soklet.McpToolRegistration.CompleteHandlerStage<A,R>

Type Parameters:

A - argument type

R - structured output type

Enclosing class:

McpToolRegistration<A>

@NotThreadSafe
public static final class McpToolRegistration.CompleteHandlerStage<A,R>
extends Object

Handler-selection stage for a typed-output path.

handler(McpCompleteToolHandler) selects an operation that always completes inline with a typed value. inlineOperationHandler(McpToolHandler) selects an inline advanced operation that may return explicit content or an isError tool result. operationHandler(McpToolHandler) selects an advanced operation that retains the same eventual output schema and is statically known to require Tasks.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
@NonNull McpToolRegistration.CompleteBuilder<@NonNull A>	handler(@NonNull McpCompleteToolHandler<@NonNull A, @NonNull R> handler)	Supplies the required complete handler.
@NonNull McpToolRegistration.OperationBuilder<@NonNull A>	inlineOperationHandler(@NonNull McpToolHandler<@NonNull A> handler)	Supplies an inline advanced handler while retaining the typed output schema.
@NonNull McpToolRegistration.OperationBuilder<@NonNull A>	operationHandler(@NonNull McpToolHandler<@NonNull A> handler)	Supplies the required advanced handler for a task-required operation whose eventual structured output has type R.

Methods inherited from class Object

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

Method Details

handler

public @NonNull McpToolRegistration.CompleteBuilder<@NonNull A> handler(@NonNull McpCompleteToolHandler<@NonNull A, @NonNull R> handler)

Supplies the required complete handler.

Parameters:

handler - complete handler

Returns:

optional-metadata builder

inlineOperationHandler

public @NonNull McpToolRegistration.OperationBuilder<@NonNull A> inlineOperationHandler(@NonNull McpToolHandler<@NonNull A> handler)

Supplies an inline advanced handler while retaining the typed output schema.

The handler returns the McpOperationResult spine directly, which permits explicit content and isError tool results. This path is not statically task-required; a successful result must include structured content satisfying the retained output schema.

Parameters:

handler - inline advanced handler

Returns:

optional-metadata builder

operationHandler

public @NonNull McpToolRegistration.OperationBuilder<@NonNull A> operationHandler(@NonNull McpToolHandler<@NonNull A> handler)

Supplies the required advanced handler for a task-required operation whose eventual structured output has type R.

Unlike handler(McpCompleteToolHandler), this handler returns the McpOperationResult spine directly, including McpTaskCreatedResult. Soklet retains the selected output type and schema for deferred completed-result validation and treats this as a task-required registration. A client that did not negotiate the Tasks extension is rejected before the application handler is invoked.

Parameters:

handler - advanced task-required handler

Returns:

optional-metadata builder