Class McpSkillRegistration

java.lang.Object

com.soklet.McpSkillRegistration

@ThreadSafe
public final class McpSkillRegistration
extends Object

Immutable association between a Skills snapshot and its root resource URI.

Construction validates the generated manifest but does not publish endpoint resources. The URI identifies the root SKILL.md, not a directory. Locale and cache settings do not grant authorization to read the bundle.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpSkillRegistration.Builder	Mutable builder for an immutable Skills registration.
static final class	McpSkillRegistration.Resource	Immutable, framework-generated resource identity and content fingerprint.

Method Summary

Modifier and Type	Method	Description
boolean	equals(@Nullable Object other)
@NonNull McpCachePolicy	getCachePolicy()
@NonNull Optional<@NonNull Locale>	getLocale()
@NonNull Set<@NonNull McpProtocolVersion>	getProtocolVersions()
@NonNull List<@NonNull McpSkillRegistration.Resource>	getResources()	Returns framework-derived file manifest entries without copying file bytes.
@NonNull McpSkillBundle	getSkillBundle()
@NonNull URI	getUri()
int	hashCode()
@NonNull String	toString()
static @NonNull McpSkillRegistration.Builder	withUriAndSkillBundle(@NonNull URI uri, @NonNull McpSkillBundle skillBundle, @NonNull Set<@NonNull McpProtocolVersion> protocolVersions)	Starts registration of a bundle at its root document URI.

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

withUriAndSkillBundle

public static @NonNull McpSkillRegistration.Builder withUriAndSkillBundle(@NonNull URI uri,
 @NonNull McpSkillBundle skillBundle,
 @NonNull Set<@NonNull McpProtocolVersion> protocolVersions)

Starts registration of a bundle at its root document URI.

Parameters:

uri - absolute normalized hierarchical ASCII URI ending in literal /SKILL.md, without query, fragment, dot segments, or encoded separators

skillBundle - validated immutable snapshot whose name matches the URI's final skill-directory segment

protocolVersions - nonempty exact revisions serving this Skill

Returns:

mutable builder with no locale and private zero-TTL cache policy

Throws:

NullPointerException - if either argument is null

getUri

public @NonNull URI getUri()

Returns:

original root SKILL.md URI

getSkillBundle

public @NonNull McpSkillBundle getSkillBundle()

Returns:

the supplied immutable bundle

getProtocolVersions

public @NonNull Set<@NonNull McpProtocolVersion> getProtocolVersions()

Returns:

exact protocol revisions on which this Skill is available

getLocale

public @NonNull Optional<@NonNull Locale> getLocale()

Returns:

configured locale, or empty when omitted

getCachePolicy

public @NonNull McpCachePolicy getCachePolicy()

Returns:

configured cache policy, private zero-TTL when omitted

getResources

public @NonNull List<@NonNull McpSkillRegistration.Resource> getResources()

Returns framework-derived file manifest entries without copying file bytes.

Returns:

cached immutable list in canonical bundle path order, root document first

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether URI identity, exact bundle content, locale, and cache policy match

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural registration hash code

toString

public @NonNull String toString()

Overrides:

toString in class Object

Returns:

diagnostic rendering without registration or bundle content