tmcp 1.1.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,10 +1,15 @@
 {
   "name": "tmcp",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "The main tmcp library",
   "main": "src/index.js",
   "type": "module",
   "keywords": [],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/paoloricciuti/tmcp.git",
+    "directory": "packages/tmcp"
+  },
   "author": "Paolo Ricciuti",
   "license": "MIT",
   "files": [
@@ -34,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,43 +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?: 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?: 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, params?: unknown) => Promise<unknown> | unknown} execute
+     * @param {(uri: string) => Promise<ReadResourceResult> | ReadResourceResult} execute
      */
     resource({ name, description, uri }: {
         name: string;
         description: string;
         uri: string;
-    }, execute: (uri: string, params?: unknown) => Promise<unknown> | unknown): void;
+    }, execute: (uri: string) => Promise<ReadResourceResult> | ReadResourceResult): void;
     /**
-     * @param {{ name: string; description: string; uri: string; complete?: Completion }} options
-     * @param {(uri: string, params?: unknown) => Promise<unknown> | unknown} execute
+     * @template {string} TUri
+     * @template {ExtractURITemplateVariables<TUri>} TVariables
+     * @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 }: {
+    template<TUri extends string, TVariables extends ExtractURITemplateVariables<TUri>>({ name, description, uri, complete }: {
         name: string;
         description: string;
-        uri: string;
-        complete?: Completion;
-    }, execute: (uri: string, params?: unknown) => Promise<unknown> | unknown): void;
+        uri: TUri;
+        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']>}
@@ -69,7 +71,11 @@ 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';
 import type { SubscriptionsKeys } from "./internal/internal.js";

package/src/index.js

@@ -1,10 +1,19 @@
 /**
  * @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
@@ -30,7 +39,7 @@ export class McpServer {
 	#resources = new Map();
 	#templates = new UriTemplateMatcher();
 	/**
-	 * @type {{ [ref: string]: Map<string, Completion> }}
+	 * @type {{ [ref: string]: Map<string, Partial<Record<string, Completion>>> }}
 	 */
 	#completions = {
 		'ref/prompt': new Map(),
@@ -138,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)
@@ -148,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),
+				);
 			},
 		);
 	}
@@ -203,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)
@@ -213,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),
+				);
 			},
 		);
 	}
@@ -277,7 +295,18 @@ export class McpServer {
 					throw new Error(`Resource ${uri} not found`);
 				}
 			}
-			return resource.execute(uri, params);
+			if (resource.template) {
+				if (!params)
+					throw new Error('Missing parameters for template resource');
+				return v.parse(
+					ReadResourceResultSchema,
+					await resource.execute(uri, params),
+				);
+			}
+			return v.parse(
+				ReadResourceResultSchema,
+				await resource.execute(uri),
+			);
 		});
 	}
 	/**
@@ -291,19 +320,19 @@ export class McpServer {
 				if (!completions) return null;
 				const complete = completions.get(ref.uri ?? ref.name);
 				if (!complete) return null;
-				return {
-					completion: {
-						values: complete(argument, context),
-						hasMore: false,
-					},
-				};
+				const actual_complete = complete[argument.name];
+				if (!actual_complete) return null;
+				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) {
@@ -317,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?: 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) {
@@ -334,43 +363,48 @@ export class McpServer {
 		});
 	}
 	/**
-	 * @param {string} name
-	 * @param {string} description
-	 * @param {string} uri
-	 * @param {(uri: string, params?: unknown) => Promise<unknown> | unknown} execute
-	 * @param {Completion} [complete]
-	 * @param {boolean} [template=false]
+	 * @type {(resource: Resource & {complete?: Partial<Record<string,Completion>>, uri: string})=> void}
 	 */
-	#resource(name, description, uri, execute, complete, template = false) {
+	#resource({ uri, complete, ...resource }) {
 		if (complete) {
 			this.#completions['ref/resource'].set(uri, complete);
 		}
