@lovable.dev/mcp-js 2.0.0 → 2.0.2-rc.0

package/README.md

@@ -228,9 +228,19 @@ The request-derived `resource` default trusts the incoming `Host` to name this s
 
 Use `auth.oauth.issuer(...)`, set `resource` or `acceptedAudiences` to anchor the accepted audience, and optionally set `jwksUri` and `requiredScopes`. For Supabase project auth, set `acceptedAudiences: "authenticated"`, keep app/business checks in app code, and forward `ctx.getToken()` to Supabase for RLS-backed data access.
 
+## Security posture
+
+For anyone evaluating an app that exposes an MCP server with this package:
+
+- **Verification runs in the app runtime.** When `defineMcp({ auth })` configures OAuth, the emitted TanStack route or Supabase Edge Function verifies the bearer before dispatching a tool. Clients call the app's published endpoint; the SDK does not relay MCP calls through a shared Lovable MCP protocol gateway, although a Lovable-hosted TanStack app still receives ordinary web traffic through Lovable's hosting proxy. The SDK may fetch issuer metadata and JWKS. When default usage telemetry is emitted, it sends the operational fields described below, including the verified token `sub`; it never sends the bearer, full claims, tool arguments, or tool results.
+- **No protocol sessions.** Every HTTP request gets a fresh MCP server, auth context, and tool callback closure. The endpoint never mints a session ID or retains MCP protocol or auth session state across requests. Durable application state belongs in the app's own storage.
+- **Audience validation is explicit.** A populated token `aud` must exactly match `resource` or `acceptedAudiences`. For issuer compatibility, the default also accepts a matching `resource` claim when `aud` is absent or an empty array; set `acceptResourceClaim: false` to require a matching `aud` (strict RFC 9068).
+- **The deployment controls the SDK version.** TanStack resolves the app's declared dependency through its package manager and lockfile. The generated Supabase function exact-pins the SDK release that emitted it. Updating or regenerating the dependency and redeploying is how an app adopts a newer SDK.
+- **Controls are divided between layers.** When OAuth is configured, the SDK owns bearer verification; it also owns origin policy (`allowedOrigins`) and redacts unexpected errors. `ToolError` and returned `isError` results are intentionally caller-visible. Per-tool authorization, data access (including RLS), rate limiting, and WAF belong to the app and its host.
+
 ## Debug logging
 
