@ait-co/devtools 0.1.136 → 0.1.138

package/dist/{debug-server-DApo0o3t.js → debug-server-BQHbaKPT.js}

@@ -1,10 +1,10 @@
-import { a as ChiiCdpConnection, o as RELAY_AUTH_REJECT_CLOSE_CODE, s as RELAY_AUTH_REJECT_REASON } from "./relay-worker-UK0nBfDX.js";
-import { c as generateAttachToken, d as startQuickTunnel, f as startTunnelHealthProbe, l as makeTunnelStatus, m as logInfo, p as logError, u as printAttachBanner } from "./attach-orchestrator-CMoDuG2A.js";
+import { a as ChiiCdpConnection, o as RELAY_AUTH_REJECT_CLOSE_CODE, s as RELAY_AUTH_REJECT_REASON } from "./relay-worker-BUXI0K0b.js";
+import { c as generateAttachToken, d as startQuickTunnel, f as startTunnelHealthProbe, l as makeTunnelStatus, m as logInfo, p as logError, u as printAttachBanner } from "./attach-orchestrator-BG8TGJOZ.js";
 import { n as buildRelayVerifyAuth, t as assertRelayAuthConfigured } from "./totp-DAxys-r0.js";
-import "./cell-DHA578lX.js";
-import "./relay-factory-DnuTH4v-.js";
-import "./qr-http-server-ZkT6F7is.js";
-import "./relay-secret-store-DGduVJhs.js";
+import "./cell-Dtgtusog.js";
+import "./relay-factory-C1X3G3WY.js";
+import "./qr-http-server-D4rGz8M7.js";
+import "./relay-secret-store-WJ8EGkIl.js";
 import { createRequire } from "node:module";
 import "node:events";
 import { WebSocketServer } from "ws";
@@ -20,7 +20,21 @@ USAGE
 
 OPTIONS
   --scheme-url <url>      intoss-private:// URL from \`ait deploy --scheme-only\`
