@ait-co/devtools 0.1.84 → 0.1.86

package/README.en.md

@@ -106,7 +106,7 @@ For environments 3 and 4 (intoss-private relay), the relay QR deep-link carries
 
 **"QR window doesn't open"**
 
-Either `build_attach_url` wasn't called first, or `open_in_browser` failed silently in a headless environment. The terminal output includes a path to a saved PNG — open that file directly, or scan the text QR printed in the terminal. (Related: [#288](https://github.com/apps-in-toss-community/devtools/issues/288))
+Either `build_attach_url` wasn't called first, or the MCP server is running in a headless environment where no browser can be opened. The tool result always includes a text QR — scan it directly with your phone camera. On a local GUI machine, the dashboard opens automatically in the browser.
 
 **"Page not attached" — list_pages returns an empty array**
 

package/README.md

@@ -106,7 +106,7 @@ import '@ait-co/devtools/in-app/auto';
 
 **"QR 창이 안 열림"**
 
-`build_attach_url`을 먼저 호출하지 않았거나, GUI 없는 headless 환경에서 `open_in_browser`가 실패한 경우입니다. 터미널에 PNG 저장 경로가 출력됩니다 — 그 파일을 직접 열거나, 텍스트 QR을 터미널에서 스캔하세요. (관련: [#288](https://github.com/apps-in-toss-community/devtools/issues/288))
+`build_attach_url`을 먼저 호출하지 않았거나, GUI 없는 headless 환경이라 대시보드를 열 수 없는 경우입니다. 도구 결과에 텍스트 QR이 출력되므로 폰 카메라로 직접 스캔하세요. 로컬 GUI 환경에서는 대시보드가 자동으로 브라우저에 열립니다.
 
 **"page 미attach" — list_pages가 빈 배열 반환**
 

package/dist/mcp/cli.js

@@ -3761,7 +3761,7 @@ const DEBUG_TOOL_DEFINITIONS = [
 	},
 	{
 		name: "build_attach_url",
-		description: "The tool result already shows the QR to the user directly (Claude Code renders MCP tool output to the user's screen; they press Ctrl+O to expand if it's collapsed). Do NOT re-print or re-render the QR in your reply — that just wastes output tokens. Simply tell the user to scan the QR shown in this tool's output with their phone camera. Builds a self-attaching deep-link for the active relay environment and returns a QR code. Scan the QR with the phone camera to open the mini-app and attach it to this debug session (QR is the single entry path — no USB cable or platform CLI needed). Call list_pages first to confirm the relay/tunnel is up. If the tunnel is not up, restart: `npx @ait-co/devtools devtools-mcp`.\n\nEnvironment-specific behaviour:\n  • env 3 / relay-staging (start_debug mode=\"relay-staging\"): requires scheme_url — the intoss-private://…?_deploymentId=<uuid> URL from `ait deploy --scheme-only`. Splices debug=1 + relay URL into the scheme URL to produce a self-attach deep-link.\n  • env 2 / relay-sandbox (start_debug mode=\"relay-sandbox\"): scheme_url is NOT used. Instead, reads AIT_TUNNEL_BASE_URL (the https://*.trycloudflare.com app tunnel from `tunnel:{cdp:true}`) and builds a launcher PWA deep-link (https://devtools.aitc.dev/launcher/?url=…&debug=1&relay=…). When projectRoot is given, the app name from <projectRoot>/package.json is automatically added as name= so the launcher partner bar shows it. Scan the QR with the phone to open the launcher, which frames the tunnel URL and attaches CDP.\n\nSet wait_for_attach=true to block until a page attaches (polls up to 30 s). On timeout, call build_attach_url again to resume polling. When open_in_browser=true (default), saves the QR as a PNG and opens it in the OS default browser — only works when the MCP server runs on a local GUI machine (not headless/remote containers). \n\nTOTP auth: when AIT_DEBUG_TOTP_SECRET is set on the MCP server, the returned attachUrl automatically includes the current one-time code (at=<code>). The code is valid for ~3 minutes (the relay gate accepts ±6 TOTP steps = 180–210 s of backwards acceptance). The response includes a `totp` field with `expiresAt` (ISO timestamp, ~3 min from issuance). If the phone scan happens after expiresAt, the relay will reject the code — just call build_attach_url again to get a fresh URL. Without AIT_DEBUG_TOTP_SECRET, the attachUrl has no expiry.\n\nselfdebug (env 2 / relay-sandbox only): pass selfdebug=true to add &selfdebug=1 to the launcher deep-link. The launcher PWA then registers its own document as the CDP target instead of the framed mini-app. SINGLE-ATTACH MODEL: attaching the launcher self-target evicts any currently-attached mini-app target — use this mode exclusively for diagnosing the launcher document itself (DOM, safe-area, console). Not applicable in env 3/4 (relay-staging/relay-live) — passing selfdebug=true there returns an error.",
+		description: "The tool result already shows the QR to the user directly (Claude Code renders MCP tool output to the user's screen; they press Ctrl+O to expand if it's collapsed). Do NOT re-print or re-render the QR in your reply — that just wastes output tokens. Simply tell the user to scan the QR shown in this tool's output with their phone camera. Builds a self-attaching deep-link for the active relay environment and returns a QR code. Scan the QR with the phone camera to open the mini-app and attach it to this debug session (QR is the single entry path — no USB cable or platform CLI needed). Call list_pages first to confirm the relay/tunnel is up. If the tunnel is not up, restart: `npx @ait-co/devtools devtools-mcp`.\n\nEnvironment-specific behaviour:\n  • env 3 / relay-staging (start_debug mode=\"relay-staging\"): requires scheme_url — the intoss-private://…?_deploymentId=<uuid> URL from `ait deploy --scheme-only`. Splices debug=1 + relay URL into the scheme URL to produce a self-attach deep-link.\n  • env 2 / relay-sandbox (start_debug mode=\"relay-sandbox\"): scheme_url is NOT used. Instead, reads AIT_TUNNEL_BASE_URL (the https://*.trycloudflare.com app tunnel from `tunnel:{cdp:true}`) and builds a launcher PWA deep-link (https://devtools.aitc.dev/launcher/?url=…&debug=1&relay=…). When projectRoot is given, the app name from <projectRoot>/package.json is automatically added as name= so the launcher partner bar shows it. Scan the QR with the phone to open the launcher, which frames the tunnel URL and attaches CDP.\n\nSet wait_for_attach=true to block until a page attaches (default 60 s, adjustable via wait_timeout_seconds). On timeout, call build_attach_url again to resume polling. The server automatically opens the QR dashboard in the OS default browser when running on a local GUI machine — headless/remote environments fall back to the text QR in the tool output.\n\nTOTP auth: when AIT_DEBUG_TOTP_SECRET is set on the MCP server, the returned attachUrl automatically includes the current one-time code (at=<code>). The code is valid for ~3 minutes (the relay gate accepts ±6 TOTP steps = 180–210 s of backwards acceptance). The response includes a `totp` field with `expiresAt` (ISO timestamp, ~3 min from issuance). If the phone scan happens after expiresAt, the relay will reject the code — just call build_attach_url again to get a fresh URL. Without AIT_DEBUG_TOTP_SECRET, the attachUrl has no expiry.\n\nselfdebug (env 2 / relay-sandbox only): pass selfdebug=true to add &selfdebug=1 to the launcher deep-link. The launcher PWA then registers its own document as the CDP target instead of the framed mini-app. SINGLE-ATTACH MODEL: attaching the launcher self-target evicts any currently-attached mini-app target — use this mode exclusively for diagnosing the launcher document itself (DOM, safe-area, console). Not applicable in env 3/4 (relay-staging/relay-live) — passing selfdebug=true there returns an error.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -3771,11 +3771,11 @@ const DEBUG_TOOL_DEFINITIONS = [
 				},
 				wait_for_attach: {
 					type: "boolean",
-					description: "If true, block after returning the QR until a page attaches to the relay (polls listTargets ~1 s interval, timeout 30 s). On attach, the response includes the attached page list. On timeout, call build_attach_url again to resume polling."
+					description: "If true, block after returning the QR until a page attaches to the relay (polls listTargets ~1 s interval, default 60 s). On attach, the response includes the attached page list. On timeout, call build_attach_url again to resume polling."
 				},
-				open_in_browser: {
-					type: "boolean",
-					description: "If true (default), render the QR as a PNG and open it in the OS default browser. Only works when the MCP server is running on a local GUI machine — headless or remote container environments should set this to false to use the text QR fallback."
+				wait_timeout_seconds: {
+					type: "number",
+					description: "Maximum seconds to wait when wait_for_attach=true (default 60, range 1–600). Values outside the range or invalid inputs (0, negative, NaN) fall back to the default silently. Only meaningful when wait_for_attach=true."
 				},
 				projectRoot: {
 					type: "string",
@@ -4779,7 +4779,7 @@ async function readMcpSdkVersion() {
 * some test environments that skip the build step).
 */
 function readDevtoolsVersion() {
-	return "0.1.84";
+	return "0.1.86";
 }
 /**
 * Derives the next recommended action from a completed diagnostics snapshot.
@@ -4855,9 +4855,14 @@ async function getDiagnostics(input) {
 		reissueAttempts: tunnel.reissueAttempts ?? 0
 	};
 	let pages = null;
-	if (connection !== void 0) try {
-		pages = listPages(connection, tunnel);
-	} catch {}
+	if (connection !== void 0) {
+		try {
+			await connection.refreshTargets?.();
+		} catch {}
+		try {
+			pages = listPages(connection, tunnel);
+		} catch {}
+	}
 	const limit = Math.min(Math.max(1, recentErrorsLimit), 50);
 	const recentErrors = collector.getRecentErrors(limit);
 	const authRejects = collector.getAuthRejects();
@@ -5275,7 +5280,7 @@ function waitForAttachWithEvents(connection, filterFn, timeoutMs, pollIntervalMs
 * naturally via `enableDomains`). The tier only controls visibility.
 */
 function createDebugServer(deps) {
-	const { connection, router: routerDep, aitSource, getTunnelStatus, waitForAttachTimeoutMs = 9e4, qrHttpServer, getEnvironment: getEnvDep, getEnvironmentReason: getEnvReasonDep, diagnosticsCollector: collectorDep, totpSecret, onAttachUrlBuilt } = deps;
+	const { connection, router: routerDep, aitSource, getTunnelStatus, waitForAttachTimeoutMs = 6e4, qrHttpServer, getEnvironment: getEnvDep, getEnvironmentReason: getEnvReasonDep, diagnosticsCollector: collectorDep, totpSecret, onAttachUrlBuilt } = deps;
 	const getTotpSecret = deps.getTotpSecret ?? (() => totpSecret);
 	const router = routerDep ?? makeSingleConnectionRouter(connection);
 	const resolveEnvironment = getEnvDep ?? (() => deriveEnvironment(router.active.kind, getLiveIntent(), router.activeRelayOrigin));
@@ -5283,7 +5288,7 @@ function createDebugServer(deps) {
 	const collector = collectorDep ?? new InMemoryDiagnosticsCollector();
 	const server = new Server({
 		name: "ait-debug",
-		version: "0.1.84"
+		version: "0.1.86"
 	}, { capabilities: { tools: { listChanged: true } } });
 	server.setRequestHandler(ListToolsRequestSchema, () => {
 		const conn = router.active;
@@ -5356,8 +5361,14 @@ function createDebugServer(deps) {
 		}
 		if (name === "build_attach_url") {
 			const waitForAttach = request.params.arguments?.wait_for_attach === true;
-			const openInBrowser = request.params.arguments?.open_in_browser !== false;
 			const selfdebug = request.params.arguments?.selfdebug === true;
+			const rawWaitTimeout = request.params.arguments?.wait_timeout_seconds;
+			const callTimeoutMs = (() => {
+				if (typeof rawWaitTimeout !== "number" || !Number.isFinite(rawWaitTimeout)) return waitForAttachTimeoutMs;
+				const clamped = Math.max(1, Math.min(600, rawWaitTimeout));
+				if (rawWaitTimeout <= 0) return waitForAttachTimeoutMs;
+				return Math.round(clamped) * 1e3;
+			})();
 			if (selfdebug && env !== "relay-mobile") return mcpError("build_attach_url: selfdebug=true는 env 2 / relay-sandbox 전용 기능입니다. 현재 환경(env 3/4)에서는 launcher가 없어 self-target 모드를 지원하지 않습니다. launcher self-target이 필요하다면 relay-sandbox 모드로 재시작하세요.");
 			if (env === "relay-mobile") {
 				const rawBuildProjectRoot = request.params.arguments?.projectRoot;
@@ -5414,8 +5425,8 @@ function createDebugServer(deps) {
 					const header = "This tool result is shown to the user directly — do NOT re-print the QR below in your reply (it wastes output tokens). Just tell the user to scan the QR in this output (Ctrl+O to expand if collapsed).";
 					const warningPrefix = "";
 					const guiAvailable = canOpenBrowser();
-					if (openInBrowser && !guiAvailable) {
-						const headlessNote = "[open_in_browser] GUI 환경이 감지되지 않았습니다 (headless/remote 환경). open_in_browser=false로 자동 폴백합니다. 텍스트 QR을 폰 카메라로 스캔하거나, 로컬 GUI 환경에서 실행하세요.\n\n";
+					if (!guiAvailable) {
+						const headlessNote = "GUI 환경이 감지되지 않았습니다 (headless/remote 환경). 텍스트 QR을 폰 카메라로 스캔하거나, 로컬 GUI 환경에서 실행하세요.\n\n";
 						const qrHeadless = await renderQr(attachUrl);
 						const headlessText = `${warningPrefix}${headlessNote}${header}\n${JSON.stringify({
 							attachUrl,
@@ -5428,13 +5439,13 @@ function createDebugServer(deps) {
 						}] };
 						let attachedPagesHl = [];
 						try {
-							attachedPagesHl = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+							attachedPagesHl = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 						} catch {
 							attachedPagesHl = conn.listTargets();
 							return {
 								content: [{
 									type: "text",
-									text: buildTimeoutError(headlessText, waitForAttachTimeoutMs / 1e3, attachedPagesHl)
+									text: buildTimeoutError(headlessText, callTimeoutMs / 1e3, attachedPagesHl)
 								}],
 								isError: true
 							};
@@ -5445,7 +5456,7 @@ function createDebugServer(deps) {
 							text: `${headlessText}\n\n${JSON.stringify(pagesResultHl, null, 2)}`
 						}] };
 					}
-					if (openInBrowser && guiAvailable && qrHttpServer) {
+					if (guiAvailable && qrHttpServer) {
 						const browserResult = await openQrInBrowser(qrHttpServer.buildAttachPageUrl(attachUrl), `http://127.0.0.1:${qrHttpServer.port}/qr.png?u=${encodeURIComponent(attachUrl)}`);
 						if (browserResult.opened) {
 							const retriedNote = browserResult.retried ? " (1회 retry 후 성공)" : "";
@@ -5465,13 +5476,13 @@ function createDebugServer(deps) {
 							}] };
 							let attachedPages = [];
 							try {
-								attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+								attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 							} catch {
 								attachedPages = conn.listTargets();
 								return {
 									content: [{
 										type: "text",
-										text: buildTimeoutError(shortText, waitForAttachTimeoutMs / 1e3, attachedPages)
+										text: buildTimeoutError(shortText, callTimeoutMs / 1e3, attachedPages)
 									}],
 									isError: true
 								};
@@ -5490,7 +5501,7 @@ function createDebugServer(deps) {
 							...browserResult.stderrSummary ? { stderrSummary: browserResult.stderrSummary } : {}
 						};
 						const stderrNote = browserResult.stderrSummary ? `\nstderr: ${browserResult.stderrSummary}` : "";
-						const fallbackNote = `[open_in_browser] 브라우저 자동 열기에 실패했습니다. 다음 URL을 직접 브라우저에서 여세요:\n${browserResult.httpUrl}\n또는 PNG로 받기: ${browserResult.pngUrl}` + stderrNote + "\n\n";
+						const fallbackNote = `브라우저 자동 열기에 실패했습니다. 다음 URL을 직접 브라우저에서 여세요:\n${browserResult.httpUrl}\n또는 PNG로 받기: ${browserResult.pngUrl}` + stderrNote + "\n\n";
 						const qr = await renderQr(attachUrl);
 						const baseText = `${warningPrefix}${fallbackNote}${header}\n${JSON.stringify({
 							attachUrl,
@@ -5504,13 +5515,13 @@ function createDebugServer(deps) {
 						}] };
 						let attachedPagesFb = [];
 						try {
-							attachedPagesFb = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+							attachedPagesFb = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 						} catch {
 							attachedPagesFb = conn.listTargets();
 							return {
 								content: [{
 									type: "text",
-									text: buildTimeoutError(baseText, waitForAttachTimeoutMs / 1e3, attachedPagesFb)
+									text: buildTimeoutError(baseText, callTimeoutMs / 1e3, attachedPagesFb)
 								}],
 								isError: true
 							};
@@ -5533,13 +5544,13 @@ function createDebugServer(deps) {
 					}] };
 					let attachedPages = [];
 					try {
-						attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+						attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 					} catch {
 						attachedPages = conn.listTargets();
 						return {
 							content: [{
 								type: "text",
-								text: buildTimeoutError(baseText, waitForAttachTimeoutMs / 1e3, attachedPages)
+								text: buildTimeoutError(baseText, callTimeoutMs / 1e3, attachedPages)
 							}],
 							isError: true
 						};
@@ -5585,8 +5596,8 @@ function createDebugServer(deps) {
 				const warningPrefix = authorityWarning ? `⚠️  scheme_url 경고: ${authorityWarning}\n\n` : "";
 				const header = "This tool result is shown to the user directly — do NOT re-print the QR below in your reply (it wastes output tokens). Just tell the user to scan the QR in this output (Ctrl+O to expand if collapsed).";
 				const guiAvailable = canOpenBrowser();
-				if (openInBrowser && !guiAvailable) {
-					const headlessNote = "[open_in_browser] GUI 환경이 감지되지 않았습니다 (headless/remote 환경). open_in_browser=false로 자동 폴백합니다. 텍스트 QR을 폰 카메라로 스캔하거나, 로컬 GUI 환경에서 실행하세요.\n\n";
+				if (!guiAvailable) {
+					const headlessNote = "GUI 환경이 감지되지 않았습니다 (headless/remote 환경). 텍스트 QR을 폰 카메라로 스캔하거나, 로컬 GUI 환경에서 실행하세요.\n\n";
 					const qrHeadless = await renderQr(attachUrl);
 					const headlessText = `${warningPrefix}${headlessNote}${header}\n${JSON.stringify({
 						attachUrl,
@@ -5599,13 +5610,13 @@ function createDebugServer(deps) {
 					}] };
 					let attachedPagesHl = [];
 					try {
-						attachedPagesHl = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+						attachedPagesHl = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 					} catch {
 						attachedPagesHl = conn.listTargets();
 						return {
 							content: [{
 								type: "text",
-								text: buildTimeoutError(headlessText, waitForAttachTimeoutMs / 1e3, attachedPagesHl)
+								text: buildTimeoutError(headlessText, callTimeoutMs / 1e3, attachedPagesHl)
 							}],
 							isError: true
 						};
@@ -5616,7 +5627,7 @@ function createDebugServer(deps) {
 						text: `${headlessText}\n\n${JSON.stringify(pagesResultHl, null, 2)}`
 					}] };
 				}
-				if (openInBrowser && guiAvailable && qrHttpServer) {
+				if (guiAvailable && qrHttpServer) {
 					const browserResult = await openQrInBrowser(qrHttpServer.buildAttachPageUrl(attachUrl), `http://127.0.0.1:${qrHttpServer.port}/qr.png?u=${encodeURIComponent(attachUrl)}`);
 					if (browserResult.opened) {
 						const retriedNote = browserResult.retried ? " (1회 retry 후 성공)" : "";
@@ -5636,13 +5647,13 @@ function createDebugServer(deps) {
 						}] };
 						let attachedPages = [];
 						try {
-							attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+							attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 						} catch {
 							attachedPages = conn.listTargets();
 							return {
 								content: [{
 									type: "text",
-									text: buildTimeoutError(shortText, waitForAttachTimeoutMs / 1e3, attachedPages)
+									text: buildTimeoutError(shortText, callTimeoutMs / 1e3, attachedPages)
 								}],
 								isError: true
 							};
@@ -5661,7 +5672,7 @@ function createDebugServer(deps) {
 						...browserResult.stderrSummary ? { stderrSummary: browserResult.stderrSummary } : {}
 					};
 					const stderrNote = browserResult.stderrSummary ? `\nstderr: ${browserResult.stderrSummary}` : "";
-					const fallbackNote = `[open_in_browser] 브라우저 자동 열기에 실패했습니다. 다음 URL을 직접 브라우저에서 여세요:
+					const fallbackNote = `브라우저 자동 열기에 실패했습니다. 다음 URL을 직접 브라우저에서 여세요:
 ${browserResult.httpUrl}\n또는 PNG로 받기: ${browserResult.pngUrl}` + stderrNote + "\n\n";
 					const qr = await renderQr(attachUrl);
 					const baseText = `${warningPrefix}${fallbackNote}${header}\n${JSON.stringify({
@@ -5676,13 +5687,13 @@ ${browserResult.httpUrl}\n또는 PNG로 받기: ${browserResult.pngUrl}` + stder
 					}] };
 					let attachedPagesFb = [];
 					try {
-						attachedPagesFb = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+						attachedPagesFb = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 					} catch {
 						attachedPagesFb = conn.listTargets();
 						return {
 							content: [{
 								type: "text",
-								text: buildTimeoutError(baseText, waitForAttachTimeoutMs / 1e3, attachedPagesFb)
+								text: buildTimeoutError(baseText, callTimeoutMs / 1e3, attachedPagesFb)
 							}],
 							isError: true
 						};
@@ -5705,13 +5716,13 @@ ${browserResult.httpUrl}\n또는 PNG로 받기: ${browserResult.pngUrl}` + stder
 				}] };
 				let attachedPages = [];
 				try {
-					attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, waitForAttachTimeoutMs);
+					attachedPages = await waitForAttachWithEvents(conn, isMatchingPage, callTimeoutMs);
 				} catch {
 					attachedPages = conn.listTargets();
 					return {
 						content: [{
 							type: "text",
-							text: buildTimeoutError(baseText, waitForAttachTimeoutMs / 1e3, attachedPages)
+							text: buildTimeoutError(baseText, callTimeoutMs / 1e3, attachedPages)
 						}],
 						isError: true
 					};
@@ -7116,11 +7127,11 @@ const DEV_TOOL_DEFINITIONS = [
 				},
 				wait_for_attach: {
 					type: "boolean",
-					description: "If true, block until a page attaches."
+					description: "If true, block until a page attaches (default 60 s)."
 				},
-				open_in_browser: {
-					type: "boolean",
-					description: "If true (default), open the QR PNG in the OS browser."
+				wait_timeout_seconds: {
+					type: "number",
+					description: "Maximum seconds to wait when wait_for_attach=true (default 60, range 1–600). Invalid inputs fall back to default."
 				}
 			},
 			required: ["scheme_url"]
@@ -7331,7 +7342,7 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.84"
+		version: "0.1.86"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {