tmcp 1.2.0 → 1.3.0

package/README.md

@@ -1,3 +1,6 @@
+> [!WARNING]
+> Unfortunately i published the 1.0 by mistake...this package is currently under heavy development so there will be breaking changes in minors...threat this `1.x` as the `0.x` of any other package. Sorry for the disservice, every breaking will be properly labeled in the PR name.
+
 # tmcp
 
 A lightweight, schema-agnostic Model Context Protocol (MCP) server implementation with unified API design.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "tmcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "The main tmcp library",
   "main": "src/index.js",
   "type": "module",
   "keywords": [],
   "repository": {
     "type": "git",
-    "url": "https://github.com/paoloricciuti/tmcp.git",
+    "url": "git+https://github.com/paoloricciuti/tmcp.git",
     "directory": "packages/tmcp"
   },
   "author": "Paolo Ricciuti",
@@ -39,7 +39,7 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
     "typecheck": "tsc --noEmit",
-    "generate:types": "rm -f ./src/*.d.ts && tsc ./src/*.js --declaration --emitDeclarationOnly --target esnext --allowJs --moduleresolution nodenext --module nodenext && publint",
+    "generate:types": "find ./src -name \"*.d.ts\" -not -path \"./src/internal/*\" -delete && tsc ./src/*.js --declaration --emitDeclarationOnly --target esnext --allowJs --moduleresolution nodenext --module nodenext && publint",
     "prepublish": "pnpm generate:types"
   }
 }

package/src/index.d.ts

