@lovable.dev/mcp-js 0.29.0-rc.4 → 0.30.0-rc.0

package/dist/schema-D3vClxb7.cjs

@@ -0,0 +1,76 @@
+let _modelcontextprotocol_sdk_server_zod_compat_js = require("@modelcontextprotocol/sdk/server/zod-compat.js");
+let _modelcontextprotocol_sdk_server_zod_json_schema_compat_js = require("@modelcontextprotocol/sdk/server/zod-json-schema-compat.js");
+//#region src/core/schema.ts
+function isZodSchema(definition) {
+	return (typeof definition === "object" || typeof definition === "function") && definition !== null && typeof definition.safeParse === "function";
+}
+function schemaFromDefinition(definition) {
+	return isZodSchema(definition) ? definition : (0, _modelcontextprotocol_sdk_server_zod_compat_js.objectFromShape)(definition);
+}
+const NON_JSON_ZOD3_OUTPUTS = /* @__PURE__ */ new Set([
+	"ZodBigInt",
+	"ZodDate",
+	"ZodFunction",
+	"ZodMap",
+	"ZodNaN",
+	"ZodPromise",
+	"ZodSet",
+	"ZodSymbol",
+	"ZodUndefined",
+	"ZodVoid"
+]);
+function unsupportedZod3Output(schema, seen = /* @__PURE__ */ new Set()) {
+	if (seen.has(schema)) return void 0;
+	seen.add(schema);
+	const definition = schema._def;
+	if (!definition) return void 0;
+	if (definition.effect?.type === "transform") return "Transforms cannot be represented in JSON Schema";
+	const typeName = definition.typeName;
+	if (typeof typeName === "string" && NON_JSON_ZOD3_OUTPUTS.has(typeName)) return `${typeName} does not produce a JSON value`;
+	const shape = definition.shape;
+	if (typeof shape === "function") {
+		const fields = shape();
+		for (const field of Object.values(fields)) {
+			const issue = unsupportedZod3Output(field, seen);
+			if (issue) return issue;
+		}
+	}
+	const getter = definition.getter;
+	if (typeof getter === "function") {
+		const issue = unsupportedZod3Output(getter(), seen);
+		if (issue) return issue;
+	}
+	for (const value of Object.values(definition)) if (Array.isArray(value)) for (const entry of value) {
+		if (!isZodSchema(entry)) continue;
+		const issue = unsupportedZod3Output(entry, seen);
+		if (issue) return issue;
+	}
+	else if (value && typeof value === "object" && isZodSchema(value)) {
+		const issue = unsupportedZod3Output(value, seen);
+		if (issue) return issue;
+	}
+}
+function jsonSchemaFromDefinition(definition, pipeStrategy) {
+	const schema = schemaFromDefinition(definition);
+	if (pipeStrategy === "output") {
+		const issue = unsupportedZod3Output(schema);
+		if (issue) throw new Error(issue);
+	}
+	return (0, _modelcontextprotocol_sdk_server_zod_json_schema_compat_js.toJsonSchemaCompat)(schema, {
+		target: "draft-2020-12",
+		pipeStrategy
+	});
+}
+//#endregion
+Object.defineProperty(exports, "jsonSchemaFromDefinition", {
+	enumerable: true,
+	get: function() {
+		return jsonSchemaFromDefinition;
+	}
+});
+Object.defineProperty(exports, "schemaFromDefinition", {
+	enumerable: true,
+	get: function() {
+		return schemaFromDefinition;
+	}
+});

package/dist/stacks/supabase/index.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_logger = require("../../logger-CN1q-KNn.cjs");
-const require_authorize = require("../../authorize-CKMlIxm9.cjs");
+const require_cors = require("../../cors-DIQIXIHY.cjs");
 const require_metadata_path = require("../../metadata-path-zd7NSNoa.cjs");
-const require_mcp = require("../../mcp-DtHM-41c.cjs");
+const require_mcp = require("../../mcp-Dq6dXUKT.cjs");
 const require_protocols_oauth_metadata = require("../../protocols/oauth-metadata.cjs");
