Class McpSkillGroup

java.lang.Object

com.soklet.McpSkillGroup

@ThreadSafe
public final class McpSkillGroup
extends Object

Immutable, explicitly grouped locale alternatives for one Skills name.

The key is an opaque application-defined, endpoint-local label, not a wire skill identifier. Grouping grants no access and does not select a language or translate file bytes. Group different content versions separately instead of relying on registration order to choose between same-locale versions.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
static @NonNull McpSkillGroup	fromKeyAndSkillRegistrations(@NonNull String key, @NonNull List<@NonNull McpSkillRegistration> skillRegistrations)	Snapshots ordered alternatives sharing one validated skill name.
@NonNull String	getKey()
@NonNull List<@NonNull McpSkillRegistration>	getSkillRegistrations()
int	hashCode()
@NonNull String	toString()

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

fromKeyAndSkillRegistrations

public static @NonNull McpSkillGroup fromKeyAndSkillRegistrations(@NonNull String key,
 @NonNull List<@NonNull McpSkillRegistration> skillRegistrations)

Snapshots ordered alternatives sharing one validated skill name.

An empty group is permitted. Among its members, registration URIs must be distinct under URI.equals(Object) and locales must be unique, including at most one member with an undeclared locale. The key is preserved literally; it is neither trimmed nor normalized.

Parameters:

key - nonblank application-local group label

skillRegistrations - alternatives in application order, possibly empty

Returns:

immutable group

Throws:

NullPointerException - if the key, list, or a member is null

IllegalArgumentException - if the key is blank, member skill names differ, or member URIs or locales are duplicated

getKey

public @NonNull String getKey()

Returns:

exact application-defined group label

getSkillRegistrations

public @NonNull List<@NonNull McpSkillRegistration> getSkillRegistrations()

Returns:

immutable alternatives in the supplied order

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether the exact key and ordered registration values match

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural group hash code

toString

public @NonNull String toString()

Overrides:

toString in class Object

Returns:

diagnostic rendering without group labels or registrations