@@ -17,45 +17,45 @@ export class McpServer<StandardSchema extends StandardSchemaV1> {
     /**
      * @template {StandardSchema | undefined} [TSchema=undefined]
      * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never }} options
-     * @param {TSchema extends undefined ? (()=>Promise<unknown> | unknown) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<unknown> | unknown)} execute
+     * @param {TSchema extends undefined ? (()=>Promise<CallToolResult> | CallToolResult) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<CallToolResult> | CallToolResult)} execute
      */
     tool<TSchema extends StandardSchema | undefined = undefined>({ name, description, schema }: {
         name: string;
         description: string;
         schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never;
-    }, execute: TSchema extends undefined ? (() => Promise<unknown> | unknown) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<unknown> | unknown)): void;
+    }, execute: TSchema extends undefined ? (() => Promise<CallToolResult> | CallToolResult) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<CallToolResult> | CallToolResult)): void;
     /**
      * @template {StandardSchema | undefined} [TSchema=undefined]
-     * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never; complete?: TSchema extends undefined ? never : Partial<Record<keyof (StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>), Completion>> }} options
-     * @param {TSchema extends undefined ? (()=>Promise<unknown> | unknown) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<unknown> | unknown} execute
+     * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never; complete?: NoInfer<TSchema extends undefined ? never : Partial<Record<keyof (StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>), Completion>>> }} options
+     * @param {TSchema extends undefined ? (()=>Promise<GetPromptResult> | GetPromptResult) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<GetPromptResult> | GetPromptResult} execute
      */
     prompt<TSchema extends StandardSchema | undefined = undefined>({ name, description, schema, complete }: {
         name: string;
         description: string;
         schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never;
-        complete?: TSchema extends undefined ? never : Partial<Record<keyof StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>, Completion>>;
-    }, execute: TSchema extends undefined ? (() => Promise<unknown> | unknown) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<unknown> | unknown): void;
+        complete?: NoInfer<TSchema extends undefined ? never : Partial<Record<keyof StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>, Completion>>>;
+    }, execute: TSchema extends undefined ? (() => Promise<GetPromptResult> | GetPromptResult) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<GetPromptResult> | GetPromptResult): void;
     /**
      * @param {{ name: string; description: string; uri: string }} options
-     * @param {(uri: string) => Promise<unknown> | unknown} execute
+     * @param {(uri: string) => Promise<ReadResourceResult> | ReadResourceResult} execute
      */
     resource({ name, description, uri }: {
         name: string;
         description: string;
         uri: string;
-    }, execute: (uri: string) => Promise<unknown> | unknown): void;
+    }, execute: (uri: string) => Promise<ReadResourceResult> | ReadResourceResult): void;
     /**
      * @template {string} TUri
      * @template {ExtractURITemplateVariables<TUri>} TVariables
-     * @param {{ name: string; description: string; uri: TUri; complete?: TVariables extends never ? never : Partial<Record<TVariables, Completion>> }} options
-     * @param {(uri: string, params: Record<TVariables, string | string[]>) => Promise<unknown> | unknown} execute
+     * @param {{ name: string; description: string; uri: TUri; complete?: NoInfer<TVariables extends never ? never : Partial<Record<TVariables, Completion>>> }} options
+     * @param {(uri: string, params: Record<TVariables, string | string[]>) => Promise<ReadResourceResult> | ReadResourceResult} execute
      */
     template<TUri extends string, TVariables extends ExtractURITemplateVariables<TUri>>({ name, description, uri, complete }: {
         name: string;
         description: string;
         uri: TUri;
-        complete?: TVariables extends never ? never : Partial<Record<TVariables, Completion>>;
-    }, execute: (uri: string, params: Record<TVariables, string | string[]>) => Promise<unknown> | unknown): void;
+        complete?: NoInfer<TVariables extends never ? never : Partial<Record<TVariables, Completion>>>;
+    }, execute: (uri: string, params: Record<TVariables, string | string[]>) => Promise<ReadResourceResult> | ReadResourceResult): void;
     /**
      * @param {JSONRPCRequest} request
      * @returns {ReturnType<JSONRPCServer['receive']>}
@@ -71,7 +71,10 @@ export class McpServer<StandardSchema extends StandardSchemaV1> {
 }
 import type { StandardSchemaV1 } from "@standard-schema/spec";
 import type { McpEvents } from "./internal/internal.js";
+import type { CallToolResult } from "./validation/index.js";
 import type { Completion } from "./internal/internal.js";
+import type { GetPromptResult } from "./validation/index.js";
+import type { ReadResourceResult } from "./validation/index.js";
 import type { ExtractURITemplateVariables } from "./internal/uri-template.js";
 import type { JSONRPCRequest } from "json-rpc-2.0";
 import { JSONRPCServer } from 'json-rpc-2.0';

package/src/index.js

@@ -2,10 +2,18 @@
  * @import { StandardSchemaV1 } from "@standard-schema/spec";
  * @import { JSONRPCRequest, JSONRPCParams } from "json-rpc-2.0";
  * @import { ExtractURITemplateVariables } from "./internal/uri-template.js";
+ * @import { CallToolResult, ReadResourceResult, GetPromptResult, CompleteResult } from "./validation/index.js";
  * @import { Tool, Completion, Prompt, Resource, ServerOptions, ServerInfo, SubscriptionsKeys, McpEvents } from "./internal/internal.js";
  */
 import { JSONRPCServer, JSONRPCClient } from 'json-rpc-2.0';
 import { UriTemplateMatcher } from 'uri-template-matcher';
