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

package/dist/unstable/ai/McpSchema.js

@@ -3,14 +3,17 @@
  *
  * MCP clients and servers use these schemas to describe the JSON-RPC requests,
  * notifications, results, and errors that can cross the protocol boundary. This
- * module focuses on message shapes: it defines the shared protocol data model,
- * groups related messages for the RPC layer, and provides helpers for optional
- * fields and parameter metadata. Transport and server behavior live in other
- * modules.
+ * This is the stable public compatibility and authoring surface. It is not an
+ * exact dated wire contract: MCP protocol adapters use frozen schemas under
+ * `internal/mcpSchema` for decoding and encoding. This module groups the
+ * current public message model for application authors and provides helpers
+ * for optional fields and parameter metadata. Transport and server behavior
+ * live in other modules.
  *
  * @since 4.0.0
  */
 import * as Context from "../../Context.js";
+import * as Data from "../../Data.js";
 import * as Effect from "../../Effect.js";
 import { constFalse, constTrue } from "../../Function.js";
 import * as Option from "../../Option.js";
@@ -63,7 +66,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 +74,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 +212,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 +356,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 +444,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 +464,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 +483,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 +503,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 +524,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 +555,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 +569,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 +595,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 +623,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 +641,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 +667,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 +682,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: 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 +699,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 +736,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 +748,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 +788,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 +808,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 +822,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({
@@ -827,12 +830,12 @@ export class BlobResourceContents extends /*#__PURE__*/Schema.Opaque()(/*#__PURE
   /**
    * The binary data of the item decoded from a base64-encoded string.
    */
-  blob: Schema.Uint8Array
+  blob: Schema.Uint8ArrayFromBase64
 })) {}
 /**
  * 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 +845,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 +857,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 +867,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 +878,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 +888,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 +914,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 +924,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 +944,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 +967,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", {
@@ -1017,7 +1022,8 @@ export class Prompt extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Prom
   /**
    * A list of arguments to use for templating the prompt.
    */
-  arguments: /*#__PURE__*/optional(/*#__PURE__*/Schema.Array(PromptArgument))
+  arguments: /*#__PURE__*/optional(/*#__PURE__*/Schema.Array(PromptArgument)),
+  _meta: /*#__PURE__*/optional(/*#__PURE__*/Schema.Record(Schema.String, Schema.Json))
 }) {}
 /**
  * Represents text content provided to or from an LLM.
@@ -1034,7 +1040,8 @@ export class TextContent extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Schem
   /**
    * Optional annotations for the client.
    */
-  annotations: /*#__PURE__*/optional(Annotations)
+  annotations: /*#__PURE__*/optional(Annotations),
+  _meta: /*#__PURE__*/optional(/*#__PURE__*/Schema.Record(Schema.String, Schema.Json))
 })) {}
 /**
  * Represents image content provided to or from an LLM.
@@ -1047,7 +1054,7 @@ export class ImageContent extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sche
   /**
    * The image data.
    */
-  data: Schema.Uint8Array,
+  data: Schema.Uint8ArrayFromBase64,
   /**
    * The MIME type of the image. Different providers may support different
    * image types.
@@ -1056,7 +1063,8 @@ export class ImageContent extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sche
   /**
    * Optional annotations for the client.
    */
-  annotations: /*#__PURE__*/optional(Annotations)
+  annotations: /*#__PURE__*/optional(Annotations),
+  _meta: /*#__PURE__*/optional(/*#__PURE__*/Schema.Record(Schema.String, Schema.Json))
 })) {}
 /**
  * Represents audio content provided to or from an LLM.
@@ -1069,7 +1077,7 @@ export class AudioContent extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sche
   /**
    * The audio data.
    */
-  data: Schema.Uint8Array,
+  data: Schema.Uint8ArrayFromBase64,
   /**
    * The MIME type of the audio. Different providers may support different
    * audio types.
@@ -1078,7 +1086,8 @@ export class AudioContent extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/Sche
   /**
    * Optional annotations for the client.
    */
-  annotations: /*#__PURE__*/optional(Annotations)
+  annotations: /*#__PURE__*/optional(Annotations),
+  _meta: /*#__PURE__*/optional(/*#__PURE__*/Schema.Record(Schema.String, Schema.Json))
 })) {}
 /**
  * Represents resource contents embedded into a prompt or tool call result.
@@ -1097,7 +1106,8 @@ export class EmbeddedResource extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/
   /**
    * Optional annotations for the client.
    */