-The runtime logs operational events (tool invocations, auth outcomes, warnings, errors) at `info` by default. Raise the level to `debug` to trace OAuth discovery, JWKS resolution, and token verification when a deployed MCP server returns `401`/`500` and you need to see why. Logs go to `console` (so they land in your platform's function logs) and **never include the bearer token, full claims, or PII** — only non-secret fields such as the JWT header `alg`/`kid`, `issuer`, `jwks_uri`, the token `scopes`, and `jose` error codes. End-user identifiers (the token `sub`/`client_id`) appear only at `debug`, as the `oauth.verify.principal` event — the default `info` level never collects them.
+The runtime logs operational events (tool invocations, auth outcomes, warnings, errors) at `info` by default. Raise the level to `debug` to trace OAuth discovery, JWKS resolution, and token verification when a deployed MCP server returns `401`/`500` and you need to see why. Logs go to `console` (so they land in your platform's function logs) and **never include the bearer token or full claims**. Depending on the log level, operational fields include the JWT header `alg`/`kid`, `issuer`, `jwks_uri`, token scopes, and `jose` error codes. The default `info` level excludes end-user identifiers; the token `sub`/`client_id` appears only at `debug`, as the `oauth.verify.principal` event.
 
 Enable it either way:
 
@@ -251,7 +261,7 @@ A `500` on an OAuth-protected route is always one of two causes, logged at `erro
 
 ## Usage metrics
 
-Each MCP server records per-invocation telemetry — tool name, JSON-RPC method, outcome, and latency — as **OTLP/HTTP JSON logs**, one awaited POST per record, bounded by a 3-second timeout; a failed or slow POST is logged (`metrics.failed`) and swallowed, never failing the request. Outcomes cover tool results (`ok`, `tool_error`, `handler_error`, `transport_error`), the authorization gate — `auth_challenge` for an unauthenticated request answered with the `401` challenge (so probe traffic produces records), and the `auth_*` discovery/JWKS failure outcomes — and `origin_rejected` for a request refused `403` by the origin policy. Tool-call records also carry the protocol era (`mcp.protocol`: `2026-07-28` or `legacy`); records emitted before protocol classification (auth challenges, transport errors, origin rejections) have no protocol attribute. No tool arguments or response payloads are ever captured. Emission is **on by default** and self-disables at runtime when `LOVABLE_API_KEY` is absent: records are dropped and one `metrics.disabled_no_api_key` warning is logged per process, so a local `vite dev` stays quiet. With `metrics: false` the recorder never runs — on Deno and Cloudflare Workers that also means `LOVABLE_MCP_LOG_LEVEL` is never applied (use `setLogLevel()` instead).
+Each MCP server records per-invocation telemetry — tool name, JSON-RPC method, outcome, latency, request and response sizes when available, and the verified token `sub` for authenticated calls — as **OTLP/HTTP JSON logs**, one awaited POST per record, bounded by a 3-second timeout; a failed or slow POST is logged (`metrics.failed`) and swallowed, never failing the request. Outcomes cover tool results (`ok`, `tool_error`, `handler_error`, `transport_error`), the authorization gate — `auth_challenge` for an unauthenticated request answered with the `401` challenge (so probe traffic produces records), and the `auth_*` discovery/JWKS failure outcomes — and `origin_rejected` for a request refused `403` by the origin policy. Tool-call records also carry the protocol era (`mcp.protocol`: `2026-07-28` or `legacy`); records emitted before protocol classification (auth challenges, transport errors, origin rejections) have no protocol attribute. The bearer token, full claims, tool arguments, and response payloads are never captured. Emission is **on by default** and self-disables at runtime when `LOVABLE_API_KEY` is absent: records are dropped and one `metrics.disabled_no_api_key` warning is logged per process, so a local `vite dev` stays quiet. With `metrics: false` the recorder never runs — on Deno and Cloudflare Workers that also means `LOVABLE_MCP_LOG_LEVEL` is never applied (use `setLogLevel()` instead).
 
 Configure it on the MCP definition:
 

package/dist/cli/extract-manifest.cjs

@@ -1,155 +1,10 @@
 #!/usr/bin/env node
-const require_schema = require("../schema-D3vClxb7.cjs");
-const require_package = require("../package-RqZMyBY1.cjs");
-const require_fs_errors = require("../fs-errors-CWNzOV75.cjs");
-let node_fs = require("node:fs");
-let node_path = require("node:path");
-let vite = require("vite");
-let node_crypto = require("node:crypto");
-//#region src/manifest/listing.ts
-function schemaToJsonSchema(definition, pipeStrategy) {
-	if (!definition) return null;
-	return require_schema.jsonSchemaFromDefinition(definition, pipeStrategy);
-}
-function buildMcpListing(mcp) {
-	return {
-		server: {
-			name: mcp.name,
-			version: mcp.version,
-			title: mcp.title
-		},
-		tools: mcp.tools.map((tool) => ({
-			name: tool.name,
-			title: tool.title,
-			description: tool.description,
-			annotations: tool.annotations,
-			inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
-			outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
-		}))
-	};
-}
-const MANIFEST_RELATIVE_PATH = ".lovable/mcp/manifest.json";
-function manifestAuth(auth) {
-	if (!auth) return { type: "none" };
-	const oauth = {
-		type: "oauth",
-		issuer: auth.issuer
-	};
-	if (auth.resource !== void 0) oauth.resource = auth.resource;
-	if (auth.resourceName !== void 0) oauth.resource_name = auth.resourceName;
-	if (auth.resourceDocumentation !== void 0) oauth.resource_documentation = auth.resourceDocumentation;
-	if (auth.protectedResourceMetadataUrl !== void 0) oauth.protected_resource_metadata_url = auth.protectedResourceMetadataUrl;
-	if (auth.requireOAuthClientClaim !== void 0) oauth.require_oauth_client_claim = auth.requireOAuthClientClaim;
-	if (auth.acceptResourceClaim !== void 0) oauth.accept_resource_claim = auth.acceptResourceClaim;
-	if (auth.acceptedAudiences !== void 0) oauth.accepted_audiences = auth.acceptedAudiences;
-	if (auth.requiredScopes !== void 0) oauth.required_scopes = auth.requiredScopes;
-	if (auth.jwksUri !== void 0) oauth.jwks_uri = auth.jwksUri;
-	if (auth.algorithms !== void 0) oauth.algorithms = auth.algorithms;
-	if (auth.clockToleranceSeconds !== void 0) oauth.clock_tolerance_seconds = auth.clockToleranceSeconds;
-	return oauth;
-}
-function isToolShape(tool) {
-	if (typeof tool !== "object" || tool === null) return false;
-	const t = tool;
-	return typeof t.name === "string" && typeof t.title === "string" && typeof t.description === "string";
-}
-function isAuthShape(auth) {
-	if (auth === void 0) return true;
-	if (typeof auth !== "object" || auth === null) return false;
-	const a = auth;
-	return a.type === "oauth" && typeof a.issuer === "string" && a.issuer.length > 0;
-}
-function manifestFromDefinition(definition, urlPath, source = "the MCP entry") {
-	const def = definition;
-	if (!(!!def && typeof def === "object" && typeof def.name === "string" && typeof def.title === "string" && typeof def.version === "string" && Array.isArray(def.tools) && def.tools.every(isToolShape) && isAuthShape(def.auth))) throw new Error(`@lovable.dev/mcp-js: ${source} must \`export default defineMcp(...)\` (got ${definition == null ? "no default export" : typeof definition}).`);
-	return {
-		version: 1,
-		sdk_version: require_package.version,
-		path: urlPath,
-		auth: manifestAuth(def.auth),
-		mcp: buildMcpListing(def)
-	};
-}
-//#endregion
-//#region src/manifest/ssr-loader.ts
-async function produceViaSsr(projectRoot, alias, entryAbs, urlPath) {
-	const server = await (0, vite.createServer)({
-		configFile: false,
-		root: projectRoot,
-		logLevel: "silent",
-		server: {
-			middlewareMode: true,
-			hmr: false,
-			watch: null
-		},
-		optimizeDeps: { noDiscovery: true },
-		resolve: { alias }
-	});
-	try {
-		return manifestFromDefinition((await server.ssrLoadModule(entryAbs)).default, urlPath, entryAbs);
-	} finally {
-		await server.close();
-	}
-}
-//#endregion
-//#region src/manifest/io.ts
-const MCP_PLUGIN_NAME_PREFIX = "@lovable.dev/mcp-js";
-function writeManifestIfChanged(file, manifest) {
-	const content = JSON.stringify(manifest, null, 2) + "\n";
-	let existing;
-	try {
-		existing = (0, node_fs.readFileSync)(file, "utf8");
-	} catch (err) {
-		if (!require_fs_errors.isFileMissing(err)) throw err;
-	}
-	if (existing === content) return;
-	(0, node_fs.mkdirSync)((0, node_path.dirname)(file), { recursive: true });
-	const tmp = `${file}.${(0, node_crypto.randomUUID)()}.tmp`;
-	try {
-		(0, node_fs.writeFileSync)(tmp, content, "utf8");
-		(0, node_fs.renameSync)(tmp, file);
-	} catch (err) {
-		try {
-			(0, node_fs.unlinkSync)(tmp);
-		} catch {}
-		throw err;
-	}
-}
-function removeManifest(file) {
-	try {
-		(0, node_fs.unlinkSync)(file);
-	} catch (err) {
-		if (!require_fs_errors.isFileMissing(err)) throw err;
-	}
-}
-async function syncManifest(manifestFile, entryAbs, urlPath, produce) {
-	let entryExists = true;
-	try {
-		(0, node_fs.lstatSync)(entryAbs);
-	} catch (err) {
-		if (!require_fs_errors.isFileMissing(err)) throw err;
-		entryExists = false;
-	}
-	if (!entryExists) {
-		removeManifest(manifestFile);
-		return;
-	}
-	writeManifestIfChanged(manifestFile, await produce(entryAbs, urlPath));
-}
-async function runExtract(projectRoot) {
-	const resolved = await (0, vite.resolveConfig)({
-		root: projectRoot,
-		logLevel: "silent"
-	}, "serve");
-	const alias = resolved.resolve?.alias ?? [];
-	const pluginApi = resolved.plugins.find((p) => typeof p.name === "string" && p.name.startsWith(MCP_PLUGIN_NAME_PREFIX))?.api;
-	const entryAbs = pluginApi?.mcpEntry ?? (0, node_path.resolve)(projectRoot, "src/lib/mcp/index.ts");
-	const urlPath = pluginApi?.urlPath ?? "/mcp";
-	await syncManifest((0, node_path.resolve)(projectRoot, MANIFEST_RELATIVE_PATH), entryAbs, urlPath, (entry, path) => produceViaSsr(projectRoot, alias, entry, path));
-}
-//#endregion
 //#region src/cli/extract-manifest.ts
