@orkestrel/mcp 0.0.30 → 0.0.32

package/dist/src/core/index.js

@@ -1,4 +1,4 @@
-import { arrayOf, attempt, cloneJSONRecord, cloneJSONValue, isArray, isBoolean, isFiniteNumber, isInteger, isJSONValue, isNumber, isRecord, isString, isUndefined, parseJSON, sanitizeBudget } from "@orkestrel/contract";
+import { arrayOf, attempt, cloneJSONRecord, cloneJSONValue, isArray, isBoolean, isError, isFiniteNumber, isInstance, isInteger, isJSONValue, isNumber, isObject, isRecord, isString, isUndefined, objectOf, parseJSON, sanitizeBudget } from "@orkestrel/contract";
 import { decodeBase64, decodeUTF8, encodeBase64, encodeHex } from "@orkestrel/codec";
 import { createSSEParser } from "@orkestrel/sse";
 import { Emitter } from "@orkestrel/emitter";
@@ -274,9 +274,12 @@ var DEFAULT_MCP_SUBSCRIPTION_CAPACITY = 64;
 * optional structured context.
 *
 * @remarks
-* {@link MCPClient} throws this error for a remote JSON-RPC `error` response and for a
-* locally detected protocol incompatibility. Local lifecycle and transport conditions such
-* as disconnects and request timeouts remain plain `Error`s. For a remote response, `context`
+* {@link MCPClient} throws this error for a remote JSON-RPC `error` response, for a locally
+* detected protocol incompatibility, and for a session-bound request refused because the
+* client holds no connection — that one carries `-32600`, so a caller separates "reconnect"
+* from "retry" without reading a message. Local lifecycle and transport conditions that
+* settle a request already in flight, such as a disconnect and a request timeout, remain
+* plain `Error`s. For a remote response, `context`
 * carries the optional `error.data` unchanged and is `undefined` when the peer omitted it.
 * This includes the modern reserved paths: `-32020` carries no context, `-32021` may carry
 * `requiredCapabilities`, and `-32022` carries the peer's `supported` revisions and
