@ait-co/devtools 0.1.72 → 0.1.74

package/dist/mcp/cli.js

@@ -1012,6 +1012,11 @@ const LAUNCHER_URL = "https://devtools.aitc.dev/launcher/";
 * is injected. `&at=<totpCode>` is added only when a code is provided (same
 * conditional as {@link buildDeepLinkAttachUrl}).
 *
+* When `opts.name` is given (non-blank), it is added as `&name=` so the
+* launcher partner bar shows the app name instead of the generic default (#498).
+* When `opts.icon` is an absolute https:// URL, it is added as `&icon=` so the
+* launcher can render an icon next to the title (#498).
+*
 * Unlike `buildDeepLinkAttachUrl` (which splices onto a non-special scheme URL
 * via raw string manipulation), this function uses WHATWG `encodeURIComponent`
 * because the target is a standard `https:` URL.
@@ -1026,12 +1031,23 @@ const LAUNCHER_URL = "https://devtools.aitc.dev/launcher/";
 * @param totpCode - Optional current TOTP code (6 digits). When provided, it
 *   is appended as `at=<totpCode>`. Must be computed at call time — it rotates
 *   every 30 s. Omit when TOTP is disabled.
+* @param opts - Optional app identity hints: `name` and `icon` (#498).
 * @returns The launcher deep-link URL with `?url=<enc>&debug=1&relay=<enc>
-*   [&at=<code>]` params.
+*   [&at=<code>][&name=<enc>][&icon=<enc>]` params.
 */
-function buildLauncherAttachUrl(tunnelUrl, wssUrl, totpCode) {
+function buildLauncherAttachUrl(tunnelUrl, wssUrl, totpCode, opts) {
 	let url = `${LAUNCHER_URL}?url=${encodeURIComponent(tunnelUrl)}&debug=1&relay=${encodeURIComponent(wssUrl)}`;
 	if (totpCode !== void 0 && totpCode !== "") url += `&at=${encodeURIComponent(totpCode)}`;
+	if (opts?.name !== void 0 && opts.name.trim() !== "") url += `&name=${encodeURIComponent(opts.name.trim())}`;
+	if (opts?.icon !== void 0) {
+		let iconParsed;
+		try {
+			iconParsed = new URL(opts.icon);
+		} catch {
+			iconParsed = null;
+		}
+		if (iconParsed?.protocol === "https:") url += `&icon=${encodeURIComponent(opts.icon)}`;
+	}
 	return url;
 }
 /**
@@ -2080,6 +2096,9 @@ const en = {
 	"dashboard.pages.empty": "No attached pages",
 	"dashboard.url.copy": "Copy",
 	"dashboard.url.copied": "Copied",
+	"dashboard.inspector.section": "Inspector",
+	"dashboard.inspector.open": "Open inspector",
+	"dashboard.inspector.waiting": "Inspector URL pending — appears after a page attaches",
 	"attach.title": "AIT Debug Session — QR Scan",
 	"attach.deployment": "deployment: {label}",
 	"attach.steps.section": "How to scan",
@@ -2110,7 +2129,6 @@ const en = {
 	"launcher.urlPlaceholder": "https://example.trycloudflare.com",
 	"launcher.openBtn": "Open",
 	"launcher.scanBtn": "Scan QR with camera",
-	"launcher.rescanBtn": "Rescan",
 	"launcher.noCamera": "No camera available — paste the URL instead.",
 	"launcher.cameraError": "Could not access the camera — paste the URL instead.",
 	"launcher.invalidUrlHttps": "Enter a valid https:// URL (the tunnel URL from your terminal).",
@@ -2119,11 +2137,16 @@ const en = {
 	"launcher.debugAuthFailedHint": "The QR code may have expired. Scan a fresh QR code.",
 	"launcher.debugAuthExpiredHint": "The debug session has expired. Scan a fresh QR from the attach page on your Mac.",
 	"launcher.debugAuthRescanCta": "Scan a new QR",
-	"launcher.diagFab": "Diag",
 	"launcher.diagTitle": "Viewport diagnostics",
 	"launcher.diagYes": "yes",
 	"launcher.diagNo": "no",
-	"launcher.letterboxDetected": "Display area is {pt}pt short — likely an iOS standalone letterbox. Removing and re-adding the launcher to the home screen may fix it."
+	"launcher.letterboxDetected": "Display area is {pt}pt short — likely an iOS standalone letterbox. Removing and re-adding the launcher to the home screen may fix it.",
+	"launcher.navbar.defaultTitle": "Mini App",
+	"launcher.navbar.menu": "Menu",
+	"launcher.navbar.close": "Close",
+	"launcher.navbar.menuRescan": "Rescan",
+	"launcher.navbar.menuDiag": "Viewport diagnostics",
+	"launcher.navbar.menuLanguage": "Language"
 };
 //#endregion
 //#region src/i18n/index.ts
@@ -2324,6 +2347,9 @@ const tables = {
 		"dashboard.pages.empty": "attach된 페이지 없음",
 		"dashboard.url.copy": "복사",
 		"dashboard.url.copied": "복사됨",
+		"dashboard.inspector.section": "인스펙터",
+		"dashboard.inspector.open": "인스펙터 열기",
+		"dashboard.inspector.waiting": "인스펙터 URL 대기 중 (페이지 attach 후 표시됩니다)",
 		"attach.title": "AIT 디버그 세션 — QR 스캔",
 		"attach.deployment": "deployment: {label}",
 		"attach.steps.section": "스캔 절차",
@@ -2354,7 +2380,6 @@ const tables = {
 		"launcher.urlPlaceholder": "https://example.trycloudflare.com",
 		"launcher.openBtn": "Open",
 		"launcher.scanBtn": "QR 카메라로 스캔",
-		"launcher.rescanBtn": "Rescan",
 		"launcher.noCamera": "카메라를 사용할 수 없습니다 — URL을 직접 붙여넣으세요.",
 		"launcher.cameraError": "카메라에 접근할 수 없습니다 — URL을 직접 붙여넣으세요.",
 		"launcher.invalidUrlHttps": "올바른 https:// URL을 입력하세요 (터미널의 터널 URL).",
@@ -2363,11 +2388,16 @@ const tables = {
 		"launcher.debugAuthFailedHint": "QR 코드가 만료되었을 수 있어요. 새 QR을 다시 스캔하세요.",
 		"launcher.debugAuthExpiredHint": "디버그 세션이 만료됐어요. Mac의 attach 페이지에서 새 QR을 스캔하세요.",
 		"launcher.debugAuthRescanCta": "새 QR 스캔하기",
-		"launcher.diagFab": "진단",
 		"launcher.diagTitle": "뷰포트 진단",
 		"launcher.diagYes": "예",
 		"launcher.diagNo": "아니요",
-		"launcher.letterboxDetected": "표시 영역이 {pt}pt 부족합니다 — iOS standalone letterbox로 보입니다. 런처를 홈 화면에서 제거 후 다시 설치하면 해소될 수 있어요."
+		"launcher.letterboxDetected": "표시 영역이 {pt}pt 부족합니다 — iOS standalone letterbox로 보입니다. 런처를 홈 화면에서 제거 후 다시 설치하면 해소될 수 있어요.",
+		"launcher.navbar.defaultTitle": "미니앱",
+		"launcher.navbar.menu": "메뉴",
+		"launcher.navbar.close": "닫기",
+		"launcher.navbar.menuRescan": "다시 스캔",
+		"launcher.navbar.menuDiag": "뷰포트 진단",
+		"launcher.navbar.menuLanguage": "언어"
 	},
 	en
 };
@@ -2455,6 +2485,14 @@ img.qr {
 }
 .copy-btn:hover { background: #30363d; }
 .hint { font-size: 0.85rem; opacity: 0.5; margin: 0.25rem 0 0; }
+.inspector-link {
+  display: inline-block; margin-top: 0.5rem;
+  padding: 0.45rem 1rem; border-radius: 6px;
+  background: #1f6feb; color: #fff; font-size: 0.85rem; font-weight: 600;
+  text-decoration: none; text-align: center;
+}
+.inspector-link:hover { background: #388bfd; }
+.inspector-hint { display: inline-block; margin-top: 0.5rem; font-size: 0.8rem; opacity: 0.45; }
 ul { margin: 0; padding-left: 1.25rem; }
 li { margin-bottom: 0.35rem; font-size: 0.85rem; line-height: 1.5; }
 li.empty { opacity: 0.4; list-style: none; padding-left: 0; }
@@ -2464,7 +2502,7 @@ hr { border: none; border-top: 1px solid #21262d; width: 100%; margin: 0; }
 .lang-switcher { display: flex; gap: 0.5rem; font-size: 0.75rem; }
 .lang-switcher a { color: #58a6ff; text-decoration: none; opacity: 0.6; }
 .lang-switcher a.active { font-weight: 700; text-decoration: underline; opacity: 1; }
-</style></head><body><h1>AIT 디버그 Dashboard</h1>__LANG_SWITCHER__<p class="updated" id="updated">마지막 갱신: __NOW__</p><section><h2>터널 상태</h2><span class="status __TUNNEL_CLASS__" id="tunnel-status">__TUNNEL_STATUS__</span></section><hr/><section><h2>Attach QR</h2><div id="attach-section">__ATTACH_SECTION__</div></section>__PAGES_SECTION__</body></html>`;
+</style></head><body><h1>AIT 디버그 Dashboard</h1>__LANG_SWITCHER__<p class="updated" id="updated">마지막 갱신: __NOW__</p><section><h2>터널 상태</h2><span class="status __TUNNEL_CLASS__" id="tunnel-status">__TUNNEL_STATUS__</span></section><hr/><section><h2>Attach QR</h2><div id="attach-section">__ATTACH_SECTION__</div></section><hr/><section id="inspector-section"><h2>인스펙터</h2>__INSPECTOR_SECTION__</section>__PAGES_SECTION__</body></html>`;
 const attachChromeHtmlKoSandbox = `<!DOCTYPE html>
 <html lang="ko"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" as="image" href="__QR_DATA_URL__"/><title>AIT 디버그 세션 — QR 스캔</title><style>
 *, *::before, *::after { box-sizing: border-box; }
@@ -2607,6 +2645,14 @@ img.qr {
 }
 .copy-btn:hover { background: #30363d; }
 .hint { font-size: 0.85rem; opacity: 0.5; margin: 0.25rem 0 0; }
+.inspector-link {
+  display: inline-block; margin-top: 0.5rem;
+  padding: 0.45rem 1rem; border-radius: 6px;
+  background: #1f6feb; color: #fff; font-size: 0.85rem; font-weight: 600;
+  text-decoration: none; text-align: center;
+}
+.inspector-link:hover { background: #388bfd; }
+.inspector-hint { display: inline-block; margin-top: 0.5rem; font-size: 0.8rem; opacity: 0.45; }
 ul { margin: 0; padding-left: 1.25rem; }
 li { margin-bottom: 0.35rem; font-size: 0.85rem; line-height: 1.5; }
 li.empty { opacity: 0.4; list-style: none; padding-left: 0; }
@@ -2616,7 +2662,7 @@ hr { border: none; border-top: 1px solid #21262d; width: 100%; margin: 0; }
 .lang-switcher { display: flex; gap: 0.5rem; font-size: 0.75rem; }
 .lang-switcher a { color: #58a6ff; text-decoration: none; opacity: 0.6; }
 .lang-switcher a.active { font-weight: 700; text-decoration: underline; opacity: 1; }
-</style></head><body><h1>AIT Debug Dashboard</h1>__LANG_SWITCHER__<p class="updated" id="updated">Last updated: __NOW__</p><section><h2>Tunnel status</h2><span class="status __TUNNEL_CLASS__" id="tunnel-status">__TUNNEL_STATUS__</span></section><hr/><section><h2>Attach QR</h2><div id="attach-section">__ATTACH_SECTION__</div></section>__PAGES_SECTION__</body></html>`;
+</style></head><body><h1>AIT Debug Dashboard</h1>__LANG_SWITCHER__<p class="updated" id="updated">Last updated: __NOW__</p><section><h2>Tunnel status</h2><span class="status __TUNNEL_CLASS__" id="tunnel-status">__TUNNEL_STATUS__</span></section><hr/><section><h2>Attach QR</h2><div id="attach-section">__ATTACH_SECTION__</div></section><hr/><section id="inspector-section"><h2>Inspector</h2>__INSPECTOR_SECTION__</section>__PAGES_SECTION__</body></html>`;
 const attachChromeHtmlEnSandbox = `<!DOCTYPE html>
 <html lang="en"><head><meta charSet="utf-8"/><meta name="viewport" content="width=device-width, initial-scale=1"/><link rel="preload" as="image" href="__QR_DATA_URL__"/><title>AIT Debug Session — QR Scan</title><style>
 *, *::before, *::after { box-sizing: border-box; }
@@ -2793,13 +2839,15 @@ function buildLangSwitcher(path, existingParams, locale, s) {
 *
 * 동적 파트 분류:
 *   - "token-fill": 단일 값 교체 (__NOW__, __TUNNEL_CLASS__, __TUNNEL_STATUS__,
-*     __ATTACH_SECTION__)
+*     __ATTACH_SECTION__, __INSPECTOR_SECTION__)
 *   - "runtime builder": 가변 길이 구조 (__PAGES_SECTION__ — 조건부 렌더 + 가변 rows)
 *   - "suffix": inline SSE <script> (빌드 파이프라인 없는 클라이언트 스크립트, locale
 *     aware 문자열 포함)
 *
 * SECRET-HANDLING:
 *   - attachUrl은 url-box 안에서만 노출 (TOTP at= 코드 캡슐 그대로).
+*   - inspectorUrl은 anchor href 안에서만 노출 (TOTP at= 코드 캡슐 그대로).
+*     relay host + TOTP 코드가 담길 수 있으나 대시보드 HTML은 의도된 transport.
 *   - tunnel wssUrl은 "터널 연결됨" 상태 표시에서 UP/DOWN만 노출.
 *     wssUrl 값 자체는 dashboard HTML에 넣지 않는다.
 */
@@ -2814,6 +2862,9 @@ function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new U
 		const copyLabel = escapeHtml(s("dashboard.url.copy"));
 		attachSection = `<img class="qr" src="${qrDataUrl}" alt="attach QR" /><div class="url-row"><p class="url-box" id="url-box">${safeAttachUrl}</p><button class="copy-btn" id="copy-btn" type="button" aria-label="${copyLabel}">${copyLabel}</button></div>`;
 	} else attachSection = `<p class="hint">${escapeHtml(s("dashboard.attach.hint"))}</p>`;
+	let inspectorSection;
+	if (state.inspectorUrl) inspectorSection = `<a class="inspector-link" id="inspector-link" href="${escapeHtml(state.inspectorUrl)}" target="_blank" rel="noopener noreferrer">${escapeHtml(s("dashboard.inspector.open"))}</a>`;
+	else inspectorSection = `<span class="inspector-hint" id="inspector-link">${escapeHtml(s("dashboard.inspector.waiting"))}</span>`;
 	const pagesSection = state.pages === null ? "" : `<hr /><section id="pages-section"><h2>${escapeHtml(s("dashboard.pages.section"))}</h2><ul id="pages-list">${state.pages.length > 0 ? state.pages.map((p) => {
 		return `<li><span class="page-id">${escapeHtml(p.id)}</span> <span class="page-url">${escapeHtml(p.url.slice(0, 120))}</span></li>`;
 	}).join("\n") : `<li class="empty">${escapeHtml(s("dashboard.pages.empty"))}</li>`}</ul></section>`;
@@ -2824,10 +2875,12 @@ function buildDashboardHtml(state, qrDataUrl, locale, path = "/", params = new U
 		attachHint: JSON.stringify(s("dashboard.attach.hint")),
 		copyLabel: JSON.stringify(s("dashboard.url.copy")),
 		copiedLabel: JSON.stringify(s("dashboard.url.copied")),
+		inspectorOpenLabel: JSON.stringify(s("dashboard.inspector.open")),
+		inspectorWaitingLabel: JSON.stringify(s("dashboard.inspector.waiting")),
 		dashboardSurface: true
 	};
 	const langSwitcher = buildLangSwitcher(path, params, locale, s);
-	const filled = dashboardChromeByLocale[locale].replaceAll("__LANG_SWITCHER__", langSwitcher).replaceAll("__NOW__", escapeHtml(now)).replaceAll("__TUNNEL_CLASS__", tunnelClass).replaceAll("__TUNNEL_STATUS__", escapeHtml(tunnelStatus)).replaceAll("__ATTACH_SECTION__", attachSection).replaceAll("__PAGES_SECTION__", pagesSection);
+	const filled = dashboardChromeByLocale[locale].replaceAll("__LANG_SWITCHER__", langSwitcher).replaceAll("__NOW__", escapeHtml(now)).replaceAll("__TUNNEL_CLASS__", tunnelClass).replaceAll("__TUNNEL_STATUS__", escapeHtml(tunnelStatus)).replaceAll("__ATTACH_SECTION__", attachSection).replaceAll("__INSPECTOR_SECTION__", inspectorSection).replaceAll("__PAGES_SECTION__", pagesSection);
 	const sseScript = buildSseScript(sseStrings);
 	return filled.replace("</body>", `${sseScript}\n</body>`);
 }
@@ -2865,6 +2918,8 @@ function buildSseScript(strings) {
       var ATTACH_HINT = ${strings.attachHint};
       var COPY_LABEL = ${strings.copyLabel};
       var COPIED_LABEL = ${strings.copiedLabel};
+      var INSPECTOR_OPEN_LABEL = ${strings.inspectorOpenLabel};
+      var INSPECTOR_WAITING_LABEL = ${strings.inspectorWaitingLabel};
 
       // ── 클립보드 복사 헬퍼 ────────────────────────────────────────────────
       function copyText(text) {
@@ -2978,6 +3033,17 @@ function buildSseScript(strings) {
               sec.innerHTML = '<p class=\\"hint\\">' + ATTACH_HINT + '</p>';`}
             }
           }
+          // 인스펙터 링크 갱신 — #inspector-link (#503).
+          // SECRET-HANDLING: inspectorUrl을 console.log 등으로 출력하지 않는다.
+          var insp = document.getElementById('inspector-link');
+          if (insp) {
+            if (s.inspectorUrl) {
+              var safeInspUrl = String(s.inspectorUrl).slice(0, 2000).replace(/[<>&"']/g, function (c) { return '&#' + c.charCodeAt(0) + ';'; });
+              insp.outerHTML = '<a class=\\"inspector-link\\" id=\\"inspector-link\\" href=\\"' + safeInspUrl + '\\" target=\\"_blank\\" rel=\\"noopener noreferrer\\">' + INSPECTOR_OPEN_LABEL + '</a>';
+            } else {
+              insp.outerHTML = '<span class=\\"inspector-hint\\" id=\\"inspector-link\\">' + INSPECTOR_WAITING_LABEL + '</span>';
+            }
+          }
           // 갱신 시각 (dashboard만 #updated 요소 있음)
           var upd = document.getElementById('updated');
           if (upd) upd.textContent = upd.textContent.replace(/[^ ]+$/, new Date().toISOString());
@@ -3022,6 +3088,8 @@ function buildAttachHtml(qrDataUrl, safeLabel, safeAttachUrl, locale, path = "/a
 		attachHint: JSON.stringify(s("dashboard.attach.hint")),
 		copyLabel: JSON.stringify(s("dashboard.url.copy")),
 		copiedLabel: JSON.stringify(s("dashboard.url.copied")),
+		inspectorOpenLabel: JSON.stringify(s("dashboard.inspector.open")),
+		inspectorWaitingLabel: JSON.stringify(s("dashboard.inspector.waiting")),
 		dashboardSurface: false
 	});
 	return filled.replace("</body>", `${sseScript}\n</body>`);
@@ -3045,7 +3113,8 @@ async function startQrHttpServer(getDashboardState) {
 				wssUrl: state.tunnel.wssUrl
 			},
 			pages: state.pages,
-			attachUrl: state.attachUrl
+			attachUrl: state.attachUrl,
+			inspectorUrl: state.inspectorUrl ?? null
 		});
 		res.write(`data: ${payload}\n\n`);
 	}
@@ -3552,7 +3621,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=…). 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.",
+		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.",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -4566,7 +4635,7 @@ async function readMcpSdkVersion() {
 * some test environments that skip the build step).
 */
 function readDevtoolsVersion() {
-	return "0.1.72";
+	return "0.1.74";
 }
 /**
 * Derives the next recommended action from a completed diagnostics snapshot.
@@ -5070,7 +5139,7 @@ function createDebugServer(deps) {
 	const collector = collectorDep ?? new InMemoryDiagnosticsCollector();
 	const server = new Server({
 		name: "ait-debug",
-		version: "0.1.72"
+		version: "0.1.74"
 	}, { capabilities: { tools: { listChanged: true } } });
 	server.setRequestHandler(ListToolsRequestSchema, () => {
 		const conn = router.active;
@@ -5170,11 +5239,20 @@ function createDebugServer(deps) {
 						expiresAt: new Date(expiresAtMs).toISOString()
 					};
 				}
-				const attachUrl = buildLauncherAttachUrl(tunnelHttpUrl, tunnelStatus.wssUrl, totpCode);
+				let launcherAppName;
+				if (buildProjectRoot !== void 0) try {
+					const { readFileSync } = await import("node:fs");
+					const pkgRaw = readFileSync(`${buildProjectRoot}/package.json`, "utf8");
+					const pkg = JSON.parse(pkgRaw);
+					const rawName = typeof pkg.name === "string" ? pkg.name : "";
+					launcherAppName = (rawName.includes("/") ? rawName.slice(rawName.indexOf("/") + 1) : rawName).trim() || void 0;
+				} catch {}
+				const attachUrl = buildLauncherAttachUrl(tunnelHttpUrl, tunnelStatus.wssUrl, totpCode, { name: launcherAppName });
 				onAttachUrlBuilt?.({
 					kind: "launcher",
 					tunnelHttpUrl,
-					wssUrl: tunnelStatus.wssUrl
+					wssUrl: tunnelStatus.wssUrl,
+					appName: launcherAppName
 				});
 				const relayUrl = tunnelStatus.wssUrl;
 				const totp = totpMeta;
@@ -5610,7 +5688,7 @@ function makeSingleConnectionRouter(connection) {
 function rebuildAttachUrl(parts) {
 	const secret = process.env.AIT_DEBUG_TOTP_SECRET;
 	const code = secret ? generateTotp(secret) : void 0;
-	return parts.kind === "launcher" ? buildLauncherAttachUrl(parts.tunnelHttpUrl, parts.wssUrl, code) : buildDeepLinkAttachUrl(parts.schemeUrl, parts.wssUrl, code);
+	return parts.kind === "launcher" ? buildLauncherAttachUrl(parts.tunnelHttpUrl, parts.wssUrl, code, { name: parts.appName }) : buildDeepLinkAttachUrl(parts.schemeUrl, parts.wssUrl, code);
 }
 function jsonResult$1(value) {
 	return { content: [{
@@ -5987,6 +6065,15 @@ var DualConnectionRouter = class {
 	get activeRelayOrigin() {
 		return this.activeFamily?.relayOrigin;
 	}
+	/**
+	* Local HTTP base URL of the Chii relay for the currently-active family (#503).
+	* Used by `getDashboardState` to build the inspector URL via `buildChiiInspectorUrl`.
+	* Returns `undefined` when no relay family is active (local/mock mode).
+	* SECRET-HANDLING: not logged — callers must not write this to stdout/logs.
+	*/
+	get activeRelayHttpUrl() {
+		return this.activeFamily?.relayHttpUrl;
+	}
 	/** Every booted family (for unified shutdown). All families are lazy (#396). */
 	bootedFamilies() {
 		return [...this.lazyFamilies.values()];
@@ -6114,18 +6201,25 @@ async function runDebugServer(options = {}) {
 		return router.active;
 	});
 	let lastAttachParts = null;
-	const getDashboardState = () => ({
-		tunnel: {
-			up: router.relayTunnelStatus().up,
-			wssUrl: router.relayTunnelStatus().wssUrl
-		},
-		pages: router.active.listTargets().map((t) => ({
-			id: t.id,
-			url: t.url
-		})),
-		attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null,
-		mode: deriveEnvironment(router.active.kind, getLiveIntent(), router.activeRelayOrigin)
-	});
+	const getDashboardState = () => {
+		const targets = router.active.listTargets();
+		const relayHttpUrl = router.activeRelayHttpUrl;
+		const totpSecret = process.env.AIT_DEBUG_TOTP_SECRET;
+		const inspectorUrl = relayHttpUrl && targets.length > 0 ? buildChiiInspectorUrl(relayHttpUrl, targets[0].id, totpSecret ? () => generateTotp(totpSecret, Date.now()) : void 0) : null;
+		return {
+			tunnel: {
+				up: router.relayTunnelStatus().up,
+				wssUrl: router.relayTunnelStatus().wssUrl
+			},
+			pages: targets.map((t) => ({
+				id: t.id,
+				url: t.url
+			})),
+			attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null,
+			inspectorUrl,
+			mode: deriveEnvironment(router.active.kind, getLiveIntent(), router.activeRelayOrigin)
+		};
+	};
 	let qrServer;
 	try {
 		qrServer = await startQrHttpServer(getDashboardState);
@@ -6280,17 +6374,24 @@ async function runLocalDebugServer(options = {}) {
 		return router.active;
 	});
 	let lastAttachParts = null;
