Class McpSkillPage

java.lang.Object

com.soklet.McpSkillPage

All Implemented Interfaces:

McpOperationResult

@ThreadSafe
public final class McpSkillPage
extends Object
implements McpOperationResult

One immutable complete skills/list page containing at most 32 skills.

Return this result directly, without a McpCompleteResult wrapper. Registrations reference complete manifests; a skill is never split between pages. Soklet derives descriptions and content identities from the registered bundles rather than accepting replacement metadata or hashes from a handler.

The endpoint's Skills-list cache policy fixes scope and default freshness. A page may override only the time to live, subject to the framework's localization and security clamps. Result-level extension metadata does not replace a bundle's frontmatter.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpSkillPage.Builder	Single-threaded builder for an immutable Skills page.

Method Summary

Modifier and Type	Method	Description
static @NonNull McpSkillPage.Builder	builder()
boolean	equals(@Nullable Object other)
@NonNull Optional<@NonNull Duration>	getCacheTimeToLiveOverride()
@NonNull McpJsonObject	getMetadata()
@NonNull Optional<@NonNull String>	getNextCursor()	Returns the opaque cursor clients should supply for the next page.
@NonNull List<@NonNull McpSkillRegistration>	getSkillRegistrations()
int	hashCode()
@NonNull String	toString()

Methods inherited from class Object

getClass, notify, notifyAll, wait, wait, wait

Method Details

builder

public static @NonNull McpSkillPage.Builder builder()

Returns:

an empty Skills-page builder

getSkillRegistrations

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

Returns:

immutable registration references in supplied order

getMetadata

public @NonNull McpJsonObject getMetadata()

Returns:

immutable result-level protocol extension metadata

getNextCursor

public @NonNull Optional<@NonNull String> getNextCursor()

Returns the opaque cursor clients should supply for the next page. The application owns its integrity, authorization binding, expiry, page position, retained snapshot, content identities, and cross-node portability. A present empty string is preserved; Soklet does not mint or protect cursors.

Returns:

next cursor, or empty when this is the final page

getCacheTimeToLiveOverride

public @NonNull Optional<@NonNull Duration> getCacheTimeToLiveOverride()

Returns:

freshness override, or empty to use the endpoint default

equals

public boolean equals(@Nullable Object other)

Overrides:

equals in class Object

Returns:

whether every page property is structurally equal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

Returns:

structural page hash code

toString

public @NonNull String toString()

Overrides:

toString in class Object

Returns:

diagnostic rendering without registrations, metadata, or cursor data