+import {
+	CallToolResultSchema,
+	ReadResourceResultSchema,
+	GetPromptResultSchema,
+	CompleteResultSchema,
+} from './validation/index.js';
+import * as v from 'valibot';
 
 /**
  * @template {StandardSchemaV1} StandardSchema
@@ -139,7 +147,7 @@ export class McpServer {
 					throw new Error(`Tool ${name} not found`);
 				}
 				if (!tool.schema) {
-					return tool.execute();
+					return v.parse(CallToolResultSchema, await tool.execute());
 				}
 				let validated_args = tool.schema['~standard'].validate(args);
 				if (validated_args instanceof Promise)
@@ -149,7 +157,10 @@ export class McpServer {
 						`Invalid arguments for tool ${name}: ${JSON.stringify(validated_args.issues)}`,
 					);
 				}
-				return tool.execute(validated_args.value);
+				return v.parse(
+					CallToolResultSchema,
+					await tool.execute(validated_args.value),
+				);
 			},
 		);
 	}
@@ -204,7 +215,10 @@ export class McpServer {
 					throw new Error(`Tool ${name} not found`);
 				}
 				if (!prompt.schema) {
-					return prompt.execute();
+					return v.parse(
+						GetPromptResultSchema,
+						await prompt.execute(),
+					);
 				}
 				let validated_args = prompt.schema['~standard'].validate(args);
 				if (validated_args instanceof Promise)
@@ -214,7 +228,10 @@ export class McpServer {
 						`Invalid arguments for tool ${name}: ${JSON.stringify(validated_args.issues)}`,
 					);
 				}
-				return prompt.execute(validated_args.value);
+				return v.parse(
+					GetPromptResultSchema,
+					await prompt.execute(validated_args.value),
+				);
 			},
 		);
 	}
@@ -281,9 +298,15 @@ export class McpServer {
 			if (resource.template) {
 				if (!params)
 					throw new Error('Missing parameters for template resource');
-				return resource.execute(uri, params);
+				return v.parse(
+					ReadResourceResultSchema,
+					await resource.execute(uri, params),
+				);
 			}
-			return resource.execute(uri);
+			return v.parse(
+				ReadResourceResultSchema,
+				await resource.execute(uri),
+			);
 		});
 	}
 	/**
@@ -299,19 +322,17 @@ export class McpServer {
 				if (!complete) return null;
 				const actual_complete = complete[argument.name];
 				if (!actual_complete) return null;
-				return {
-					completion: {
-						values: actual_complete(argument.value, context),
-						hasMore: false,
-					},
-				};
+				return v.parse(
+					CompleteResultSchema,
+					actual_complete(argument.value, context),
+				);
 			},
 		);
 	}
 	/**
 	 * @template {StandardSchema | undefined} [TSchema=undefined]
 	 * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never }} options
-	 * @param {TSchema extends undefined ? (()=>Promise<unknown> | unknown) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<unknown> | unknown)} execute
+	 * @param {TSchema extends undefined ? (()=>Promise<CallToolResult> | CallToolResult) : ((input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<CallToolResult> | CallToolResult)} execute
 	 */
 	tool({ name, description, schema }, execute) {
 		if (this.#options.capabilities?.tools?.listChanged) {
@@ -325,8 +346,8 @@ export class McpServer {
 	}
 	/**
 	 * @template {StandardSchema | undefined} [TSchema=undefined]
-	 * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never; complete?: TSchema extends undefined ? never : Partial<Record<keyof (StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>), Completion>> }} options
-	 * @param {TSchema extends undefined ? (()=>Promise<unknown> | unknown) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<unknown> | unknown} execute
+	 * @param {{ name: string; description: string; schema?: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema> extends Record<string, unknown> ? TSchema : never; complete?: NoInfer<TSchema extends undefined ? never : Partial<Record<keyof (StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>), Completion>>> }} options
+	 * @param {TSchema extends undefined ? (()=>Promise<GetPromptResult> | GetPromptResult) : (input: StandardSchemaV1.InferInput<TSchema extends undefined ? never : TSchema>) => Promise<GetPromptResult> | GetPromptResult} execute
 	 */
 	prompt({ name, description, schema, complete }, execute) {
 		if (complete) {
@@ -358,7 +379,7 @@ export class McpServer {
 	}
 	/**
 	 * @param {{ name: string; description: string; uri: string }} options
-	 * @param {(uri: string) => Promise<unknown> | unknown} execute
+	 * @param {(uri: string) => Promise<ReadResourceResult> | ReadResourceResult} execute
 	 */
 	resource({ name, description, uri }, execute) {
 		this.#resource({
@@ -372,8 +393,8 @@ export class McpServer {
 	/**
 	 * @template {string} TUri
 	 * @template {ExtractURITemplateVariables<TUri>} TVariables
-	 * @param {{ name: string; description: string; uri: TUri; complete?: TVariables extends never ? never : Partial<Record<TVariables, Completion>> }} options
-	 * @param {(uri: string, params: Record<TVariables, string | string[]>) => Promise<unknown> | unknown} execute
+	 * @param {{ name: string; description: string; uri: TUri; complete?: NoInfer<TVariables extends never ? never : Partial<Record<TVariables, Completion>>> }} options
+	 * @param {(uri: string, params: Record<TVariables, string | string[]>) => Promise<ReadResourceResult> | ReadResourceResult} execute
 	 */
 	template({ name, description, uri, complete }, execute) {
 		this.#resource({

package/src/internal/internal.d.ts

@@ -1,26 +1,32 @@
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import { JSONRPCRequest } from 'json-rpc-2.0';
 import { JsonSchemaAdapter } from '../adapter.js';
+import {
+	GetPromptResult,
+	CallToolResult,
+	ReadResourceResult,
+	CompleteResult,
+} from '../validation/index.js';
 
 export type Tool<TSchema extends StandardSchemaV1 = StandardSchemaV1<any>> = {
 	description: string;
 	schema: TSchema;
 	execute: (
 		input?: StandardSchemaV1.InferInput<TSchema>,
-	) => Promise<unknown> | unknown;
+	) => Promise<CallToolResult> | CallToolResult;
 };
 
 export type Completion = (
 	query: string,
 	context: { arguments: Record<string, string> },
-) => string[];
+) => CompleteResult;
 
 export type Prompt<TSchema extends StandardSchemaV1 = StandardSchemaV1<any>> = {
 	description: string;
 	schema: TSchema;
 	execute: (
 		input?: StandardSchemaV1.InferInput<TSchema>,
-	) => Promise<unknown> | unknown;
+	) => Promise<GetPromptResult> | GetPromptResult;
 };
 
 export type Resource =
@@ -31,13 +37,15 @@ export type Resource =
 			execute: (
 				uri: string,
 				params: Record<string, string | string[]>,
-			) => Promise<unknown> | unknown;
+			) => Promise<ReadResourceResult> | ReadResourceResult;
 	  }
 	| {
 			description: string;
 			name: string;
 			template: false;
-			execute: (uri: string) => Promise<unknown> | unknown;
+			execute: (
+				uri: string,
+			) => Promise<ReadResourceResult> | ReadResourceResult;
 	  };
 
 export type ServerOptions<TSchema extends StandardSchemaV1> = {

package/src/validation/index.d.ts

@@ -0,0 +1,682 @@
+/**
+ * Text provided to or from an LLM.
+ */
+export const TextContentSchema: v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"text", undefined>;
+    /**
+     * The text content of the message.
+     */
+    readonly text: v.StringSchema<undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * An image provided to or from an LLM.
+ */
+export const ImageContentSchema: v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"image", undefined>;
+    /**
+     * The base64-encoded image data.
+     */
+    readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+    /**
+     * The MIME type of the image. Different providers may support different image types.
+     */
+    readonly mimeType: v.StringSchema<undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * An Audio provided to or from an LLM.
+ */
+export const AudioContentSchema: v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"audio", undefined>;
+    /**
+     * The base64-encoded audio data.
+     */
+    readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+    /**
+     * The MIME type of the audio. Different providers may support different audio types.
+     */
+    readonly mimeType: v.StringSchema<undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * The contents of a specific resource or sub-resource.
+ */
+export const ResourceContentsSchema: v.LooseObjectSchema<{
+    /**
+     * The URI of this resource.
+     */
+    readonly uri: v.StringSchema<undefined>;
+    /**
+     * The MIME type of this resource, if known.
+     */
+    readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+export const TextResourceContentsSchema: v.LooseObjectSchema<{
+    /**
+     * The URI of this resource.
+     */
+    readonly uri: v.StringSchema<undefined>;
+    /**
+     * The MIME type of this resource, if known.
+     */
+    readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+     */
+    readonly text: v.StringSchema<undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+export const BlobResourceContentsSchema: v.LooseObjectSchema<{
+    /**
+     * The URI of this resource.
+     */
+    readonly uri: v.StringSchema<undefined>;
+    /**
+     * The MIME type of this resource, if known.
+     */
+    readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * A base64-encoded string representing the binary data of the item.
+     */
+    readonly blob: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * The contents of a resource, embedded into a prompt or tool call result.
+ */
+export const EmbeddedResourceSchema: v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"resource", undefined>;
+    readonly resource: v.UnionSchema<[v.LooseObjectSchema<{
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+         */
+        readonly text: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * A base64-encoded string representing the binary data of the item.
+         */
+        readonly blob: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>], undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * A resource that the server is capable of reading, included in a prompt or tool call result.
+ */
+export const ResourceLinkSchema: v.LooseObjectSchema<{
+    /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+    readonly name: v.StringSchema<undefined>;
+    readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * The URI of this resource.
+     */
+    readonly uri: v.StringSchema<undefined>;
+    /**
+     * A description of what this resource represents.
+     */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * The MIME type of this resource, if known.
+     */
+    readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly type: v.LiteralSchema<"resource_link", undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * A content block that can be used in prompts and tool results.
+ */
+export const ContentBlockSchema: v.UnionSchema<[v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"text", undefined>;
+    /**
+     * The text content of the message.
+     */
+    readonly text: v.StringSchema<undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>, v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"image", undefined>;
+    /**
+     * The base64-encoded image data.
+     */
+    readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+    /**
+     * The MIME type of the image. Different providers may support different image types.
+     */
+    readonly mimeType: v.StringSchema<undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>, v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"audio", undefined>;
+    /**
+     * The base64-encoded audio data.
+     */
+    readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+    /**
+     * The MIME type of the audio. Different providers may support different audio types.
+     */
+    readonly mimeType: v.StringSchema<undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>, v.LooseObjectSchema<{
+    /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+    readonly name: v.StringSchema<undefined>;
+    readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * The URI of this resource.
+     */
+    readonly uri: v.StringSchema<undefined>;
+    /**
+     * A description of what this resource represents.
+     */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * The MIME type of this resource, if known.
+     */
+    readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly type: v.LiteralSchema<"resource_link", undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>, v.LooseObjectSchema<{
+    readonly type: v.LiteralSchema<"resource", undefined>;
+    readonly resource: v.UnionSchema<[v.LooseObjectSchema<{
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+         */
+        readonly text: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * A base64-encoded string representing the binary data of the item.
+         */
+        readonly blob: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>], undefined>;
+    /**
+     * See [MCP specification] for notes on _meta usage.
+     */
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>], undefined>;
+/**
+ * Describes a message returned as part of a prompt.
+ */
+export const PromptMessageSchema: v.LooseObjectSchema<{
+    readonly role: v.PicklistSchema<["user", "assistant"], undefined>;
+    readonly content: v.UnionSchema<[v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"text", undefined>;
+        /**
+         * The text content of the message.
+         */
+        readonly text: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"image", undefined>;
+        /**
+         * The base64-encoded image data.
+         */
+        readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+        /**
+         * The MIME type of the image. Different providers may support different image types.
+         */
+        readonly mimeType: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"audio", undefined>;
+        /**
+         * The base64-encoded audio data.
+         */
+        readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+        /**
+         * The MIME type of the audio. Different providers may support different audio types.
+         */
+        readonly mimeType: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+        readonly name: v.StringSchema<undefined>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * A description of what this resource represents.
+         */
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"resource_link", undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"resource", undefined>;
+        readonly resource: v.UnionSchema<[v.LooseObjectSchema<{
+            /**
+             * The URI of this resource.
+             */
+            readonly uri: v.StringSchema<undefined>;
+            /**
+             * The MIME type of this resource, if known.
+             */
+            readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /**
+             * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+             */
+            readonly text: v.StringSchema<undefined>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>, v.LooseObjectSchema<{
+            /**
+             * The URI of this resource.
+             */
+            readonly uri: v.StringSchema<undefined>;
+            /**
+             * The MIME type of this resource, if known.
+             */
+            readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /**
+             * A base64-encoded string representing the binary data of the item.
+             */
+            readonly blob: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>], undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>], undefined>;
+}, undefined>;
+/**
+ * The server's response to a tool call.
+ */
+export const CallToolResultSchema: v.LooseObjectSchema<{
+    /**
+     * A list of content objects that represent the result of the tool call.
+     */
+    readonly content: v.OptionalSchema<v.ArraySchema<v.UnionSchema<[v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"text", undefined>;
+        /**
+         * The text content of the message.
+         */
+        readonly text: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"image", undefined>;
+        /**
+         * The base64-encoded image data.
+         */
+        readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+        /**
+         * The MIME type of the image. Different providers may support different image types.
+         */
+        readonly mimeType: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"audio", undefined>;
+        /**
+         * The base64-encoded audio data.
+         */
+        readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+        /**
+         * The MIME type of the audio. Different providers may support different audio types.
+         */
+        readonly mimeType: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+        readonly name: v.StringSchema<undefined>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * A description of what this resource represents.
+         */
+        readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly type: v.LiteralSchema<"resource_link", undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        readonly type: v.LiteralSchema<"resource", undefined>;
+        readonly resource: v.UnionSchema<[v.LooseObjectSchema<{
+            /**
+             * The URI of this resource.
+             */
+            readonly uri: v.StringSchema<undefined>;
+            /**
+             * The MIME type of this resource, if known.
+             */
+            readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /**
+             * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+             */
+            readonly text: v.StringSchema<undefined>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>, v.LooseObjectSchema<{
+            /**
+             * The URI of this resource.
+             */
+            readonly uri: v.StringSchema<undefined>;
+            /**
+             * The MIME type of this resource, if known.
+             */
+            readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /**
+             * A base64-encoded string representing the binary data of the item.
+             */
+            readonly blob: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>], undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>], undefined>, undefined>, readonly []>;
+    /**
+     * An object containing structured tool output.
+     */
+    readonly structuredContent: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    /**
+     * Whether the tool call ended in an error.
+     */
+    readonly isError: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * The server's response to a resources/read request from the client.
+ */
+export const ReadResourceResultSchema: v.LooseObjectSchema<{
+    readonly contents: v.ArraySchema<v.UnionSchema<[v.LooseObjectSchema<{
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+         */
+        readonly text: v.StringSchema<undefined>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>, v.LooseObjectSchema<{
+        /**
+         * The URI of this resource.
+         */
+        readonly uri: v.StringSchema<undefined>;
+        /**
+         * The MIME type of this resource, if known.
+         */
+        readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * A base64-encoded string representing the binary data of the item.
+         */
+        readonly blob: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+        /**
+         * See [MCP specification] for notes on _meta usage.
+         */
+        readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+    }, undefined>], undefined>, undefined>;
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * The server's response to a prompts/get request from the client.
+ */
+export const GetPromptResultSchema: v.LooseObjectSchema<{
+    /**
+     * An optional description for the prompt.
+     */
+    readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly messages: v.ArraySchema<v.LooseObjectSchema<{
+        readonly role: v.PicklistSchema<["user", "assistant"], undefined>;
+        readonly content: v.UnionSchema<[v.LooseObjectSchema<{
+            readonly type: v.LiteralSchema<"text", undefined>;
+            /**
+             * The text content of the message.
+             */
+            readonly text: v.StringSchema<undefined>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>, v.LooseObjectSchema<{
+            readonly type: v.LiteralSchema<"image", undefined>;
+            /**
+             * The base64-encoded image data.
+             */
+            readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+            /**
+             * The MIME type of the image. Different providers may support different image types.
+             */
+            readonly mimeType: v.StringSchema<undefined>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>, v.LooseObjectSchema<{
+            readonly type: v.LiteralSchema<"audio", undefined>;
+            /**
+             * The base64-encoded audio data.
+             */
+            readonly data: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+            /**
+             * The MIME type of the audio. Different providers may support different audio types.
+             */
+            readonly mimeType: v.StringSchema<undefined>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>, v.LooseObjectSchema<{
+            /** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+            readonly name: v.StringSchema<undefined>;
+            readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /**
+             * The URI of this resource.
+             */
+            readonly uri: v.StringSchema<undefined>;
+            /**
+             * A description of what this resource represents.
+             */
+            readonly description: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            /**
+             * The MIME type of this resource, if known.
+             */
+            readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly type: v.LiteralSchema<"resource_link", undefined>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>, v.LooseObjectSchema<{
+            readonly type: v.LiteralSchema<"resource", undefined>;
+            readonly resource: v.UnionSchema<[v.LooseObjectSchema<{
+                /**
+                 * The URI of this resource.
+                 */
+                readonly uri: v.StringSchema<undefined>;
+                /**
+                 * The MIME type of this resource, if known.
+                 */
+                readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                /**
+                 * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+                 */
+                readonly text: v.StringSchema<undefined>;
+                /**
+                 * See [MCP specification] for notes on _meta usage.
+                 */
+                readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+            }, undefined>, v.LooseObjectSchema<{
+                /**
+                 * The URI of this resource.
+                 */
+                readonly uri: v.StringSchema<undefined>;
+                /**
+                 * The MIME type of this resource, if known.
+                 */
+                readonly mimeType: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                /**
+                 * A base64-encoded string representing the binary data of the item.
+                 */
+                readonly blob: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.Base64Action<string, undefined>]>;
+                /**
+                 * See [MCP specification] for notes on _meta usage.
+                 */
+                readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+            }, undefined>], undefined>;
+            /**
+             * See [MCP specification] for notes on _meta usage.
+             */
+            readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+        }, undefined>], undefined>;
+    }, undefined>, undefined>;
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+/**
+ * The server's response to a completion/complete request
+ */
+export const CompleteResultSchema: v.LooseObjectSchema<{
+    readonly completion: v.LooseObjectSchema<{
+        /**
+         * An array of completion values. Must not exceed 100 items.
+         */
+        readonly values: v.SchemaWithPipe<readonly [v.ArraySchema<v.StringSchema<undefined>, undefined>, v.MaxLengthAction<string[], 100, undefined>]>;
+        /**
+         * The total number of completion options available. This can exceed the number of values actually sent in the response.
+         */
+        readonly total: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>]>, undefined>;
+        /**
+         * Indicates whether there are additional completion options beyond those provided in the current response, even if the exact total is unknown.
+         */
+        readonly hasMore: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    }, undefined>;
+    readonly _meta: v.OptionalSchema<v.LooseObjectSchema<{}, undefined>, undefined>;
+}, undefined>;
+export type CallToolResult = v.InferInput<typeof CallToolResultSchema>;
+export type ReadResourceResult = v.InferInput<typeof ReadResourceResultSchema>;
+export type GetPromptResult = v.InferInput<typeof GetPromptResultSchema>;
+export type CompleteResult = v.InferInput<typeof CompleteResultSchema>;
+import * as v from 'valibot';

package/src/validation/index.js

@@ -0,0 +1,248 @@
+/* eslint-disable jsdoc/no-undefined-types */
+import * as v from 'valibot';
+
+/**
+ * Text provided to or from an LLM.
+ */
+export const TextContentSchema = v.looseObject({
+	type: v.literal('text'),
+	/**
+	 * The text content of the message.
+	 */
+	text: v.string(),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * An image provided to or from an LLM.
+ */
+export const ImageContentSchema = v.looseObject({
+	type: v.literal('image'),
+	/**
+	 * The base64-encoded image data.
+	 */
+	data: v.pipe(v.string(), v.base64()),
+	/**
+	 * The MIME type of the image. Different providers may support different image types.
+	 */
+	mimeType: v.string(),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * An Audio provided to or from an LLM.
+ */
+export const AudioContentSchema = v.looseObject({
+	type: v.literal('audio'),
+	/**
+	 * The base64-encoded audio data.
+	 */
+	data: v.pipe(v.string(), v.base64()),
+	/**
+	 * The MIME type of the audio. Different providers may support different audio types.
+	 */
+	mimeType: v.string(),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * The contents of a specific resource or sub-resource.
+ */
+export const ResourceContentsSchema = v.looseObject({
+	/**
+	 * The URI of this resource.
+	 */
+	uri: v.string(),
+	/**
+	 * The MIME type of this resource, if known.
+	 */
+	mimeType: v.optional(v.string()),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+export const TextResourceContentsSchema = v.looseObject({
+	/**
+	 * The URI of this resource.
+	 */
+	uri: v.string(),
+	/**
+	 * The MIME type of this resource, if known.
+	 */
+	mimeType: v.optional(v.string()),
+	/**
+	 * The text of the item. This must only be set if the item can actually be represented as text (not binary data).
+	 */
+	text: v.string(),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+export const BlobResourceContentsSchema = v.looseObject({
+	/**
+	 * The URI of this resource.
+	 */
+	uri: v.string(),
+	/**
+	 * The MIME type of this resource, if known.
+	 */
+	mimeType: v.optional(v.string()),
+	/**
+	 * A base64-encoded string representing the binary data of the item.
+	 */
+	blob: v.pipe(v.string(), v.base64()),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * The contents of a resource, embedded into a prompt or tool call result.
+ */
+export const EmbeddedResourceSchema = v.looseObject({
+	type: v.literal('resource'),
+	resource: v.union([TextResourceContentsSchema, BlobResourceContentsSchema]),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * A resource that the server is capable of reading, included in a prompt or tool call result.
+ */
+export const ResourceLinkSchema = v.looseObject({
+	/** Intended for programmatic or logical use, but used as a display name in past specs or fallback */
+	name: v.string(),
+	title: v.optional(v.string()),
+	/**
+	 * The URI of this resource.
+	 */
+	uri: v.string(),
+	/**
+	 * A description of what this resource represents.
+	 */
+	description: v.optional(v.string()),
+	/**
+	 * The MIME type of this resource, if known.
+	 */
+	mimeType: v.optional(v.string()),
+	type: v.literal('resource_link'),
+	/**
+	 * See [MCP specification] for notes on _meta usage.
+	 */
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * A content block that can be used in prompts and tool results.
+ */
+export const ContentBlockSchema = v.union([
+	TextContentSchema,
+	ImageContentSchema,
+	AudioContentSchema,
+	ResourceLinkSchema,
+	EmbeddedResourceSchema,
+]);
+
+/**
+ * Describes a message returned as part of a prompt.
+ */
+export const PromptMessageSchema = v.looseObject({
+	role: v.picklist(['user', 'assistant']),
+	content: ContentBlockSchema,
+});
+
+/**
+ * The server's response to a tool call.
+ */
+export const CallToolResultSchema = v.looseObject({
+	/**
+	 * A list of content objects that represent the result of the tool call.
+	 */
+	content: v.optional(v.array(ContentBlockSchema), []),
+
+	/**
+	 * An object containing structured tool output.
+	 */
+	structuredContent: v.optional(v.looseObject({})),
+
+	/**
+	 * Whether the tool call ended in an error.
+	 */
+	isError: v.optional(v.boolean()),
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * The server's response to a resources/read request from the client.
+ */
+export const ReadResourceResultSchema = v.looseObject({
+	contents: v.array(
+		v.union([TextResourceContentsSchema, BlobResourceContentsSchema]),
+	),
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * The server's response to a prompts/get request from the client.
+ */
+export const GetPromptResultSchema = v.looseObject({
+	/**
+	 * An optional description for the prompt.
+	 */
+	description: v.optional(v.string()),
+	messages: v.array(PromptMessageSchema),
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * The server's response to a completion/complete request
+ */
+export const CompleteResultSchema = v.looseObject({
+	completion: v.looseObject({
+		/**
+		 * An array of completion values. Must not exceed 100 items.
+		 */
+		values: v.pipe(v.array(v.string()), v.maxLength(100)),
+		/**
+		 * The total number of completion options available. This can exceed the number of values actually sent in the response.
+		 */
+		total: v.optional(v.pipe(v.number(), v.integer())),
+		/**
+		 * Indicates whether there are additional completion options beyond those provided in the current response, even if the exact total is unknown.
+		 */
+		hasMore: v.optional(v.boolean()),
+	}),
+	_meta: v.optional(v.looseObject({})),
+});
+
+/**
+ * @typedef {v.InferInput<typeof CallToolResultSchema>} CallToolResult
+ */
+
+/**
+ * @typedef {v.InferInput<typeof ReadResourceResultSchema>} ReadResourceResult
+ */
+
+/**
+ * @typedef {v.InferInput<typeof GetPromptResultSchema>} GetPromptResult
+ */
+
+/**
+ * @typedef {v.InferInput<typeof CompleteResultSchema>} CompleteResult
+ */