effect 4.0.0-beta.70 → 4.0.0-beta.72

package/dist/unstable/ai/McpSchema.d.ts

@@ -78,9 +78,9 @@ export declare const optionalWithDefault: <S extends Schema.Top & Schema.Without
  */
 export declare const optional: <S extends Schema.Top>(schema: S) => Schema.decodeTo<Schema.optional<S>, Schema.optionalKey<S>>;
 /**
- * A uniquely identifying ID for a request in JSON-RPC.
+ * Schema for JSON-RPC request identifiers, allowing string or number ids.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare const RequestId: Schema.Union<[
@@ -88,17 +88,17 @@ export declare const RequestId: Schema.Union<[
     typeof Schema.Number
 ]>;
 /**
- * A uniquely identifying ID for a request in JSON-RPC.
+ * Type represented by the JSON-RPC request identifier schema.
  *
- * @category common
+ * @category models
  * @since 4.0.0
  */
 export type RequestId = typeof RequestId.Type;
 /**
- * A progress token, used to associate progress notifications with the original
- * request.
+ * Schema for MCP progress tokens that associate progress notifications with the
+ * original request.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare const ProgressToken: Schema.Union<[
@@ -106,10 +106,9 @@ export declare const ProgressToken: Schema.Union<[
     typeof Schema.Number
 ]>;
 /**
- * A progress token, used to associate progress notifications with the original
- * request.
+ * Type represented by the MCP progress token schema.
  *
- * @category common
+ * @category models
  * @since 4.0.0
  */
 export type ProgressToken = typeof ProgressToken.Type;