-const require_forwarded = require("../../forwarded-Bhwcj22u.cjs");
+const require_forwarded = require("../../forwarded-zNAIofM2.cjs");
 const require_paths = require("../../paths-OP318a6c.cjs");
 //#region src/stacks/supabase/handler.ts
 function deriveResourcePath(options) {
@@ -29,7 +29,7 @@ function isMetadataPath(pathname) {
 */
 function createSupabaseHandler(mcp, options = {}) {
 	const resourcePath = deriveResourcePath(options);
-	if (resourcePath !== void 0) require_authorize.assertResourcePathShape(resourcePath);
+	if (resourcePath !== void 0) require_cors.assertResourcePathShape(resourcePath);
 	const servesOwnPrm = !(mcp.auth?.type === "oauth" && mcp.auth.protectedResourceMetadataUrl !== void 0);
 	const metadataPath = resourcePath === void 0 || !servesOwnPrm ? void 0 : `${require_logger.trimTrailingSlash(resourcePath)}${require_metadata_path.OAUTH_PROTECTED_RESOURCE_METADATA_PATH}`;
 	const runtimeOptions = {
@@ -44,8 +44,8 @@ function createSupabaseHandler(mcp, options = {}) {
 	const metadataHandler = require_protocols_oauth_metadata.createOAuthProtectedResourceMetadataHandler(mcp, runtimeOptions);
 	return async (request) => {
 		const req = require_forwarded.applyForwardedOrigin(request, runtimeOptions);
-		if (isMetadataPath(new URL(req.url).pathname)) return metadataHandler(req);
-		return mcpHandler(req, require_authorize.createRecorderForRuntime(mcp, { stack: "supabase" }));
+		if (isMetadataPath(new URL(req.url).pathname)) return metadataHandler(req, require_cors.createRecorderForRuntime(mcp, { stack: "supabase" }));
+		return mcpHandler(req, require_cors.createRecorderForRuntime(mcp, { stack: "supabase" }));
 	};
 }
 //#endregion

package/dist/stacks/supabase/index.d.cts

@@ -1,4 +1,4 @@
-import { c as McpDefinition } from "../../types-C0Wgm9zp.cjs";
+import { d as McpDefinition } from "../../types-3CZPz364.cjs";
 //#region src/stacks/supabase/handler.d.ts
 type SupabaseHandler = (request: Request) => Promise<Response>;
 interface SupabaseHandlerOptions {

package/dist/stacks/supabase/index.d.ts

@@ -1,4 +1,4 @@
-import { c as McpDefinition } from "../../types-C0Wgm9zp.js";
+import { d as McpDefinition } from "../../types-3CZPz364.js";
 //#region src/stacks/supabase/handler.d.ts
 type SupabaseHandler = (request: Request) => Promise<Response>;
 interface SupabaseHandlerOptions {

package/dist/stacks/supabase/index.js

@@ -1,9 +1,9 @@
 import { s as trimTrailingSlash } from "../../logger-Ctv5xUSD.js";
-import { i as assertResourcePathShape, o as createRecorderForRuntime } from "../../authorize-b3VqTC_7.js";
+import { c as createRecorderForRuntime, o as assertResourcePathShape } from "../../cors-5P69YRDK.js";
 import { t as OAUTH_PROTECTED_RESOURCE_METADATA_PATH } from "../../metadata-path-CAkNcfyY.js";
-import { t as createMcpProtocolHandler } from "../../mcp-BLs6_g8i.js";
+import { t as createMcpProtocolHandler } from "../../mcp-Cb5SavFT.js";
 import { createOAuthProtectedResourceMetadataHandler } from "../../protocols/oauth-metadata.js";
-import { t as applyForwardedOrigin } from "../../forwarded-BlLF3dfc.js";
+import { t as applyForwardedOrigin } from "../../forwarded-DG83ubwT.js";
 import { n as assertFunctionName, t as FUNCTIONS_MOUNT_PREFIX } from "../../paths-IS65L6TA.js";
 //#region src/stacks/supabase/handler.ts
 function deriveResourcePath(options) {
@@ -43,7 +43,7 @@ function createSupabaseHandler(mcp, options = {}) {
 	const metadataHandler = createOAuthProtectedResourceMetadataHandler(mcp, runtimeOptions);
 	return async (request) => {
 		const req = applyForwardedOrigin(request, runtimeOptions);
-		if (isMetadataPath(new URL(req.url).pathname)) return metadataHandler(req);
+		if (isMetadataPath(new URL(req.url).pathname)) return metadataHandler(req, createRecorderForRuntime(mcp, { stack: "supabase" }));
 		return mcpHandler(req, createRecorderForRuntime(mcp, { stack: "supabase" }));
 	};
 }

package/dist/stacks/supabase/vite.cjs

@@ -2,7 +2,7 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_package = require("../../package-Xk8p8Q_E.cjs");
+const require_package = require("../../package-QViIguII.cjs");
 const require_fs_errors = require("../../fs-errors-CWNzOV75.cjs");
 const require_supabase_config = require("../../supabase-config-Dz7dnUv0.cjs");
 const require_paths = require("../../paths-OP318a6c.cjs");

package/dist/stacks/supabase/vite.d.cts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-Dx0nPc1-.cjs";
+import { t as McpPluginApi } from "../../io-CDV3mud0.cjs";
 import { Plugin } from "vite";
 //#region src/stacks/supabase/vite.d.ts
 interface McpPluginOptions {

package/dist/stacks/supabase/vite.d.ts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-DP3icuxa.js";
+import { t as McpPluginApi } from "../../io-D_5cuaEL.js";
 import { Plugin } from "vite";
 //#region src/stacks/supabase/vite.d.ts
 interface McpPluginOptions {

package/dist/stacks/supabase/vite.js

@@ -1,4 +1,4 @@
-import { t as version } from "../../package-DMs4EVwG.js";
+import { t as version } from "../../package-ZFJI6B7S.js";
 import { t as isFileMissing } from "../../fs-errors-PA2t1TIp.js";
 import { t as readSupabaseProjectRef } from "../../supabase-config-CakTU8YF.js";
 import { n as assertFunctionName, t as FUNCTIONS_MOUNT_PREFIX } from "../../paths-IS65L6TA.js";

package/dist/stacks/tanstack/index.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_authorize = require("../../authorize-CKMlIxm9.cjs");
-const require_mcp = require("../../mcp-DtHM-41c.cjs");
+const require_cors = require("../../cors-DIQIXIHY.cjs");
+const require_mcp = require("../../mcp-Dq6dXUKT.cjs");
 const require_protocols_oauth_metadata = require("../../protocols/oauth-metadata.cjs");
-const require_forwarded = require("../../forwarded-Bhwcj22u.cjs");
+const require_forwarded = require("../../forwarded-zNAIofM2.cjs");
 //#region src/stacks/tanstack/handlers.ts
 const STACK = "tanstack";
 /**
@@ -11,7 +11,7 @@ const STACK = "tanstack";
 */
 function createTanStackMcpHandler(mcp, options = {}) {
 	const handler = require_mcp.createMcpProtocolHandler(mcp, options);
-	return ({ request }) => handler(require_forwarded.applyForwardedOrigin(request, options), require_authorize.createRecorderForRuntime(mcp, { stack: STACK }));
+	return ({ request }) => handler(require_forwarded.applyForwardedOrigin(request, options), require_cors.createRecorderForRuntime(mcp, { stack: STACK }));
 }
 /**
 * Build a TanStack Start handler for `GET /.well-known/oauth-protected-resource`.
@@ -19,7 +19,7 @@ function createTanStackMcpHandler(mcp, options = {}) {
 */
 function createTanStackOAuthProtectedResourceMetadataHandler(mcp, options = {}) {
 	const handler = require_protocols_oauth_metadata.createOAuthProtectedResourceMetadataHandler(mcp, options);
-	return ({ request }) => handler(require_forwarded.applyForwardedOrigin(request, options));
+	return ({ request }) => handler(require_forwarded.applyForwardedOrigin(request, options), require_cors.createRecorderForRuntime(mcp, { stack: STACK }));
 }
 //#endregion
 exports.createTanStackMcpHandler = createTanStackMcpHandler;

package/dist/stacks/tanstack/index.d.cts

@@ -1,5 +1,5 @@
-import { c as McpDefinition } from "../../types-C0Wgm9zp.cjs";
-import { t as McpRuntimeOptions } from "../../authorize-DIYS7zBP.cjs";
+import { d as McpDefinition } from "../../types-3CZPz364.cjs";
+import { t as McpRuntimeOptions } from "../../authorize-9hTTG-qJ.cjs";
 //#region src/stacks/tanstack/handlers.d.ts
 interface TanStackRouteCtx {
   request: Request;

package/dist/stacks/tanstack/index.d.ts

@@ -1,5 +1,5 @@
-import { c as McpDefinition } from "../../types-C0Wgm9zp.js";
-import { t as McpRuntimeOptions } from "../../authorize-CqYsQYfa.js";
+import { d as McpDefinition } from "../../types-3CZPz364.js";
+import { t as McpRuntimeOptions } from "../../authorize-DNUlPT7k.js";
 //#region src/stacks/tanstack/handlers.d.ts
 interface TanStackRouteCtx {
   request: Request;

package/dist/stacks/tanstack/index.js

@@ -1,7 +1,7 @@
-import { o as createRecorderForRuntime } from "../../authorize-b3VqTC_7.js";
-import { t as createMcpProtocolHandler } from "../../mcp-BLs6_g8i.js";
+import { c as createRecorderForRuntime } from "../../cors-5P69YRDK.js";
+import { t as createMcpProtocolHandler } from "../../mcp-Cb5SavFT.js";
 import { createOAuthProtectedResourceMetadataHandler } from "../../protocols/oauth-metadata.js";
-import { t as applyForwardedOrigin } from "../../forwarded-BlLF3dfc.js";
+import { t as applyForwardedOrigin } from "../../forwarded-DG83ubwT.js";
 //#region src/stacks/tanstack/handlers.ts
 const STACK = "tanstack";
 /**
@@ -18,7 +18,7 @@ function createTanStackMcpHandler(mcp, options = {}) {
 */
 function createTanStackOAuthProtectedResourceMetadataHandler(mcp, options = {}) {
 	const handler = createOAuthProtectedResourceMetadataHandler(mcp, options);
-	return ({ request }) => handler(applyForwardedOrigin(request, options));
+	return ({ request }) => handler(applyForwardedOrigin(request, options), createRecorderForRuntime(mcp, { stack: STACK }));
 }
 //#endregion
 export { createTanStackMcpHandler, createTanStackOAuthProtectedResourceMetadataHandler };

package/dist/stacks/tanstack/vite.cjs

@@ -64,13 +64,16 @@ function relativeImportSpecifier(routeFile, target) {
 	const withoutExt = normalizePath((0, node_path.relative)((0, node_path.dirname)(routeFile), target)).replace(/\.ts$/, "");
 	return withoutExt.startsWith(".") ? withoutExt : `./${withoutExt}`;
 }
-function buildRouteSource(route, resourcePath, metadataPath, trustForwardedHost, mcpEntry, projectRoot) {
+function buildRouteSource(route, resourcePath, metadataPath, trustForwardedHost, trustForwardedProto, mcpEntry, projectRoot) {
 	const mcpImport = relativeImportSpecifier(route.file, mcpEntry);
 	const routeRel = normalizePath((0, node_path.relative)(projectRoot, route.file));
 	const optionEntries = [`resourcePath: "${resourcePath}"`];
 	if (metadataPath !== void 0) optionEntries.push(`metadataPath: "${metadataPath}"`);
-	if (trustForwardedHost) if (route.attestsForwardedHost) optionEntries.push("// Trusting X-Forwarded-Host is safe on Lovable hosting only (its proxy\n        // overwrites the header); remove both options behind other proxies.\n        trustForwardedHost: true", "forwardedHostTrustedByPlatform: true");
-	else optionEntries.push("trustForwardedHost: true");
+	if (trustForwardedHost) if (route.attestsForwardedHost) {
+		const trustNote = trustForwardedProto ? "// Trusting X-Forwarded-Host/-Proto is safe on Lovable hosting only (its\n        // proxies overwrite both headers); remove these options behind other proxies." : "// Trusting X-Forwarded-Host is safe on Lovable hosting only (its proxy\n        // overwrites the header); remove both options behind other proxies.";
+		optionEntries.push(`${trustNote}\n        trustForwardedHost: true`, "forwardedHostTrustedByPlatform: true");
+	} else optionEntries.push("trustForwardedHost: true");
+	if (trustForwardedProto) optionEntries.push("trustForwardedProto: true");
 	const optionsObject = `{\n${optionEntries.map((entry) => `        ${entry},`).join("\n")}\n      }`;
 	const inlineRouteOpen = `export const Route = createFileRoute("${route.routeLiteral}")({`;
 	const routeOpen = inlineRouteOpen.length <= OXFMT_PRINT_WIDTH ? inlineRouteOpen : `export const Route = createFileRoute(\n  "${route.routeLiteral}",\n)({`;
@@ -176,6 +179,7 @@ function mcpPlugin(options = {}) {
 	const metadataUrlPath = canonicalUrlPath(options.metadataPath ?? "/.well-known/oauth-protected-resource");
 	const injectedMetadataPath = emitProtectedResourceMetadataRoute ? metadataUrlPath : void 0;
 	const trustForwardedHost = options.trustForwardedHost !== false;
+	const trustForwardedProto = options.trustForwardedProto !== false;
 	let projectRoot = process.cwd();
 	let mcpEntry = (0, node_path.resolve)(projectRoot, mcpEntryOption);
 	let { routesDir, mcpRouteFile, metadataRouteFile } = resolveAllRoutes(projectRoot, routesDirOption, routeFileName, metadataUrlPath);
@@ -202,7 +206,7 @@ function mcpPlugin(options = {}) {
 			});
 			for (const route of routes) {
 				expected.add(route.file);
-				writeIfChanged(route.file, buildRouteSource(route, urlPath, injectedMetadataPath, trustForwardedHost, mcpEntry, projectRoot));
+				writeIfChanged(route.file, buildRouteSource(route, urlPath, injectedMetadataPath, trustForwardedHost, trustForwardedProto, mcpEntry, projectRoot));
 			}
 		}
 		for (const file of findAdoptedFiles(routesDir)) if (!expected.has(file)) try {

package/dist/stacks/tanstack/vite.d.cts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-Dx0nPc1-.cjs";
+import { t as McpPluginApi } from "../../io-CDV3mud0.cjs";
 import { Plugin } from "vite";
 //#region src/stacks/tanstack/vite.d.ts
 interface McpPluginOptions {
@@ -57,6 +57,9 @@ interface McpPluginOptions {
    * @default true
    */
   trustForwardedHost?: boolean;
+  /** Derive the public scheme from `X-Forwarded-Proto`; safe only behind an
+   * overwriting proxy. @default true */
+  trustForwardedProto?: boolean;
 }
 declare function assertUrlPathShape(urlPath: string): string;
 declare function deriveRouteFileName(urlPath: string): string;

package/dist/stacks/tanstack/vite.d.ts

@@ -1,4 +1,4 @@
-import { t as McpPluginApi } from "../../io-DP3icuxa.js";
+import { t as McpPluginApi } from "../../io-D_5cuaEL.js";
 import { Plugin } from "vite";
 //#region src/stacks/tanstack/vite.d.ts
 interface McpPluginOptions {
@@ -57,6 +57,9 @@ interface McpPluginOptions {
    * @default true
    */
   trustForwardedHost?: boolean;
+  /** Derive the public scheme from `X-Forwarded-Proto`; safe only behind an
+   * overwriting proxy. @default true */
+  trustForwardedProto?: boolean;
 }
 declare function assertUrlPathShape(urlPath: string): string;
 declare function deriveRouteFileName(urlPath: string): string;

package/dist/stacks/tanstack/vite.js

@@ -60,13 +60,16 @@ function relativeImportSpecifier(routeFile, target) {
 	const withoutExt = normalizePath(relative(dirname(routeFile), target)).replace(/\.ts$/, "");
 	return withoutExt.startsWith(".") ? withoutExt : `./${withoutExt}`;
 }
-function buildRouteSource(route, resourcePath, metadataPath, trustForwardedHost, mcpEntry, projectRoot) {
+function buildRouteSource(route, resourcePath, metadataPath, trustForwardedHost, trustForwardedProto, mcpEntry, projectRoot) {
 	const mcpImport = relativeImportSpecifier(route.file, mcpEntry);
 	const routeRel = normalizePath(relative(projectRoot, route.file));
 	const optionEntries = [`resourcePath: "${resourcePath}"`];
 	if (metadataPath !== void 0) optionEntries.push(`metadataPath: "${metadataPath}"`);
-	if (trustForwardedHost) if (route.attestsForwardedHost) optionEntries.push("// Trusting X-Forwarded-Host is safe on Lovable hosting only (its proxy\n        // overwrites the header); remove both options behind other proxies.\n        trustForwardedHost: true", "forwardedHostTrustedByPlatform: true");
-	else optionEntries.push("trustForwardedHost: true");
+	if (trustForwardedHost) if (route.attestsForwardedHost) {
+		const trustNote = trustForwardedProto ? "// Trusting X-Forwarded-Host/-Proto is safe on Lovable hosting only (its\n        // proxies overwrite both headers); remove these options behind other proxies." : "// Trusting X-Forwarded-Host is safe on Lovable hosting only (its proxy\n        // overwrites the header); remove both options behind other proxies.";
+		optionEntries.push(`${trustNote}\n        trustForwardedHost: true`, "forwardedHostTrustedByPlatform: true");
+	} else optionEntries.push("trustForwardedHost: true");
+	if (trustForwardedProto) optionEntries.push("trustForwardedProto: true");
 	const optionsObject = `{\n${optionEntries.map((entry) => `        ${entry},`).join("\n")}\n      }`;
 	const inlineRouteOpen = `export const Route = createFileRoute("${route.routeLiteral}")({`;
 	const routeOpen = inlineRouteOpen.length <= OXFMT_PRINT_WIDTH ? inlineRouteOpen : `export const Route = createFileRoute(\n  "${route.routeLiteral}",\n)({`;
@@ -172,6 +175,7 @@ function mcpPlugin(options = {}) {
 	const metadataUrlPath = canonicalUrlPath(options.metadataPath ?? "/.well-known/oauth-protected-resource");
 	const injectedMetadataPath = emitProtectedResourceMetadataRoute ? metadataUrlPath : void 0;
 	const trustForwardedHost = options.trustForwardedHost !== false;
+	const trustForwardedProto = options.trustForwardedProto !== false;
 	let projectRoot = process.cwd();
 	let mcpEntry = resolve(projectRoot, mcpEntryOption);
 	let { routesDir, mcpRouteFile, metadataRouteFile } = resolveAllRoutes(projectRoot, routesDirOption, routeFileName, metadataUrlPath);
@@ -198,7 +202,7 @@ function mcpPlugin(options = {}) {
 			});
 			for (const route of routes) {
 				expected.add(route.file);
-				writeIfChanged(route.file, buildRouteSource(route, urlPath, injectedMetadataPath, trustForwardedHost, mcpEntry, projectRoot));
+				writeIfChanged(route.file, buildRouteSource(route, urlPath, injectedMetadataPath, trustForwardedHost, trustForwardedProto, mcpEntry, projectRoot));
 			}
 		}
 		for (const file of findAdoptedFiles(routesDir)) if (!expected.has(file)) try {

package/dist/{types-C0Wgm9zp.d.cts → types-3CZPz364.d.cts}

@@ -85,16 +85,49 @@ interface McpAuthConfig {
 }
 //#endregion
 //#region src/auth/context.d.ts
-/**
- * The auth surface passed to every tool handler as its second argument. It wraps
- * the verified per-request auth context in a private field, so the context — and
- * the bearer token inside it — can't be read, enumerated, spread, or
- * `JSON.stringify`'d off the instance; the accessors below are the only way out.
- * `getToken()` is the single intentional escape hatch for the raw bearer.
- */
+/** Protocol era of an in-flight request: self-describing `2026-07-28` or the
+ * initialization-era `legacy` fallback. */
+type McpProtocolEra = "2026-07-28" | "legacy";
+/** What the client declared about itself on the in-flight request. Unverified
+ * client input — a hint, never an authorization signal (use the auth accessors). */
+interface McpClientInfo {
+  /** Protocol era of the in-flight request. */
+  protocol: McpProtocolEra;
+  /** Client name/version from the request envelope (`2026-07-28` era only). */
+  info?: {
+    name: string;
+    version: string;
+    title?: string;
+  };
+  /** Client capabilities from the request envelope (`2026-07-28` era only). */
+  capabilities?: Record<string, unknown>;
+  /** Extension declarations (`capabilities.extensions`), keyed by extension id. */
+  extensions?: Record<string, Record<string, unknown>>;
+}
+/** A progress notification payload. `progress` should increase monotonically. */
+interface ProgressUpdate {
+  progress: number;
+  total?: number;
+  message?: string;
+}
+/** Per-request runtime surface threaded into `ToolContext` by the protocol layer. */
+interface ToolRequestContext {
+  signal?: AbortSignal;
+  client?: McpClientInfo;
+  sendProgress?: (update: ProgressUpdate) => Promise<void>;
+}
+/** The per-request context passed to every tool handler as its second argument. The
+ * auth context lives in a private field so the accessors are the only way out; `getToken()` is the sole bearer escape hatch. */
 declare class ToolContext {
   #private;
-  constructor(auth: McpAuthContext | undefined);
+  constructor(auth: McpAuthContext | undefined, request?: ToolRequestContext);
+  /** Aborts when the client cancels the request or disconnects. */
+  get signal(): AbortSignal;
+  /** What the client declared about itself on this request. Unverified input. */
+  get client(): McpClientInfo;
+  /** Send a progress notification for this call. A no-op when the client
+   * didn't request progress (no `progressToken` on the request). */
+  progress(update: ProgressUpdate): Promise<void>;
   /** Whether the in-flight tool call carries a verified auth context. */
   isAuthenticated(): boolean;
   /** The verified bearer token, or `undefined` when unauthenticated. Pass it to downstream APIs; never return or log it. */
@@ -148,11 +181,10 @@ type MetricsConfig = boolean | MetricsOptions;
  * `inputSchema`, use `ZodRawShape`.
  */
 type ZodSchema = ZodType;
-/**
- * A raw zod shape (`{ text: z.string(), n: z.number() }`) — the format
- * `defineTool`'s `inputSchema`/`outputSchema` expects.
- */
+/** A raw zod shape (`{ text: z.string() }`) — the format `defineTool`'s
+ *  `inputSchema` expects and the object shorthand accepted by `outputSchema`. */
 type ZodRawShape$1 = ZodRawShape;
+type ZodOutputSchema = ZodSchema | ZodRawShape$1;
 /**
  * Infer the parsed-output type of a zod raw shape — given
  * `{ text: ZodString, n: ZodNumber }`, produces `{ text: string, n: number }`.
@@ -217,8 +249,8 @@ type EmbeddedResource = EmbeddedTextResource | EmbeddedBlobResource;
 interface ResourceLinkIcon {
   src: string;
   mimeType?: string;
-  /** Space-separated dimension string, HTML `<link sizes>` convention (e.g. `"16x16 32x32"`). */
-  sizes?: string;
+  /** Array per MCP 2026-07-28; legacy space-separated strings remain accepted. */
+  sizes?: string | string[];
   theme?: "light" | "dark";
 }
 interface ResourceLink extends ContentBlockBase {
@@ -241,6 +273,15 @@ type ContentBlock = TextContent | ImageContent | AudioContent | EmbeddedResource
  * the tool returns to the caller.
  */
 type ToolContent = ContentBlock[];
+type JsonValue = null | boolean | number | string | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+/** Handler-input relaxation of `JsonValue`: object properties may be `undefined`
+ * (they serialize away, matching `JSON.stringify` semantics). */
+type JsonValueInput = null | boolean | number | string | JsonValueInput[] | {
+  [key: string]: JsonValueInput | undefined;
+};
+type McpAllowedOrigins = "any" | readonly string[];
 /**
  * Per-tool client hints (not enforcement). `annotations.title` is
  * intentionally omitted — use `ToolDefinition.title`, which the MCP
@@ -258,10 +299,10 @@ interface ToolAnnotations {
 }
 interface ToolHandlerResult {
   content?: ToolContent;
-  structuredContent?: Record<string, unknown>;
+  structuredContent?: JsonValueInput;
   isError?: boolean;
 }
-interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined> {
+interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$1 | undefined, TOutput extends ZodOutputSchema | undefined = ZodOutputSchema | undefined> {
   readonly name: string;
   /** Human-readable display name shown to the user in MCP clients. Required. */
   readonly title: string;
@@ -272,32 +313,27 @@ interface ToolDefinition<TInput extends ZodRawShape$1 | undefined = ZodRawShape$
   readonly annotations?: ToolAnnotations;
   readonly handler: TInput extends ZodRawShape$1 ? (args: ShapeOutput<TInput>, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult> : (args: Record<string, never> | undefined, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult>;
 }
-/**
- * Type-erased element of `McpDefinition.tools`. Per-tool generic typing
- * happens at the `defineTool` call site; see README §6 for the rationale.
- */
+/** Type-erased element of `McpDefinition.tools`; per-tool generic typing
+ * happens at the `defineTool` call site. */
 interface AnyToolDefinition {
   readonly name: string;
   readonly title: string;
   readonly description: string;
   readonly inputSchema?: ZodRawShape$1;
-  readonly outputSchema?: ZodRawShape$1;
+  readonly outputSchema?: ZodOutputSchema;
   readonly annotations?: ToolAnnotations;
   readonly handler: (args: any, ctx: ToolContext) => ToolHandlerResult | Promise<ToolHandlerResult>;
 }
-/**
- * Fields a caller supplies when constructing an MCP definition. Pass this
- * shape to `defineMcp(...)` — its return type is the branded `McpDefinition`,
- * which is the type every internal factory (`createInvokeToolHandler`,
- * `createMcpProtocolHandler`, …) consumes. The brand forces consumers
- * through `defineMcp`'s `assertUniqueNames` + freeze.
- */
+/** Input shape for `defineMcp(...)`, whose branded `McpDefinition` return type is what
+ * `createMcpProtocolHandler` consumes — the brand forces validation + freeze. */
 interface McpDefinitionInput {
   readonly name: string;
   /** Human-readable display name shown to MCP clients. Required. */
   readonly title: string;
   readonly version: string;
   readonly auth?: McpAuthConfig;
+  /** Cross-origin browser access. Omit to allow only same-origin and non-browser requests. */
+  readonly allowedOrigins?: McpAllowedOrigins;
   /**
    * Server-level prose the LLM reads as context for all tools on this server.
    * Required for the same reason `ToolDefinition.description` is — optional
@@ -318,4 +354,4 @@ type McpDefinition = McpDefinitionInput & {
   readonly [McpDefinitionBrand]: never;
 };
 //#endregion
-export { McpAuthConfig as C, JwtClaims as S, ZodRawShape$1 as _, EmbeddedResource as a, MetricsOptions as b, McpDefinition as c, ResourceLinkIcon as d, TextContent as f, ToolHandlerResult as g, ToolDefinition as h, EmbeddedBlobResource as i, McpDefinitionInput as l, ToolContent as m, ContentAnnotations as n, EmbeddedTextResource as o, ToolAnnotations as p, ContentBlock as r, ImageContent as s, AudioContent as t, ResourceLink as u, ZodSchema as v, ToolContext as x, MetricsConfig as y };
+export { McpAuthConfig as A, MetricsConfig as C, ProgressUpdate as D, McpProtocolEra as E, ToolContext as O, ZodSchema as S, McpClientInfo as T, ToolContent as _, EmbeddedResource as a, ZodOutputSchema as b, JsonValue as c, McpDefinition as d, McpDefinitionInput as f, ToolAnnotations as g, TextContent as h, EmbeddedBlobResource as i, JwtClaims as k, JsonValueInput as l, ResourceLinkIcon as m, ContentAnnotations as n, EmbeddedTextResource as o, ResourceLink as p, ContentBlock as r, ImageContent as s, AudioContent as t, McpAllowedOrigins as u, ToolDefinition as v, MetricsOptions as w, ZodRawShape$1 as x, ToolHandlerResult as y };