-                          (required for standalone relay attach / env3)
+                          (required for standalone relay attach / env3). Unused
+                          and ignored when --attach-launcher is set.
+  --attach-launcher       Attach over the env-2 AITC Sandbox PWA launcher
+                          (real-device WebKit) instead of the env-3 intoss
+                          scheme deep-link. The relay/QR/dashboard/attach-wait
+                          are identical; only the QR is a launcher deep-link.
+                          Requires --app-url. The SDK still hits the mock in
+                          env 2, so this measures the mock + standard Web API
+                          layer's engine-attributable behavior (env1↔env2
+                          equivalence), NOT native-bridge fidelity (that is env3).
+  --app-url <url>         The consumer dev server's HTTP tunnel URL (e.g. the
+                          *.trycloudflare.com URL from \`pnpm dev:phone:cdp\`)
+                          that the launcher PWA frames. REQUIRED with
+                          --attach-launcher; ignored otherwise. SECRET: a tunnel
+                          host — never printed; it rides only inside the QR.
   --timeout <ms>          Per-file evaluate timeout in ms (default: 60000).
                           Controls how long a single test file is allowed to run
                           before it is considered hung. Does NOT affect how long
@@ -32,7 +46,10 @@ OPTIONS
                           Pass a value to bound the wait for CI/headless runs.
   --cell-sdk-line <line>  SDK line to inject as __AIT_CELL__.sdkLine (2.x|3.x)
   --cell-platform <plat>  Platform to inject as __AIT_CELL__.platform
-                          (mock|ios|android, default: AIT_CELL_PLATFORM env)
+                          (mock|ios|android|ios-pwa, default: AIT_CELL_PLATFORM
+                          env). Use ios-pwa for env-2 (--attach-launcher) runs
+                          so env1(mock@desktop) and env2(mock@WebKit) captures
+                          stay distinguishable. An unknown value is rejected.
   --report-dir <dir>      Persist a runner-agnostic report + captures to <dir>
                           (report: <sdkLine>.<platform>.json; captures:
                           <dir>/.ait-capture/<category>.<sdkLine>.<platform>.json).
@@ -47,6 +64,28 @@ OPTIONS
   --headless              Disable browser auto-open (text QR only)
   --project-root <dir>    Project root for .ait_relay secret lookup
                           (default: current working directory)
+  --pace <ms>             Minimum delay in ms between test-to-test AND
+                          file-to-file bridge calls (default: 0, i.e. no
+                          added delay — today's behavior byte-for-byte).
+                          Falls back to the AIT_PACE env var when omitted
+                          (--pace takes precedence over the env var when both
+                          are given). Use on a 2.x cell scan when the native
+                          per-method bridge rate limit (APP_BRIDGE_THROTTLED,
+                          devtools#767) is rejecting rapid same-method calls —
+                          3.x cells are unaffected by that limiter and do not
+                          need this flag.
+  --pace-method <ms>      Minimum delay in ms BETWEEN calls to the SAME named
+                          SDK function — paces a same-method burst WITHIN a
+                          single test body (e.g. a clipboard happy-path loop
+                          calling setClipboardText/getClipboardText 8 times
+                          back to back), which --pace's test/file spacing
+                          cannot reach (devtools#769). Falls back to the
+                          AIT_PACE_METHOD env var when omitted (--pace-method
+                          takes precedence over the env var when both are
+                          given). Default: 250ms when --cell-sdk-line is 2.x
+                          (unset --cell-sdk-line also defaults to 2.x — see
+                          --cell-sdk-line), 0 (no added delay) otherwise. Pass
+                          --pace-method 0 to opt out even on a 2.x cell.
   --manual-blocking       Run manual-tagged test files (*.manual.ait.test.ts)
                           LAST, after all regular files, with a human present.
                           Before each manual file, the QR dashboard is pushed
@@ -65,6 +104,24 @@ OPTIONS
                           each manual file's report entry is stamped
                           mode: 'manual' — never diff a manual run against an
                           unattended baseline as if they were equivalent.
+  --stub-blocking         Run manual-tagged test files (*.manual.ait.test.ts)
+                          UNATTENDED (devtools#740, DT-2) by intercepting a
+                          fixed allowlist of blocking-UI SDK calls (ads
+                          show*, openPermissionDialog/requestPermission,
+                          saveBase64Data) in the page and answering them from
+                          fixtures captured by a real --manual-blocking run,
+                          instead of forwarding them to native UI. Implies
+                          --manual-blocking (manual files are included in the
+                          run); no human presence or QR-dashboard prompt is
+                          needed for them. HYBRID cell, not pure env3 — every
+                          other SDK call in the same run still hits the real
+                          native bridge. With --report-dir, files that ran
+                          under the stub are written to a SEPARATE
+                          <sdkLine>.<platform>.stubbed.json artifact (never
+                          merged into the standard or .manual.json report) and
+                          the report body is stamped cell.bridgeStub: true —
+                          never diff a stubbed run against a real device
+                          baseline (manual or unattended) as if equivalent.
   --help, -h              Show this help message
 
 DESCRIPTION
@@ -81,7 +138,7 @@ DESCRIPTION
   The test files run against the live relay connection started by this process;
   no separate MCP daemon is required.
 
-EXAMPLE
+EXAMPLE (env 3 — intoss-private scheme)
   devtools-test 'src/**/*.ait.test.ts' \\
     --scheme-url "intoss-private://..." \\
     --cell-sdk-line 3.x \\
@@ -89,6 +146,14 @@ EXAMPLE
     --report-dir .ait-report \\
     --timeout 60000
 
+EXAMPLE (env 2 — AITC Sandbox PWA launcher)
+  devtools-test 'src/**/*.ait.test.ts' \\
+    --attach-launcher \\
+    --app-url "https://<subdomain>.trycloudflare.com" \\
+    --cell-sdk-line 3.x \\
+    --cell-platform ios-pwa \\
+    --report-dir .ait-report
+
 `.trimStart();
 //#endregion
 //#region src/mcp/chii-relay.ts