@@ -162,7 +161,7 @@ declare const RequestMeta_base: Schema.Opaque<RequestMeta, Schema.Struct<{
  * Request metadata may include a progress token that asks the receiver to send
  * out-of-band progress notifications for the request.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class RequestMeta extends RequestMeta_base {
@@ -188,7 +187,7 @@ declare const ResultMeta_base: Schema.Opaque<ResultMeta, Schema.Struct<{
  * The `_meta` field is reserved for protocol, extension, or implementation
  * metadata attached to a result.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ResultMeta extends ResultMeta_base {
@@ -214,15 +213,15 @@ declare const NotificationMeta_base: Schema.Opaque<NotificationMeta, Schema.Stru
  * The `_meta` field is reserved for protocol, extension, or implementation
  * metadata attached to a notification.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class NotificationMeta extends NotificationMeta_base {
 }
 /**
- * An opaque token used to represent a cursor for pagination.
+ * Schema for opaque cursor tokens used in pagination.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare const Cursor: typeof Schema.String;
@@ -233,7 +232,7 @@ export declare const Cursor: typeof Schema.String;
  *
  * A cursor is an opaque string token used to continue paginated requests.
  *
- * @category common
+ * @category models
  * @since 4.0.0
  */
 export type Cursor = typeof Cursor.Type;
@@ -296,7 +295,7 @@ declare const PaginatedRequestMeta_base: Schema.Opaque<PaginatedRequestMeta, Sch
  * It includes the base request metadata fields plus an optional cursor
  * indicating where the server should continue listing results.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class PaginatedRequestMeta extends PaginatedRequestMeta_base {
@@ -332,15 +331,15 @@ declare const PaginatedResultMeta_base: Schema.Opaque<PaginatedResultMeta, Schem
  * It includes the base result metadata fields plus an optional `nextCursor`,
  * which indicates that more results may be available.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class PaginatedResultMeta extends PaginatedResultMeta_base {
 }
 /**
- * The sender or recipient of messages and data in a conversation.
+ * Schema for MCP conversation roles, allowing user and assistant.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare const Role: Schema.Literals<["user", "assistant"]>;
@@ -351,7 +350,7 @@ export declare const Role: Schema.Literals<["user", "assistant"]>;
  *
  * Valid roles are `"user"` and `"assistant"`.
  *
- * @category common
+ * @category models
  * @since 4.0.0
  */
 export type Role = typeof Role.Type;
@@ -389,10 +388,14 @@ declare const Annotations_base: Schema.Opaque<Annotations, Schema.Struct<{
     readonly priority: Schema.decodeTo<Schema.optional<Schema.Number>, Schema.optionalKey<Schema.Number>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * Optional annotations for the client. The client can use annotations to
- * inform how objects are used or displayed
+ * Schema for optional client-facing annotations on MCP objects.
+ *
+ * **When to use**
  *
- * @category common
+ * Use to describe intended audience and priority metadata for objects shown or
+ * processed by a client.
+ *
+ * @category schemas
  * @since 4.0.0
  */
 export declare class Annotations extends Annotations_base {
@@ -409,7 +412,7 @@ declare const Implementation_base: Schema.Opaque<Implementation, Schema.Struct<{
 /**
  * Describes the name and version of an MCP implementation.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class Implementation extends Implementation_base {
@@ -448,11 +451,19 @@ declare const ClientCapabilities_base: Schema.Class<ClientCapabilities, Schema.S
     readonly elicitation: Schema.decodeTo<Schema.optional<Schema.Struct<{}>>, Schema.optionalKey<Schema.Struct<{}>>, never, never>;
 }>, {}>;
 /**
- * Capabilities a client may support. Known capabilities are defined here, in
- * this schema, but this is not a closed set: any client can define its own,
- * additional capabilities.
+ * Describes capabilities advertised by an MCP client.
+ *
+ * **When to use**
+ *
+ * Use to describe which optional MCP features a client supports during
+ * initialization.
+ *
+ * **Details**
+ *
+ * Known capabilities are represented by this schema, but the capability set is
+ * open and clients may define additional capabilities.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ClientCapabilities extends ClientCapabilities_base {
@@ -595,11 +606,19 @@ declare const ServerCapabilities_base: Schema.Opaque<ServerCapabilities, Schema.
     }>>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * Capabilities that a server may support. Known capabilities are defined
- * here, in this schema, but this is not a closed set: any server can define
- * its own, additional capabilities.
+ * Describes capabilities advertised by an MCP server.
+ *
+ * **When to use**
+ *
+ * Use to describe which optional MCP features a server supports during
+ * initialization.
+ *
+ * **Details**
+ *
+ * Known capabilities are represented by this schema, but the capability set is
+ * open and servers may define additional capabilities.
  *
- * @category common
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ServerCapabilities extends ServerCapabilities_base {
@@ -621,51 +640,74 @@ declare const McpErrorBase_base: Schema.Class<McpErrorBase, Schema.Struct<{
     readonly data: Schema.decodeTo<Schema.optional<Schema.Any>, Schema.optionalKey<Schema.Any>, never, never>;
 }>, {}>;
 /**
- * Base schema for MCP and JSON-RPC error objects.
+ * Schema for MCP and JSON-RPC error objects.
  *
  * **Details**
  *
  * It contains the numeric error `code`, a concise `message`, and optional
  * sender-defined `data`.
  *
- * @category errors
+ * @category schemas
  * @since 4.0.0
  */
 export declare class McpErrorBase extends McpErrorBase_base {
 }
 /**
- * JSON-RPC error code for requests that are not valid request objects.
+ * Represents the JSON-RPC error code for requests that are not valid request objects.
  *
- * @category errors
+ * **When to use**
+ *
+ * Use when you need the JSON-RPC error code for requests that are not valid
+ * request objects.
+ *
+ * @category constants
  * @since 4.0.0
  */
 export declare const INVALID_REQUEST_ERROR_CODE: -32600;
 /**
- * JSON-RPC error code for requests whose method does not exist or is not
+ * Represents the JSON-RPC error code for requests whose method does not exist or is not
  * available.
  *
- * @category errors
+ * **When to use**
+ *
+ * Use when you need the JSON-RPC error code for requests whose method does not
+ * exist or is not available.
+ *
+ * @category constants
  * @since 4.0.0
  */
 export declare const METHOD_NOT_FOUND_ERROR_CODE: -32601;
 /**
- * JSON-RPC error code for invalid method parameters.
+ * Represents the JSON-RPC error code for invalid method parameters.
  *
- * @category errors
+ * **When to use**
+ *
+ * Use when you need the JSON-RPC error code for invalid method parameters.
+ *
+ * @category constants
  * @since 4.0.0
  */
 export declare const INVALID_PARAMS_ERROR_CODE: -32602;
 /**
- * JSON-RPC error code for internal server errors.
+ * Represents the JSON-RPC error code for internal server errors.
  *
- * @category errors
+ * **When to use**
+ *
+ * Use when you need the JSON-RPC error code for internal server errors.
+ *
+ * @category constants
  * @since 4.0.0
  */
 export declare const INTERNAL_ERROR_CODE: -32603;
 /**
- * JSON-RPC error code for invalid JSON that could not be parsed.
+ * Represents the JSON-RPC error code for invalid JSON that could not be parsed.
  *
- * @category errors
+ * **When to use**
+ *
+ * Use when you need the JSON-RPC error code for invalid JSON that could not be
+ * parsed.
+ *
+ * @category constants
  * @since 4.0.0
  */
 export declare const PARSE_ERROR_CODE: -32700;
@@ -684,8 +726,16 @@ declare const ParseError_base: Schema.Class<ParseError, Schema.Struct<{
     readonly data: Schema.decodeTo<Schema.optional<Schema.Any>, Schema.optionalKey<Schema.Any>, never, never>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
- * MCP/JSON-RPC error for invalid JSON that could not be parsed. This error
- * uses the standard parse error code `-32700`.
+ * Represents an MCP/JSON-RPC error for invalid JSON that could not be parsed.
+ *
+ * **When to use**
+ *
+ * Use to report a JSON parse failure before a valid JSON-RPC request object is
+ * available.
+ *
+ * **Details**
+ *
+ * Uses the standard JSON-RPC parse error code `-32700`.
  *
  * @category errors
  * @since 4.0.0
@@ -707,8 +757,16 @@ declare const InvalidRequest_base: Schema.Class<InvalidRequest, Schema.Struct<{
     readonly data: Schema.decodeTo<Schema.optional<Schema.Any>, Schema.optionalKey<Schema.Any>, never, never>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
- * MCP/JSON-RPC error for a request object that is not valid. This error uses
- * the standard invalid request code `-32600`.
+ * Represents an MCP/JSON-RPC error for a request object that is not valid.
+ *
+ * **When to use**
+ *
+ * Use to report a syntactically parsed JSON-RPC request that is not a valid
+ * request object.
+ *
+ * **Details**
+ *
+ * Uses the standard JSON-RPC invalid request code `-32600`.
  *
  * @category errors
  * @since 4.0.0
@@ -730,8 +788,15 @@ declare const MethodNotFound_base: Schema.Class<MethodNotFound, Schema.Struct<{
     readonly data: Schema.decodeTo<Schema.optional<Schema.Any>, Schema.optionalKey<Schema.Any>, never, never>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
- * MCP/JSON-RPC error for a method that does not exist or is not available.
- * This error uses the standard method not found code `-32601`.
+ * Represents an MCP/JSON-RPC error for an unavailable method.
+ *
+ * **When to use**
+ *
+ * Use to report a JSON-RPC method that does not exist or is not available.
+ *
+ * **Details**
+ *
+ * Uses the standard JSON-RPC method-not-found code `-32601`.
  *
  * @category errors
  * @since 4.0.0
@@ -753,8 +818,16 @@ declare const InvalidParams_base: Schema.Class<InvalidParams, Schema.Struct<{
     readonly data: Schema.decodeTo<Schema.optional<Schema.Any>, Schema.optionalKey<Schema.Any>, never, never>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
- * MCP/JSON-RPC error for invalid method parameters. This error uses the
- * standard invalid params code `-32602`.
+ * Represents an MCP/JSON-RPC error for invalid method parameters.
+ *
+ * **When to use**
+ *
+ * Use to report a request whose method parameters do not match the method
+ * schema.
+ *
+ * **Details**
+ *
+ * Uses the standard JSON-RPC invalid params code `-32602`.
  *
  * @category errors
  * @since 4.0.0
@@ -776,8 +849,16 @@ declare const InternalError_base: Schema.Class<InternalError, Schema.Struct<{
     readonly data: Schema.decodeTo<Schema.optional<Schema.Any>, Schema.optionalKey<Schema.Any>, never, never>;
 }>, import("../../Cause.ts").YieldableError>;
 /**
- * MCP/JSON-RPC error for unexpected internal server failures. This error uses
- * the standard internal error code `-32603` and includes
+ * Represents an MCP/JSON-RPC error for unexpected internal server failures.
+ *
+ * **When to use**
+ *
+ * Use to report an unexpected server-side failure while handling a valid
+ * request.
+ *
+ * **Details**
+ *
+ * Uses the standard JSON-RPC internal error code `-32603` and includes
  * `InternalError.notImplemented` for unimplemented handlers.
  *
  * @category errors
@@ -796,9 +877,15 @@ export declare class InternalError extends InternalError_base {
 export declare const McpError: Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>;
 declare const Ping_base: Rpc.Rpc<"ping", Schema.UndefinedOr<typeof RequestMeta>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * A ping, issued by either the server or the client, to check that the other
- * party is still alive. The receiver must promptly respond, or else may be
- * disconnected.
+ * Represents an MCP ping request used to check whether the peer is still alive.
+ *
+ * **When to use**
+ *
+ * Use to implement client or server liveness checks.
+ *
+ * **Details**
+ *
+ * The receiver should respond promptly; otherwise the sender may disconnect.
  *
  * @category ping
  * @since 4.0.0
@@ -851,8 +938,7 @@ declare const InitializeResult_base: Schema.Opaque<InitializeResult, Schema.Stru
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * After receiving an initialize request from the client, the server sends this
- * response.
+ * Schema for the server's response to an initialize request from the client.
  *
  * @category initialization
  * @since 4.0.0
@@ -896,8 +982,8 @@ declare const Initialize_base: Rpc.Rpc<"initialize", Schema.Struct<{
     }>>, never, never>;
 }>, typeof InitializeResult, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * This request is sent from the client to the server when it first connects,
- * asking it to begin initialization.
+ * Sent from the client to the server when it first connects, asking it to begin
+ * initialization.
  *
  * @category initialization
  * @since 4.0.0
@@ -906,8 +992,7 @@ export declare class Initialize extends Initialize_base {
 }
 declare const InitializedNotification_base: Rpc.Rpc<"notifications/initialized", Schema.UndefinedOr<typeof NotificationMeta>, Schema.Void, Schema.Never, never, never>;
 /**
- * This notification is sent from the client to the server after initialization
- * has finished.
+ * Sent from the client to the server after initialization has finished.
  *
  * @category initialization
  * @since 4.0.0
@@ -930,8 +1015,8 @@ declare const CancelledNotification_base: Rpc.Rpc<"notifications/cancelled", Sch
     _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, Schema.Void, Schema.Never, never, never>;
 /**
- * Notification sent by either peer to cancel a previously issued request in
- * the same direction.
+ * Sent from either peer to cancel a previously issued request in the same
+ * direction.
  *
  * **Details**
  *
@@ -965,8 +1050,7 @@ declare const ProgressNotification_base: Rpc.Rpc<"notifications/progress", Schem
     _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, Schema.Void, Schema.Never, never, never>;
 /**
- * An out-of-band notification used to inform the receiver of a progress update
- * for a long-running request.
+ * Sent from either peer to report progress for a long-running request.
  *
  * @category progress
  * @since 4.0.0
@@ -1017,7 +1101,7 @@ declare const Resource_base: Schema.Class<Resource, Schema.Struct<{
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * A known resource that the server is capable of reading.
+ * Schema for a known resource that the server is capable of reading.
  *
  * @category resources
  * @since 4.0.0
@@ -1059,7 +1143,7 @@ declare const ResourceTemplate_base: Schema.Class<ResourceTemplate, Schema.Struc
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * A template description for resources available on the server.
+ * Schema for a template description of resources available on the server.
  *
  * @category resources
  * @since 4.0.0
@@ -1094,7 +1178,7 @@ declare const ResourceContents_base: Schema.Opaque<ResourceContents, Schema.Stru
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * The contents of a specific resource or sub-resource.
+ * Schema for the contents of a specific resource or sub-resource.
  *
  * @category resources
  * @since 4.0.0
@@ -1139,7 +1223,7 @@ declare const TextResourceContents_base: Schema.Opaque<TextResourceContents, Sch
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * The contents of a text resource, which can be represented as a string.
+ * Schema for text resource contents represented as a string.
  *
  * @category resources
  * @since 4.0.0
@@ -1182,7 +1266,7 @@ declare const BlobResourceContents_base: Schema.Opaque<BlobResourceContents, Sch
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * The contents of a binary resource, which can be represented as an Uint8Array
+ * Schema for binary resource contents represented as a `Uint8Array`.
  *
  * @category resources
  * @since 4.0.0
@@ -1203,7 +1287,7 @@ declare const ListResourcesResult_base: Schema.Class<ListResourcesResult, Schema
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The server's response to a resources/list request from the client.
+ * Schema for the server's response to a resources/list request from the client.
  *
  * @category resources
  * @since 4.0.0
@@ -1233,7 +1317,8 @@ declare const ListResourceTemplatesResult_base: Schema.Class<ListResourceTemplat
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The server's response to a resources/templates/list request from the client.
+ * Schema for the server's response to a resources/templates/list request from
+ * the client.
  *
  * @category resources
  * @since 4.0.0
@@ -1265,7 +1350,7 @@ declare const ReadResourceResult_base: Schema.Opaque<ReadResourceResult, Schema.
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * The server's response to a resources/read request from the client.
+ * Schema for the server's response to a resources/read request from the client.
  *
  * @category resources
  * @since 4.0.0
@@ -1308,9 +1393,15 @@ export declare class ReadResource extends ReadResource_base {
 }
 declare const ResourceListChangedNotification_base: Rpc.Rpc<"notifications/resources/list_changed", Schema.UndefinedOr<typeof NotificationMeta>, Schema.Void, Schema.Never, never, never>;
 /**
- * An optional notification from the server to the client, informing it that the
- * list of resources it can read from has changed. This may be issued by servers
- * without any previous subscription from the client.
+ * Represents a notification that the server's resource list changed.
+ *
+ * **When to use**
+ *
+ * Use to notify clients that `resources/list` should be requested again.
+ *
+ * **Details**
+ *
+ * Servers may send this notification without a previous client subscription.
  *
  * @category resources
  * @since 4.0.0
@@ -1396,7 +1487,7 @@ declare const ResourceUpdatedNotification_base: Rpc.Rpc<"notifications/resources
     _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, Schema.Void, Schema.Never, never, never>;
 /**
- * Notification sent by the server when a subscribed resource URI has changed.
+ * Sent from the server when a subscribed resource URI has changed.
  *
  * **Details**
  *
@@ -1440,7 +1531,7 @@ declare const PromptArgument_base: Schema.Opaque<PromptArgument, Schema.Struct<{
 /**
  * Describes an argument that a prompt can accept.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class PromptArgument extends PromptArgument_base {
@@ -1461,9 +1552,9 @@ declare const Prompt_base: Schema.Class<Prompt, Schema.Struct<{
     readonly arguments: Schema.decodeTo<Schema.optional<Schema.$Array<typeof PromptArgument>>, Schema.optionalKey<Schema.$Array<typeof PromptArgument>>, never, never>;
 }>, {}>;
 /**
- * A prompt or prompt template that the server offers.
+ * Represents a prompt or prompt template that the server offers.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class Prompt extends Prompt_base {
@@ -1490,9 +1581,9 @@ declare const TextContent_base: Schema.Opaque<TextContent, Schema.Struct<{
     readonly annotations: Schema.decodeTo<Schema.optional<typeof Annotations>, Schema.optionalKey<typeof Annotations>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * Text provided to or from an LLM.
+ * Represents text content provided to or from an LLM.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class TextContent extends TextContent_base {
@@ -1529,9 +1620,9 @@ declare const ImageContent_base: Schema.Opaque<ImageContent, Schema.Struct<{
     readonly annotations: Schema.decodeTo<Schema.optional<typeof Annotations>, Schema.optionalKey<typeof Annotations>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * An image provided to or from an LLM.
+ * Represents image content provided to or from an LLM.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ImageContent extends ImageContent_base {
@@ -1568,9 +1659,9 @@ declare const AudioContent_base: Schema.Opaque<AudioContent, Schema.Struct<{
     readonly annotations: Schema.decodeTo<Schema.optional<typeof Annotations>, Schema.optionalKey<typeof Annotations>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * Audio provided to or from an LLM.
+ * Represents audio content provided to or from an LLM.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class AudioContent extends AudioContent_base {
@@ -1591,14 +1682,14 @@ declare const EmbeddedResource_base: Schema.Opaque<EmbeddedResource, Schema.Stru
     readonly annotations: Schema.decodeTo<Schema.optional<typeof Annotations>, Schema.optionalKey<typeof Annotations>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * The contents of a resource, embedded into a prompt or tool call result.
+ * Represents resource contents embedded into a prompt or tool call result.
  *
  * **Details**
  *
  * It is up to the client how best to render embedded resources for the benefit
  * of the LLM and/or the user.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class EmbeddedResource extends EmbeddedResource_base {
@@ -1691,24 +1782,23 @@ declare const ResourceLink_base: Schema.Opaque<ResourceLink, Schema.Struct<{
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * A resource that the server is capable of reading, included in a prompt or
- * tool call result.
+ * Represents a readable resource included in a prompt or tool call result.
  *
  * **Gotchas**
  *
  * Resource links returned by tools are not guaranteed to appear in the results
  * of `resources/list` requests.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ResourceLink extends ResourceLink_base {
 }
 /**
- * Union of MCP content blocks that can appear in prompt messages or tool
- * results, including text, media, embedded resources, and resource links.
+ * Schema for MCP content blocks that can appear in prompt messages or tool
+ * results.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare const ContentBlock: Schema.Union<readonly [typeof TextContent, typeof ImageContent, typeof AudioContent, typeof EmbeddedResource, typeof ResourceLink]>;
@@ -1727,7 +1817,7 @@ declare const PromptMessage_base: Schema.Opaque<PromptMessage, Schema.Struct<{
  * This is similar to `SamplingMessage`, but also supports the embedding of
  * resources from the MCP server.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class PromptMessage extends PromptMessage_base {
@@ -1746,9 +1836,9 @@ declare const ListPromptsResult_base: Schema.Class<ListPromptsResult, Schema.Str
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The server's response to a prompts/list request from the client.
+ * Represents the server response to a prompts/list request from the client.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ListPromptsResult extends ListPromptsResult_base {
@@ -1758,7 +1848,7 @@ declare const ListPrompts_base: Rpc.Rpc<"prompts/list", Schema.UndefinedOr<typeo
  * Sent from the client to request a list of prompts and prompt templates the
  * server has.
  *
- * @category prompts
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ListPrompts extends ListPrompts_base {
@@ -1776,9 +1866,9 @@ declare const GetPromptResult_base: Schema.Class<GetPromptResult, Schema.Struct<
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The server's response to a prompts/get request from the client.
+ * Represents the server response to a prompts/get request from the client.
  *
- * @category prompts
+ * @category schemas
  * @since 4.0.0
  */
 export declare class GetPromptResult extends GetPromptResult_base {
@@ -1814,20 +1904,26 @@ declare const GetPrompt_base: Rpc.Rpc<"prompts/get", Schema.Struct<{
     }>>, never, never>;
 }>, typeof GetPromptResult, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * Used by the client to get a prompt provided by the server.
+ * Sent from the client to get a prompt provided by the server.
  *
- * @category prompts
+ * @category protocols
  * @since 4.0.0
  */
 export declare class GetPrompt extends GetPrompt_base {
 }
 declare const PromptListChangedNotification_base: Rpc.Rpc<"notifications/prompts/list_changed", Schema.UndefinedOr<typeof NotificationMeta>, Schema.Void, Schema.Never, never, never>;
 /**
- * An optional notification from the server to the client, informing it that
- * the list of prompts it offers has changed. This may be issued by servers
- * without any previous subscription from the client.
+ * Represents a notification that the server's prompt list changed.
+ *
+ * **When to use**
+ *
+ * Use to notify clients that `prompts/list` should be requested again.
+ *
+ * **Details**
+ *
+ * Servers may send this notification without a previous client subscription.
  *
- * @category prompts
+ * @category protocols
  * @since 4.0.0
  */
 export declare class PromptListChangedNotification extends PromptListChangedNotification_base {
@@ -1910,7 +2006,7 @@ declare const ToolAnnotations_base: Schema.Opaque<ToolAnnotations, Schema.Struct
     readonly openWorldHint: optionalWithDefault<Schema.Boolean>;
 }>, keyof Schema.Top>;
 /**
- * Additional properties describing a Tool to clients.
+ * Schema for additional properties describing a tool to clients.
  *
  * **Details**
  *
@@ -1957,7 +2053,7 @@ declare const Tool_base: Schema.Class<Tool, Schema.Struct<{
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * Definition for a tool the client can call.
+ * Schema for the definition of a tool the client can call.
  *
  * @category tools
  * @since 4.0.0
@@ -1978,7 +2074,7 @@ declare const ListToolsResult_base: Schema.Class<ListToolsResult, Schema.Struct<
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The server's response to a tools/list request from the client.
+ * Schema for the server's response to a tools/list request from the client.
  *
  * @category tools
  * @since 4.0.0
@@ -2010,7 +2106,7 @@ declare const CallToolResult_base: Schema.Class<CallToolResult, Schema.Struct<{
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The server's response to a tool call.
+ * Schema for the server's response to a tool call.
  *
  * **Details**
  *
@@ -2050,7 +2146,15 @@ declare const CallTool_base: Rpc.Rpc<"tools/call", Schema.Struct<{
     }>>, never, never>;
 }>, typeof CallToolResult, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * Used by the client to invoke a tool provided by the server.
+ * Represents a client request to invoke a tool provided by the server.
+ *
+ * **When to use**
+ *
+ * Use when a client already knows the tool name and wants the server to execute
+ * it with argument values.
+ *
+ * @see {@link ListTools} for discovering available tools before calling one
+ * @see {@link CallToolResult} for the successful tool-call result shape
  *
  * @category tools
  * @since 4.0.0
@@ -2059,9 +2163,15 @@ export declare class CallTool extends CallTool_base {
 }
 declare const ToolListChangedNotification_base: Rpc.Rpc<"notifications/tools/list_changed", Schema.UndefinedOr<typeof NotificationMeta>, Schema.Void, Schema.Never, never, never>;
 /**
- * An optional notification from the server to the client, informing it that
- * the list of tools it offers has changed. This may be issued by servers
- * without any previous subscription from the client.
+ * Represents a notification that the server's tool list changed.
+ *
+ * **When to use**
+ *
+ * Use to notify clients that `tools/list` should be requested again.
+ *
+ * **Details**
+ *
+ * Servers may send this notification without a previous client subscription.
  *
  * @category tools
  * @since 4.0.0
@@ -2069,8 +2179,8 @@ declare const ToolListChangedNotification_base: Rpc.Rpc<"notifications/tools/lis
 export declare class ToolListChangedNotification extends ToolListChangedNotification_base {
 }
 /**
- * The severity of a log message, mapped to syslog message severities as
- * specified in RFC 5424 section 6.2.1:
+ * Schema for log message severity levels, mapped to syslog message severities
+ * as specified in RFC 5424 section 6.2.1:
  * https://datatracker.ietf.org/doc/html/rfc5424#section-6.2.1.
  *
  * @category logging
@@ -2123,7 +2233,7 @@ declare const SetLevel_base: Rpc.Rpc<"logging/setLevel", Schema.Struct<{
     }>>, never, never>;
 }>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * A request from the client to the server, to enable or adjust logging.
+ * Sent from the client to the server to enable or adjust logging.
  *
  * @category logging
  * @since 4.0.0
@@ -2151,7 +2261,7 @@ declare const LoggingMessageNotification_base: Rpc.Rpc<"notifications/message",
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, Schema.Void, Schema.Never, never, never>;
 /**
- * Server notification carrying a log message for the client.
+ * Sent from the server to the client carrying a log message.
  *
  * **Details**
  *
@@ -2208,7 +2318,7 @@ declare const ModelHint_base: Schema.Opaque<ModelHint, Schema.Struct<{
     readonly name: Schema.decodeTo<Schema.optional<Schema.String>, Schema.optionalKey<Schema.String>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * Hints to use for model selection.
+ * Schema for model selection hints.
  *
  * **Details**
  *
@@ -2251,8 +2361,8 @@ declare const ModelPreferences_base: Schema.Class<ModelPreferences, Schema.Struc
     readonly intelligencePriority: Schema.decodeTo<Schema.optional<Schema.Number>, Schema.optionalKey<Schema.Number>, never, never>;
 }>, {}>;
 /**
- * The server's preferences for model selection, requested of the client during
- * sampling.
+ * Schema for the server's model selection preferences requested of the client
+ * during sampling.
  *
  * **Details**
  *
@@ -2284,10 +2394,16 @@ declare const CreateMessageResult_base: Schema.Class<CreateMessageResult, Schema
     readonly stopReason: Schema.decodeTo<Schema.optional<Schema.String>, Schema.optionalKey<Schema.String>, never, never>;
 }>, {}>;
 /**
- * The client's response to a sampling/create_message request from the server.
- * The client should inform the user before returning the sampled message, to
- * allow them to inspect the response (human in the loop) and decide whether to
- * allow the server to see it.
+ * Represents a client response to an MCP sampling request.
+ *
+ * **When to use**
+ *
+ * Use to return the message produced by client-side model sampling.
+ *
+ * **Details**
+ *
+ * The client should let the user inspect the sampled message before returning
+ * it to the server.
  *
  * @category sampling
  * @since 4.0.0
@@ -2325,10 +2441,17 @@ declare const CreateMessage_base: Rpc.Rpc<"sampling/createMessage", Schema.Struc
     metadata: Schema.Any;
 }>, typeof CreateMessageResult, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * A request from the server to sample an LLM via the client. The client has
- * full discretion over which model to select. The client should also inform the
- * user before beginning sampling, to allow them to inspect the request (human
- * in the loop) and decide whether to approve it.
+ * Represents a server request for the client to sample an LLM.
+ *
+ * **When to use**
+ *
+ * Use when an MCP server needs the client to perform model sampling on its
+ * behalf.
+ *
+ * **Details**
+ *
+ * The client chooses the model and should ask the user to approve the sampling
+ * request before it begins.
  *
  * @category sampling
  * @since 4.0.0
@@ -2349,7 +2472,7 @@ declare const ResourceReference_base: Schema.Opaque<ResourceReference, Schema.St
     readonly uri: Schema.String;
 }>, keyof Schema.Top>;
 /**
- * A reference to a resource or resource template definition.
+ * Schema for a reference to a resource or resource template definition.
  *
  * @category autocomplete
  * @since 4.0.0
@@ -2372,7 +2495,7 @@ declare const PromptReference_base: Schema.Opaque<PromptReference, Schema.Struct
     readonly title: Schema.decodeTo<Schema.optional<Schema.String>, Schema.optionalKey<Schema.String>, never, never>;
 }>, keyof Schema.Top>;
 /**
- * Identifies a prompt.
+ * Schema for a prompt reference used in autocomplete requests.
  *
  * @category autocomplete
  * @since 4.0.0
@@ -2415,7 +2538,7 @@ declare const CompleteResult_base: Schema.Opaque<CompleteResult, Schema.Struct<{
     }>;
 }>, keyof Schema.Top>;
 /**
- * The server's response to a completion/complete request
+ * Schema for the server's response to a completion/complete request.
  *
  * @category autocomplete
  * @since 4.0.0
@@ -2454,7 +2577,7 @@ declare const Complete_base: Rpc.Rpc<"completion/complete", Schema.Struct<{
     }>>;
 }>, typeof CompleteResult, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * A request from the client to the server, to ask for completion options.
+ * Sent from the client to the server to ask for completion options.
  *
  * @category autocomplete
  * @since 4.0.0
@@ -2487,9 +2610,11 @@ declare const ListRootsResult_base: Schema.Class<ListRootsResult, Schema.Struct<
     readonly roots: Schema.$Array<typeof Root>;
 }>, {}>;
 /**
- * The client's response to a roots/list request from the server. This result
- * contains an array of Root objects, each representing a root directory or file
- * that the server can operate on.
+ * Represents a client response containing the roots available to the server.
+ *
+ * **When to use**
+ *
+ * Use to return the directories or files that an MCP server may operate on.
  *
  * @category roots
  * @since 4.0.0
@@ -2516,10 +2641,15 @@ export declare class ListRoots extends ListRoots_base {
 }
 declare const RootsListChangedNotification_base: Rpc.Rpc<"notifications/roots/list_changed", Schema.UndefinedOr<typeof NotificationMeta>, Schema.Void, Schema.Never, never, never>;
 /**
- * A notification from the client to the server, informing it that the list of
- * roots has changed. This notification should be sent whenever the client adds,
- * removes, or modifies any root. The server should then request an updated list
- * of roots using the ListRootsRequest.
+ * Represents a notification that the client's root list changed.
+ *
+ * **When to use**
+ *
+ * Use to tell the server that it should request an updated roots list.
+ *
+ * **Details**
+ *
+ * Send this when the client adds, removes, or modifies a root.
  *
  * @category roots
  * @since 4.0.0
@@ -2546,7 +2676,7 @@ declare const ElicitAcceptResult_base: Schema.Class<ElicitAcceptResult, Schema.S
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The client's response to an elicitation request
+ * Schema for an accepted client response to an elicitation request.
  *
  * @category elicitation
  * @since 4.0.0
@@ -2568,7 +2698,7 @@ declare const ElicitDeclineResult_base: Schema.Class<ElicitDeclineResult, Schema
     readonly _meta: Schema.decodeTo<Schema.optional<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, Schema.optionalKey<Schema.$Record<Schema.String, Schema.Codec<Schema.Json, Schema.Json, never, never>>>, never, never>;
 }>, {}>;
 /**
- * The client's response to an elicitation request
+ * Schema for a declined or canceled client response to an elicitation request.
  *
  * @category elicitation
  * @since 4.0.0
@@ -2576,7 +2706,7 @@ declare const ElicitDeclineResult_base: Schema.Class<ElicitDeclineResult, Schema
 export declare class ElicitDeclineResult extends ElicitDeclineResult_base {
 }
 /**
- * The client's response to an elicitation request
+ * Schema for every client response to an elicitation request.
  *
  * @category elicitation
  * @since 4.0.0
@@ -2595,8 +2725,8 @@ declare const Elicit_base: Rpc.Rpc<"elicitation/create", Schema.Struct<{
     requestedSchema: Schema.Any;
 }>, Schema.Union<readonly [typeof ElicitAcceptResult, typeof ElicitDeclineResult]>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
- * Request sent by the server asking the client to collect structured input
- * from the user.
+ * Sent from the server asking the client to collect structured input from the
+ * user.
  *
  * **Details**
  *
@@ -2670,7 +2800,7 @@ export declare class McpServerClientMiddleware extends McpServerClientMiddleware
  * Encoded JSON-RPC request message for an RPC in `Group`, including the request
  * id, method, and encoded payload.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type RequestEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Group> extends infer Rpc ? Rpc extends Rpc.Rpc<infer _Tag, infer _Payload, infer _Success, infer _Error, infer _Middleware> ? {
@@ -2683,7 +2813,7 @@ export type RequestEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Group> ex
  * Encoded notification message for an RPC in `Group`, including the method and
  * encoded payload without a request id.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type NotificationEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Group> extends infer Rpc ? Rpc extends Rpc.Rpc<infer _Tag, infer _Payload, infer _Success, infer _Error, infer _Middleware> ? {
@@ -2695,7 +2825,7 @@ export type NotificationEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Grou
  * Encoded success response for an RPC in `Group`, containing the original
  * request id and encoded result.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type SuccessEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Group> extends infer Rpc ? Rpc extends Rpc.Rpc<infer _Tag, infer _Payload, infer _Success, infer _Error, infer _Middleware> ? {
@@ -2707,7 +2837,7 @@ export type SuccessEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Group> ex
  * Encoded failure response for an RPC in `Group`, containing the original
  * request id and encoded error.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type FailureEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Group> extends infer Rpc ? Rpc extends Rpc.Rpc<infer _Tag, infer _Payload, infer _Success, infer _Error, infer _Middleware> ? {
@@ -2936,7 +3066,7 @@ declare const ClientRequestRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.U
  * completion, and ping requests, and installs `McpServerClientMiddleware` for
  * handlers.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ClientRequestRpcs extends ClientRequestRpcs_base {
@@ -2944,7 +3074,7 @@ export declare class ClientRequestRpcs extends ClientRequestRpcs_base {
 /**
  * Encoded union of all client-to-server MCP request messages.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ClientRequestEncoded = RequestEncoded<typeof ClientRequestRpcs>;
@@ -2953,7 +3083,7 @@ declare const ClientNotificationRpcs_base: RpcGroup.RpcGroup<typeof InitializedN
  * RPC group for notifications that MCP clients send to the server, such as
  * cancellation, progress, initialization completion, and roots list changes.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ClientNotificationRpcs extends ClientNotificationRpcs_base {
@@ -2961,7 +3091,7 @@ export declare class ClientNotificationRpcs extends ClientNotificationRpcs_base
 /**
  * Encoded union of all client-to-server MCP notification messages.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ClientNotificationEncoded = NotificationEncoded<typeof ClientNotificationRpcs>;
@@ -3180,7 +3310,7 @@ declare const ClientRpcs_base: RpcGroup.RpcGroup<typeof InitializedNotification
 /**
  * RPC group combining all client-to-server MCP requests and notifications.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ClientRpcs extends ClientRpcs_base {
@@ -3188,14 +3318,14 @@ export declare class ClientRpcs extends ClientRpcs_base {
 /**
  * Encoded success response sent by a client for a server-initiated request.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ClientSuccessEncoded = SuccessEncoded<typeof ServerRequestRpcs>;
 /**
  * Encoded failure response sent by a client for a server-initiated request.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ClientFailureEncoded = FailureEncoded<typeof ServerRequestRpcs>;
@@ -3204,7 +3334,7 @@ declare const ServerRequestRpcs_base: RpcGroup.RpcGroup<typeof Ping | typeof Cre
  * RPC group for requests that an MCP server can send to a client, including
  * ping, sampling, roots listing, and elicitation.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ServerRequestRpcs extends ServerRequestRpcs_base {
@@ -3212,7 +3342,7 @@ export declare class ServerRequestRpcs extends ServerRequestRpcs_base {
 /**
  * Encoded union of all server-to-client MCP request messages.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ServerRequestEncoded = RequestEncoded<typeof ServerRequestRpcs>;
@@ -3222,7 +3352,7 @@ declare const ServerNotificationRpcs_base: RpcGroup.RpcGroup<typeof CancelledNot
  * including cancellation, progress, logging, and list or resource update
  * notifications.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ServerNotificationRpcs extends ServerNotificationRpcs_base {
@@ -3230,28 +3360,28 @@ export declare class ServerNotificationRpcs extends ServerNotificationRpcs_base
 /**
  * Encoded union of all server-to-client MCP notification messages.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ServerNotificationEncoded = NotificationEncoded<typeof ServerNotificationRpcs>;
 /**
  * Encoded success response sent by the server for a client-initiated request.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ServerSuccessEncoded = SuccessEncoded<typeof ClientRequestRpcs>;
 /**
  * Encoded failure response sent by the server for a client-initiated request.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ServerFailureEncoded = FailureEncoded<typeof ClientRequestRpcs>;
 /**
  * Encoded server response to a client request, either success or failure.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type ServerResultEncoded = ServerSuccessEncoded | ServerFailureEncoded;
@@ -3259,7 +3389,7 @@ export type ServerResultEncoded = ServerSuccessEncoded | ServerFailureEncoded;
  * Encoded MCP messages accepted from a client by the server protocol: client
  * requests and client notifications.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type FromClientEncoded = ClientRequestEncoded | ClientNotificationEncoded;
@@ -3267,7 +3397,7 @@ export type FromClientEncoded = ClientRequestEncoded | ClientNotificationEncoded
  * Encoded MCP messages emitted by the server protocol to a client: server
  * responses and server notifications.
  *
- * @category protocol
+ * @category protocols
  * @since 4.0.0
  */
 export type FromServerEncoded = ServerResultEncoded | ServerNotificationEncoded;
@@ -3298,7 +3428,7 @@ export interface Param<Name extends string, S extends Schema.Top> extends Schema
     readonly schema: S;
 }
 /**
- * Helper to create a param for a resource URI template.
+ * Creates a parameter for a resource URI template.
  *
  * @category parameters
  * @since 4.0.0