-		if (template) {
+		if (resource.template) {
 			this.#templates.add(uri);
 		}
 		if (this.#options.capabilities?.resources?.listChanged) {
 			this.#notify('notifications/resources/list_changed', {});
 		}
-		this.#resources.set(uri, {
-			description,
-			name,
-			execute,
-			template,
-		});
+		this.#resources.set(uri, resource);
 	}
 	/**
 	 * @param {{ name: string; description: string; uri: string }} options
-	 * @param {(uri: string, params?: unknown) => Promise<unknown> | unknown} execute
+	 * @param {(uri: string) => Promise<ReadResourceResult> | ReadResourceResult} execute
 	 */
 	resource({ name, description, uri }, execute) {
-		this.#resource(name, description, uri, execute, undefined, false);
+		this.#resource({
+			name,
+			description,
+			uri,
+			execute,
+			template: false,
+		});
 	}
 	/**
-	 * @param {{ name: string; description: string; uri: string; complete?: Completion }} options
-	 * @param {(uri: string, params?: unknown) => Promise<unknown> | unknown} execute
+	 * @template {string} TUri
+	 * @template {ExtractURITemplateVariables<TUri>} TVariables
+	 * @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(name, description, uri, execute, complete, true);
+		this.#resource({
+			name,
+			description,
+			uri,
+			execute,
+			complete,
+			template: true,
+		});
 	}
 	/**
 	 * @param {JSONRPCRequest} request

package/src/internal/internal.d.ts

@@ -1,34 +1,52 @@
 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 = (
-	argument: { name: string; value: string },
+	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 = {
-	description: string;
-	name: string;
-	template: boolean;
-	execute: (uri: string, params?: unknown) => Promise<unknown> | unknown;
-};
+export type Resource =
+	| {
+			description: string;
+			name: string;
+			template: true;
+			execute: (
+				uri: string,
+				params: Record<string, string | string[]>,
+			) => Promise<ReadResourceResult> | ReadResourceResult;
+	  }
+	| {
+			description: string;
+			name: string;
+			template: false;
+			execute: (
+				uri: string,
+			) => Promise<ReadResourceResult> | ReadResourceResult;
+	  };
 
 export type ServerOptions<TSchema extends StandardSchemaV1> = {
 	capabilities?: {

package/src/internal/uri-template.d.ts

@@ -0,0 +1,45 @@
+// Helper type to remove whitespace
+type Trim<S extends string> = S extends ` ${infer R}`
+	? Trim<R>
+	: S extends `${infer L} `
+		? Trim<L>
+		: S;
+
+// Helper type to extract variable name, removing modifiers
+type ExtractVarName<S extends string> = S extends `${infer Name}:${string}`
+	? Trim<Name> // Remove prefix modifier
+	: S extends `${infer Name}*`
+		? Trim<Name> // Remove explode modifier
+		: Trim<S>;
+
+// Helper type to split comma-separated variables
+type SplitVariables<S extends string> = S extends `${infer First},${infer Rest}`
+	? ExtractVarName<First> | SplitVariables<Rest>
+	: ExtractVarName<S>;
+
+// Helper type to extract content from braces and handle operators
+type ExtractFromExpression<S extends string> = S extends `+${infer Vars}`
+	? SplitVariables<Vars> // Reserved {+var}
+	: S extends `#${infer Vars}`
+		? SplitVariables<Vars> // Fragment {#var}
+		: S extends `.${infer Vars}`
+			? SplitVariables<Vars> // Label {.var}
+			: S extends `/${infer Vars}`
+				? SplitVariables<Vars> // Path {/var}
+				: S extends `;${infer Vars}`
+					? SplitVariables<Vars> // Path-style {;var}
+					: S extends `?${infer Vars}`
+						? SplitVariables<Vars> // Query {?var}
+						: S extends `&${infer Vars}`
+							? SplitVariables<Vars> // Query continuation {&var}
+							: SplitVariables<S>; // Simple {var}
+
+// Main recursive type to extract all variables from URI template
+type ExtractVariablesFromTemplate<S extends string> =
+	S extends `${string}{${infer Expression}}${infer Rest}`
+		? ExtractFromExpression<Expression> | ExtractVariablesFromTemplate<Rest>
+		: never;
+
+// Main exported type
+export type ExtractURITemplateVariables<T extends string> =
+	ExtractVariablesFromTemplate<T>;

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
+ */