@@ -322,11 +325,7 @@ var MCPError = class extends Error {
 * ```
 */
 function isMCPError(value) {
-	try {
-		return value instanceof MCPError;
-	} catch {
-		return false;
-	}
+	return isInstance(value, MCPError);
 }
 //#endregion
 //#region src/core/cloners.ts
@@ -577,7 +576,7 @@ function parseMCPInputState(value) {
 		const name = parsed["name"];
 		const digest = parsed["digest"];
 		const state = parsed["state"];
-		if (!isString(principal) || principal.length === 0 || !isNumber(expiry) || !Number.isFinite(expiry)) return;
+		if (!isString(principal) || principal.length === 0 || !isFiniteNumber(expiry)) return;
 		if (!isJSONRPCId(id)) return void 0;
 		if (!isString(version) || !isString(method) || !isString(name)) return void 0;
 		if (!isString(digest) || !isUndefined(state) && !isJSONValue(state)) return void 0;
@@ -740,9 +739,9 @@ function serializeJSON(value, limits) {
 		const limit = limits.bytes;
 		const depth = limits.depth;
 		const breadth = limits.keys;
-		if (!Number.isFinite(limit) || !Number.isInteger(limit) || limit < 0) return void 0;
-		if (!Number.isFinite(depth) || !Number.isInteger(depth) || depth < 0) return void 0;
-		if (breadth !== void 0 && (!Number.isFinite(breadth) || !Number.isInteger(breadth) || breadth < 0)) return void 0;
+		if (!isInteger(limit) || limit < 0) return void 0;
+		if (!isInteger(depth) || depth < 0) return void 0;
+		if (breadth !== void 0 && (!isInteger(breadth) || breadth < 0)) return void 0;
 		let bytes = 0;
 		let keys = 0;
 		const chunks = [];
@@ -856,7 +855,7 @@ function serializeJSON(value, limits) {
 				continue;
 			}
 			if (isNumber(entry)) {
-				if (!Number.isFinite(entry)) return void 0;
+				if (!isFiniteNumber(entry)) return void 0;
 				const text = JSON.stringify(entry);
 				if (!isString(text)) return void 0;
 				bytes += text.length;
@@ -872,10 +871,10 @@ function serializeJSON(value, limits) {
 				});
 				continue;
 			}
-			if (typeof entry !== "object" || ancestors.has(entry)) return void 0;
-			if (Array.isArray(entry)) {
+			if (!isObject(entry) || ancestors.has(entry)) return void 0;
+			if (isArray(entry)) {
 				const lengthDescriptor = Reflect.getOwnPropertyDescriptor(entry, "length");
-				if (lengthDescriptor === void 0 || !Object.hasOwn(lengthDescriptor, "value") || !isNumber(lengthDescriptor.value) || !Number.isInteger(lengthDescriptor.value) || lengthDescriptor.value < 0 || lengthDescriptor.value > 4294967295 || lengthDescriptor.enumerable === true || lengthDescriptor.configurable === true) return void 0;
+				if (lengthDescriptor === void 0 || !Object.hasOwn(lengthDescriptor, "value") || !isNumber(lengthDescriptor.value) || !isInteger(lengthDescriptor.value) || lengthDescriptor.value < 0 || lengthDescriptor.value > 4294967295 || lengthDescriptor.enumerable === true || lengthDescriptor.configurable === true) return void 0;
 				const length = lengthDescriptor.value;
 				keys += length;
 				bytes += 2 + (length === 0 ? 0 : length - 1);
@@ -892,7 +891,7 @@ function serializeJSON(value, limits) {
 						continue;
 					}
 					const index = Number(name);
-					if (!Number.isInteger(index) || index < 0 || index >= length || String(index) !== name) return void 0;
+					if (!isInteger(index) || index < 0 || index >= length || String(index) !== name) return void 0;
 				}
 				if (!foundLength) return void 0;
 				const values = [];
@@ -1113,10 +1112,9 @@ function buildCallOutcome(name, result) {
 	if (isRecord(result) && result["isError"] === true) throw new Error(text.length > 0 ? text : `MCP tool '${name}' failed`);
 	let value;
 	if (isRecord(result) && Object.hasOwn(result, "structuredContent")) value = result["structuredContent"];
-	else if (text.length > 0) try {
-		value = JSON.parse(text);
-	} catch {
-		value = text;
+	else if (text.length > 0) {
+		const parsed = parseJSON(text);
+		value = parsed === void 0 ? text : parsed;
 	}
 	return Object.freeze({
 		resultType: "complete",
@@ -1127,19 +1125,17 @@ function buildCallOutcome(name, result) {
 * Builds the canonical Tool call for one validated MCP `tools/call` request.
 *
 * @param request - The original MCP request
-* @param caller - Optional consumer-asserted caller context
 * @param args - Optional once-validated modern arguments; omission retains legacy normalization
 * @returns The canonical call, or `undefined` when the name is invalid
 */
-function buildToolCall(request, caller, args) {
+function buildToolCall(request, args) {
 	const name = request.params?.["name"];
-	if (typeof name !== "string") return void 0;
+	if (!isString(name)) return void 0;
 	const rawArguments = request.params?.["arguments"];
 	return {
 		id: String(request.id),
 		name,
-		arguments: args ?? (isRecord(rawArguments) ? rawArguments : {}),
-		...caller === void 0 ? {} : { caller }
+		arguments: args ?? (isRecord(rawArguments) ? rawArguments : {})
 	};
 }
 /**
@@ -1230,7 +1226,8 @@ function buildMethodOptions(options, lifetime) {
 *
 * @remarks
 * Each {@link import('@orkestrel/tool').ToolDefinition} carries through its
-* `name` and (when present) `description`; its open JSON-Schema `parameters`
+* `name`, optional `title` and `description`, and mapped annotation hints;
+* its open JSON-Schema `parameters`
 * becomes `inputSchema`, defaulting to an empty object schema (`{ type: 'object' }`)
 * when a tool declares none (MCP requires an `inputSchema`).
 *
@@ -1239,14 +1236,50 @@ function buildMethodOptions(options, lifetime) {
 */
 function buildToolDescriptors(manager) {
 	return manager.definitions().map((definition) => {
-		const descriptor = {
+		const annotations = definition.annotations === void 0 ? {} : toolAnnotationsToMCP(definition.annotations);
+		return {
 			name: definition.name,
-			inputSchema: definition.parameters ?? { type: "object" }
+			inputSchema: definition.parameters ?? { type: "object" },
+			...definition.title === void 0 ? {} : { title: definition.title },
+			...definition.description === void 0 ? {} : { description: definition.description },
+			...Object.keys(annotations).length === 0 ? {} : { annotations }
 		};
-		if (definition.description !== void 0) descriptor.description = definition.description;
-		return descriptor;
 	});
 }
+/**
+* Projects domain tool annotations onto MCP wire hints without inventing defaults.
+*
+* @param annotations - The authored domain annotations
+* @returns The mapped hints; `untrusted` has no MCP counterpart
+*
+* @example
+* ```ts
+* toolAnnotationsToMCP({ pure: true, consequential: false }) // { readOnlyHint: true, destructiveHint: false }
+* ```
+*/
+function toolAnnotationsToMCP(annotations) {
+	return {
+		...annotations.pure === void 0 ? {} : { readOnlyHint: annotations.pure },
+		...annotations.consequential === void 0 ? {} : { destructiveHint: annotations.consequential }
+	};
+}
+/**
+* Projects MCP wire hints onto domain tool annotations without inventing defaults.
+*
+* @param annotations - The validated MCP wire annotations
+* @returns The mapped annotations; unmapped wire hints are omitted
+*
+* @example
+* ```ts
+* mcpAnnotationsToTool({ readOnlyHint: false, destructiveHint: true }) // { pure: false, consequential: true }
+* ```
+*/
+function mcpAnnotationsToTool(annotations) {
+	return {
+		...annotations.readOnlyHint === void 0 ? {} : { pure: annotations.readOnlyHint },
+		...annotations.destructiveHint === void 0 ? {} : { consequential: annotations.destructiveHint }
+	};
+}
 function buildModernResult(result, identity, ttl, scope) {
 	const currentMetadata = isRecord(result) ? result["_meta"] : void 0;
 	if (!isJSONValue(identity)) throw new TypeError("MCP identity must be exact JSON");
@@ -1282,7 +1315,7 @@ function modernResultToLegacy(result) {
 	const projected = {};
 	for (const [key, value] of Object.entries(result)) {
 		if (key === "resultType" || key === "ttlMs" || key === "cacheScope") continue;
-		if (key === "content" && Array.isArray(value)) {
+		if (key === "content" && isArray(value)) {
 			projected[key] = value.map((entry) => isRecord(entry) && entry["type"] === "text" && isString(entry["text"]) ? {
 				type: "text",
 				text: entry["text"]
@@ -1395,7 +1428,7 @@ function matchesSubscriptionNotification(notification, filter) {
 	if (notification.method === "notifications/resources/list_changed") return filter.resourcesListChanged === true;
 	if (notification.method === "notifications/resources/updated") {
 		const uri = notification.params?.["uri"];
-		return typeof uri === "string" && filter.resourceSubscriptions?.includes(uri) === true;
+		return isString(uri) && filter.resourceSubscriptions?.includes(uri) === true;
 	}
 	if (notification.method === "notifications/tasks") return isMCPTaskNotification(notification) && filter.taskIds?.includes(notification.params.taskId) === true;
 	return false;
@@ -1451,10 +1484,11 @@ function buildSubscriptionResult(id, identity) {
 * @remarks
 * `capabilities.resources` and `capabilities.prompts` appear only for servers with their
 * respective managers and derive notification flags from the configured subscription filter.
-* `capabilities.completions` is independent and appears only with a completion provider.
-* `capabilities.extensions` appears only for a server that configured the extension it
-* would name. An advertisement is a promise a client is entitled to act on, so a server
-* with no `task` policy omits the member entirely rather than advertising an empty
+* `tools.listChanged` is always advertised because the server produces the family from its
+* own registry. `capabilities.completions` is independent and appears only with a completion
+* provider. `capabilities.extensions` appears only for a server that configured the
+* extension it would name. An advertisement is a promise a client is entitled to act on, so
+* a server with no `task` policy omits the member entirely rather than advertising an empty
 * record — and its discovery answer stays byte-for-byte what it was before the extension
 * existed.
 *
@@ -1465,7 +1499,7 @@ function buildDiscoverResult(options) {
 	return buildModernResult({
 		supportedVersions: SUPPORTED_MODERN_PROTOCOL_VERSIONS,
 		capabilities: {
-			tools: {},
+			tools: { listChanged: true },
 			...options.resources === void 0 ? {} : { resources: {
 				...options.subscription?.notifications.resourceSubscriptions === void 0 ? {} : { subscribe: true },
 				...options.subscription?.notifications.resourcesListChanged === true ? { listChanged: true } : {}
@@ -2108,7 +2142,7 @@ function bindServer(server, transport) {
 		try {
 			const answer = await server.handle(message, { signal: request.signal });
 			if (answer === void 0) return;
-			if (typeof answer === "string") {
+			if (isString(answer)) {
 				if (!request.signal.aborted) await transport.send(answer);
 			} else if (request.signal.aborted) await answer[Symbol.asyncDispose]();
 			else await sendStream(answer, transport);
@@ -2509,7 +2543,7 @@ function isMCPAnnotations(value) {
 		const audience = annotations["audience"];
 		const priority = annotations["priority"];
 		const lastModified = annotations["lastModified"];
-		if (!isUndefined(audience) && (!Array.isArray(audience) || !audience.every((role) => role === "user" || role === "assistant"))) return false;
+		if (!isUndefined(audience) && (!isArray(audience) || !audience.every((role) => role === "user" || role === "assistant"))) return false;
 		if (!isUndefined(priority) && (!isFiniteNumber(priority) || priority < 0 || priority > 1)) return false;
 		return isUndefined(lastModified) || isString(lastModified);
 	} catch {
@@ -2531,7 +2565,7 @@ function isMCPIcon(value) {
 		const mimeType = icon["mimeType"];
 		const sizes = icon["sizes"];
 		const theme = icon["theme"];
-		return (isUndefined(mimeType) || isString(mimeType)) && (isUndefined(sizes) || Array.isArray(sizes) && sizes.every((size) => isString(size))) && (isUndefined(theme) || theme === "light" || theme === "dark");
+		return (isUndefined(mimeType) || isString(mimeType)) && (isUndefined(sizes) || isArray(sizes) && sizes.every((size) => isString(size))) && (isUndefined(theme) || theme === "light" || theme === "dark");
 	} catch {
 		return false;
 	}
@@ -2547,7 +2581,7 @@ function isMCPIdentity(value) {
 		const description = identity["description"];
 		const website = identity["websiteUrl"];
 		const icons = identity["icons"];
-		return (isUndefined(title) || isString(title)) && (isUndefined(description) || isString(description)) && (isUndefined(website) || isAbsoluteURI(website)) && (isUndefined(icons) || Array.isArray(icons) && icons.every((icon) => isMCPIcon(icon)));
+		return (isUndefined(title) || isString(title)) && (isUndefined(description) || isString(description)) && (isUndefined(website) || isAbsoluteURI(website)) && (isUndefined(icons) || isArray(icons) && icons.every((icon) => isMCPIcon(icon)));
 	} catch {
 		return false;
 	}
@@ -2658,12 +2692,34 @@ function isMCPResource(value) {
 		const resource = owned.value;
 		const icons = resource["icons"];
 		const size = resource["size"];
-		return isAbsoluteURI(resource["uri"]) && isString(resource["name"]) && (isUndefined(resource["title"]) || isString(resource["title"])) && (isUndefined(resource["description"]) || isString(resource["description"])) && (isUndefined(resource["mimeType"]) || isString(resource["mimeType"])) && (isUndefined(resource["annotations"]) || isMCPAnnotations(resource["annotations"])) && (isUndefined(size) || isInteger(size) && size >= 0) && (isUndefined(icons) || Array.isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(resource["_meta"]) || isMCPMetaObject(resource["_meta"]));
+		return isAbsoluteURI(resource["uri"]) && isString(resource["name"]) && (isUndefined(resource["title"]) || isString(resource["title"])) && (isUndefined(resource["description"]) || isString(resource["description"])) && (isUndefined(resource["mimeType"]) || isString(resource["mimeType"])) && (isUndefined(resource["annotations"]) || isMCPAnnotations(resource["annotations"])) && (isUndefined(size) || isInteger(size) && size >= 0) && (isUndefined(icons) || isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(resource["_meta"]) || isMCPMetaObject(resource["_meta"]));
 	} catch {
 		return false;
 	}
 }
 /**
+* Checks whether a value carries valid consumed MCP 2026-07-28 tool annotation hints.
+*
+* @remarks
+* Validates only `readOnlyHint` and `destructiveHint`; other wire fields are not consumed, so
+* the open `objectOf` combinator carries them through unread. Every declared member is
+* optional, a hostile read answers `false` rather than throwing, and an array is refused.
+*
+* @param value - The unknown wire annotations
+* @returns True if consumed annotation fields are optional booleans; false otherwise
+*
+* @example
+* ```ts
+* isMCPToolAnnotations({ readOnlyHint: false }) // true
+* ```
+*/
+function isMCPToolAnnotations(value) {
+	return objectOf({
+		readOnlyHint: isBoolean,
+		destructiveHint: isBoolean
+	}, true)(value);
+}
+/**
 * Determines whether a value is one resource-template descriptor.
 *
 * @remarks
@@ -2679,7 +2735,7 @@ function isMCPResourceTemplate(value) {
 	try {
 		const template = owned.value;
 		const icons = template["icons"];
-		return isString(template["uriTemplate"]) && template["uriTemplate"].length > 0 && isString(template["name"]) && (isUndefined(template["title"]) || isString(template["title"])) && (isUndefined(template["description"]) || isString(template["description"])) && (isUndefined(template["mimeType"]) || isString(template["mimeType"])) && (isUndefined(template["annotations"]) || isMCPAnnotations(template["annotations"])) && (isUndefined(icons) || Array.isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(template["_meta"]) || isMCPMetaObject(template["_meta"]));
+		return isString(template["uriTemplate"]) && template["uriTemplate"].length > 0 && isString(template["name"]) && (isUndefined(template["title"]) || isString(template["title"])) && (isUndefined(template["description"]) || isString(template["description"])) && (isUndefined(template["mimeType"]) || isString(template["mimeType"])) && (isUndefined(template["annotations"]) || isMCPAnnotations(template["annotations"])) && (isUndefined(icons) || isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(template["_meta"]) || isMCPMetaObject(template["_meta"]));
 	} catch {
 		return false;
 	}
@@ -2719,7 +2775,7 @@ function isMCPResourcePage(value) {
 	if (!owned.success) return false;
 	const resources = owned.value["resources"];
 	const cursor = owned.value["nextCursor"];
-	return Array.isArray(resources) && resources.every((resource) => isMCPResource(resource)) && (isUndefined(cursor) || isString(cursor));
+	return isArray(resources) && resources.every((resource) => isMCPResource(resource)) && (isUndefined(cursor) || isString(cursor));
 }
 /**
 * Determines whether a value is one consumer-owned resource-template page.
@@ -2732,7 +2788,7 @@ function isMCPResourceTemplatePage(value) {
 	if (!owned.success) return false;
 	const templates = owned.value["resourceTemplates"];
 	const cursor = owned.value["nextCursor"];
-	return Array.isArray(templates) && templates.every((template) => isMCPResourceTemplate(template)) && (isUndefined(cursor) || isString(cursor));
+	return isArray(templates) && templates.every((template) => isMCPResourceTemplate(template)) && (isUndefined(cursor) || isString(cursor));
 }
 /**
 * Determines whether a value is a string-valued MCP argument record.
@@ -2768,7 +2824,7 @@ function isMCPPrompt(value) {
 	const prompt = owned.value;
 	const argumentsValue = prompt["arguments"];
 	const icons = prompt["icons"];
-	return isString(prompt["name"]) && (isUndefined(prompt["title"]) || isString(prompt["title"])) && (isUndefined(prompt["description"]) || isString(prompt["description"])) && (isUndefined(argumentsValue) || Array.isArray(argumentsValue) && argumentsValue.every((argument) => isMCPPromptArgument(argument))) && (isUndefined(icons) || Array.isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(prompt["_meta"]) || isMCPMetaObject(prompt["_meta"]));
+	return isString(prompt["name"]) && (isUndefined(prompt["title"]) || isString(prompt["title"])) && (isUndefined(prompt["description"]) || isString(prompt["description"])) && (isUndefined(argumentsValue) || isArray(argumentsValue) && argumentsValue.every((argument) => isMCPPromptArgument(argument))) && (isUndefined(icons) || isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(prompt["_meta"]) || isMCPMetaObject(prompt["_meta"]));
 }
 /**
 * Determines whether a value is one prompt message with existing rich content.
@@ -2791,7 +2847,7 @@ function isMCPPromptPage(value) {
 	if (!owned.success) return false;
 	const prompts = owned.value["prompts"];
 	const cursor = owned.value["nextCursor"];
-	return Array.isArray(prompts) && prompts.every((prompt) => isMCPPrompt(prompt)) && (isUndefined(cursor) || isString(cursor));
+	return isArray(prompts) && prompts.every((prompt) => isMCPPrompt(prompt)) && (isUndefined(cursor) || isString(cursor));
 }
 /**
 * Determines whether a value is one complete `prompts/get` result.
@@ -2804,7 +2860,7 @@ function isMCPPromptGetResult(value) {
 	if (!owned.success) return false;
 	const result = owned.value;
 	const messages = result["messages"];
-	return result["resultType"] === "complete" && (isUndefined(result["description"]) || isString(result["description"])) && Array.isArray(messages) && messages.every((message) => isMCPPromptMessage(message)) && (isUndefined(result["_meta"]) || isMCPResultMetaObject(result["_meta"]));
+	return result["resultType"] === "complete" && (isUndefined(result["description"]) || isString(result["description"])) && isArray(messages) && messages.every((message) => isMCPPromptMessage(message)) && (isUndefined(result["_meta"]) || isMCPResultMetaObject(result["_meta"]));
 }
 /**
 * Determines whether a value is a prompt or resource-template completion reference.
@@ -2849,7 +2905,7 @@ function isMCPCompletion(value) {
 	const completion = owned.value;
 	const values = completion["values"];
 	const total = completion["total"];
-	return Array.isArray(values) && values.every((candidate) => isString(candidate)) && (isUndefined(total) || isInteger(total) && total >= 0) && (isUndefined(completion["hasMore"]) || isBoolean(completion["hasMore"]));
+	return isArray(values) && values.every((candidate) => isString(candidate)) && (isUndefined(total) || isInteger(total) && total >= 0) && (isUndefined(completion["hasMore"]) || isBoolean(completion["hasMore"]));
 }
 /**
 * Determines whether a value is one complete, capped `completion/complete` result.
@@ -2887,7 +2943,7 @@ function isMCPContent(value) {
 			case "resource_link": {
 				const icons = content["icons"];
 				const size = content["size"];
-				return isString(content["name"]) && isAbsoluteURI(content["uri"]) && (isUndefined(content["title"]) || isString(content["title"])) && (isUndefined(content["description"]) || isString(content["description"])) && (isUndefined(content["mimeType"]) || isString(content["mimeType"])) && (isUndefined(icons) || Array.isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(size) || isInteger(size) && size >= 0);
+				return isString(content["name"]) && isAbsoluteURI(content["uri"]) && (isUndefined(content["title"]) || isString(content["title"])) && (isUndefined(content["description"]) || isString(content["description"])) && (isUndefined(content["mimeType"]) || isString(content["mimeType"])) && (isUndefined(icons) || isArray(icons) && icons.every((icon) => isMCPIcon(icon))) && (isUndefined(size) || isInteger(size) && size >= 0);
 			}
 			default: return false;
 		}
@@ -2961,7 +3017,7 @@ function isMCPCallResult(value) {
 		const content = result["content"];
 		const error = result["isError"];
 		const metadata = result["_meta"];
-		return Array.isArray(content) && content.every((entry) => isMCPContent(entry)) && (isUndefined(error) || isBoolean(error)) && (isUndefined(metadata) || isMCPResultMetaObject(metadata));
+		return isArray(content) && content.every((entry) => isMCPContent(entry)) && (isUndefined(error) || isBoolean(error)) && (isUndefined(metadata) || isMCPResultMetaObject(metadata));
 	} catch {
 		return false;
 	}
@@ -3150,7 +3206,7 @@ function isMCPTaskNotification(value) {
 * ```
 */
 function isBoundedString(value, bytes) {
-	if (!isString(value) || !Number.isFinite(bytes) || !Number.isInteger(bytes) || bytes < 0) return false;
+	if (!isString(value) || !isInteger(bytes) || bytes < 0) return false;
 	let measured = 0;
 	for (let index = 0; index < value.length; index += 1) {
 		const code = value.charCodeAt(index);
@@ -3272,6 +3328,22 @@ function isMCPSubscriptionFilter(value) {
 	return isUndefined(tasks) || arrayOf(isString)(tasks);
 }
 /**
+* Checks whether a subscription filter leaves the built-in tools family to the server.
+*
+* @param value - The unknown value to inspect
+* @returns True if the filter is valid and does not claim tools changes; false otherwise
+*
+* @example
+* ```ts
+* isMCPConsumerFilter({ promptsListChanged: true }) // true
+* isMCPConsumerFilter({ toolsListChanged: true }) // false
+* ```
+*/
+function isMCPConsumerFilter(value) {
+	const owned = attempt(() => cloneJSONRecord(value));
+	return owned.success && isMCPSubscriptionFilter(owned.value) && owned.value["toolsListChanged"] !== true;
+}
+/**
 * Determines whether a value is a graceful `subscriptions/listen` result.
 *
 * @param value - The unknown value to inspect
@@ -3319,21 +3391,21 @@ function isMCPElicitFieldSchema(value) {
 			const names = schema["enumNames"];
 			const titled = schema["oneOf"];
 			if (!isUndefined(minimum) && (!isInteger(minimum) || minimum < 0) || !isUndefined(maximum) && (!isInteger(maximum) || maximum < 0) || !isUndefined(fallback) && !isString(fallback) || !isUndefined(format) && format !== "uri" && format !== "email" && format !== "date" && format !== "date-time") return false;
-			if (!isUndefined(choices) && (!Array.isArray(choices) || !choices.every(isString))) return false;
-			if (!isUndefined(names) && (isUndefined(choices) || !Array.isArray(names) || !names.every(isString))) return false;
-			return !(!isUndefined(titled) && (!Array.isArray(titled) || !titled.every((choice) => isJSONObject(choice) && isString(choice["const"]) && isString(choice["title"]))));
+			if (!isUndefined(choices) && (!isArray(choices) || !choices.every(isString))) return false;
+			if (!isUndefined(names) && (isUndefined(choices) || !isArray(names) || !names.every(isString))) return false;
+			return !(!isUndefined(titled) && (!isArray(titled) || !titled.every((choice) => isJSONObject(choice) && isString(choice["const"]) && isString(choice["title"]))));
 		}
 		if (schema["type"] !== "array") return false;
 		const minimum = schema["minItems"];
 		const maximum = schema["maxItems"];
 		const items = schema["items"];
-		if (!isUndefined(minimum) && (!isInteger(minimum) || minimum < 0) || !isUndefined(maximum) && (!isInteger(maximum) || maximum < 0) || !isUndefined(fallback) && (!Array.isArray(fallback) || !fallback.every((item) => isString(item))) || !isJSONObject(items)) return false;
+		if (!isUndefined(minimum) && (!isInteger(minimum) || minimum < 0) || !isUndefined(maximum) && (!isInteger(maximum) || maximum < 0) || !isUndefined(fallback) && (!isArray(fallback) || !fallback.every((item) => isString(item))) || !isJSONObject(items)) return false;
 		const itemType = items["type"];
 		const choices = items["enum"];
 		const titled = items["anyOf"];
 		if (!isUndefined(itemType) && itemType !== "string") return false;
-		if (!isUndefined(choices) && (!Array.isArray(choices) || !choices.every(isString))) return false;
-		if (!isUndefined(titled) && (!Array.isArray(titled) || !titled.every((choice) => isJSONObject(choice) && isString(choice["const"]) && isString(choice["title"])))) return false;
+		if (!isUndefined(choices) && (!isArray(choices) || !choices.every(isString))) return false;
+		if (!isUndefined(titled) && (!isArray(titled) || !titled.every((choice) => isJSONObject(choice) && isString(choice["const"]) && isString(choice["title"])))) return false;
 		return itemType === "string" && !isUndefined(choices) || !isUndefined(titled);
 	} catch {
 		return false;
@@ -3368,7 +3440,7 @@ function isMCPElicitSchema(value) {
 		const dialect = schema["$schema"];
 		if (!isUndefined(dialect) && !isString(dialect)) return false;
 		const required = schema["required"];
-		return (isUndefined(required) || Array.isArray(required) && required.every((name) => isString(name))) && Object.values(properties).every((property) => isMCPElicitFieldSchema(property));
+		return (isUndefined(required) || isArray(required) && required.every((name) => isString(name))) && Object.values(properties).every((property) => isMCPElicitFieldSchema(property));
 	} catch {
 		return false;
 	}
@@ -3511,7 +3583,7 @@ function isMCPElicitResult(value) {
 		if (action !== "accept") return isUndefined(content);
 		if (isUndefined(content)) return true;
 		if (!isJSONObject(content)) return false;
-		return Object.values(content).every((item) => isString(item) || isFiniteNumber(item) || isBoolean(item) || Array.isArray(item) && item.every((entry) => isString(entry)));
+		return Object.values(content).every((item) => isString(item) || isFiniteNumber(item) || isBoolean(item) || isArray(item) && item.every((entry) => isString(entry)));
 	} catch {
 		return false;
 	}
@@ -3566,11 +3638,11 @@ function isElicitContent(value, schema) {
 		const properties = declared.value["properties"];
 		const required = declared.value["required"];
 		if (!isJSONObject(properties)) return false;
-		if (Array.isArray(required)) {
+		if (isArray(required)) {
 			for (const name of required) if (!isString(name) || !Object.hasOwn(content, name)) return false;
 		}
 		for (const [name, item] of Object.entries(content)) {
-			if (!isString(item) && !isFiniteNumber(item) && !isBoolean(item) && !(Array.isArray(item) && item.every((entry) => isString(entry)))) return false;
+			if (!isString(item) && !isFiniteNumber(item) && !isBoolean(item) && !(isArray(item) && item.every((entry) => isString(entry)))) return false;
 			if (!Object.hasOwn(properties, name)) continue;
 			const field = properties[name];
 			if (!isJSONObject(field)) return false;
@@ -3583,7 +3655,7 @@ function isElicitContent(value, schema) {
 				const minimum = field["minimum"];
 				const maximum = field["maximum"];
 				if (!isFiniteNumber(item)) return false;
-				if (declaredType === "integer" && !Number.isInteger(item)) return false;
+				if (declaredType === "integer" && !isInteger(item)) return false;
 				if (isFiniteNumber(minimum) && item < minimum) return false;
 				if (isFiniteNumber(maximum) && item > maximum) return false;
 				continue;
@@ -3595,8 +3667,8 @@ function isElicitContent(value, schema) {
 				const maximum = field["maxLength"];
 				const format = field["format"];
 				if (!isString(item)) return false;
-				if (Array.isArray(choices) && !choices.includes(item)) return false;
-				if (Array.isArray(titled) && !titled.some((choice) => isJSONObject(choice) && choice["const"] === item)) return false;
+				if (isArray(choices) && !choices.includes(item)) return false;
+				if (isArray(titled) && !titled.some((choice) => isJSONObject(choice) && choice["const"] === item)) return false;
 				const length = Array.from(item).length;
 				if (isInteger(minimum) && length < minimum) return false;
 				if (isInteger(maximum) && length > maximum) return false;
@@ -3609,14 +3681,14 @@ function isElicitContent(value, schema) {
 			const items = field["items"];
 			const minimum = field["minItems"];
 			const maximum = field["maxItems"];
-			if (!Array.isArray(item) || !item.every((entry) => isString(entry))) return false;
+			if (!isArray(item) || !item.every((entry) => isString(entry))) return false;
 			if (isInteger(minimum) && item.length < minimum) return false;
 			if (isInteger(maximum) && item.length > maximum) return false;
 			if (!isJSONObject(items)) return false;
 			const choices = items["enum"];
 			const titled = items["anyOf"];
-			if (Array.isArray(choices) && !item.every((entry) => choices.includes(entry))) return false;
-			if (Array.isArray(titled) && !item.every((entry) => titled.some((choice) => isJSONObject(choice) && choice["const"] === entry))) return false;
+			if (isArray(choices) && !item.every((entry) => choices.includes(entry))) return false;
+			if (isArray(titled) && !item.every((entry) => titled.some((choice) => isJSONObject(choice) && choice["const"] === entry))) return false;
 		}
 		return true;
 	} catch {
@@ -3677,7 +3749,7 @@ function isMCPRootResult(value) {
 		const result = owned.value;
 		const roots = result["roots"];
 		const metadata = result["_meta"];
-		if (!Array.isArray(roots) || !roots.every((root) => isMCPRoot(root))) return false;
+		if (!isArray(roots) || !roots.every((root) => isMCPRoot(root))) return false;
 		return isUndefined(metadata) || isMCPMetaObject(metadata);
 	} catch {
 		return false;
@@ -3715,7 +3787,7 @@ function isMCPSampleContent(value) {
 		if (block["type"] === "tool_result") {
 			const carried = block["content"];
 			const failed = block["isError"];
-			if (!Array.isArray(carried) || !carried.every((entry) => isMCPContent(entry))) return false;
+			if (!isArray(carried) || !carried.every((entry) => isMCPContent(entry))) return false;
 			if (!isUndefined(failed) && !isBoolean(failed)) return false;
 			return isString(block["toolUseId"]);
 		}
@@ -3764,7 +3836,7 @@ function isMCPSampleResult(value) {
 		const metadata = result["_meta"];
 		if (role !== "user" && role !== "assistant") return false;
 		if (!isString(result["model"])) return false;
-		if (!(Array.isArray(content) ? content : [content]).every((block) => isMCPSampleContent(block))) return false;
+		if (!(isArray(content) ? content : [content]).every((block) => isMCPSampleContent(block))) return false;
 		if (!isUndefined(reason) && !isString(reason)) return false;
 		return isUndefined(metadata) || isMCPMetaObject(metadata);
 	} catch {
@@ -5014,6 +5086,7 @@ var MCPServer = class {
 	#limits;
 	#subscriptions = 0;
 	constructor(options) {
+		if (options.subscription !== void 0 && !isMCPConsumerFilter(options.subscription.notifications)) throw new MCPError("The consumer filter must be a valid filter that omits tools changes, because the server produces that family from its registry", JSONRPC_INVALID_PARAMS);
 		this.#emitter = new Emitter({
 			...options.on !== void 0 ? { on: options.on } : {},
 			...options.error !== void 0 ? { error: options.error } : {}
@@ -5176,7 +5249,7 @@ var MCPServer = class {
 			const input = captured[0];
 			return this.#forward(input, request);
 		}
-		if (!Array.isArray(captured[0]) || !captured[0].every((entry) => isMCPResourceContents(entry))) return buildJSONRPCError(request.id, JSONRPC_INTERNAL_ERROR, "Server resource manager returned invalid or oversized contents");
+		if (!isArray(captured[0]) || !captured[0].every((entry) => isMCPResourceContents(entry))) return buildJSONRPCError(request.id, JSONRPC_INTERNAL_ERROR, "Server resource manager returned invalid or oversized contents");
 		const result = buildModernResult({ contents: captured[0] }, this.#options.identity, this.#options.cache?.ttl ?? 6e4, this.#options.cache?.scope);
 		return buildJSONRPCResult(request.id, result);
 	}
@@ -5259,7 +5332,7 @@ var MCPServer = class {
 		const generated = await manager.complete(params, options);
 		if (generated === void 0) return buildJSONRPCError(request.id, JSONRPC_INVALID_PARAMS, "Completion reference not found");
 		const candidate = generated;
-		if (!isRecord(candidate) || !Array.isArray(candidate["values"])) return buildJSONRPCError(request.id, JSONRPC_INTERNAL_ERROR, "Server completion manager returned invalid or oversized candidates");
+		if (!isRecord(candidate) || !isArray(candidate["values"])) return buildJSONRPCError(request.id, JSONRPC_INTERNAL_ERROR, "Server completion manager returned invalid or oversized candidates");
 		const values = candidate["values"];
 		const truncated = values.length > 100;
 		const captured = snapshotJSON({
@@ -5286,14 +5359,14 @@ var MCPServer = class {
 		const args = isRecord(rawArguments) ? rawArguments : EMPTY_MCP_ARGUMENTS;
 		const input = await this.#input(request, args, options);
 		if (input !== void 0) return input;
-		const call = buildToolCall(request, options.caller, args);
+		const call = buildToolCall(request, args);
 		if (call === void 0) return buildJSONRPCError(id, JSONRPC_INVALID_PARAMS, "Invalid params: a string `name` is required");
 		const deferred = await this.#defer(request, call, options);
 		if (deferred !== void 0) return deferred;
 		const token = params?.["_meta"];
 		const progressToken = isRecord(token) ? token["progressToken"] : void 0;
-		if (this.#options.execution !== void 0 && (isString(progressToken) || typeof progressToken === "number" && Number.isInteger(progressToken))) return this.#progress(request, call, progressToken, options);
-		const result = await this.#execute(request, call, options.signal);
+		if (this.#options.execution !== void 0 && (isString(progressToken) || isInteger(progressToken))) return this.#progress(request, call, progressToken, options);
+		const result = await this.#execute(request, call, options);
 		return "jsonrpc" in result ? result : buildJSONRPCResult(id, result);
 	}
 	async #defer(request, call, options) {
@@ -5337,7 +5410,7 @@ var MCPServer = class {
 			keys: this.#limits.keys,
 			depth: this.#limits.depth
 		}, signal);
-		const execution = this.#execute(request, call, signal, reporter);
+		const execution = this.#execute(request, call, options, reporter);
 		try {
 			while (true) {
 				const outcome = await Promise.race([reporter.take(), execution]);
@@ -5355,14 +5428,19 @@ var MCPServer = class {
 			reporter.stop();
 		}
 	}
-	async #execute(request, call, signal, progress) {
+	async #execute(request, call, options, progress) {
+		const { signal, caller } = options;
 		let result;
 		try {
-			result = this.#options.execution === void 0 ? await this.#options.tools.execute(call) : await this.#options.execution({
+			result = this.#options.execution === void 0 ? await this.#options.tools.execute(call, {
+				signal,
+				...caller === void 0 ? {} : { caller }
+			}) : await this.#options.execution({
 				request,
 				call,
 				tools: this.#options.tools,
 				signal,
+				...caller === void 0 ? {} : { caller },
 				...progress === void 0 ? {} : { progress }
 			});
 		} catch (error) {
@@ -5500,7 +5578,7 @@ var MCPServer = class {
 			bytes: this.#limits.message,
 			depth: this.#limits.depth
 		});
-		if (configured === void 0 || context === void 0 || !isString(principal) || principal.length === 0 || !Number.isFinite(configured.ttl) || configured.ttl <= 0) return buildJSONRPCError(id, JSONRPC_INVALID_PARAMS, "Invalid params: input policy returned an invalid round or continuation context");
+		if (configured === void 0 || context === void 0 || !isString(principal) || principal.length === 0 || !isFiniteNumber(configured.ttl) || configured.ttl <= 0) return buildJSONRPCError(id, JSONRPC_INVALID_PARAMS, "Invalid params: input policy returned an invalid round or continuation context");
 		if (previous !== void 0 && previous <= Date.now()) return buildJSONRPCError(id, JSONRPC_INVALID_PARAMS, "Invalid params: request state could not be verified for this retry");
 		const expiry = Date.now() + configured.ttl;
 		const protectedState = {
@@ -5550,7 +5628,10 @@ var MCPServer = class {
 			const task = this.#options.task;
 			const configured = this.#options.subscription;
 			const tasks = task !== void 0 && configured !== void 0;
-			let notifications = buildSubscriptionFilter(requested, configured?.notifications ?? {}, tasks);
+			let notifications = buildSubscriptionFilter(requested, {
+				...configured?.notifications,
+				toolsListChanged: true
+			}, tasks);
 			const requestedTaskIds = notifications.taskIds;
 			if (requestedTaskIds !== void 0) {
 				const resolved = [];
@@ -5563,19 +5644,22 @@ var MCPServer = class {
 					taskIds: resolved
 				} : rest;
 			}
+			const state = {
+				frame: void 0,
+				failure: void 0,
+				iterator: void 0
+			};
+			const source = new ReadableStream({
+				start: this.#startSubscription.bind(this, notifications, options, configured, state),
+				pull: this.#pullSubscription.bind(this, notifications, options, state)
+			});
 			yield buildSubscriptionAcknowledgement(notifications, id);
-			if (configured !== void 0) {
-				const iterator = (await configured.producer(notifications, options))[Symbol.asyncIterator]();
-				options.signal.addEventListener("abort", () => void iterator.return?.(void 0)?.catch(() => void 0), { once: true });
-				for (let next = await iterator.next(); next.done !== true; next = await iterator.next()) {
-					const owned = parseJSONRPCMessage(next.value, {
-						bytes: this.#limits.message,
-						depth: this.#limits.depth
-					});
-					if (owned === void 0 || !isJSONRPCNotification(owned)) continue;
-					if (matchesSubscriptionNotification(owned, notifications)) yield stampSubscriptionNotification(owned, id);
-				}
+			for await (const notification of source) {
+				if (notification === void 0) continue;
+				if (notification === state.frame) state.frame = void 0;
+				yield stampSubscriptionNotification(notification, id);
 			}
+			if (state.failure !== void 0) throw state.failure.error;
 			return buildSubscriptionResult(id, this.#options.identity);
 		} catch (error) {
 			if (options.signal.aborted) throw error;
@@ -5584,6 +5668,72 @@ var MCPServer = class {
 			slot.abort();
 		}
 	}
+	async #startSubscription(notifications, options, configured, state, controller) {
+		const emitter = this.#options.tools.emitter;
+		const changed = this.#change.bind(this, controller, options.signal, state);
+		if (options.signal.aborted) {
+			controller.error(options.signal.reason);
+			return;
+		}
+		if (notifications.toolsListChanged === true && !emitter.destroyed) {
+			emitter.on("add", changed);
+			emitter.on("remove", changed);
+			emitter.on("clear", changed);
+		}
+		options.signal.addEventListener("abort", () => {
+			emitter.off("add", changed);
+			emitter.off("remove", changed);
+			emitter.off("clear", changed);
+			const iterator = state.iterator;
+			state.iterator = void 0;
+			if (iterator !== void 0) this.#releaseProducer(iterator, options.signal.reason);
+			controller.error(options.signal.reason);
+		}, { once: true });
+		try {
+			if (configured === void 0) return;
+			const iterator = (await configured.producer(notifications, options))[Symbol.asyncIterator]();
+			if (options.signal.aborted) this.#releaseProducer(iterator, options.signal.reason);
+			else state.iterator = iterator;
+		} catch (error) {
+			this.#failSubscription(state, options.signal, controller, error);
+		}
+	}
+	#change(controller, signal, state) {
+		if (signal.aborted || state.failure !== void 0 || state.frame !== void 0) return;
+		const notification = {
+			jsonrpc: "2.0",
+			method: "notifications/tools/list_changed"
+		};
+		state.frame = notification;
+		controller.enqueue(notification);
+	}
+	async #pullSubscription(notifications, options, state, controller) {
+		try {
+			if (options.signal.aborted) return;
+			const next = await state.iterator?.next();
+			if (options.signal.aborted) return;
+			if (next === void 0 || next.done === true) {
+				state.iterator = void 0;
+				if (notifications.toolsListChanged !== true) controller.close();
+				return;
+			}
+			const owned = parseJSONRPCMessage(next.value, {
+				bytes: this.#limits.message,
+				depth: this.#limits.depth
+			});
+			controller.enqueue(owned !== void 0 && isJSONRPCNotification(owned) && owned.method !== "notifications/tools/list_changed" && matchesSubscriptionNotification(owned, notifications) ? owned : void 0);
+		} catch (error) {
+			this.#failSubscription(state, options.signal, controller, error);
+		}
+	}
+	#failSubscription(state, signal, controller, error) {
+		if (signal.aborted) return;
+		state.failure = { error };
+		controller.close();
+	}
+	#releaseProducer(iterator, reason) {
+		iterator.return?.(reason)?.catch(() => void 0);
+	}
 	#readTaskId(request) {
 		const id = request.id;
 		const context = parseRequestContext(request, {
@@ -5951,9 +6101,11 @@ var MCPClient = class {
 	async *#openSubscription(notifications, signal, capacity) {
 		signal.throwIfAborted();
 		if (!isInteger(capacity) || capacity < 1) throw new MCPError("MCP subscription capacity must be a positive integer", JSONRPC_INVALID_PARAMS);
+		const method = "subscriptions/listen";
+		const opening = this.#refuse(method);
+		if (opening !== void 0) throw opening;
 		this.#nextId += 1;
 		const id = this.#nextId;
-		const method = "subscriptions/listen";
 		const modern = this.#version;
 		const request = {
 			jsonrpc: "2.0",
@@ -6001,7 +6153,16 @@ var MCPClient = class {
 			this.#cancelSubscription(id, /* @__PURE__ */ new Error("MCP subscription closed by its consumer"));
 		}
 	}