@@ -350,6 +415,82 @@ async function startChiiRelay(options = {}) {
 //#endregion
 //#region src/mcp/debug-server.ts
 /**
+* Starts a polling watcher that detects target-set changes on
+* `connection.listTargets()` and sends a `notifications/tools/list_changed`
+* notification on the given server.
+*
+* The watcher polls every `intervalMs` (default 1 000 ms). On each tick it
+* calls `connection.refreshTargets?.()` first (fix #705-B) so that silent
+* disconnects (no CDP event, phone backgrounded / tunnel quiet) are picked up
+* before the signature is read. If `refreshTargets` throws — e.g. a transient
+* relay error — the tick is skipped entirely to avoid a spurious detach signal.
+*
+* After the refresh, it fires `server.sendToolListChanged()` + `onAttach()`
+* whenever the sorted target-id signature changes AND the new target set is
+* non-empty. This covers:
+*   - 0→N first attach
+*   - 1→1 target replacement (same count, different id — e.g. rescan)
+*   - N→M any change where the result is still non-empty
+*
+* Full detach (→ empty) fires `onDetach()` (fix #705-A) on the exact
+* non-empty→empty edge — i.e. only when the previous signature was non-empty.
+* This lets callers push an immediate "disconnected" SSE update to the
+* dashboard without waiting for the next periodic interval.
+*
+* The interval is **never cleared automatically** — it keeps running until
+* `stop()` is called during shutdown. This ensures that a target replacement
+* after the first attach is always detected.
+*
+* `onAttach` is called on every non-empty signature change (or immediately when
+* already attached). Use this to trigger side-effects such as pushing a fresh
+* SSE state to open dashboard tabs (issue #509). Both callbacks are optional;
+* omitting them preserves the previous behaviour exactly.
+*
+* SECRET-HANDLING: target `id`/`title`/`url` are not written to any log here.
+* Only an attach-detected stderr line is emitted (no target details).
+*
+* `server` is optional (devtools#772): the standalone test-runner path
+* (`test-runner/relay-factory.ts`) has no MCP `Server` instance to notify —
+* it only needs the `onAttach`/`onDetach` dashboard-push side effects. When
+* omitted, `sendToolListChanged()` is simply skipped; the signature-diff and
+* callback logic is byte-for-byte the same. Existing MCP daemon call sites
+* always pass a real `Server`, so their behavior is unchanged.
+*
+* @returns `stop` — call this during shutdown to clear the interval.
+*/
+function startAttachWatcher(connection, server, intervalMs = 1e3, onAttach, onDetach) {
+	/** Sorted, comma-joined target-id string — '' means no targets attached. */
+	function signature() {
+		return connection.listTargets().map((t) => t.id).sort().join(",");
+	}
+	let lastSignature = signature();
+	if (lastSignature !== "") {
+		server?.sendToolListChanged();
+		onAttach?.();
+	}
+	/** Compare current vs last signature and fire the appropriate callback. */
+	function tick() {
+		const current = signature();
+		if (current !== lastSignature) {
+			const wasNonEmpty = lastSignature !== "";
+			lastSignature = current;
+			if (current !== "") {
+				server?.sendToolListChanged();
+				onAttach?.();
+			} else if (wasNonEmpty) onDetach?.();
+		}
+	}
+	const handle = setInterval(() => {
+		if (connection.refreshTargets) connection.refreshTargets().then(() => {
+			tick();
+		}, (_err) => {});
+		else tick();
+	}, intervalMs);
+	return { stop() {
+		clearInterval(handle);
+	} };
+}
+/**
 * Factory that constructs a `ChiiCdpConnection` for the given relay base URL.
 *
 * Introduced as a named seam so PR-2 (dual-connection, #348) can defer
@@ -454,6 +595,6 @@ async function bootRelayFamily(options = {}) {
 	};
 }
 //#endregion
-export { bootRelayFamily, buildRelayVerifyAuth };
+export { bootRelayFamily, buildRelayVerifyAuth, startAttachWatcher };
 
-//# sourceMappingURL=debug-server-DApo0o3t.js.map
+//# sourceMappingURL=debug-server-BQHbaKPT.js.map