-	const getDashboardState = () => ({
-		tunnel: {
-			up: router.relayTunnelStatus().up,
-			wssUrl: router.relayTunnelStatus().wssUrl
-		},
-		pages: router.active.listTargets().map((t) => ({
-			id: t.id,
-			url: t.url
-		})),
-		attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null
-	});
+	const getDashboardState = () => {
+		const targets = router.active.listTargets();
+		const relayHttpUrl = router.activeRelayHttpUrl;
+		const totpSecret = process.env.AIT_DEBUG_TOTP_SECRET;
+		const inspectorUrl = relayHttpUrl && targets.length > 0 ? buildChiiInspectorUrl(relayHttpUrl, targets[0].id, totpSecret ? () => generateTotp(totpSecret, Date.now()) : void 0) : null;
+		return {
+			tunnel: {
+				up: router.relayTunnelStatus().up,
+				wssUrl: router.relayTunnelStatus().wssUrl
+			},
+			pages: targets.map((t) => ({
+				id: t.id,
+				url: t.url
+			})),
+			attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null,
+			inspectorUrl
+		};
+	};
 	let qrServer;
 	try {
 		qrServer = await startQrHttpServer(getDashboardState);
@@ -6429,17 +6530,24 @@ async function runMobileDebugServer(options = {}) {
 		return router.active;
 	});
 	let lastAttachParts = null;
