@ait-co/devtools 0.1.85 → 0.1.86

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. 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.",
+		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,7 +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."
+				},
+				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",
@@ -4775,7 +4779,7 @@ async function readMcpSdkVersion() {
 * some test environments that skip the build step).
 */
 function readDevtoolsVersion() {
-	return "0.1.85";
+	return "0.1.86";
 }
 /**
 * Derives the next recommended action from a completed diagnostics snapshot.
@@ -4851,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();
@@ -5271,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));
@@ -5279,7 +5288,7 @@ function createDebugServer(deps) {
 	const collector = collectorDep ?? new InMemoryDiagnosticsCollector();
 	const server = new Server({
 		name: "ait-debug",
-		version: "0.1.85"
+		version: "0.1.86"
 	}, { capabilities: { tools: { listChanged: true } } });
 	server.setRequestHandler(ListToolsRequestSchema, () => {
 		const conn = router.active;
@@ -5353,6 +5362,13 @@ function createDebugServer(deps) {
 		if (name === "build_attach_url") {
 			const waitForAttach = request.params.arguments?.wait_for_attach === true;
 			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;
@@ -5423,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
 							};
@@ -5460,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
 								};
@@ -5499,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
 							};
@@ -5528,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
 						};
@@ -5594,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
 						};
@@ -5631,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
 							};
@@ -5671,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
 						};
@@ -5700,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
 					};
@@ -7111,7 +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)."
+				},
+				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"]
@@ -7322,7 +7342,7 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.85"
+		version: "0.1.86"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {