@ait-co/devtools 0.1.116 → 0.1.117

package/dist/{debug-server-DlXJARIC.js → debug-server-jrI9U_f4.js}

@@ -7,12 +7,12 @@ import { fileURLToPath } from "node:url";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { parseArgs } from "node:util";
 import { homedir, platform } from "node:os";
 import * as path from "node:path";
 import { isAbsolute, join, resolve } from "node:path";
 import { randomBytes } from "node:crypto";
 import { Tunnel, bin, install } from "cloudflared";
+import { parseArgs } from "node:util";
 import * as fs from "node:fs/promises";
 import { glob } from "node:fs/promises";
 import { EventEmitter } from "node:events";
@@ -221,29 +221,6 @@ function startMaxAgeWatchdog(onExpired, opts = {}) {
 	} };
 }
 //#endregion
-//#region src/test-runner/cell.ts
-/**
-* Injects each key of `globals` into `globalThis` in the page via a single
-* `Runtime.evaluate` call. Must be called BEFORE the first `bundleTestFile`
-* inject — the cell is session-global and applies to all subsequent files.
-*
-* Throws if the CDP evaluate returns an exception.
-*
-* @param conn    - The live CDP connection (relay-attached page).
-* @param globals - Plain-JSON-serialisable key→value map to assign onto `globalThis`.
-*/
-async function injectGlobals(conn, globals) {
-	const expr = `(() => { Object.assign(globalThis, ${JSON.stringify(globals)}); return true; })()`;
-	const result = await conn.send("Runtime.evaluate", {
-		expression: expr,
-		returnByValue: true
-	});
-	if (result.exceptionDetails) {
-		const msg = result.exceptionDetails.exception?.description ?? result.exceptionDetails.text ?? "unknown error";
-		throw new Error(`injectGlobals: Runtime.evaluate threw: ${msg}`);
-	}
-}
-//#endregion
 //#region src/mcp/deeplink.ts
 /**
 * URL of the AITC Sandbox launcher PWA.
@@ -2057,7 +2034,7 @@ async function readMcpSdkVersion() {
 * some test environments that skip the build step).
 */
 function readDevtoolsVersion() {
-	return "0.1.116";
+	return "0.1.117";
 }
 /**
 * Derives the next recommended action from a completed diagnostics snapshot.
@@ -2903,6 +2880,114 @@ async function renderAndMaybeWait(deps, prep, waitForAttach, callTimeoutMs, conn
 		...totpResult() ? { totp: totpResult() } : {}
 	}, null, 2)}\n\n${qr}`);
 }
+/**
+* Builds a self-contained IIFE DOM expression that renders a dismissible
+* "Debugger Connected" badge on the bottom-left of the phone screen.
+*
+* **Pure function** — returns a JS expression string; does NOT inject it.
+* Injection is performed by {@link injectDebugIndicator} in `cell.ts`.
+*
+* The expression, when evaluated on the page, does the following:
+*   1. Early-returns if `#__ait_debug_indicator` already exists (idempotent —
+*      prevents duplicate badges on re-injection after page reload).
+*   2. Appends a fixed-position `<div id="__ait_debug_indicator">` at the
+*      bottom-left, accounting for safe-area insets.
+*   3. Attaches a `{ once: true }` `pointerdown` listener that removes the
+*      badge on first touch — one-tap dismiss.
+*
+* The expression intentionally contains NO relay URLs, wss addresses, TOTP
+* codes, or any other secrets. It is pure DOM UI text only.
+*
+* SECRET-HANDLING: this expression contains no secrets, relay URLs, wss
+* addresses, or TOTP codes whatsoever — DOM label text only.
+*
+* @param opts.label - Badge text (default: `'Debugger Connected'`).
+* @returns A JS expression string suitable for `Runtime.evaluate`.
+*/
+function buildIndicatorExpression(opts) {
+	const label = opts?.label ?? "Debugger Connected";
+	return `(() => {if (document.getElementById('__ait_debug_indicator')) return;const el = document.createElement('div');el.id = '__ait_debug_indicator';el.style.cssText = ['position:fixed','left:max(12px,calc(env(safe-area-inset-left,0px) + 8px))','bottom:max(12px,calc(env(safe-area-inset-bottom,0px) + 8px))','z-index:2147483647','background:#e5484d','color:#fff','font:bold 11px/1 system-ui,sans-serif','padding:5px 9px','border-radius:6px','pointer-events:auto','user-select:none',].join(';');el.textContent = ${JSON.stringify(label)};el.addEventListener('pointerdown', () => el.remove(), { once: true });document.body.appendChild(el);})()`;
+}
+//#endregion
+//#region src/test-runner/cell.ts
+/**
+* Cell injection utility for the `devtools-test` CLI (issue #684 §4.1).
+*
+* Injects arbitrary globals into the page via `Runtime.evaluate` BEFORE the
+* first test bundle is injected. The injected values are session-global — one
+* call covers all files in the run.
+*
+* The primary use-case is injecting `__AIT_CELL__` (sdkLine/platform) so
+* sdk-example's `aitCapture.ts` picks up the correct test-axis values instead
+* of falling back to `'2.x'`/`'mock'`.
+*
+* devtools does NOT know the shape of `__AIT_CELL__` — it only provides the
+* general injection mechanism. The caller (CLI or MCP auto-attach path) is
+* responsible for constructing the cell object.
+*
+* SECRET-HANDLING: cell values (sdkLine/platform) are not secrets and may be
+* logged at the caller's discretion. This module does NOT log them itself.
+*
+* Node-only. react-free. CdpConnection only.
+*/
+/**
+* Injects each key of `globals` into `globalThis` in the page via a single
+* `Runtime.evaluate` call. Must be called BEFORE the first `bundleTestFile`
+* inject — the cell is session-global and applies to all subsequent files.
+*
+* Throws if the CDP evaluate returns an exception.
+*
+* @param conn    - The live CDP connection (relay-attached page).
+* @param globals - Plain-JSON-serialisable key→value map to assign onto `globalThis`.
+*/
+async function injectGlobals(conn, globals) {
+	const expr = `(() => { Object.assign(globalThis, ${JSON.stringify(globals)}); return true; })()`;
+	const result = await conn.send("Runtime.evaluate", {
+		expression: expr,
+		returnByValue: true
+	});
+	if (result.exceptionDetails) {
+		const msg = result.exceptionDetails.exception?.description ?? result.exceptionDetails.text ?? "unknown error";
+		throw new Error(`injectGlobals: Runtime.evaluate threw: ${msg}`);
+	}
+}
+/**
+* Injects the "Debugger Connected" on-phone indicator via `Runtime.evaluate`.
+*
+* Uses the same CDP mechanism as {@link injectGlobals} — a single
+* `Runtime.evaluate` round-trip with the expression built by
+* {@link buildIndicatorExpression}. The indicator is a dismissible red badge
+* rendered at the bottom-left of the page (position:fixed, safe-area-aware).
+*
+* **Isolation**: unlike {@link injectGlobals}, this function NEVER throws to
+* its caller. Injection failure (e.g. page detached during inject, CSS not
+* supported) is swallowed and logged as `console.debug` — the badge is
+* informational UI and must never block attach success or test execution.
+* This is the same fire-and-forget spirit as the eruda mount in
+* `src/in-app/attach.ts`.
+*
+* Call this ONLY on the manual debug paths (start_attach MCP, devtools-test
+* CLI). Do NOT call on the `run_tests` auto-attach path — the red badge
+* would contaminate screenshots, measure_safe_area probes, and DOM snapshots
+* taken during automated measurement runs.
+*
+* SECRET-HANDLING: the injected expression contains no secrets, relay URLs,
+* wss addresses, or TOTP codes — it is pure DOM UI text built by
+* {@link buildIndicatorExpression}.
+*
+* @param conn - The live CDP connection (relay-attached page).
+* @param opts - Optional overrides forwarded to {@link buildIndicatorExpression}.
+*/
+async function injectDebugIndicator(conn, opts) {
+	try {
+		await conn.send("Runtime.evaluate", {
+			expression: buildIndicatorExpression(opts),
+			returnByValue: true
+		});
+	} catch (err) {
+		console.debug("[@ait-co/devtools] debug indicator inject skipped:", err);
+	}
+}
 //#endregion
 //#region src/test-runner/discover.ts
 /**
@@ -3597,6 +3682,7 @@ async function main(argv = process.argv.slice(2)) {
 			return;
 		}
 		for (const chunk of waitResult.content) if (chunk.type === "text") process.stdout.write(`${chunk.text}\n`);
+		await injectDebugIndicator(family.connection);
 		if (hasCell) {
 			const cell = {};
 			if (cellSdkLine !== void 0) cell.sdkLine = cellSdkLine;
@@ -6688,7 +6774,7 @@ function createDebugServer(deps) {
 	};
 	const server = new Server({
 		name: "ait-debug",
-		version: "0.1.116"
+		version: "0.1.117"
 	}, { capabilities: { tools: { listChanged: true } } });
 	server.setRequestHandler(ListToolsRequestSchema, () => {
 		const conn = router.active;
@@ -6750,7 +6836,9 @@ function createDebugServer(deps) {
 			try {
 				const prep = await prepareAttach(attachDeps, attachEnv, args, attachConn);
 				if (!prep.ok) return prep.error;
-				return await renderAndMaybeWait(attachDeps, prep, waitForAttach, callTimeoutMs, attachConn);
+				const attachResult = await renderAndMaybeWait(attachDeps, prep, waitForAttach, callTimeoutMs, attachConn);
+				if (!attachResult.isError) await injectDebugIndicator(attachConn);
+				return attachResult;
 			} catch (err) {
 				return errorResult(err, name);
 			}
@@ -8168,4 +8256,4 @@ async function runMobileDebugServer(options = {}) {
 //#endregion
 export { wrapEnvelope as a, getSdkCallHistory as c, tierRejectionError as d, runMobileDebugServer as i, isAitToolName as l, runDebugServer as n, getMockState as o, runLocalDebugServer as r, getOperationalEnvironment as s, debug_server_exports as t, mcpError as u };
 
-//# sourceMappingURL=debug-server-DlXJARIC.js.map
+//# sourceMappingURL=debug-server-jrI9U_f4.js.map