effect 4.0.0-beta.102 → 4.0.0-beta.103

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

@@ -20,6 +20,7 @@ import type * as RpcClient from "../rpc/RpcClient.ts";
 import type { RpcClientError } from "../rpc/RpcClientError.ts";
 import * as RpcGroup from "../rpc/RpcGroup.ts";
 import * as RpcMiddleware from "../rpc/RpcMiddleware.ts";
+import type * as McpProtocol from "./McpProtocol.ts";
 /**
  * Schema type returned by `optionalWithDefault`.
  *
@@ -870,7 +871,7 @@ declare const Ping_base: Rpc.Rpc<"ping", Schema.UndefinedOr<typeof RequestMeta>,
  *
  * The receiver should respond promptly; otherwise the sender may disconnect.
  *
- * @category ping
+ * @category protocols
  * @since 4.0.0
  */
 export declare class Ping extends Ping_base {
@@ -923,7 +924,7 @@ declare const InitializeResult_base: Schema.Opaque<InitializeResult, Schema.Stru
 /**
  * Schema for the server's response to an initialize request from the client.
  *
- * @category initialization
+ * @category schemas
  * @since 4.0.0
  */
 export declare class InitializeResult extends InitializeResult_base {
@@ -968,7 +969,7 @@ declare const Initialize_base: Rpc.Rpc<"initialize", Schema.Struct<{
  * Sent from the client to the server when it first connects, asking it to begin
  * initialization.
  *
- * @category initialization
+ * @category protocols
  * @since 4.0.0
  */
 export declare class Initialize extends Initialize_base {
@@ -977,7 +978,7 @@ declare const InitializedNotification_base: Rpc.Rpc<"notifications/initialized",
 /**
  * Sent from the client to the server after initialization has finished.
  *
- * @category initialization
+ * @category protocols
  * @since 4.0.0
  */
 export declare class InitializedNotification extends InitializedNotification_base {
@@ -1006,7 +1007,7 @@ declare const CancelledNotification_base: Rpc.Rpc<"notifications/cancelled", Sch
  * The payload identifies the request to cancel and may include a
  * human-readable reason.
  *
- * @category cancellation
+ * @category protocols
  * @since 4.0.0
  */
 export declare class CancelledNotification extends CancelledNotification_base {
@@ -1035,7 +1036,7 @@ declare const ProgressNotification_base: Rpc.Rpc<"notifications/progress", Schem
 /**
  * Sent from either peer to report progress for a long-running request.
  *
- * @category progress
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ProgressNotification extends ProgressNotification_base {
@@ -1086,7 +1087,7 @@ declare const Resource_base: Schema.Class<Resource, Schema.Struct<{
 /**
  * Schema for a known resource that the server is capable of reading.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class Resource extends Resource_base {
@@ -1128,7 +1129,7 @@ declare const ResourceTemplate_base: Schema.Class<ResourceTemplate, Schema.Struc
 /**
  * Schema for a template description of resources available on the server.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ResourceTemplate extends ResourceTemplate_base {
@@ -1163,7 +1164,7 @@ declare const ResourceContents_base: Schema.Opaque<ResourceContents, Schema.Stru
 /**
  * Schema for the contents of a specific resource or sub-resource.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ResourceContents extends ResourceContents_base {
@@ -1208,7 +1209,7 @@ declare const TextResourceContents_base: Schema.Opaque<TextResourceContents, Sch
 /**
  * Schema for text resource contents represented as a string.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class TextResourceContents extends TextResourceContents_base {
@@ -1251,7 +1252,7 @@ declare const BlobResourceContents_base: Schema.Opaque<BlobResourceContents, Sch
 /**
  * Schema for binary resource contents represented as a `Uint8Array`.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class BlobResourceContents extends BlobResourceContents_base {
@@ -1272,7 +1273,7 @@ declare const ListResourcesResult_base: Schema.Class<ListResourcesResult, Schema
 /**
  * Schema for the server's response to a resources/list request from the client.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ListResourcesResult extends ListResourcesResult_base {
@@ -1281,7 +1282,7 @@ declare const ListResources_base: Rpc.Rpc<"resources/list", Schema.UndefinedOr<t
 /**
  * Sent from the client to request a list of resources the server has.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ListResources extends ListResources_base {
@@ -1303,7 +1304,7 @@ declare const ListResourceTemplatesResult_base: Schema.Class<ListResourceTemplat
  * Schema for the server's response to a resources/templates/list request from
  * the client.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ListResourceTemplatesResult extends ListResourceTemplatesResult_base {
@@ -1312,7 +1313,7 @@ declare const ListResourceTemplates_base: Rpc.Rpc<"resources/templates/list", Sc
 /**
  * Sent from the client to request a list of resource templates the server has.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ListResourceTemplates extends ListResourceTemplates_base {
@@ -1335,7 +1336,7 @@ declare const ReadResourceResult_base: Schema.Opaque<ReadResourceResult, Schema.
 /**
  * Schema for the server's response to a resources/read request from the client.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ReadResourceResult extends ReadResourceResult_base {
@@ -1369,7 +1370,7 @@ declare const ReadResource_base: Rpc.Rpc<"resources/read", Schema.Struct<{
 /**
  * Sent from the client to the server, to read a specific resource URI.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ReadResource extends ReadResource_base {
@@ -1386,7 +1387,7 @@ declare const ResourceListChangedNotification_base: Rpc.Rpc<"notifications/resou
  *
  * Servers may send this notification without a previous client subscription.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ResourceListChangedNotification extends ResourceListChangedNotification_base {
@@ -1416,12 +1417,12 @@ declare const Subscribe_base: Rpc.Rpc<"resources/subscribe", Schema.Struct<{
      * it is up to the server how to interpret it.
      */
     uri: Schema.String;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
  * Sent from the client to request resources/updated notifications from the
  * server whenever a particular resource changes.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export declare class Subscribe extends Subscribe_base {
@@ -1451,13 +1452,13 @@ declare const Unsubscribe_base: Rpc.Rpc<"resources/unsubscribe", Schema.Struct<{
      * it is up to the server how to interpret it.
      */
     uri: Schema.String;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
  * Sent from the client to request cancellation of resources/updated
  * notifications from the server. This should follow a previous
  * resources/subscribe request.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export declare class Unsubscribe extends Unsubscribe_base {
@@ -1477,7 +1478,7 @@ declare const ResourceUpdatedNotification_base: Rpc.Rpc<"notifications/resources
  * The URI may identify a sub-resource of the resource that the client
  * originally subscribed to.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ResourceUpdatedNotification extends ResourceUpdatedNotification_base {
@@ -2002,7 +2003,7 @@ declare const ToolAnnotations_base: Schema.Opaque<ToolAnnotations, Schema.Struct
  * Clients should never make tool use decisions based on ToolAnnotations
  * received from untrusted servers.
  *
- * @category tools
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ToolAnnotations extends ToolAnnotations_base {
@@ -2023,6 +2024,10 @@ declare const Tool_base: Schema.Class<Tool, Schema.Struct<{
      * A JSON Schema object defining the expected parameters for the tool.
      */
     readonly inputSchema: Schema.Any;
+    /**
+     * An optional JSON Schema object defining the expected output of the tool.
+     */
+    readonly outputSchema: Schema.decodeTo<Schema.optional<Schema.Any>, Schema.optionalKey<Schema.Any>, never, never>;
     /**
      * Optional additional tool information.
      */
@@ -2038,7 +2043,7 @@ declare const Tool_base: Schema.Class<Tool, Schema.Struct<{
 /**
  * Schema for the definition of a tool the client can call.
  *
- * @category tools
+ * @category schemas
  * @since 4.0.0
  */
 export declare class Tool extends Tool_base {
@@ -2059,7 +2064,7 @@ declare const ListToolsResult_base: Schema.Class<ListToolsResult, Schema.Struct<
 /**
  * Schema for the server's response to a tools/list request from the client.
  *
- * @category tools
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ListToolsResult extends ListToolsResult_base {
@@ -2068,7 +2073,7 @@ declare const ListTools_base: Rpc.Rpc<"tools/list", Schema.UndefinedOr<typeof Pa
 /**
  * Sent from the client to request a list of tools the server has.
  *
- * @category tools
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ListTools extends ListTools_base {
@@ -2100,7 +2105,7 @@ declare const CallToolResult_base: Schema.Class<CallToolResult, Schema.Struct<{
  * indicating that the server does not support tool calls, or any other
  * exceptional conditions, should be reported as an MCP error response.
  *
- * @category tools
+ * @category schemas
  * @since 4.0.0
  */
 export declare class CallToolResult extends CallToolResult_base {
@@ -2139,7 +2144,7 @@ declare const CallTool_base: Rpc.Rpc<"tools/call", Schema.Struct<{
  * @see {@link ListTools} for discovering available tools before calling one
  * @see {@link CallToolResult} for the successful tool-call result shape
  *
- * @category tools
+ * @category protocols
  * @since 4.0.0
  */
 export declare class CallTool extends CallTool_base {
@@ -2156,7 +2161,7 @@ declare const ToolListChangedNotification_base: Rpc.Rpc<"notifications/tools/lis
  *
  * Servers may send this notification without a previous client subscription.
  *
- * @category tools
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ToolListChangedNotification extends ToolListChangedNotification_base {
@@ -2214,7 +2219,7 @@ declare const SetLevel_base: Rpc.Rpc<"logging/setLevel", Schema.Struct<{
      * severe) to the client as notifications/message.
      */
     level: Schema.Literals<["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"]>;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, never, never>;
 /**
  * Sent from the client to the server to enable or adjust logging.
  *
@@ -2266,7 +2271,7 @@ declare const SamplingMessage_base: Schema.Opaque<SamplingMessage, Schema.Struct
 /**
  * Describes a message issued to or received from an LLM API.
  *
- * @category sampling
+ * @category schemas
  * @since 4.0.0
  */
 export declare class SamplingMessage extends SamplingMessage_base {
@@ -2308,7 +2313,7 @@ declare const ModelHint_base: Schema.Opaque<ModelHint, Schema.Struct<{
  * Keys not declared here are currently left unspecified by the spec and are up
  * to the client to interpret.
  *
- * @category sampling
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ModelHint extends ModelHint_base {
@@ -2361,12 +2366,14 @@ declare const ModelPreferences_base: Schema.Class<ModelPreferences, Schema.Struc
  * up to the client to decide how to interpret these preferences and how to
  * balance them against other considerations.
  *
- * @category sampling
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ModelPreferences extends ModelPreferences_base {
 }
 declare const CreateMessageResult_base: Schema.Class<CreateMessageResult, Schema.Struct<{
+    readonly role: Schema.Literals<["user", "assistant"]>;
+    readonly content: Schema.Union<readonly [typeof TextContent, typeof ImageContent, typeof AudioContent]>;
     /**
      * The name of the model that generated the message.
      */
@@ -2388,7 +2395,7 @@ declare const CreateMessageResult_base: Schema.Class<CreateMessageResult, Schema
  * The client should let the user inspect the sampled message before returning
  * it to the server.
  *
- * @category sampling
+ * @category schemas
  * @since 4.0.0
  */
 export declare class CreateMessageResult extends CreateMessageResult_base {
@@ -2399,7 +2406,65 @@ declare const CreateMessage_base: Rpc.Rpc<"sampling/createMessage", Schema.Struc
      * The server's preferences for which model to select. The client MAY ignore
      * these preferences.
      */
-    modelPreferences: Schema.decodeTo<Schema.optional<typeof ModelPreferences>, Schema.optionalKey<typeof ModelPreferences>, never, never>;
+    modelPreferences: Schema.decodeTo<Schema.optional<Schema.Struct<{
+        /**
+         * Optional hints to use for model selection.
+         *
+         * If multiple hints are specified, the client MUST evaluate them in order
+         * (such that the first match is taken).
+         *
+         * The client SHOULD prioritize these hints over the numeric priorities, but
+         * MAY still use the priorities to select from ambiguous matches.
+         */
+        readonly hints: Schema.decodeTo<Schema.optional<Schema.$Array<typeof ModelHint>>, Schema.optionalKey<Schema.$Array<typeof ModelHint>>, never, never>;
+        /**
+         * How much to prioritize cost when selecting a model. A value of 0 means cost
+         * is not important, while a value of 1 means cost is the most important
+         * factor.
+         */
+        readonly costPriority: Schema.decodeTo<Schema.optional<Schema.Finite>, Schema.optionalKey<Schema.Finite>, never, never>;
+        /**
+         * How much to prioritize sampling speed (latency) when selecting a model. A
+         * value of 0 means speed is not important, while a value of 1 means speed is
+         * the most important factor.
+         */
+        readonly speedPriority: Schema.decodeTo<Schema.optional<Schema.Finite>, Schema.optionalKey<Schema.Finite>, never, never>;
+        /**
+         * How much to prioritize intelligence and capabilities when selecting a
+         * model. A value of 0 means intelligence is not important, while a value of 1
+         * means intelligence is the most important factor.
+         */
+        readonly intelligencePriority: Schema.decodeTo<Schema.optional<Schema.Finite>, Schema.optionalKey<Schema.Finite>, never, never>;
+    }>>, Schema.optionalKey<Schema.Struct<{
+        /**
+         * Optional hints to use for model selection.
+         *
+         * If multiple hints are specified, the client MUST evaluate them in order
+         * (such that the first match is taken).
+         *
+         * The client SHOULD prioritize these hints over the numeric priorities, but
+         * MAY still use the priorities to select from ambiguous matches.
+         */
+        readonly hints: Schema.decodeTo<Schema.optional<Schema.$Array<typeof ModelHint>>, Schema.optionalKey<Schema.$Array<typeof ModelHint>>, never, never>;
+        /**
+         * How much to prioritize cost when selecting a model. A value of 0 means cost
+         * is not important, while a value of 1 means cost is the most important
+         * factor.
+         */
+        readonly costPriority: Schema.decodeTo<Schema.optional<Schema.Finite>, Schema.optionalKey<Schema.Finite>, never, never>;
+        /**
+         * How much to prioritize sampling speed (latency) when selecting a model. A
+         * value of 0 means speed is not important, while a value of 1 means speed is
+         * the most important factor.
+         */
+        readonly speedPriority: Schema.decodeTo<Schema.optional<Schema.Finite>, Schema.optionalKey<Schema.Finite>, never, never>;
+        /**
+         * How much to prioritize intelligence and capabilities when selecting a
+         * model. A value of 0 means intelligence is not important, while a value of 1
+         * means intelligence is the most important factor.
+         */
+        readonly intelligencePriority: Schema.decodeTo<Schema.optional<Schema.Finite>, Schema.optionalKey<Schema.Finite>, never, never>;
+    }>>, never, never>;
     /**
      * An optional system prompt the server wants to use for sampling. The
      * client MAY modify or omit this prompt.
@@ -2436,7 +2501,7 @@ declare const CreateMessage_base: Rpc.Rpc<"sampling/createMessage", Schema.Struc
  * The client chooses the model and should ask the user to approve the sampling
  * request before it begins.
  *
- * @category sampling
+ * @category protocols
  * @since 4.0.0
  */
 export declare class CreateMessage extends CreateMessage_base {
@@ -2457,7 +2522,7 @@ declare const ResourceReference_base: Schema.Opaque<ResourceReference, Schema.St
 /**
  * Schema for a reference to a resource or resource template definition.
  *
- * @category autocomplete
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ResourceReference extends ResourceReference_base {
@@ -2480,7 +2545,7 @@ declare const PromptReference_base: Schema.Opaque<PromptReference, Schema.Struct
 /**
  * Schema for a prompt reference used in autocomplete requests.
  *
- * @category autocomplete
+ * @category schemas
  * @since 4.0.0
  */
 export declare class PromptReference extends PromptReference_base {
@@ -2523,7 +2588,7 @@ declare const CompleteResult_base: Schema.Opaque<CompleteResult, Schema.Struct<{
 /**
  * Schema for the server's response to a completion/complete request.
  *
- * @category autocomplete
+ * @category schemas
  * @since 4.0.0
  */
 export declare class CompleteResult extends CompleteResult_base {
@@ -2562,7 +2627,7 @@ declare const Complete_base: Rpc.Rpc<"completion/complete", Schema.Struct<{
 /**
  * Sent from the client to the server to ask for completion options.
  *
- * @category autocomplete
+ * @category protocols
  * @since 4.0.0
  */
 export declare class Complete extends Complete_base {
@@ -2584,7 +2649,7 @@ declare const Root_base: Schema.Class<Root, Schema.Struct<{
 /**
  * Represents a root directory or file that the server can operate on.
  *
- * @category roots
+ * @category schemas
  * @since 4.0.0
  */
 export declare class Root extends Root_base {
@@ -2599,7 +2664,7 @@ declare const ListRootsResult_base: Schema.Class<ListRootsResult, Schema.Struct<
  *
  * Use to return the directories or files that an MCP server may operate on.
  *
- * @category roots
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ListRootsResult extends ListRootsResult_base {
@@ -2617,7 +2682,7 @@ declare const ListRoots_base: Rpc.Rpc<"roots/list", Schema.UndefinedOr<typeof Re
  * system structure or access specific locations that the client has permission
  * to read from.
  *
- * @category roots
+ * @category protocols
  * @since 4.0.0
  */
 export declare class ListRoots extends ListRoots_base {
@@ -2634,7 +2699,7 @@ declare const RootsListChangedNotification_base: Rpc.Rpc<"notifications/roots/li
  *
  * Send this when the client adds, removes, or modifies a root.
  *
- * @category roots
+ * @category protocols
  * @since 4.0.0
  */
 export declare class RootsListChangedNotification extends RootsListChangedNotification_base {
@@ -2661,7 +2726,7 @@ declare const ElicitAcceptResult_base: Schema.Class<ElicitAcceptResult, Schema.S
 /**
  * Schema for an accepted client response to an elicitation request.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ElicitAcceptResult extends ElicitAcceptResult_base {
@@ -2683,7 +2748,7 @@ declare const ElicitDeclineResult_base: Schema.Class<ElicitDeclineResult, Schema
 /**
  * Schema for a declined or canceled client response to an elicitation request.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ElicitDeclineResult extends ElicitDeclineResult_base {
@@ -2691,7 +2756,7 @@ export declare class ElicitDeclineResult extends ElicitDeclineResult_base {
 /**
  * Schema for every client response to an elicitation request.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
 export declare const ElicitResult: Schema.Union<readonly [typeof ElicitAcceptResult, typeof ElicitDeclineResult]>;
@@ -2716,7 +2781,7 @@ declare const Elicit_base: Rpc.Rpc<"elicitation/create", Schema.Struct<{
  * The client responds with accepted content, an explicit decline, or a
  * cancellation.
  *
- * @category elicitation
+ * @category protocols
  * @since 4.0.0
  */
 export declare class Elicit extends Elicit_base {
@@ -2746,13 +2811,14 @@ declare const ElicitationDeclined_base: Schema.Class<ElicitationDeclined, Schema
  * The error stores the original elicitation request and, when available, the
  * underlying cause.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
 export declare class ElicitationDeclined extends ElicitationDeclined_base {
 }
 declare const McpServerClient_base: Context.ServiceClass<McpServerClient, "effect/ai/McpSchema/McpServerClient", {
     readonly clientId: number;
+    readonly protocolVersion: McpProtocol.ProtocolVersion;
     readonly initializePayload: typeof Initialize.payloadSchema["Type"];
     readonly getClient: Effect.Effect<RpcClient.RpcClient<RpcGroup.Rpcs<typeof ServerRequestRpcs>, RpcClientError>, never, Scope.Scope>;
 }>;
@@ -2764,7 +2830,7 @@ declare const McpServerClient_base: Context.ServiceClass<McpServerClient, "effec
  * It exposes the current client id, the client's initialize payload, and a
  * scoped RPC client for server-initiated requests back to that client.
  *
- * @category client
+ * @category services
  * @since 4.0.0
  */
 export declare class McpServerClient extends McpServerClient_base {
@@ -2828,7 +2894,7 @@ export type FailureEncoded<Group extends RpcGroup.Any> = RpcGroup.Rpcs<Group> ex
     readonly id: string | number;
     readonly error: _Error["Encoded"];
 } : never : never;
-declare const ClientRequestRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.UndefinedOr<typeof RequestMeta>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"logging/setLevel", Schema.Struct<{
+declare const ClientRequestRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.UndefinedOr<typeof RequestMeta>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/subscribe", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -2849,12 +2915,11 @@ declare const ClientRequestRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.U
         readonly progressToken: Schema.decodeTo<Schema.optional<Schema.Union<[Schema.String, Schema.Finite]>>, Schema.optionalKey<Schema.Union<[Schema.String, Schema.Finite]>>, never, never>;
     }>>, never, never>;
     /**
-     * The level of logging that the client wants to receive from the server.
-     * The server should send all logs at this level and higher (i.e., more
-     * severe) to the client as notifications/message.
+     * The URI of the resource to subscribe to. The URI can use any protocol;
+     * it is up to the server how to interpret it.
      */
-    level: Schema.Literals<["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"]>;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/subscribe", Schema.Struct<{
+    uri: Schema.String;
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/unsubscribe", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -2879,7 +2944,7 @@ declare const ClientRequestRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.U
      * it is up to the server how to interpret it.
      */
     uri: Schema.String;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/unsubscribe", Schema.Struct<{
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"logging/setLevel", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -2900,11 +2965,12 @@ declare const ClientRequestRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.U
         readonly progressToken: Schema.decodeTo<Schema.optional<Schema.Union<[Schema.String, Schema.Finite]>>, Schema.optionalKey<Schema.Union<[Schema.String, Schema.Finite]>>, never, never>;
     }>>, never, never>;
     /**
-     * The URI of the resource to subscribe to. The URI can use any protocol;
-     * it is up to the server how to interpret it.
+     * The level of logging that the client wants to receive from the server.
+     * The server should send all logs at this level and higher (i.e., more
+     * severe) to the client as notifications/message.
      */
-    uri: Schema.String;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"initialize", Schema.Struct<{
+    level: Schema.Literals<["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"]>;
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"initialize", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -3078,7 +3144,7 @@ export declare class ClientNotificationRpcs extends ClientNotificationRpcs_base
  * @since 4.0.0
  */
 export type ClientNotificationEncoded = NotificationEncoded<typeof ClientNotificationRpcs>;
-declare const ClientRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.UndefinedOr<typeof RequestMeta>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"logging/setLevel", Schema.Struct<{
+declare const ClientRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.UndefinedOr<typeof RequestMeta>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/subscribe", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -3099,12 +3165,11 @@ declare const ClientRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.Undefine
         readonly progressToken: Schema.decodeTo<Schema.optional<Schema.Union<[Schema.String, Schema.Finite]>>, Schema.optionalKey<Schema.Union<[Schema.String, Schema.Finite]>>, never, never>;
     }>>, never, never>;
     /**
-     * The level of logging that the client wants to receive from the server.
-     * The server should send all logs at this level and higher (i.e., more
-     * severe) to the client as notifications/message.
+     * The URI of the resource to subscribe to. The URI can use any protocol;
+     * it is up to the server how to interpret it.
      */
-    level: Schema.Literals<["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"]>;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/subscribe", Schema.Struct<{
+    uri: Schema.String;
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/unsubscribe", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -3129,7 +3194,7 @@ declare const ClientRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.Undefine
      * it is up to the server how to interpret it.
      */
     uri: Schema.String;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"resources/unsubscribe", Schema.Struct<{
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"logging/setLevel", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -3150,11 +3215,12 @@ declare const ClientRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"ping", Schema.Undefine
         readonly progressToken: Schema.decodeTo<Schema.optional<Schema.Union<[Schema.String, Schema.Finite]>>, Schema.optionalKey<Schema.Union<[Schema.String, Schema.Finite]>>, never, never>;
     }>>, never, never>;
     /**
-     * The URI of the resource to subscribe to. The URI can use any protocol;
-     * it is up to the server how to interpret it.
+     * The level of logging that the client wants to receive from the server.
+     * The server should send all logs at this level and higher (i.e., more
+     * severe) to the client as notifications/message.
      */
-    uri: Schema.String;
-}>, Schema.Void, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"initialize", Schema.Struct<{
+    level: Schema.Literals<["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"]>;
+}>, Schema.Struct<{}>, Schema.Union<readonly [typeof ParseError, typeof InvalidRequest, typeof MethodNotFound, typeof InvalidParams, typeof InternalError, typeof McpErrorBase]>, typeof McpServerClientMiddleware, never> | Rpc.Rpc<"initialize", Schema.Struct<{
     _meta: Schema.decodeTo<Schema.optional<Schema.Struct<{
         /**
          * If specified, the caller is requesting out-of-band progress notifications
@@ -3389,7 +3455,7 @@ declare const ParamSchemaTypeId = "~effect/ai/McpSchema/ParamSchema";
  * Returns `true` when a schema was created with `param` and therefore carries
  * a resource URI template parameter name.
  *
- * @category parameters
+ * @category guards
  * @since 4.0.0
  */
 export declare function isParam(schema: Schema.Constraint): schema is Param<string, Schema.Top>;
@@ -3436,7 +3502,7 @@ declare const EnabledWhen_base: Context.ServiceClass<EnabledWhen, "effect/unstab
  * Annotation to conditionally enable or disable tools based on client
  * information.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export declare class EnabledWhen extends EnabledWhen_base {