+	#refuse(method) {
+		if (method === "server/discover") return void 0;
+		if (this.#connected) return void 0;
+		const inflight = this.#connecting;
+		if (inflight !== void 0 && inflight.generation === this.#generation) return void 0;
+		return new MCPError(`MCP client is not connected, so '${method}' was not issued`, JSONRPC_INVALID_REQUEST);
+	}
 	#request(method, params, deadline, version, options) {
+		const refusal = this.#refuse(method);
+		if (refusal !== void 0) return Promise.reject(refusal);
 		this.#nextId += 1;
 		const id = this.#nextId;
 		const timeout = deadline;
@@ -6055,7 +6216,7 @@ var MCPClient = class {
 				...report === void 0 ? {} : { progress: report }
 			});
 			this.#transport.send(request).catch((error) => {
-				this.#settle(id, error instanceof Error ? error : new Error(String(error)), true);
+				this.#settle(id, isError(error) ? error : new Error(String(error)), true);
 			});
 		});
 	}
@@ -6143,16 +6304,20 @@ var MCPClient = class {
 	#tool(name, descriptor) {
 		const inputSchema = descriptor["inputSchema"];
 		const description = descriptor["description"];
-		const options = {
+		const title = descriptor["title"];
+		const annotations = descriptor["annotations"];
+		const projected = isMCPToolAnnotations(annotations) ? mcpAnnotationsToTool(annotations) : {};
+		return new Tool({
 			name,
+			...isString(title) ? { title } : {},
+			...isString(description) ? { description } : {},
+			...isRecord(inputSchema) ? { parameters: inputSchema } : {},
+			...Object.keys(projected).length === 0 ? {} : { annotations: projected },
 			execute: this.#execute.bind(this, name)
-		};
-		if (isString(description)) options.description = description;
-		if (isRecord(inputSchema)) options.parameters = inputSchema;
-		return new Tool(options);
+		});
 	}