-runExtract(process.argv[2] ?? process.cwd()).catch((err) => {
+const projectRoot = process.argv[2] ?? process.cwd();
+import("zod/v3").catch((err) => {
+	const message = err instanceof Error ? err.message : String(err);
+	throw new Error(`@lovable.dev/mcp-js requires zod ^3.25 or ^4.0 to extract MCP schemas. Verify the project's zod dependency and package resolution, then try again. Underlying error: ${message}`);
+}).then(() => Promise.resolve().then(() => require("../io-CKGFa7_M.cjs"))).then(({ runExtract }) => runExtract(projectRoot)).catch((err) => {
 	console.error(err instanceof Error ? err.message : String(err));
 	process.exit(1);
 });

package/dist/cli/extract-manifest.js

@@ -1,155 +1,10 @@
 #!/usr/bin/env node
-import { t as jsonSchemaFromDefinition } from "../schema-CW1jKvio.js";
-import { t as version } from "../package-CZERyrAn.js";
-import { t as isFileMissing } from "../fs-errors-PA2t1TIp.js";
-import { lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
-import { dirname, resolve } from "node:path";
-import { createServer, resolveConfig } from "vite";
-import { randomUUID } from "node:crypto";
-//#region src/manifest/listing.ts
-function schemaToJsonSchema(definition, pipeStrategy) {
-	if (!definition) return null;
-	return jsonSchemaFromDefinition(definition, pipeStrategy);
-}
-function buildMcpListing(mcp) {
-	return {
-		server: {
-			name: mcp.name,
-			version: mcp.version,
-			title: mcp.title
-		},
-		tools: mcp.tools.map((tool) => ({
-			name: tool.name,
-			title: tool.title,
-			description: tool.description,
-			annotations: tool.annotations,
-			inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
-			outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
-		}))
-	};
-}
-const MANIFEST_RELATIVE_PATH = ".lovable/mcp/manifest.json";
-function manifestAuth(auth) {
-	if (!auth) return { type: "none" };
-	const oauth = {
-		type: "oauth",
-		issuer: auth.issuer
-	};
-	if (auth.resource !== void 0) oauth.resource = auth.resource;
-	if (auth.resourceName !== void 0) oauth.resource_name = auth.resourceName;
-	if (auth.resourceDocumentation !== void 0) oauth.resource_documentation = auth.resourceDocumentation;
-	if (auth.protectedResourceMetadataUrl !== void 0) oauth.protected_resource_metadata_url = auth.protectedResourceMetadataUrl;
-	if (auth.requireOAuthClientClaim !== void 0) oauth.require_oauth_client_claim = auth.requireOAuthClientClaim;
-	if (auth.acceptResourceClaim !== void 0) oauth.accept_resource_claim = auth.acceptResourceClaim;
-	if (auth.acceptedAudiences !== void 0) oauth.accepted_audiences = auth.acceptedAudiences;
-	if (auth.requiredScopes !== void 0) oauth.required_scopes = auth.requiredScopes;
-	if (auth.jwksUri !== void 0) oauth.jwks_uri = auth.jwksUri;
-	if (auth.algorithms !== void 0) oauth.algorithms = auth.algorithms;
-	if (auth.clockToleranceSeconds !== void 0) oauth.clock_tolerance_seconds = auth.clockToleranceSeconds;
-	return oauth;
-}
-function isToolShape(tool) {
-	if (typeof tool !== "object" || tool === null) return false;
-	const t = tool;
-	return typeof t.name === "string" && typeof t.title === "string" && typeof t.description === "string";
-}
-function isAuthShape(auth) {
-	if (auth === void 0) return true;
-	if (typeof auth !== "object" || auth === null) return false;
-	const a = auth;
-	return a.type === "oauth" && typeof a.issuer === "string" && a.issuer.length > 0;
-}
-function manifestFromDefinition(definition, urlPath, source = "the MCP entry") {
-	const def = definition;
-	if (!(!!def && typeof def === "object" && typeof def.name === "string" && typeof def.title === "string" && typeof def.version === "string" && Array.isArray(def.tools) && def.tools.every(isToolShape) && isAuthShape(def.auth))) throw new Error(`@lovable.dev/mcp-js: ${source} must \`export default defineMcp(...)\` (got ${definition == null ? "no default export" : typeof definition}).`);
-	return {
-		version: 1,
-		sdk_version: version,
-		path: urlPath,
-		auth: manifestAuth(def.auth),
-		mcp: buildMcpListing(def)
-	};
-}
-//#endregion
-//#region src/manifest/ssr-loader.ts
-async function produceViaSsr(projectRoot, alias, entryAbs, urlPath) {
-	const server = await createServer({
-		configFile: false,
-		root: projectRoot,
-		logLevel: "silent",
-		server: {
-			middlewareMode: true,
-			hmr: false,
-			watch: null
-		},
-		optimizeDeps: { noDiscovery: true },
-		resolve: { alias }
-	});
-	try {
-		return manifestFromDefinition((await server.ssrLoadModule(entryAbs)).default, urlPath, entryAbs);
-	} finally {
-		await server.close();
-	}
-}
-//#endregion
-//#region src/manifest/io.ts
-const MCP_PLUGIN_NAME_PREFIX = "@lovable.dev/mcp-js";
-function writeManifestIfChanged(file, manifest) {
-	const content = JSON.stringify(manifest, null, 2) + "\n";
-	let existing;
-	try {
-		existing = readFileSync(file, "utf8");
-	} catch (err) {
-		if (!isFileMissing(err)) throw err;
-	}
-	if (existing === content) return;
-	mkdirSync(dirname(file), { recursive: true });
-	const tmp = `${file}.${randomUUID()}.tmp`;
-	try {
-		writeFileSync(tmp, content, "utf8");
-		renameSync(tmp, file);
-	} catch (err) {
-		try {
-			unlinkSync(tmp);
-		} catch {}
-		throw err;
-	}
-}
-function removeManifest(file) {
-	try {
-		unlinkSync(file);
-	} catch (err) {
-		if (!isFileMissing(err)) throw err;
-	}
-}
-async function syncManifest(manifestFile, entryAbs, urlPath, produce) {
-	let entryExists = true;
-	try {
-		lstatSync(entryAbs);
-	} catch (err) {
-		if (!isFileMissing(err)) throw err;
-		entryExists = false;
-	}
-	if (!entryExists) {
-		removeManifest(manifestFile);
-		return;
-	}
-	writeManifestIfChanged(manifestFile, await produce(entryAbs, urlPath));
-}
-async function runExtract(projectRoot) {
-	const resolved = await resolveConfig({
-		root: projectRoot,
-		logLevel: "silent"
-	}, "serve");
-	const alias = resolved.resolve?.alias ?? [];
-	const pluginApi = resolved.plugins.find((p) => typeof p.name === "string" && p.name.startsWith(MCP_PLUGIN_NAME_PREFIX))?.api;
-	const entryAbs = pluginApi?.mcpEntry ?? resolve(projectRoot, "src/lib/mcp/index.ts");
-	const urlPath = pluginApi?.urlPath ?? "/mcp";
-	await syncManifest(resolve(projectRoot, MANIFEST_RELATIVE_PATH), entryAbs, urlPath, (entry, path) => produceViaSsr(projectRoot, alias, entry, path));
-}
-//#endregion
 //#region src/cli/extract-manifest.ts
-runExtract(process.argv[2] ?? process.cwd()).catch((err) => {
+const projectRoot = process.argv[2] ?? process.cwd();
+import("zod/v3").catch((err) => {
+	const message = err instanceof Error ? err.message : String(err);
+	throw new Error(`@lovable.dev/mcp-js requires zod ^3.25 or ^4.0 to extract MCP schemas. Verify the project's zod dependency and package resolution, then try again. Underlying error: ${message}`);
+}).then(() => import("../io-ufHBQyKg.js")).then(({ runExtract }) => runExtract(projectRoot)).catch((err) => {
 	console.error(err instanceof Error ? err.message : String(err));
 	process.exit(1);
 });

package/dist/{cors-Bb8_NLEB.js → cors-BLtFfCwv.js}

@@ -1,5 +1,5 @@
 import { i as log, n as applyLogLevelFromEnv, o as parseSafeUrl, r as describeError, s as trimTrailingSlash, t as LOG_LEVEL_ENV_VAR, u as resolveMetricsConfig } from "./logger-Ctv5xUSD.js";
-import { t as version } from "./package-CZERyrAn.js";
+import { t as version } from "./package-Bu8wLlvG.js";
 import "./metadata-path-CAkNcfyY.js";
 import { createLocalJWKSet, decodeProtectedHeader, errors, jwtVerify } from "jose";
 //#region src/core/http.ts

package/dist/{cors-aOILwe5U.cjs → cors-DiBSnA0M.cjs}

@@ -1,5 +1,5 @@
 const require_logger = require("./logger-CN1q-KNn.cjs");
-const require_package = require("./package-RqZMyBY1.cjs");
+const require_package = require("./package-BGn-LvT3.cjs");
 require("./metadata-path-zd7NSNoa.cjs");
 let jose = require("jose");
 //#region src/core/http.ts

package/dist/io-CKGFa7_M.cjs

@@ -0,0 +1,155 @@
+const require_schema = require("./schema-D3vClxb7.cjs");
+const require_package = require("./package-BGn-LvT3.cjs");
+const require_fs_errors = require("./fs-errors-CWNzOV75.cjs");
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let vite = require("vite");
+let node_crypto = require("node:crypto");
+//#region src/manifest/listing.ts
+function schemaToJsonSchema(definition, pipeStrategy) {
+	if (!definition) return null;
+	return require_schema.jsonSchemaFromDefinition(definition, pipeStrategy);
+}
+function buildMcpListing(mcp) {
+	return {
+		server: {
+			name: mcp.name,
+			version: mcp.version,
+			title: mcp.title
+		},
+		tools: mcp.tools.map((tool) => ({
+			name: tool.name,
+			title: tool.title,
+			description: tool.description,
+			annotations: tool.annotations,
+			inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
+			outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
+		}))
+	};
+}
+const MANIFEST_RELATIVE_PATH = ".lovable/mcp/manifest.json";
+function manifestAuth(auth) {
+	if (!auth) return { type: "none" };
+	const oauth = {
+		type: "oauth",
+		issuer: auth.issuer
+	};
+	if (auth.resource !== void 0) oauth.resource = auth.resource;
+	if (auth.resourceName !== void 0) oauth.resource_name = auth.resourceName;
+	if (auth.resourceDocumentation !== void 0) oauth.resource_documentation = auth.resourceDocumentation;
+	if (auth.protectedResourceMetadataUrl !== void 0) oauth.protected_resource_metadata_url = auth.protectedResourceMetadataUrl;
+	if (auth.requireOAuthClientClaim !== void 0) oauth.require_oauth_client_claim = auth.requireOAuthClientClaim;
+	if (auth.acceptResourceClaim !== void 0) oauth.accept_resource_claim = auth.acceptResourceClaim;
+	if (auth.acceptedAudiences !== void 0) oauth.accepted_audiences = auth.acceptedAudiences;
+	if (auth.requiredScopes !== void 0) oauth.required_scopes = auth.requiredScopes;
+	if (auth.jwksUri !== void 0) oauth.jwks_uri = auth.jwksUri;
+	if (auth.algorithms !== void 0) oauth.algorithms = auth.algorithms;
+	if (auth.clockToleranceSeconds !== void 0) oauth.clock_tolerance_seconds = auth.clockToleranceSeconds;
+	return oauth;
+}
+function isToolShape(tool) {
+	if (typeof tool !== "object" || tool === null) return false;
+	const t = tool;
+	return typeof t.name === "string" && typeof t.title === "string" && typeof t.description === "string";
+}
+function isAuthShape(auth) {
+	if (auth === void 0) return true;
+	if (typeof auth !== "object" || auth === null) return false;
+	const a = auth;
+	return a.type === "oauth" && typeof a.issuer === "string" && a.issuer.length > 0;
+}
+function manifestFromDefinition(definition, urlPath, source = "the MCP entry") {
+	const def = definition;
+	if (!(!!def && typeof def === "object" && typeof def.name === "string" && typeof def.title === "string" && typeof def.version === "string" && Array.isArray(def.tools) && def.tools.every(isToolShape) && isAuthShape(def.auth))) throw new Error(`@lovable.dev/mcp-js: ${source} must \`export default defineMcp(...)\` (got ${definition == null ? "no default export" : typeof definition}).`);
+	return {
+		version: 1,
+		sdk_version: require_package.version,
+		path: urlPath,
+		auth: manifestAuth(def.auth),
+		mcp: buildMcpListing(def)
+	};
+}
+//#endregion
+//#region src/manifest/ssr-loader.ts
+async function produceViaSsr(projectRoot, alias, entryAbs, urlPath) {
+	const server = await (0, vite.createServer)({
+		configFile: false,
+		root: projectRoot,
+		logLevel: "silent",
+		server: {
+			middlewareMode: true,
+			hmr: false,
+			watch: null
+		},
+		optimizeDeps: { noDiscovery: true },
+		resolve: { alias }
+	});
+	try {
+		return manifestFromDefinition((await server.ssrLoadModule(entryAbs)).default, urlPath, entryAbs);
+	} finally {
+		await server.close();
+	}
+}
+//#endregion
+//#region src/manifest/io.ts
+const MCP_PLUGIN_NAME_PREFIX = "@lovable.dev/mcp-js";
+const DEFAULT_MCP_ENTRY = "src/lib/mcp/index.ts";
+const DEFAULT_MCP_PATH = "/mcp";
+function writeManifestIfChanged(file, manifest) {
+	const content = JSON.stringify(manifest, null, 2) + "\n";
+	let existing;
+	try {
+		existing = (0, node_fs.readFileSync)(file, "utf8");
+	} catch (err) {
+		if (!require_fs_errors.isFileMissing(err)) throw err;
+	}
+	if (existing === content) return;
+	(0, node_fs.mkdirSync)((0, node_path.dirname)(file), { recursive: true });
+	const tmp = `${file}.${(0, node_crypto.randomUUID)()}.tmp`;
+	try {
+		(0, node_fs.writeFileSync)(tmp, content, "utf8");
+		(0, node_fs.renameSync)(tmp, file);
+	} catch (err) {
+		try {
+			(0, node_fs.unlinkSync)(tmp);
+		} catch {}
+		throw err;
+	}
+}
+function removeManifest(file) {
+	try {
+		(0, node_fs.unlinkSync)(file);
+	} catch (err) {
+		if (!require_fs_errors.isFileMissing(err)) throw err;
+	}
+}
+async function syncManifest(manifestFile, entryAbs, urlPath, produce) {
+	let entryExists = true;
+	try {
+		(0, node_fs.lstatSync)(entryAbs);
+	} catch (err) {
+		if (!require_fs_errors.isFileMissing(err)) throw err;
+		entryExists = false;
+	}
+	if (!entryExists) {
+		removeManifest(manifestFile);
+		return;
+	}
+	writeManifestIfChanged(manifestFile, await produce(entryAbs, urlPath));
+}
+async function runExtract(projectRoot) {
+	const resolved = await (0, vite.resolveConfig)({
+		root: projectRoot,
+		logLevel: "silent"
+	}, "serve");
+	const alias = resolved.resolve?.alias ?? [];
+	const pluginApi = resolved.plugins.find((p) => typeof p.name === "string" && p.name.startsWith(MCP_PLUGIN_NAME_PREFIX))?.api;
+	const entryAbs = pluginApi?.mcpEntry ?? (0, node_path.resolve)(projectRoot, "src/lib/mcp/index.ts");
+	const urlPath = pluginApi?.urlPath ?? "/mcp";
+	await syncManifest((0, node_path.resolve)(projectRoot, MANIFEST_RELATIVE_PATH), entryAbs, urlPath, (entry, path) => produceViaSsr(projectRoot, alias, entry, path));
+}
+//#endregion
+exports.DEFAULT_MCP_ENTRY = DEFAULT_MCP_ENTRY;
+exports.DEFAULT_MCP_PATH = DEFAULT_MCP_PATH;
+exports.runExtract = runExtract;
+exports.syncManifest = syncManifest;

package/dist/io-ufHBQyKg.js

@@ -0,0 +1,152 @@
+import { t as jsonSchemaFromDefinition } from "./schema-CW1jKvio.js";
+import { t as version } from "./package-Bu8wLlvG.js";
+import { t as isFileMissing } from "./fs-errors-PA2t1TIp.js";
+import { lstatSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { createServer, resolveConfig } from "vite";
+import { randomUUID } from "node:crypto";
+//#region src/manifest/listing.ts
+function schemaToJsonSchema(definition, pipeStrategy) {
+	if (!definition) return null;
+	return jsonSchemaFromDefinition(definition, pipeStrategy);
+}
+function buildMcpListing(mcp) {
+	return {
+		server: {
+			name: mcp.name,
+			version: mcp.version,
+			title: mcp.title
+		},
+		tools: mcp.tools.map((tool) => ({
+			name: tool.name,
+			title: tool.title,
+			description: tool.description,
+			annotations: tool.annotations,
+			inputSchema: schemaToJsonSchema(tool.inputSchema, "input"),
+			outputSchema: schemaToJsonSchema(tool.outputSchema, "output")
+		}))
+	};
+}
+const MANIFEST_RELATIVE_PATH = ".lovable/mcp/manifest.json";
+function manifestAuth(auth) {
+	if (!auth) return { type: "none" };
+	const oauth = {
+		type: "oauth",
+		issuer: auth.issuer
+	};
+	if (auth.resource !== void 0) oauth.resource = auth.resource;
+	if (auth.resourceName !== void 0) oauth.resource_name = auth.resourceName;
+	if (auth.resourceDocumentation !== void 0) oauth.resource_documentation = auth.resourceDocumentation;
+	if (auth.protectedResourceMetadataUrl !== void 0) oauth.protected_resource_metadata_url = auth.protectedResourceMetadataUrl;
+	if (auth.requireOAuthClientClaim !== void 0) oauth.require_oauth_client_claim = auth.requireOAuthClientClaim;
+	if (auth.acceptResourceClaim !== void 0) oauth.accept_resource_claim = auth.acceptResourceClaim;
+	if (auth.acceptedAudiences !== void 0) oauth.accepted_audiences = auth.acceptedAudiences;
+	if (auth.requiredScopes !== void 0) oauth.required_scopes = auth.requiredScopes;
+	if (auth.jwksUri !== void 0) oauth.jwks_uri = auth.jwksUri;
+	if (auth.algorithms !== void 0) oauth.algorithms = auth.algorithms;
+	if (auth.clockToleranceSeconds !== void 0) oauth.clock_tolerance_seconds = auth.clockToleranceSeconds;
+	return oauth;
+}
+function isToolShape(tool) {
+	if (typeof tool !== "object" || tool === null) return false;
+	const t = tool;
+	return typeof t.name === "string" && typeof t.title === "string" && typeof t.description === "string";
+}
+function isAuthShape(auth) {
+	if (auth === void 0) return true;
+	if (typeof auth !== "object" || auth === null) return false;
+	const a = auth;
+	return a.type === "oauth" && typeof a.issuer === "string" && a.issuer.length > 0;
+}
+function manifestFromDefinition(definition, urlPath, source = "the MCP entry") {
+	const def = definition;
+	if (!(!!def && typeof def === "object" && typeof def.name === "string" && typeof def.title === "string" && typeof def.version === "string" && Array.isArray(def.tools) && def.tools.every(isToolShape) && isAuthShape(def.auth))) throw new Error(`@lovable.dev/mcp-js: ${source} must \`export default defineMcp(...)\` (got ${definition == null ? "no default export" : typeof definition}).`);
+	return {
+		version: 1,
+		sdk_version: version,
+		path: urlPath,
+		auth: manifestAuth(def.auth),
+		mcp: buildMcpListing(def)
+	};
+}
+//#endregion
+//#region src/manifest/ssr-loader.ts
+async function produceViaSsr(projectRoot, alias, entryAbs, urlPath) {
+	const server = await createServer({
+		configFile: false,
+		root: projectRoot,
+		logLevel: "silent",
+		server: {
+			middlewareMode: true,
+			hmr: false,
+			watch: null
+		},
+		optimizeDeps: { noDiscovery: true },
+		resolve: { alias }
+	});
+	try {
+		return manifestFromDefinition((await server.ssrLoadModule(entryAbs)).default, urlPath, entryAbs);
+	} finally {
+		await server.close();
+	}
+}
+//#endregion
+//#region src/manifest/io.ts
+const MCP_PLUGIN_NAME_PREFIX = "@lovable.dev/mcp-js";
+const DEFAULT_MCP_ENTRY = "src/lib/mcp/index.ts";
+const DEFAULT_MCP_PATH = "/mcp";
+function writeManifestIfChanged(file, manifest) {
+	const content = JSON.stringify(manifest, null, 2) + "\n";
+	let existing;
+	try {
+		existing = readFileSync(file, "utf8");
+	} catch (err) {
+		if (!isFileMissing(err)) throw err;
+	}
+	if (existing === content) return;
+	mkdirSync(dirname(file), { recursive: true });
+	const tmp = `${file}.${randomUUID()}.tmp`;
+	try {
+		writeFileSync(tmp, content, "utf8");
+		renameSync(tmp, file);
+	} catch (err) {
+		try {
+			unlinkSync(tmp);
+		} catch {}
+		throw err;
+	}
+}
+function removeManifest(file) {
+	try {
+		unlinkSync(file);
+	} catch (err) {
+		if (!isFileMissing(err)) throw err;
+	}
+}
+async function syncManifest(manifestFile, entryAbs, urlPath, produce) {
+	let entryExists = true;
+	try {
+		lstatSync(entryAbs);
+	} catch (err) {
+		if (!isFileMissing(err)) throw err;
+		entryExists = false;
+	}
+	if (!entryExists) {
+		removeManifest(manifestFile);
+		return;
+	}
+	writeManifestIfChanged(manifestFile, await produce(entryAbs, urlPath));
+}
+async function runExtract(projectRoot) {
+	const resolved = await resolveConfig({
+		root: projectRoot,
+		logLevel: "silent"
+	}, "serve");
+	const alias = resolved.resolve?.alias ?? [];
+	const pluginApi = resolved.plugins.find((p) => typeof p.name === "string" && p.name.startsWith(MCP_PLUGIN_NAME_PREFIX))?.api;
+	const entryAbs = pluginApi?.mcpEntry ?? resolve(projectRoot, "src/lib/mcp/index.ts");
+	const urlPath = pluginApi?.urlPath ?? "/mcp";
+	await syncManifest(resolve(projectRoot, MANIFEST_RELATIVE_PATH), entryAbs, urlPath, (entry, path) => produceViaSsr(projectRoot, alias, entry, path));
+}
+//#endregion
+export { DEFAULT_MCP_ENTRY, DEFAULT_MCP_PATH, runExtract, syncManifest };

package/dist/{mcp-B1hj8ZPg.js → mcp-BQeQCXB4.js}

@@ -1,7 +1,7 @@
 import { i as log, r as describeError } from "./logger-Ctv5xUSD.js";
 import { n as schemaFromDefinition, t as jsonSchemaFromDefinition } from "./schema-CW1jKvio.js";
 import { i as ToolContext, n as errorSummary, r as resolveToolErrorMessage } from "./errors-Bwd1L0Rf.js";
-import { f as finalizeWireResponse, i as normalizeHttpMethod, l as createNoopRecorder, n as createRequestAuthorizer, t as evaluateCors, u as nowMs } from "./cors-Bb8_NLEB.js";
+import { f as finalizeWireResponse, i as normalizeHttpMethod, l as createNoopRecorder, n as createRequestAuthorizer, t as evaluateCors, u as nowMs } from "./cors-BLtFfCwv.js";
 import { getParseErrorMessage, safeParseAsync } from "@modelcontextprotocol/sdk/server/zod-compat.js";
 import { CLIENT_CAPABILITIES_META_KEY, CLIENT_INFO_META_KEY, McpServer, createMcpHandler } from "@modelcontextprotocol/server";
 //#region src/core/content.ts

package/dist/{mcp-Bbl8sdkl.cjs → mcp-LfeCqruq.cjs}

@@ -1,7 +1,7 @@
 const require_logger = require("./logger-CN1q-KNn.cjs");
 const require_schema = require("./schema-D3vClxb7.cjs");
 const require_errors = require("./errors-Cr95rSkB.cjs");
-const require_cors = require("./cors-aOILwe5U.cjs");
+const require_cors = require("./cors-DiBSnA0M.cjs");
 let _modelcontextprotocol_sdk_server_zod_compat_js = require("@modelcontextprotocol/sdk/server/zod-compat.js");
 let _modelcontextprotocol_server = require("@modelcontextprotocol/server");
 //#region src/core/content.ts

package/dist/{package-RqZMyBY1.cjs → package-BGn-LvT3.cjs}

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "2.0.0";
+var version = "2.0.2-rc.0";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,

package/dist/{package-CZERyrAn.js → package-Bu8wLlvG.js}

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "2.0.0";
+var version = "2.0.2-rc.0";
 //#endregion
 export { version as t };

package/dist/protocols/mcp/index.cjs

@@ -1,3 +1,3 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_mcp = require("../../mcp-Bbl8sdkl.cjs");
+const require_mcp = require("../../mcp-LfeCqruq.cjs");
 exports.createMcpProtocolHandler = require_mcp.createMcpProtocolHandler;

package/dist/protocols/mcp/index.js

@@ -1,2 +1,2 @@
-import { t as createMcpProtocolHandler } from "../../mcp-B1hj8ZPg.js";
+import { t as createMcpProtocolHandler } from "../../mcp-BQeQCXB4.js";
 export { createMcpProtocolHandler };

package/dist/protocols/oauth-metadata.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_logger = require("../logger-CN1q-KNn.cjs");
-const require_cors = require("../cors-aOILwe5U.cjs");
+const require_cors = require("../cors-DiBSnA0M.cjs");
 //#region src/protocols/oauth-metadata.ts
 function notFound() {
 	return new Response(JSON.stringify({ error: "not found" }), {

package/dist/protocols/oauth-metadata.js

@@ -1,5 +1,5 @@
 import { i as log, r as describeError } from "../logger-Ctv5xUSD.js";
-import { a as oauthConfigurationErrorResponse, d as JSON_HEADERS, f as finalizeWireResponse, i as normalizeHttpMethod, l as createNoopRecorder, p as methodNotAllowed, r as getOAuthRuntime, s as resolveProtectedResource, t as evaluateCors } from "../cors-Bb8_NLEB.js";
+import { a as oauthConfigurationErrorResponse, d as JSON_HEADERS, f as finalizeWireResponse, i as normalizeHttpMethod, l as createNoopRecorder, p as methodNotAllowed, r as getOAuthRuntime, s as resolveProtectedResource, t as evaluateCors } from "../cors-BLtFfCwv.js";
 //#region src/protocols/oauth-metadata.ts
 function notFound() {
 	return new Response(JSON.stringify({ error: "not found" }), {

package/dist/stacks/supabase/index.cjs

@@ -1,8 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_logger = require("../../logger-CN1q-KNn.cjs");
-const require_cors = require("../../cors-aOILwe5U.cjs");
+const require_cors = require("../../cors-DiBSnA0M.cjs");
 const require_metadata_path = require("../../metadata-path-zd7NSNoa.cjs");
-const require_mcp = require("../../mcp-Bbl8sdkl.cjs");
+const require_mcp = require("../../mcp-LfeCqruq.cjs");
 const require_protocols_oauth_metadata = require("../../protocols/oauth-metadata.cjs");
 const require_forwarded = require("../../forwarded-B37IdmMX.cjs");
 const require_paths = require("../../paths-OP318a6c.cjs");

package/dist/stacks/supabase/index.js

@@ -1,7 +1,7 @@
 import { s as trimTrailingSlash } from "../../logger-Ctv5xUSD.js";
-import { c as createRecorderForRuntime, o as assertResourcePathShape } from "../../cors-Bb8_NLEB.js";
+import { c as createRecorderForRuntime, o as assertResourcePathShape } from "../../cors-BLtFfCwv.js";
 import { t as OAUTH_PROTECTED_RESOURCE_METADATA_PATH } from "../../metadata-path-CAkNcfyY.js";
-import { t as createMcpProtocolHandler } from "../../mcp-B1hj8ZPg.js";
+import { t as createMcpProtocolHandler } from "../../mcp-BQeQCXB4.js";
 import { createOAuthProtectedResourceMetadataHandler } from "../../protocols/oauth-metadata.js";
 import { t as applyForwardedOrigin } from "../../forwarded-BBXvFeh6.js";
 import { n as assertFunctionName, t as FUNCTIONS_MOUNT_PREFIX } from "../../paths-IS65L6TA.js";

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-RqZMyBY1.cjs");
+const require_package = require("../../package-BGn-LvT3.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.js

@@ -1,4 +1,4 @@
-import { t as version } from "../../package-CZERyrAn.js";
+import { t as version } from "../../package-Bu8wLlvG.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,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_cors = require("../../cors-aOILwe5U.cjs");
-const require_mcp = require("../../mcp-Bbl8sdkl.cjs");
+const require_cors = require("../../cors-DiBSnA0M.cjs");
+const require_mcp = require("../../mcp-LfeCqruq.cjs");
 const require_protocols_oauth_metadata = require("../../protocols/oauth-metadata.cjs");
 const require_forwarded = require("../../forwarded-B37IdmMX.cjs");
 //#region src/stacks/tanstack/handlers.ts

package/dist/stacks/tanstack/index.js

@@ -1,5 +1,5 @@
-import { c as createRecorderForRuntime } from "../../cors-Bb8_NLEB.js";
-import { t as createMcpProtocolHandler } from "../../mcp-B1hj8ZPg.js";
+import { c as createRecorderForRuntime } from "../../cors-BLtFfCwv.js";
+import { t as createMcpProtocolHandler } from "../../mcp-BQeQCXB4.js";
 import { createOAuthProtectedResourceMetadataHandler } from "../../protocols/oauth-metadata.js";
 import { t as applyForwardedOrigin } from "../../forwarded-BBXvFeh6.js";
 //#region src/stacks/tanstack/handlers.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lovable.dev/mcp-js",
-  "version": "2.0.0",
+  "version": "2.0.2-rc.0",
   "engines": {
     "node": ">=20"
   },
@@ -108,14 +108,14 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@modelcontextprotocol/server": "2.0.0",
     "@modelcontextprotocol/sdk": "1.28.0",
+    "@modelcontextprotocol/server": "2.0.0",
     "esbuild": "^0.27.0",
     "jose": "^6.2.2"
   },
   "peerDependencies": {
     "vite": ">=5.0.0 <9.0.0",
-    "zod": ">=3.23.0"
+    "zod": "^3.25 || ^4.0"
   },
   "devDependencies": {
     "@types/node": "22.13.13",
@@ -135,7 +135,8 @@
     "format:check": "oxfmt --check src/ tests/",
     "lint": "oxfmt --check src/ tests/ && oxlint -c ../../oxlint.config.ts src/ tests/",
     "lint:fix": "oxfmt --write src/ tests/ && oxlint -c ../../oxlint.config.ts --fix src/ tests/",
-    "test": "vitest run --project unit",
+    "test": "vitest run --project unit && npm run test:package:zod",
+    "test:package:zod": "npm run build && node tests/package/zod-compat.mjs",
     "test:watch": "vitest --project unit",
     "example:tanstack:install": "bun link && cd example/tanstack && bun install && bun link @lovable.dev/mcp-js",
     "example:tanstack:dev": "cd example/tanstack && bun --bun run dev",