effect 4.0.0-beta.99 → 4.0.0-rc.108

package/dist/unstable/ai/McpSchema.js

@@ -63,7 +63,7 @@ export const optional = schema => Schema.optionalKey(schema).pipe(Schema.decodeT
  * @category schemas
  * @since 4.0.0
  */
-export const RequestId = /*#__PURE__*/Schema.Union([Schema.String, Schema.Number]);
+export const RequestId = /*#__PURE__*/Schema.Union([Schema.String, Schema.Finite]);
 /**
  * Schema for MCP progress tokens that associate progress notifications with the
  * original request.
@@ -71,7 +71,7 @@ export const RequestId = /*#__PURE__*/Schema.Union([Schema.String, Schema.Number
  * @category schemas
  * @since 4.0.0
  */
-export const ProgressToken = /*#__PURE__*/Schema.Union([Schema.String, Schema.Number]);
+export const ProgressToken = /*#__PURE__*/Schema.Union([Schema.String, Schema.Finite]);
 /**
  * Schema for optional MCP request metadata.
  *
@@ -209,7 +209,7 @@ export class Annotations extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schem
    * effectively required, while 0 means "least important," and indicates that
    * the data is entirely optional.
    */
-  priority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Number.check(/*#__PURE__*/Schema.isBetween({
+  priority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Finite.check(/*#__PURE__*/Schema.isBetween({
     minimum: 0,
     maximum: 1
   })))
@@ -353,7 +353,7 @@ export class McpErrorBase extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchem
   /**
    * The error type that occurred.
    */
-  code: Schema.Number,
+  code: Schema.Int,
   /**
    * A short description of the error. The message SHOULD be limited to a
    * concise single sentence.
@@ -441,7 +441,7 @@ export const PARSE_ERROR_CODE = -32700;
  * @category errors
  * @since 4.0.0
  */
-export class ParseError extends /*#__PURE__*/Schema.ErrorClass("effect/ai/McpSchema/ParseError")({
+export class ParseError extends /*#__PURE__*/Schema.Error("effect/ai/McpSchema/ParseError")({
   ...McpErrorBase.fields,
   _tag: /*#__PURE__*/Schema.tag("ParseError"),
   code: /*#__PURE__*/Schema.tag(PARSE_ERROR_CODE)
@@ -461,7 +461,7 @@ export class ParseError extends /*#__PURE__*/Schema.ErrorClass("effect/ai/McpSch
  * @category errors
  * @since 4.0.0
  */
-export class InvalidRequest extends /*#__PURE__*/Schema.ErrorClass("effect/ai/McpSchema/InvalidRequest")({
+export class InvalidRequest extends /*#__PURE__*/Schema.Error("effect/ai/McpSchema/InvalidRequest")({
   ...McpErrorBase.fields,
   _tag: /*#__PURE__*/Schema.tag("InvalidRequest"),
   code: /*#__PURE__*/Schema.tag(INVALID_REQUEST_ERROR_CODE)
@@ -480,7 +480,7 @@ export class InvalidRequest extends /*#__PURE__*/Schema.ErrorClass("effect/ai/Mc
  * @category errors
  * @since 4.0.0
  */
-export class MethodNotFound extends /*#__PURE__*/Schema.ErrorClass("effect/ai/McpSchema/MethodNotFound")({
+export class MethodNotFound extends /*#__PURE__*/Schema.Error("effect/ai/McpSchema/MethodNotFound")({
   ...McpErrorBase.fields,
   _tag: /*#__PURE__*/Schema.tag("MethodNotFound"),
   code: /*#__PURE__*/Schema.tag(METHOD_NOT_FOUND_ERROR_CODE)
@@ -500,7 +500,7 @@ export class MethodNotFound extends /*#__PURE__*/Schema.ErrorClass("effect/ai/Mc
  * @category errors
  * @since 4.0.0
  */
-export class InvalidParams extends /*#__PURE__*/Schema.ErrorClass("effect/ai/McpSchema/InvalidParams")({
+export class InvalidParams extends /*#__PURE__*/Schema.Error("effect/ai/McpSchema/InvalidParams")({
   ...McpErrorBase.fields,
   _tag: /*#__PURE__*/Schema.tag("InvalidParams"),
   code: /*#__PURE__*/Schema.tag(INVALID_PARAMS_ERROR_CODE)
@@ -521,7 +521,7 @@ export class InvalidParams extends /*#__PURE__*/Schema.ErrorClass("effect/ai/Mcp
  * @category errors
  * @since 4.0.0
  */
-export class InternalError extends /*#__PURE__*/Schema.ErrorClass("effect/ai/McpSchema/InternalError")({
+export class InternalError extends /*#__PURE__*/Schema.Error("effect/ai/McpSchema/InternalError")({
   ...McpErrorBase.fields,
   _tag: /*#__PURE__*/Schema.tag("InternalError"),
   code: /*#__PURE__*/Schema.tag(INTERNAL_ERROR_CODE)
@@ -552,7 +552,7 @@ export const McpError = /*#__PURE__*/Schema.Union([ParseError, InvalidRequest, M
  *
  * The receiver should respond promptly; otherwise the sender may disconnect.
  *
- * @category ping
+ * @category protocols
  * @since 4.0.0
  */
 export class Ping extends /*#__PURE__*/Rpc.make("ping", {
@@ -566,7 +566,7 @@ export class Ping extends /*#__PURE__*/Rpc.make("ping", {
 /**
  * Schema for the server's response to an initialize request from the client.
  *
- * @category initialization
+ * @category schemas
  * @since 4.0.0
  */
 export class InitializeResult extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -592,7 +592,7 @@ export class InitializeResult extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/
  * 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 class Initialize extends /*#__PURE__*/Rpc.make("initialize", {
@@ -620,7 +620,7 @@ export class Initialize extends /*#__PURE__*/Rpc.make("initialize", {
 /**
  * Sent from the client to the server after initialization has finished.
  *
- * @category initialization
+ * @category protocols
  * @since 4.0.0
  */
 export class InitializedNotification extends /*#__PURE__*/Rpc.make("notifications/initialized", {
@@ -638,7 +638,7 @@ export class InitializedNotification extends /*#__PURE__*/Rpc.make("notification
  * The payload identifies the request to cancel and may include a
  * human-readable reason.
  *
- * @category cancellation
+ * @category protocols
  * @since 4.0.0
  */
 export class CancelledNotification extends /*#__PURE__*/Rpc.make("notifications/cancelled", {
@@ -664,7 +664,7 @@ export class CancelledNotification extends /*#__PURE__*/Rpc.make("notifications/
 /**
  * Sent from either peer to report progress for a long-running request.
  *
- * @category progress
+ * @category protocols
  * @since 4.0.0
  */
 export class ProgressNotification extends /*#__PURE__*/Rpc.make("notifications/progress", {
@@ -679,11 +679,11 @@ export class ProgressNotification extends /*#__PURE__*/Rpc.make("notifications/p
      * The progress thus far. This should increase every time progress is made,
      * even if the total is unknown.
      */
-    progress: /*#__PURE__*/optional(Schema.Number),
+    progress: /*#__PURE__*/optional(Schema.Finite),
     /**
      * Total number of items to process (or total progress required), if known.
      */
-    total: /*#__PURE__*/optional(Schema.Number),
+    total: /*#__PURE__*/optional(Schema.Finite),
     /**
      * An optional message describing the current progress.
      */
@@ -696,7 +696,7 @@ export class ProgressNotification extends /*#__PURE__*/Rpc.make("notifications/p
 /**
  * Schema for a known resource that the server is capable of reading.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class Resource extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Resource")({
@@ -733,7 +733,7 @@ export class Resource extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Re
    * This can be used by Hosts to display file sizes and estimate context
    * window usage.
    */
-  size: /*#__PURE__*/optional(Schema.Number),
+  size: /*#__PURE__*/optional(Schema.Int),
   /**
    * Optional additional metadata for the client.
    *
@@ -745,7 +745,7 @@ export class Resource extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Re
 /**
  * Schema for a template description of resources available on the server.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class ResourceTemplate extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ResourceTemplate")({
@@ -785,7 +785,7 @@ export class ResourceTemplate extends /*#__PURE__*/Schema.Class("@effect/ai/McpS
 /**
  * Schema for the contents of a specific resource or sub-resource.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class ResourceContents extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -805,7 +805,7 @@ export class ResourceContents extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/
 /**
  * Schema for text resource contents represented as a string.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class TextResourceContents extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -819,7 +819,7 @@ export class TextResourceContents extends /*#__PURE__*/Schema.Opaque()(/*#__PURE
 /**
  * Schema for binary resource contents represented as a `Uint8Array`.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class BlobResourceContents extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -832,7 +832,7 @@ export class BlobResourceContents extends /*#__PURE__*/Schema.Opaque()(/*#__PURE
 /**
  * Schema for the server's response to a resources/list request from the client.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class ListResourcesResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ListResourcesResult")({
@@ -842,7 +842,7 @@ export class ListResourcesResult extends /*#__PURE__*/Schema.Class("@effect/ai/M
 /**
  * Sent from the client to request a list of resources the server has.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export class ListResources extends /*#__PURE__*/Rpc.make("resources/list", {
@@ -854,7 +854,7 @@ export class ListResources extends /*#__PURE__*/Rpc.make("resources/list", {
  * Schema for the server's response to a resources/templates/list request from
  * the client.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class ListResourceTemplatesResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ListResourceTemplatesResult")({
@@ -864,7 +864,7 @@ export class ListResourceTemplatesResult extends /*#__PURE__*/Schema.Class("@eff
 /**
  * Sent from the client to request a list of resource templates the server has.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export class ListResourceTemplates extends /*#__PURE__*/Rpc.make("resources/templates/list", {
@@ -875,7 +875,7 @@ export class ListResourceTemplates extends /*#__PURE__*/Rpc.make("resources/temp
 /**
  * Schema for the server's response to a resources/read request from the client.
  *
- * @category resources
+ * @category schemas
  * @since 4.0.0
  */
 export class ReadResourceResult extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -885,7 +885,7 @@ export class ReadResourceResult extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__
 /**
  * Sent from the client to the server, to read a specific resource URI.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export class ReadResource extends /*#__PURE__*/Rpc.make("resources/read", {
@@ -911,7 +911,7 @@ export class ReadResource extends /*#__PURE__*/Rpc.make("resources/read", {
  *
  * Servers may send this notification without a previous client subscription.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export class ResourceListChangedNotification extends /*#__PURE__*/Rpc.make("notifications/resources/list_changed", {
@@ -921,10 +921,11 @@ export class ResourceListChangedNotification extends /*#__PURE__*/Rpc.make("noti
  * 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 class Subscribe extends /*#__PURE__*/Rpc.make("resources/subscribe", {
+  success: /*#__PURE__*/Schema.Struct({}),
   error: McpError,
   payload: {
     ...RequestMeta.fields,
@@ -940,10 +941,11 @@ export class Subscribe extends /*#__PURE__*/Rpc.make("resources/subscribe", {
  * notifications from the server. This should follow a previous
  * resources/subscribe request.
  *
- * @category resources
+ * @category protocols
  * @since 4.0.0
  */
 export class Unsubscribe extends /*#__PURE__*/Rpc.make("resources/unsubscribe", {
+  success: /*#__PURE__*/Schema.Struct({}),
   error: McpError,
   payload: {
     ...RequestMeta.fields,
@@ -962,7 +964,7 @@ export class Unsubscribe extends /*#__PURE__*/Rpc.make("resources/unsubscribe",
  * 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 class ResourceUpdatedNotification extends /*#__PURE__*/Rpc.make("notifications/resources/updated", {
@@ -1229,7 +1231,7 @@ export class PromptListChangedNotification extends /*#__PURE__*/Rpc.make("notifi
  * Clients should never make tool use decisions based on ToolAnnotations
  * received from untrusted servers.
  *
- * @category tools
+ * @category schemas
  * @since 4.0.0
  */
 export class ToolAnnotations extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -1274,7 +1276,7 @@ export class ToolAnnotations extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/S
 /**
  * Schema for the definition of a tool the client can call.
  *
- * @category tools
+ * @category schemas
  * @since 4.0.0
  */
 export class Tool extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Tool")({
@@ -1293,6 +1295,10 @@ export class Tool extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Tool")
    * A JSON Schema object defining the expected parameters for the tool.
    */
   inputSchema: Schema.Any,
+  /**
+   * An optional JSON Schema object defining the expected output of the tool.
+   */
+  outputSchema: /*#__PURE__*/optional(Schema.Any),
   /**
    * Optional additional tool information.
    */
@@ -1308,7 +1314,7 @@ export class Tool extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Tool")
 /**
  * Schema for the server's response to a tools/list request from the client.
  *
- * @category tools
+ * @category schemas
  * @since 4.0.0
  */
 export class ListToolsResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ListToolsResult")({
@@ -1318,7 +1324,7 @@ export class ListToolsResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSc
 /**
  * Sent from the client to request a list of tools the server has.
  *
- * @category tools
+ * @category protocols
  * @since 4.0.0
  */
 export class ListTools extends /*#__PURE__*/Rpc.make("tools/list", {
@@ -1338,7 +1344,7 @@ export class ListTools extends /*#__PURE__*/Rpc.make("tools/list", {
  * 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 class CallToolResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/CallToolResult")({
@@ -1363,7 +1369,7 @@ export class CallToolResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSch
  * @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 class CallTool extends /*#__PURE__*/Rpc.make("tools/call", {
@@ -1372,7 +1378,7 @@ export class CallTool extends /*#__PURE__*/Rpc.make("tools/call", {
   payload: {
     ...RequestMeta.fields,
     name: Schema.String,
-    arguments: /*#__PURE__*/Schema.Record(Schema.String, Schema.Any)
+    arguments: /*#__PURE__*/optionalWithDefault(/*#__PURE__*/Schema.Record(Schema.String, Schema.Any), () => ({}))
   }
 }) {}
 /**
@@ -1386,7 +1392,7 @@ export class CallTool extends /*#__PURE__*/Rpc.make("tools/call", {
  *
  * Servers may send this notification without a previous client subscription.
  *
- * @category tools
+ * @category protocols
  * @since 4.0.0
  */
 export class ToolListChangedNotification extends /*#__PURE__*/Rpc.make("notifications/tools/list_changed", {
@@ -1420,6 +1426,7 @@ export class SetLevel extends /*#__PURE__*/Rpc.make("logging/setLevel", {
      */
     level: LoggingLevel
   },
+  success: /*#__PURE__*/Schema.Struct({}),
   error: McpError
 }) {}
 /**
@@ -1457,7 +1464,7 @@ export class LoggingMessageNotification extends /*#__PURE__*/Rpc.make("notificat
 /**
  * Describes a message issued to or received from an LLM API.
  *
- * @category sampling
+ * @category schemas
  * @since 4.0.0
  */
 export class SamplingMessage extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -1472,7 +1479,7 @@ export class SamplingMessage extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/S
  * 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 class ModelHint extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -1508,7 +1515,7 @@ export class ModelHint extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.
  * 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 class ModelPreferences extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ModelPreferences")({
@@ -1527,7 +1534,7 @@ export class ModelPreferences extends /*#__PURE__*/Schema.Class("@effect/ai/McpS
    * is not important, while a value of 1 means cost is the most important
    * factor.
    */
-  costPriority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Number.check(/*#__PURE__*/Schema.isBetween({
+  costPriority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Finite.check(/*#__PURE__*/Schema.isBetween({
     minimum: 0,
     maximum: 1
   }))),
@@ -1536,7 +1543,7 @@ export class ModelPreferences extends /*#__PURE__*/Schema.Class("@effect/ai/McpS
    * value of 0 means speed is not important, while a value of 1 means speed is
    * the most important factor.
    */
-  speedPriority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Number.check(/*#__PURE__*/Schema.isBetween({
+  speedPriority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Finite.check(/*#__PURE__*/Schema.isBetween({
     minimum: 0,
     maximum: 1
   }))),
@@ -1545,7 +1552,7 @@ export class ModelPreferences extends /*#__PURE__*/Schema.Class("@effect/ai/McpS
    * model. A value of 0 means intelligence is not important, while a value of 1
    * means intelligence is the most important factor.
    */
-  intelligencePriority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Number.check(/*#__PURE__*/Schema.isBetween({
+  intelligencePriority: /*#__PURE__*/optional(/*#__PURE__*/Schema.Finite.check(/*#__PURE__*/Schema.isBetween({
     minimum: 0,
     maximum: 1
   })))
@@ -1562,10 +1569,11 @@ export class ModelPreferences extends /*#__PURE__*/Schema.Class("@effect/ai/McpS
  * 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 class CreateMessageResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/CreateMessageResult")({
+  ...SamplingMessage.fields,
   /**
    * The name of the model that generated the message.
    */
@@ -1588,7 +1596,7 @@ export class CreateMessageResult extends /*#__PURE__*/Schema.Class("@effect/ai/M
  * 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 class CreateMessage extends /*#__PURE__*/Rpc.make("sampling/createMessage", {
@@ -1600,7 +1608,7 @@ export class CreateMessage extends /*#__PURE__*/Rpc.make("sampling/createMessage
      * The server's preferences for which model to select. The client MAY ignore
      * these preferences.
      */
-    modelPreferences: /*#__PURE__*/optional(ModelPreferences),
+    modelPreferences: /*#__PURE__*/optional(/*#__PURE__*/Schema.Struct(ModelPreferences.fields)),
     /**
      * An optional system prompt the server wants to use for sampling. The
      * client MAY modify or omit this prompt.
@@ -1611,18 +1619,18 @@ export class CreateMessage extends /*#__PURE__*/Rpc.make("sampling/createMessage
      * caller), to be attached to the prompt. The client MAY ignore this request.
      */
     includeContext: /*#__PURE__*/optional(/*#__PURE__*/Schema.Literals(["none", "thisServer", "allServers"])),
-    temperature: /*#__PURE__*/optional(Schema.Number),
+    temperature: /*#__PURE__*/optional(Schema.Finite),
     /**
      * The maximum number of tokens to sample, as requested by the server. The
      * client MAY choose to sample fewer tokens than requested.
      */
-    maxTokens: Schema.Number,
+    maxTokens: Schema.Int,
     stopSequences: /*#__PURE__*/optional(/*#__PURE__*/Schema.Array(Schema.String)),
     /**
      * Optional metadata to pass through to the LLM provider. The format of
      * this metadata is provider-specific.
      */
-    metadata: Schema.Any
+    metadata: /*#__PURE__*/optional(/*#__PURE__*/Schema.Record(Schema.String, Schema.Unknown))
   }
 }) {}
 // =============================================================================
@@ -1631,7 +1639,7 @@ export class CreateMessage extends /*#__PURE__*/Rpc.make("sampling/createMessage
 /**
  * Schema for a reference to a resource or resource template definition.
  *
- * @category autocomplete
+ * @category schemas
  * @since 4.0.0
  */
 export class ResourceReference extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -1644,7 +1652,7 @@ export class ResourceReference extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*
 /**
  * Schema for a prompt reference used in autocomplete requests.
  *
- * @category autocomplete
+ * @category schemas
  * @since 4.0.0
  */
 export class PromptReference extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -1658,7 +1666,7 @@ export class PromptReference extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/S
 /**
  * Schema for the server's response to a completion/complete request.
  *
- * @category autocomplete
+ * @category schemas
  * @since 4.0.0
  */
 export class CompleteResult extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schema.Struct({
@@ -1671,7 +1679,7 @@ export class CompleteResult extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sc
      * The total number of completion options available. This can exceed the
      * number of values actually sent in the response.
      */
-    total: /*#__PURE__*/optional(Schema.Number),
+    total: /*#__PURE__*/optional(Schema.Int),
     /**
      * Indicates whether there are additional completion options beyond those
      * provided in the current response, even if the exact total is unknown.
@@ -1695,7 +1703,7 @@ export class CompleteResult extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sc
 /**
  * Sent from the client to the server to ask for completion options.
  *
- * @category autocomplete
+ * @category protocols
  * @since 4.0.0
  */
 export class Complete extends /*#__PURE__*/Rpc.make("completion/complete", {
@@ -1735,7 +1743,7 @@ export class Complete extends /*#__PURE__*/Rpc.make("completion/complete", {
 /**
  * Represents a root directory or file that the server can operate on.
  *
- * @category roots
+ * @category schemas
  * @since 4.0.0
  */
 export class Root extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Root")({
@@ -1759,7 +1767,7 @@ export class Root extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Root")
  *
  * Use to return the directories or files that an MCP server may operate on.
  *
- * @category roots
+ * @category schemas
  * @since 4.0.0
  */
 export class ListRootsResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ListRootsResult")({
@@ -1777,7 +1785,7 @@ export class ListRootsResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSc
  * system structure or access specific locations that the client has permission
  * to read from.
  *
- * @category roots
+ * @category protocols
  * @since 4.0.0
  */
 export class ListRoots extends /*#__PURE__*/Rpc.make("roots/list", {
@@ -1796,7 +1804,7 @@ export class ListRoots extends /*#__PURE__*/Rpc.make("roots/list", {
  *
  * Send this when the client adds, removes, or modifies a root.
  *
- * @category roots
+ * @category protocols
  * @since 4.0.0
  */
 export class RootsListChangedNotification extends /*#__PURE__*/Rpc.make("notifications/roots/list_changed", {
@@ -1808,7 +1816,7 @@ export class RootsListChangedNotification extends /*#__PURE__*/Rpc.make("notific
 /**
  * Schema for an accepted client response to an elicitation request.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
 export class ElicitAcceptResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ElicitAcceptResult")({
@@ -1829,7 +1837,7 @@ export class ElicitAcceptResult extends /*#__PURE__*/Schema.Class("@effect/ai/Mc
 /**
  * Schema for a declined or canceled client response to an elicitation request.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
 export class ElicitDeclineResult extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/ElicitDeclineResult")({
@@ -1845,7 +1853,7 @@ export class ElicitDeclineResult extends /*#__PURE__*/Schema.Class("@effect/ai/M
 /**
  * Schema for every client response to an elicitation request.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
 export const ElicitResult = /*#__PURE__*/Schema.Union([ElicitAcceptResult, ElicitDeclineResult]);
@@ -1858,7 +1866,7 @@ export const ElicitResult = /*#__PURE__*/Schema.Union([ElicitAcceptResult, Elici
  * The client responds with accepted content, an explicit decline, or a
  * cancellation.
  *
- * @category elicitation
+ * @category protocols
  * @since 4.0.0
  */
 export class Elicit extends /*#__PURE__*/Rpc.make("elicitation/create", {
@@ -1886,10 +1894,10 @@ export class Elicit extends /*#__PURE__*/Rpc.make("elicitation/create", {
  * The error stores the original elicitation request and, when available, the
  * underlying cause.
  *
- * @category elicitation
+ * @category schemas
  * @since 4.0.0
  */
-export class ElicitationDeclined extends /*#__PURE__*/Schema.ErrorClass("@effect/ai/McpSchema/ElicitationDeclined")({
+export class ElicitationDeclined extends /*#__PURE__*/Schema.Error("@effect/ai/McpSchema/ElicitationDeclined")({
   _tag: /*#__PURE__*/Schema.tag("ElicitationDeclined"),
   request: Elicit.payloadSchema,
   cause: /*#__PURE__*/optional(/*#__PURE__*/Schema.Defect())
@@ -1905,7 +1913,7 @@ export class ElicitationDeclined extends /*#__PURE__*/Schema.ErrorClass("@effect
  * 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 class McpServerClient extends /*#__PURE__*/Context.Service()("effect/ai/McpSchema/McpServerClient") {}
@@ -1967,7 +1975,7 @@ 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 function isParam(schema) {
@@ -1990,7 +1998,7 @@ export function param(name, schema) {
  * Annotation to conditionally enable or disable tools based on client
  * information.
  *
- * @category annotations
+ * @category services
  * @since 4.0.0
  */
 export class EnabledWhen extends /*#__PURE__*/Context.Service()("effect/unstable/ai/McpSchema/EnabledWhen") {}