-	async #execute(name, args) {
-		const outcome = await this.call(name, args);
+	async #execute(name, args, context) {
+		const outcome = await this.call(name, args, { signal: context.signal });
 		if (outcome.resultType !== "complete") throw new Error(`MCP tool '${name}' answered '${outcome.resultType}' and has no inline value`);
 		return outcome.value;
 	}
@@ -6696,6 +6861,6 @@ function createDuplexClientTransport(transport) {
 	};
 }
 //#endregion
-export { DEFAULT_MCP_CACHE_TTL, DEFAULT_MCP_CLIENT_NAME, DEFAULT_MCP_CLIENT_VERSION, DEFAULT_MCP_LIMITS, DEFAULT_MCP_REQUEST_TIMEOUT, DEFAULT_MCP_SUBSCRIPTION_CAPACITY, EMPTY_MCP_ARGUMENTS, HTTPClientTransport, JSONRPC_INTERNAL_ERROR, JSONRPC_INVALID_PARAMS, JSONRPC_INVALID_REQUEST, JSONRPC_METHOD_NOT_FOUND, JSONRPC_PARSE_ERROR, JSONRPC_SERVER_ERROR, MCPClient, MCPError, MCPLegacy, MCPLegacyClientTransport, MCPMethodManager, MCPProgressReporter, MCPServer, MCPStreamController, MCPTaskClient, MCPTextStreamController, MCP_EXTENSION_TASKS, MCP_FALLBACK_VERSION, MCP_HANDSHAKE_VERSION, MCP_HEADER_ANNOTATION, MCP_HEADER_MISMATCH, MCP_LOOKUP_PAGES, MCP_META_CAPABILITIES, MCP_META_CLIENT, MCP_META_SERVER, MCP_META_SUBSCRIPTION, MCP_META_VERSION, MCP_METHOD_HEADER, MCP_MISSING_CAPABILITY, MCP_MODERN_VERSION, MCP_NAME_HEADER, MCP_PARAM_PREFIX, MCP_PROTOCOL_VERSION_HEADER, MCP_SENTINEL_PREFIX, MCP_SENTINEL_SUFFIX, MCP_SESSION_HEADER, MCP_UNSUPPORTED_VERSION, MCP_WEBSOCKET_SUBPROTOCOL, SUPPORTED_LEGACY_PROTOCOL_VERSIONS, SUPPORTED_MCP_VERSIONS, SUPPORTED_MODERN_PROTOCOL_VERSIONS, bindClient, bindServer, buildCallOutcome, buildCancelledNotification, buildDiscoverResult, buildHeaderParameters, buildHeaderProjection, buildInitializeResult, buildJSONRPCError, buildJSONRPCResult, buildMethodOptions, buildModernResult, buildProgressNotification, buildResponseError, buildSubscriptionAcknowledgement, buildSubscriptionFilter, buildSubscriptionResult, buildToolCall, buildToolDescriptors, computeMissingCapabilities, countHeaderAnnotations, createDuplexClientTransport, createMCPClient, createMCPLegacy, createMCPLegacyClientTransport, createMCPServer, decodeBoundedMessage, decodeEvent, decodeSentinel, deliverMessage, digestJSON, encodeSentinel, extractContentText, extractHeaderAnnotations, extractToolSchema, inferEra, inferRequestEra, inferRequestVersion, inferVersion, isAbsoluteURI, isBoundedJSON, isBoundedString, isElicitContent, isFieldToken, isInitializeRequest, isJSONObject, isJSONRPCError, isJSONRPCErrorResponse, isJSONRPCId, isJSONRPCInvocation, isJSONRPCMessage, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse, isJSONRPCResultResponse, isMCPAnnotations, isMCPBlobResource, isMCPCallResult, isMCPClientCapabilities, isMCPCompletion, isMCPCompletionParams, isMCPCompletionReference, isMCPCompletionResult, isMCPContent, isMCPElicitFieldSchema, isMCPElicitForm, isMCPElicitRequest, isMCPElicitResult, isMCPElicitSchema, isMCPElicitURL, isMCPError, isMCPHeaderPrimitive, isMCPIcon, isMCPIdentity, isMCPInputRequest, isMCPInputRequestMap, isMCPInputResponse, isMCPInputResult, isMCPLegacyResult, isMCPLegacyVersion, isMCPLoggingLevel, isMCPMetaKey, isMCPMetaObject, isMCPModernVersion, isMCPNotificationMetaObject, isMCPPaginationParams, isMCPProgress, isMCPPrompt, isMCPPromptArgument, isMCPPromptGetResult, isMCPPromptMessage, isMCPPromptPage, isMCPResource, isMCPResourceContents, isMCPResourcePage, isMCPResourceTemplate, isMCPResourceTemplatePage, isMCPResult, isMCPResultMetaObject, isMCPRoot, isMCPRootResult, isMCPSampleContent, isMCPSampleResult, isMCPServerCapabilities, isMCPStringArguments, isMCPSubscriptionFilter, isMCPSubscriptionResult, isMCPTaskDetail, isMCPTaskDetailResult, isMCPTaskNotification, isMCPTaskResult, isMCPTaskStatus, isMCPTextResource, isMCPVersion, isModernRequest, isRFC3339Date, isRFC3339DateTime, isStandardBase64, legacyInvocationToModern, legacyResultToModern, matchesResultType, matchesSubscriptionNotification, modernInvocationToLegacy, modernResultToLegacy, parseJSONRPCMessage, parseMCPInputState, parseRequestContext, readCancelledId, readEventStream, renderHeaderValue, sendStream, serializeJSON, snapshotJSON, snapshotToolResult, stampSubscriptionNotification, supportsFormElicitation, supportsTask };
+export { DEFAULT_MCP_CACHE_TTL, DEFAULT_MCP_CLIENT_NAME, DEFAULT_MCP_CLIENT_VERSION, DEFAULT_MCP_LIMITS, DEFAULT_MCP_REQUEST_TIMEOUT, DEFAULT_MCP_SUBSCRIPTION_CAPACITY, EMPTY_MCP_ARGUMENTS, HTTPClientTransport, JSONRPC_INTERNAL_ERROR, JSONRPC_INVALID_PARAMS, JSONRPC_INVALID_REQUEST, JSONRPC_METHOD_NOT_FOUND, JSONRPC_PARSE_ERROR, JSONRPC_SERVER_ERROR, MCPClient, MCPError, MCPLegacy, MCPLegacyClientTransport, MCPMethodManager, MCPProgressReporter, MCPServer, MCPStreamController, MCPTaskClient, MCPTextStreamController, MCP_EXTENSION_TASKS, MCP_FALLBACK_VERSION, MCP_HANDSHAKE_VERSION, MCP_HEADER_ANNOTATION, MCP_HEADER_MISMATCH, MCP_LOOKUP_PAGES, MCP_META_CAPABILITIES, MCP_META_CLIENT, MCP_META_SERVER, MCP_META_SUBSCRIPTION, MCP_META_VERSION, MCP_METHOD_HEADER, MCP_MISSING_CAPABILITY, MCP_MODERN_VERSION, MCP_NAME_HEADER, MCP_PARAM_PREFIX, MCP_PROTOCOL_VERSION_HEADER, MCP_SENTINEL_PREFIX, MCP_SENTINEL_SUFFIX, MCP_SESSION_HEADER, MCP_UNSUPPORTED_VERSION, MCP_WEBSOCKET_SUBPROTOCOL, SUPPORTED_LEGACY_PROTOCOL_VERSIONS, SUPPORTED_MCP_VERSIONS, SUPPORTED_MODERN_PROTOCOL_VERSIONS, bindClient, bindServer, buildCallOutcome, buildCancelledNotification, buildDiscoverResult, buildHeaderParameters, buildHeaderProjection, buildInitializeResult, buildJSONRPCError, buildJSONRPCResult, buildMethodOptions, buildModernResult, buildProgressNotification, buildResponseError, buildSubscriptionAcknowledgement, buildSubscriptionFilter, buildSubscriptionResult, buildToolCall, buildToolDescriptors, computeMissingCapabilities, countHeaderAnnotations, createDuplexClientTransport, createMCPClient, createMCPLegacy, createMCPLegacyClientTransport, createMCPServer, decodeBoundedMessage, decodeEvent, decodeSentinel, deliverMessage, digestJSON, encodeSentinel, extractContentText, extractHeaderAnnotations, extractToolSchema, inferEra, inferRequestEra, inferRequestVersion, inferVersion, isAbsoluteURI, isBoundedJSON, isBoundedString, isElicitContent, isFieldToken, isInitializeRequest, isJSONObject, isJSONRPCError, isJSONRPCErrorResponse, isJSONRPCId, isJSONRPCInvocation, isJSONRPCMessage, isJSONRPCNotification, isJSONRPCRequest, isJSONRPCResponse, isJSONRPCResultResponse, isMCPAnnotations, isMCPBlobResource, isMCPCallResult, isMCPClientCapabilities, isMCPCompletion, isMCPCompletionParams, isMCPCompletionReference, isMCPCompletionResult, isMCPConsumerFilter, isMCPContent, isMCPElicitFieldSchema, isMCPElicitForm, isMCPElicitRequest, isMCPElicitResult, isMCPElicitSchema, isMCPElicitURL, isMCPError, isMCPHeaderPrimitive, isMCPIcon, isMCPIdentity, isMCPInputRequest, isMCPInputRequestMap, isMCPInputResponse, isMCPInputResult, isMCPLegacyResult, isMCPLegacyVersion, isMCPLoggingLevel, isMCPMetaKey, isMCPMetaObject, isMCPModernVersion, isMCPNotificationMetaObject, isMCPPaginationParams, isMCPProgress, isMCPPrompt, isMCPPromptArgument, isMCPPromptGetResult, isMCPPromptMessage, isMCPPromptPage, isMCPResource, isMCPResourceContents, isMCPResourcePage, isMCPResourceTemplate, isMCPResourceTemplatePage, isMCPResult, isMCPResultMetaObject, isMCPRoot, isMCPRootResult, isMCPSampleContent, isMCPSampleResult, isMCPServerCapabilities, isMCPStringArguments, isMCPSubscriptionFilter, isMCPSubscriptionResult, isMCPTaskDetail, isMCPTaskDetailResult, isMCPTaskNotification, isMCPTaskResult, isMCPTaskStatus, isMCPTextResource, isMCPToolAnnotations, isMCPVersion, isModernRequest, isRFC3339Date, isRFC3339DateTime, isStandardBase64, legacyInvocationToModern, legacyResultToModern, matchesResultType, matchesSubscriptionNotification, mcpAnnotationsToTool, modernInvocationToLegacy, modernResultToLegacy, parseJSONRPCMessage, parseMCPInputState, parseRequestContext, readCancelledId, readEventStream, renderHeaderValue, sendStream, serializeJSON, snapshotJSON, snapshotToolResult, stampSubscriptionNotification, supportsFormElicitation, supportsTask, toolAnnotationsToMCP };
 
 //# sourceMappingURL=index.js.map