Interface McpSubscriptionEvent

All Known Implementing Classes:

McpSubscriptionEvent.PromptsListChanged, McpSubscriptionEvent.ResourcesListChanged, McpSubscriptionEvent.ResourceUpdated, McpSubscriptionEvent.ToolsListChanged

@ThreadSafe
public sealed interface McpSubscriptionEvent
permits McpSubscriptionEvent.ResourcesListChanged, McpSubscriptionEvent.ResourceUpdated, McpSubscriptionEvent.ToolsListChanged, McpSubscriptionEvent.PromptsListChanged

Immutable application event that identifies a coarse MCP subscription-visible change.

Events do not identify an endpoint, authorization partition, or connected client. Soklet applies endpoint configuration and accepted subscription filters before wire emission. The authorization partition stored when a subscription is admitted scopes registration and quota accounting; it is not an event target and does not authorize catalog or resource access.

This type may gain reviewed permitted subtypes in Soklet 4.x; use a forward-compatible default when switching over its values.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	McpSubscriptionEvent.PromptsListChanged	Requests reevaluation of the caller-visible prompts/list catalog for interested subscriptions.
static final class	McpSubscriptionEvent.ResourcesListChanged	Signals that clients should request resources/list again.
static final class	McpSubscriptionEvent.ResourceUpdated	Signals that the representation at one absolute normalized resource URI in ASCII wire form changed.
static final class	McpSubscriptionEvent.ToolsListChanged	Requests reevaluation of the caller-visible tools/list catalog for interested subscriptions.

Method Summary

Static Methods

Modifier and Type	Method	Description
static @NonNull McpSubscriptionEvent.PromptsListChanged	promptsListChanged()	Creates a prompt-list-changed event.
static @NonNull McpSubscriptionEvent.ResourcesListChanged	resourcesListChanged()	Creates a resource-list-changed event.
static @NonNull McpSubscriptionEvent.ResourceUpdated	resourceUpdated(@NonNull URI resourceUri)	Creates a resource-updated event.
static @NonNull McpSubscriptionEvent.ToolsListChanged	toolsListChanged()	Creates a tool-list-changed event.

Method Details

resourcesListChanged

static @NonNull McpSubscriptionEvent.ResourcesListChanged resourcesListChanged()

Creates a resource-list-changed event.

Returns:

resource-list-changed event

resourceUpdated

static @NonNull McpSubscriptionEvent.ResourceUpdated resourceUpdated(@NonNull URI resourceUri)

Creates a resource-updated event.

Parameters:

resourceUri - changed resource URI

Returns:

resource-updated event

Throws:

NullPointerException - if resourceUri is null

IllegalArgumentException - if the URI is relative, not normalized, or not in ASCII wire form

toolsListChanged

static @NonNull McpSubscriptionEvent.ToolsListChanged toolsListChanged()

Creates a tool-list-changed event.

Returns:

tool-list-changed event

promptsListChanged

static @NonNull McpSubscriptionEvent.PromptsListChanged promptsListChanged()

Creates a prompt-list-changed event.

Returns:

prompt-list-changed event