Interface McpSkillListHandler

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@ThreadSafe
@FunctionalInterface
public interface McpSkillListHandler

Concurrently callable application-owned skills/list page handler.

On the first page, return an ordered subsequence of the initial selection supplied by the context. On continuation, restore the original ordered selection and page position from an authenticated application-owned cursor. Every returned registration must be an exact currently configured instance; duplicate URIs and foreign or reconstructed instances are rejected. Current access and discovery are rechecked on continuation without selecting a new variant. A complete skill manifest is never split between pages.

The application owns cursor integrity, endpoint/caller binding, expiry, content identities, retained snapshot availability, cross-page duplicate prevention, and cross-node portability. Current membership alone does not prove an old snapshot's content is unchanged. Do not retain request objects, invocation features, or localization contexts as snapshot state. Invalid or unavailable continuations should fail neutrally, without substituting content. The handler controls list pages, not canonical file reads.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
@NonNull McpSkillPage	handle(@NonNull McpRequestContext requestContext, @NonNull McpSkillListContext skillListContext, @NonNull McpInvocationFeatures invocationFeatures)	Produces one complete page containing at most 32 registered skills.

Method Details

handle

@NonNull McpSkillPage handle(@NonNull McpRequestContext requestContext,
 @NonNull McpSkillListContext skillListContext,
 @NonNull McpInvocationFeatures invocationFeatures)
                      throws Exception

Produces one complete page containing at most 32 registered skills.

Parameters:

requestContext - admitted request context

skillListContext - opaque cursor and authoritative first-page phase marker

invocationFeatures - invocation-scoped optional features

Returns:

non-null Skills page

Throws:

Exception - if page production or snapshot restoration fails