-	const getDashboardState = () => ({
-		tunnel: {
-			up: router.relayTunnelStatus().up,
-			wssUrl: router.relayTunnelStatus().wssUrl
-		},
-		pages: router.active.listTargets().map((t) => ({
-			id: t.id,
-			url: t.url
-		})),
-		attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null
-	});
+	const getDashboardState = () => {
+		const targets = router.active.listTargets();
+		const relayHttpUrl = router.activeRelayHttpUrl;
+		const totpSecret = process.env.AIT_DEBUG_TOTP_SECRET;
+		const inspectorUrl = relayHttpUrl && targets.length > 0 ? buildChiiInspectorUrl(relayHttpUrl, targets[0].id, totpSecret ? () => generateTotp(totpSecret, Date.now()) : void 0) : null;
+		return {
+			tunnel: {
+				up: router.relayTunnelStatus().up,
+				wssUrl: router.relayTunnelStatus().wssUrl
+			},
+			pages: targets.map((t) => ({
+				id: t.id,
+				url: t.url
+			})),
+			attachUrl: lastAttachParts ? rebuildAttachUrl(lastAttachParts) : null,
+			inspectorUrl
+		};
+	};
 	let qrServer;
 	try {
 		qrServer = await startQrHttpServer(getDashboardState);
@@ -6957,7 +7065,7 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.72"
+		version: "0.1.74"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {