Class McpArgumentCompletionResult

java.lang.Object

com.soklet.McpArgumentCompletionResult

All Implemented Interfaces:

McpOperationResult

@ThreadSafe
public final class McpArgumentCompletionResult
extends Object
implements McpOperationResult

Immutable ordered argument suggestions returned by an MCP completer.

Values remain exact application-provided strings. Soklet does not sort, normalize, deduplicate, translate, or perform prefix matching on them. Unpaired UTF-16 surrogates are rejected at construction. The independent JSON string/token and response-size limits described by McpJsonString remain serialization checks.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpArgumentCompletionResult.Builder	Mutable builder for an immutable argument-completion result.

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
static @NonNull McpArgumentCompletionResult	fromValues(@NonNull List<@NonNull String> values)	Creates a result containing only ordered suggestions.
@NonNull Optional<@NonNull Boolean>	getHasMore()
@NonNull McpJsonObject	getMetadata()
@NonNull Optional<@NonNull Long>	getTotal()
@NonNull List<@NonNull String>	getValues()
int	hashCode()
@NonNull String	toString()
static @NonNull McpArgumentCompletionResult.Builder	withValues(@NonNull List<@NonNull String> values)	Begins a result with ordered suggestions and optional fields.

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

fromValues

public static @NonNull McpArgumentCompletionResult fromValues(@NonNull List<@NonNull String> values)

Creates a result containing only ordered suggestions.

Parameters:

values - zero to 100 exact, non-null suggestion strings

Returns:

immutable result

Throws:

IllegalArgumentException - if there are more than 100 values or a value contains an unpaired surrogate

withValues

public static @NonNull McpArgumentCompletionResult.Builder withValues(@NonNull List<@NonNull String> values)

Begins a result with ordered suggestions and optional fields.

Parameters:

values - zero to 100 exact, non-null suggestion strings

Returns:

mutable builder

Throws:

IllegalArgumentException - if there are more than 100 values or a value contains an unpaired surrogate

getValues

public @NonNull List<@NonNull String> getValues()

Returns:

immutable suggestions in application order

getTotal

public @NonNull Optional<@NonNull Long> getTotal()

Returns:

exact match count, or empty when unknown or omitted

getHasMore

public @NonNull Optional<@NonNull Boolean> getHasMore()

Returns:

whether additional values exist, or empty when omitted

getMetadata

public @NonNull McpJsonObject getMetadata()

Returns:

result-level protocol extension metadata

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether values, optional fields, and metadata match

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural hash code

toString

public @NonNull String toString()

Overrides:

toString in class Object

Returns:

diagnostic rendering without suggestions or metadata