Class McpTask.Builder

java.lang.Object

com.soklet.McpTask.Builder

Enclosing class:

McpTask

@NotThreadSafe
public static final class McpTask.Builder
extends Object

Mutable builder for an immutable task snapshot.

The builder is intended for use by a single thread. Its status-specific setters do not silently change the configured status; build() rejects every mismatched payload combination.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
@NonNull McpTask.Builder	addInputRequest(@NonNull String key, @NonNull McpInputRequest inputRequest)	Appends one uniquely keyed outstanding input request.
@NonNull McpTask.Builder	addInputRequests(@NonNull Map<@NonNull String, ? extends @NonNull McpInputRequest> inputRequests)	Appends outstanding input requests in iteration order.
@NonNull McpTask	build()	Builds and validates the immutable task snapshot.
@NonNull McpTask.Builder	completedResult(@NonNull McpCompleteResult completedResult)	Supplies the required completed operation result.
@NonNull McpTask.Builder	failure(@NonNull McpJsonRpcError failure)	Supplies the required task-execution JSON-RPC failure.
@NonNull McpTask.Builder	metadata(@Nullable McpJsonObject metadata)	Sets task-result protocol extension metadata.
@NonNull McpTask.Builder	pollInterval(@Nullable Duration pollInterval)	Sets or clears the suggested polling interval.
@NonNull McpTask.Builder	taskStatusMessage(@Nullable String taskStatusMessage)	Sets or clears the client-visible status message.
@NonNull McpTask.Builder	timeToLive(@Nullable Duration timeToLive)	Sets the task time to live or selects unlimited retention.

Methods inherited from class Object

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

Method Details

taskStatusMessage

public @NonNull McpTask.Builder taskStatusMessage(@Nullable String taskStatusMessage)

Sets or clears the client-visible status message.

Parameters:

taskStatusMessage - status message, or null to clear

Returns:

this builder

timeToLive

public @NonNull McpTask.Builder timeToLive(@Nullable Duration timeToLive)

Sets the task time to live or selects unlimited retention.

Parameters:

timeToLive - positive whole-millisecond duration, or null for the wire-level unlimited value

Returns:

this builder

Throws:

IllegalArgumentException - if the duration is not positive, has sub-millisecond precision, or does not fit in a signed 64-bit millisecond count

pollInterval

public @NonNull McpTask.Builder pollInterval(@Nullable Duration pollInterval)

Sets or clears the suggested polling interval.

Parameters:

pollInterval - positive whole-millisecond duration, or null to omit the suggestion

Returns:

this builder

Throws:

IllegalArgumentException - if the duration is not positive, has sub-millisecond precision, or does not fit in a signed 64-bit millisecond count

addInputRequest

public @NonNull McpTask.Builder addInputRequest(@NonNull String key,
 @NonNull McpInputRequest inputRequest)

Appends one uniquely keyed outstanding input request.

Parameters:

key - task-lifetime-unique input-request key

inputRequest - outstanding input request

Returns:

this builder

Throws:

NullPointerException - if an argument is null

IllegalArgumentException - if the key is already present or contains malformed UTF-16

addInputRequests

public @NonNull McpTask.Builder addInputRequests(@NonNull Map<@NonNull String, ? extends @NonNull McpInputRequest> inputRequests)

Appends outstanding input requests in iteration order.

The call fails without mutation if an entry is null or any key is already present in this builder.

Parameters:

inputRequests - input requests to append

Returns:

this builder

Throws:

NullPointerException - if the map, a key, or a value is null

IllegalArgumentException - if a key is already present or contains malformed UTF-16

completedResult

public @NonNull McpTask.Builder completedResult(@NonNull McpCompleteResult completedResult)

Supplies the required completed operation result.

Parameters:

completedResult - completed operation result

Returns:

this builder

failure

public @NonNull McpTask.Builder failure(@NonNull McpJsonRpcError failure)

Supplies the required task-execution JSON-RPC failure.

Parameters:

failure - client-visible JSON-RPC failure

Returns:

this builder

metadata

public @NonNull McpTask.Builder metadata(@Nullable McpJsonObject metadata)

Sets task-result protocol extension metadata.

Parameters:

metadata - immutable metadata, or null to restore the empty default

Returns:

this builder

Throws:

IllegalArgumentException - when build() is called if the metadata uses a reserved MCP key

build

public @NonNull McpTask build()

Builds and validates the immutable task snapshot.

Returns:

immutable task

Throws:

IllegalStateException - if the status-specific payload is absent or does not match the task status