-  annotations: /*#__PURE__*/optional(Annotations)
+  annotations: /*#__PURE__*/optional(Annotations),
+  _meta: /*#__PURE__*/optional(/*#__PURE__*/Schema.Record(Schema.String, Schema.Json))
 })) {}
 /**
  * Represents a readable resource included in a prompt or tool call result.
@@ -1229,7 +1239,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({
@@ -1272,11 +1282,22 @@ export class ToolAnnotations extends /*#__PURE__*/Schema.Opaque()(/*#__PURE__*/S
   openWorldHint: /*#__PURE__*/optionalWithDefault(Schema.Boolean, constTrue)
 })) {}
 /**
- * Schema for the definition of a tool the client can call.
+ * Schema for {@link ToolJsonSchema}.
  *
  * @category tools
  * @since 4.0.0
  */
+export const ToolJsonSchema = /*#__PURE__*/Schema.StructWithRest(/*#__PURE__*/Schema.Struct({
+  type: /*#__PURE__*/Schema.Literal("object"),
+  properties: /*#__PURE__*/optional(/*#__PURE__*/Schema.Record(Schema.String, /*#__PURE__*/Schema.Record(Schema.String, Schema.Json))),
+  required: /*#__PURE__*/optional(/*#__PURE__*/Schema.Array(Schema.String))
+}), [/*#__PURE__*/Schema.Record(Schema.String, Schema.Json)]);
+/**
+ * Schema for the definition of a tool the client can call.
+ *
+ * @category schemas
+ * @since 4.0.0
+ */
 export class Tool extends /*#__PURE__*/Schema.Class("@effect/ai/McpSchema/Tool")({
   /**
    * The name of the tool.
@@ -1292,7 +1313,11 @@ 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,
+  inputSchema: ToolJsonSchema,
+  /**
+   * An optional JSON Schema object defining the structure of the tool output.
+   */
+  outputSchema: /*#__PURE__*/optional(ToolJsonSchema),
   /**
    * Optional additional tool information.
    */
@@ -1308,7 +1333,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 +1343,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,13 +1363,16 @@ 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")({
   ...ResultMeta.fields,
   content: /*#__PURE__*/Schema.Array(ContentBlock),
-  structuredContent: /*#__PURE__*/optional(Schema.Any),
+  /**
+   * An optional JSON value containing the structured result of the tool call.
+   */
+  structuredContent: /*#__PURE__*/optional(Schema.Json),
   /**
    * Whether the tool call ended in an error.
    *
@@ -1363,7 +1391,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 +1400,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 +1414,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 +1448,7 @@ export class SetLevel extends /*#__PURE__*/Rpc.make("logging/setLevel", {
      */
     level: LoggingLevel
   },
+  success: /*#__PURE__*/Schema.Struct({}),
   error: McpError
 }) {}
 /**
@@ -1457,7 +1486,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 +1501,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 +1537,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 +1556,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 +1565,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 +1574,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 +1591,12 @@ 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")({
+  role: Role,
+  content: /*#__PURE__*/Schema.Union([TextContent, ImageContent, AudioContent]),
   /**
    * The name of the model that generated the message.
    */
@@ -1588,7 +1619,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 +1631,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 +1642,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 +1662,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 +1675,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,10 +1689,11 @@ 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({
+  ...ResultMeta.fields,
   completion: /*#__PURE__*/Schema.Struct({
     /**
      * An array of completion values. Must not exceed 100 items.
@@ -1671,7 +1703,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 +1727,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 +1767,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 +1791,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 +1809,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 +1828,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 +1840,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 +1861,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 +1877,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 +1890,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 +1918,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())
@@ -1897,15 +1929,31 @@ export class ElicitationDeclined extends /*#__PURE__*/Schema.ErrorClass("@effect
 // =============================================================================
 // McpServerClient
 // =============================================================================
+/**
+ * Raised when the negotiated MCP revision or client capabilities do not
+ * support a server-initiated operation.
+ *
+ * @category errors
+ * @since 4.0.0
+ */
+export class McpReverseOperationUnsupported extends /*#__PURE__*/Data.TaggedError("McpReverseOperationUnsupported") {}
+/**
+ * A reverse MCP operation failed while being sent or projected through a
+ * version adapter.
+ *
+ * @category errors
+ * @since 4.0.0
+ */
+export class McpReverseOperationError extends /*#__PURE__*/Data.TaggedError("McpReverseOperationError") {}
 /**
  * Service available while handling an MCP client request.
  *
  * **Details**
  *
- * It exposes the current client id, the client's initialize payload, and a
- * scoped RPC client for server-initiated requests back to that client.
+ * It exposes the current client id, normalized initialization data, and a
+ * scoped version-neutral facade for server-initiated requests.
  *
- * @category client
+ * @category services
  * @since 4.0.0
  */
 export class McpServerClient extends /*#__PURE__*/Context.Service()("effect/ai/McpSchema/McpServerClient") {}
@@ -1967,7 +2015,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 +2038,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") {}