@crouton-kit/capture 1.3.13 → 1.3.15

package/bin/capture

@@ -7797,6 +7797,7 @@ var init_render = __esm({
       "screenshot",
       "tabs",
       "tab-opened",
+      "tab-closed",
       "tab-reset",
       "network",
       "cdp-result",
@@ -8715,7 +8716,7 @@ function validateKnownLeaf(command, positional) {
   const branches = {
     session: ["start", "stop", "list", "view", "har", "log"],
     page: ["click", "type", "scroll", "navigate", "exec", "shot", "elements"],
-    tab: ["list", "open", "reset", "network"],
+    tab: ["list", "open", "close", "reset", "network"],
     measure: ["snap", "check", "diff", "census", "explain", "sweep", "map"],
     motion: ["rec", "mask", "timeline", "jank", "response"],
     lib: ["list", "search", "show", "read"]
@@ -8862,6 +8863,7 @@ function parseCliSyntax(argv) {
     if (VALUE_FLAGS.has(arg)) valueFor(arg, next);
     if (arg === "--port") {
       parsed.port = integer(valueFor(arg, next), "--port", 1, 65535);
+      parsed.portSource = "flag";
       i++;
     } else if (arg === "--out") {
       parsed.out = valueFor(arg, next);
@@ -9018,10 +9020,14 @@ function resolveCliContext(parsed) {
       parsed.target = session.targetId;
       parsed.targetSource = "session";
     }
-    if (parsed.port === void 0 && session.port !== void 0 && session.port !== null) parsed.port = session.port;
+    if (parsed.port === void 0 && session.port !== void 0 && session.port !== null) {
+      parsed.port = session.port;
+      parsed.portSource = "session";
+    }
   }
   if (parsed.port === void 0 && process.env.CDP_PORT !== void 0) {
     parsed.port = integer(process.env.CDP_PORT, "CDP_PORT", 1, 65535);
+    parsed.portSource = "env";
   }
   if (!session) getActiveSession();
   if (!parsed.target && !parsed.url && process.env.CDP_TARGET) {
@@ -9099,6 +9105,20 @@ var init_gate_guard = __esm({
 });
 
 // src/session/coordinator.ts
+function scopeLifecycleLockPath() {
+  return path5.join(CAPTURE_ROOT, `.session-lifecycle-${process.env.CRTR_NODE_ID ?? "default"}`);
+}
+async function withSessionScopeLifecycle(action) {
+  const lock = await acquirePrivateLock(scopeLifecycleLockPath(), {
+    acquireTimeoutMs: 12e4,
+    leaseMs: 1e3
+  });
+  try {
+    return await action();
+  } finally {
+    lock.release();
+  }
+}
 function statePath(sessionDir2) {
   return path5.join(assertUnderCaptureRoot(sessionDir2), ".operations.json");
 }
@@ -9822,7 +9842,7 @@ function validateHarAppendBatch(value, source) {
   return { entries, incompleteLifecycles };
 }
 function captureVersion() {
-  const version = "1.3.13";
+  const version = "1.3.15";
   return typeof version === "string" && version.length > 0 ? version : "development";
 }
 function token() {
@@ -11467,8 +11487,8 @@ function __domPathOf(el) {
       const elements = [];
       if (raw.length > 0) {
         const resolved = await Promise.all(
-          raw.map(async (fact3) => {
-            const objectId = objectIds[fact3.idx];
+          raw.map(async (fact4) => {
+            const objectId = objectIds[fact4.idx];
             let backendNodeId2;
             let quads = [];
             let boxModel = null;
@@ -11495,33 +11515,33 @@ function __domPathOf(el) {
             }
             const geometryUnavailable = geometryUnavailableReason !== void 0;
             const rect3 = quads.length > 0 ? unionRect(quads) : { x: 0, y: 0, width: 0, height: 0 };
-            const zeroSize = quadsUnavailable ? fact3.visibility.zeroSize : fact3.visibility.zeroSize || quads.length === 0;
-            const visible = quadsUnavailable ? fact3.visibility.visible : fact3.visibility.visible && quads.length > 0;
+            const zeroSize = quadsUnavailable ? fact4.visibility.zeroSize : fact4.visibility.zeroSize || quads.length === 0;
+            const visible = quadsUnavailable ? fact4.visibility.visible : fact4.visibility.visible && quads.length > 0;
             return {
-              id: `el-${fact3.idx}`,
-              tag: sanitizeString(fact3.tag, { max: 64 }),
-              selector: fact3.selector !== void 0 ? sanitizeString(fact3.selector, { max: 300 }) : void 0,
-              domPath: sanitizeString(fact3.domPath, { max: 500 }),
+              id: `el-${fact4.idx}`,
+              tag: sanitizeString(fact4.tag, { max: 64 }),
+              selector: fact4.selector !== void 0 ? sanitizeString(fact4.selector, { max: 300 }) : void 0,
+              domPath: sanitizeString(fact4.domPath, { max: 500 }),
               ...resolvedIdentity(backendNodeId2),
-              text: fact3.text !== void 0 ? sanitizeString(fact3.text, { max: 200 }) : void 0,
-              frame: fact3.frame,
-              shadow: fact3.shadow ? {
-                ...fact3.shadow,
-                hostSelector: fact3.shadow.hostSelector !== void 0 ? sanitizeString(fact3.shadow.hostSelector, { max: 300 }) : void 0
+              text: fact4.text !== void 0 ? sanitizeString(fact4.text, { max: 200 }) : void 0,
+              frame: fact4.frame,
+              shadow: fact4.shadow ? {
+                ...fact4.shadow,
+                hostSelector: fact4.shadow.hostSelector !== void 0 ? sanitizeString(fact4.shadow.hostSelector, { max: 300 }) : void 0
               } : null,
               rect: rect3,
               quads,
               boxModel,
-              zIndex: sanitizeString(fact3.zIndex, { max: 20 }),
-              stackingContext: fact3.stackingContext,
-              visibility: { ...fact3.visibility, visible, zeroSize },
-              clipping: fact3.clipping ? {
-                clippedBy: fact3.clipping.clippedBy !== void 0 ? sanitizeString(fact3.clipping.clippedBy, { max: 300 }) : void 0,
-                clippedFraction: fact3.clipping.clippedFraction
+              zIndex: sanitizeString(fact4.zIndex, { max: 20 }),
+              stackingContext: fact4.stackingContext,
+              visibility: { ...fact4.visibility, visible, zeroSize },
+              clipping: fact4.clipping ? {
+                clippedBy: fact4.clipping.clippedBy !== void 0 ? sanitizeString(fact4.clipping.clippedBy, { max: 300 }) : void 0,
+                clippedFraction: fact4.clipping.clippedFraction
               } : null,
-              layout: capLayoutFact(fact3.layout),
+              layout: capLayoutFact(fact4.layout),
               ...geometryUnavailable ? { geometryUnavailable: true, geometryUnavailableReason } : {},
-              ...fact3.iframeContentUnavailable ? { iframeContentUnavailable: true, iframeContentUnavailableReason: fact3.iframeContentUnavailableReason } : {}
+              ...fact4.iframeContentUnavailable ? { iframeContentUnavailable: true, iframeContentUnavailableReason: fact4.iframeContentUnavailableReason } : {}
             };
           })
         );
@@ -11581,7 +11601,7 @@ function wallTime(value) {
   }
 }
 function captureVersion2() {
-  const version = "1.3.13";
+  const version = "1.3.15";
   return typeof version === "string" && version.length > 0 ? version : "development";
 }
 function deepFreeze(value) {
@@ -13759,20 +13779,6 @@ function readBundleManifest(bundlePath) {
 function sessionDir(id) {
   return path12.join(CAPTURE_ROOT, id);
 }
-function lifecycleScopeLockPath() {
-  return path12.join(CAPTURE_ROOT, `.session-lifecycle-${process.env.CRTR_NODE_ID ?? "default"}`);
-}
-async function withLifecycleCoordinator(action) {
-  const handle = await acquirePrivateLock(lifecycleScopeLockPath(), {
-    acquireTimeoutMs: 12e4,
-    leaseMs: 1e3
-  });
-  try {
-    return await action();
-  } finally {
-    handle.release();
-  }
-}
 function isSessionStopped(session) {
   return Boolean(session.stoppedAt) || fs9.existsSync(path12.join(session.dir, "bundle.json"));
 }
@@ -13896,7 +13902,7 @@ async function start(parsed) {
     return;
   }
   if (rejectSurplusPositionals(parsed, "start", 0, "capture session start [--url <url>] [--hold]")) return;
-  return withLifecycleCoordinator(async () => {
+  return withSessionScopeLifecycle(async () => {
     const active = getActiveSession();
     if (active && !isSessionStopped(active)) {
       emitResult({
@@ -14306,7 +14312,7 @@ async function stop(parsed) {
     process.exitCode = 1;
     return;
   }
-  return withLifecycleCoordinator(async () => {
+  return withSessionScopeLifecycle(async () => {
     let session;
     try {
       session = readSession(id);
@@ -14626,6 +14632,8 @@ input:
   --hold         Hold one CDP browser connection open for the session's
                  lifetime, so browser-level state (permission grants,
                  ServiceWorker enablement) survives across separate commands.
+                 With no --url, later --target <existing-id> commands adopt
+                 an already-open tab without creating a new one.
   --port <n>     CDP port to attach to; default is auto-detected across localhost.
 
 Output:
@@ -14870,7 +14878,12 @@ async function connectForCommand(parsed) {
   }
   const port = resolved?.port ?? getPortFromWebSocketDebuggerUrl(tab.webSocketDebuggerUrl);
   if (activeSession && !activeSession.targetId) {
-    await seams.updateActiveSession({ targetId: tab.id, port: port ?? null });
+    await seams.withSessionScopeLifecycle(async () => {
+      const current = seams.getActiveSession();
+      if (current?.sessionId === activeSession.sessionId && !current.targetId) {
+        await seams.updateActiveSession({ targetId: tab.id, port: port ?? null });
+      }
+    });
   }
   console.error(
     `Using target ${tab.id.slice(0, 8)}${port ? ` on port ${port}` : ""}${tab.url ? ` (${tab.url})` : ""}`
@@ -14988,12 +15001,14 @@ var init_connection = __esm({
     init_har_recorder();
     init_har_manager();
     init_session_context();
+    init_coordinator();
     init_recorder_client();
     init_recorder();
     init_errors();
     seams = {
       getActiveSession: () => getActiveSession(),
       updateActiveSession,
+      withSessionScopeLifecycle,
       resolveTab: defaultResolveTab,
       createClient: (wsUrl) => new CDPClient(wsUrl),
       appendHar: appendToHarRecording,
@@ -227405,6 +227420,94 @@ effects: opens (or reuses) a background browser tab and waits up to 10s for its
   }
 });
 
+// src/cdp/commands/tab/close.ts
+function buildTabClosedResult(tab, port) {
+  return {
+    tag: "tab-closed",
+    attrs: { port, target: tab.id },
+    summary: line(text`tab `, data(tab.id.slice(0, 8)), text` closed: `, data(tab.url, 300))
+  };
+}
+async function cmdTabClose(parsed, _args) {
+  if (parsed.help) {
+    console.log(USAGE10);
+    return;
+  }
+  const target = parsed.positional[0];
+  if (!target) {
+    throw invalidInput("received: no target; expected: capture tab close <target> [--port <port>].", "missing_argument");
+  }
+  if (target.length < 8) {
+    throw invalidInput(`received: target ${target}; expected: a full target id or an unambiguous prefix of at least 8 characters.`, "target_prefix_too_short");
+  }
+  let port;
+  try {
+    port = parsed.port ?? await detectCdpPort();
+  } catch {
+    throw captureError(
+      "world",
+      "no_cdp_endpoint",
+      "received: no --port, and no CDP endpoint was discovered on localhost; expected: a running CDP-enabled browser (or an explicit --port <port>). capture tab list probes every localhost CDP endpoint."
+    );
+  }
+  const tab = await withSessionScopeLifecycle(async () => {
+    let resolved;
+    try {
+      resolved = await findTabById(port, target);
+    } catch (error) {
+      throw captureError("precondition", "target_unavailable", `received: target ${target} on port ${port}; expected: one unambiguous page-tab target id. ${error instanceof Error ? error.message : String(error)}`, error);
+    }
+    if (!resolved || resolved.type !== "page") {
+      throw captureError(
+        "precondition",
+        "target_unavailable",
+        `received: target ${target} on port ${port}; expected: one existing page-tab target id (8-character prefix accepted). capture tab list shows available tabs.`
+      );
+    }
+    const active = getActiveSession();
+    if (active && !active.targetId) {
+      throw captureError(
+        "precondition",
+        "active_session_target_unknown",
+        `session ${active.sessionId} has not established its target yet, so capture tab close cannot prove ${resolved.id} is a background tab. Target the session with a page command first, or stop the session with capture session stop ${active.sessionId}.`
+      );
+    }
+    if (active?.targetId === resolved.id) {
+      throw captureError(
+        "precondition",
+        "active_session_target",
+        `target ${resolved.id} is the active session ${active.sessionId}'s tab; capture tab close never leaves an active session pointing at a closed target. Use capture tab reset <url> to replace it or capture session stop ${active.sessionId} first.`
+      );
+    }
+    try {
+      await closeTarget(port, resolved.id);
+    } catch (error) {
+      throw captureError("world", "close_failed", `closing target ${resolved.id} on port ${port} failed: ${error instanceof Error ? error.message : String(error)}`, error);
+    }
+    return resolved;
+  });
+  emitResult(buildTabClosedResult(tab, port), { json: parsed.json });
+}
+var USAGE10;
+var init_close = __esm({
+  "src/cdp/commands/tab/close.ts"() {
+    init_errors();
+    init_detect();
+    init_targets();
+    init_session_context();
+    init_coordinator();
+    init_render();
+    USAGE10 = `capture tab close \u2014 close one explicitly identified background browser tab.
+
+input:
+  <target>        required \u2014 full tab target id or an unambiguous 8-character prefix
+  --port <port>   CDP endpoint (default: the auto-discovered preferred endpoint)
+
+output: <tab-closed port=\u2026 target=\u2026> \u2014 the closed tab's full target id and last observed URL.
+effects: closes exactly one page tab. Refuses unless any active session's background-tab ownership is known, and never closes that session's tab; reset or stop the session first.`;
+  }
+});
+
 // src/cdp/commands/tab/reset.ts
 function buildTabResetResult(tab, port, sessionUpdated) {
   return {
@@ -227445,46 +227548,48 @@ async function boundedLoadWait(tab) {
 }
 async function cmdTabReset(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE10);
+    console.log(USAGE11);
     return;
   }
   const url = parsed.positional[0];
   if (!url) throw invalidInput("received: no URL; expected: capture tab reset <url> [--port <port>].", "missing_argument");
-  const session = getActiveSession();
-  if (!session) {
-    let port;
-    try {
-      port = parsed.port ?? await deps5.detectCdpPort();
-    } catch {
-      throw captureError("world", "no_cdp_endpoint", "received: no --port, and no CDP endpoint was discovered on localhost; expected: a running CDP-enabled browser (or an explicit --port <port>).");
-    }
-    const tab = await openTabOrThrow(port, url);
-    await boundedLoadWait(tab);
-    emitResult(buildTabResetResult(tab, port, false), { json: parsed.json });
-    return;
-  }
-  const op = await admitSessionOperation(session.dir);
-  try {
-    const result = await withSessionLifecycle(session.dir, async () => {
-      const fresh = getActiveSession();
-      if (!fresh || fresh.dir !== session.dir) throw captureError("precondition", "session_unavailable", "The active capture session is no longer available.");
-      const scan = scanRecorderHandles(session.dir, deps5.lifecycle);
-      if (scan.some((h) => h.classification === "unknown")) throw captureError("world", "recorder_liveness_unknown", "Cannot determine recorder liveness; refusing to reset.");
-      if (scan.some((h) => h.classification === "malformed")) throw captureError("precondition", "recorder_unavailable", "A malformed recorder handle exists on this session; resolve it before resetting.");
-      if (scan.some((h) => h.classification === "live")) throw captureError("precondition", "recorder_active", "A recording is active on this session; stop it first: `capture motion rec --stop`. Reset never rebinds a live recorder.");
-      await clearDanglingRecorderPointer(session.dir, scan);
-      const port = fresh.port ?? parsed.port ?? await deps5.detectCdpPort();
+  return withSessionScopeLifecycle(async () => {
+    const session = getActiveSession();
+    if (!session) {
+      let port;
+      try {
+        port = parsed.port ?? await deps5.detectCdpPort();
+      } catch {
+        throw captureError("world", "no_cdp_endpoint", "received: no --port, and no CDP endpoint was discovered on localhost; expected: a running CDP-enabled browser (or an explicit --port <port>).");
+      }
       const tab = await openTabOrThrow(port, url);
       await boundedLoadWait(tab);
-      await updateSessionState(session.dir, { targetId: tab.id, port });
-      return buildTabResetResult(tab, port, true);
-    }, deps5.lifecycle);
-    emitResult(result, { json: parsed.json });
-  } finally {
-    await op.release();
-  }
+      emitResult(buildTabResetResult(tab, port, false), { json: parsed.json });
+      return;
+    }
+    const op = await admitSessionOperation(session.dir);
+    try {
+      const result = await withSessionLifecycle(session.dir, async () => {
+        const fresh = getActiveSession();
+        if (!fresh || fresh.dir !== session.dir) throw captureError("precondition", "session_unavailable", "The active capture session is no longer available.");
+        const scan = scanRecorderHandles(session.dir, deps5.lifecycle);
+        if (scan.some((h) => h.classification === "unknown")) throw captureError("world", "recorder_liveness_unknown", "Cannot determine recorder liveness; refusing to reset.");
+        if (scan.some((h) => h.classification === "malformed")) throw captureError("precondition", "recorder_unavailable", "A malformed recorder handle exists on this session; resolve it before resetting.");
+        if (scan.some((h) => h.classification === "live")) throw captureError("precondition", "recorder_active", "A recording is active on this session; stop it first: `capture motion rec --stop`. Reset never rebinds a live recorder.");
+        await clearDanglingRecorderPointer(session.dir, scan);
+        const port = fresh.port ?? parsed.port ?? await deps5.detectCdpPort();
+        const tab = await openTabOrThrow(port, url);
+        await boundedLoadWait(tab);
+        await updateSessionState(session.dir, { targetId: tab.id, port });
+        return buildTabResetResult(tab, port, true);
+      }, deps5.lifecycle);
+      emitResult(result, { json: parsed.json });
+    } finally {
+      await op.release();
+    }
+  });
 }
-var USAGE10, deps5;
+var USAGE11, deps5;
 var init_reset = __esm({
   "src/cdp/commands/tab/reset.ts"() {
     init_detect();
@@ -227494,7 +227599,7 @@ var init_reset = __esm({
     init_coordinator();
     init_errors();
     init_render();
-    USAGE10 = `capture tab reset \u2014 abandon a stuck tab and open a fresh one at the URL.
+    USAGE11 = `capture tab reset \u2014 abandon a stuck tab and open a fresh one at the URL.
 
 input:
   <url>           required \u2014 the URL the fresh tab opens at
@@ -227566,7 +227671,7 @@ function buildNetworkResult(mode, target) {
 }
 async function cmdTabNetwork(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE11);
+    console.log(USAGE12);
     return;
   }
   const mode = parsed.positional[0];
@@ -227656,7 +227761,7 @@ async function cmdTabNetwork(parsed, _args) {
   }
   emitResult(buildNetworkResult(mode, targetId), { json: parsed.json });
 }
-var fs15, USAGE11;
+var fs15, USAGE12;
 var init_network = __esm({
   "src/cdp/commands/tab/network.ts"() {
     fs15 = __toESM(require("node:fs"));
@@ -227665,7 +227770,7 @@ var init_network = __esm({
     init_coordinator();
     init_client2();
     init_render();
-    USAGE11 = `capture tab network \u2014 toggle connection-level network emulation for the active session's held tab.
+    USAGE12 = `capture tab network \u2014 toggle connection-level network emulation for the active session's held tab.
 
 input:
   <offline|online>   required \u2014 offline blocks HTTP requests and drops WebSocket connections; online restores connectivity
@@ -227687,6 +227792,8 @@ async function tabMain(parsed, args) {
       return cmdTabList(rest, args);
     case "open":
       return cmdTabOpen(rest, args);
+    case "close":
+      return cmdTabClose(rest, args);
     case "reset":
       return cmdTabReset(rest, args);
     case "network":
@@ -227704,12 +227811,13 @@ var init_tab = __esm({
     init_errors();
     init_list();
     init_open();
+    init_close();
     init_reset();
     init_network();
     COMMAND_BLOCK3 = `<command name="tab">
-tab and connection plumbing \u2014 endpoint/tab discovery, open/reset tabs, connection-level network emulation
-use when finding a CDP endpoint or tab, opening/replacing a tab, or toggling connectivity; \`tab list\` is the probe for a running browser
-  list \xB7 open \xB7 reset \xB7 network \u2014 \`capture tab -h\`
+tab and connection plumbing \u2014 endpoint/tab discovery, lifecycle, connection-level network emulation
+use when finding a CDP endpoint or tab, opening/closing/replacing a tab, or toggling connectivity; \`tab list\` is the probe for a running browser
+  list \xB7 open \xB7 close \xB7 reset \xB7 network \u2014 \`capture tab -h\`
 </command>`;
     TAB_USAGE = `capture tab \u2014 tab and connection plumbing: discovery, lifecycle, network emulation.
 
@@ -227721,6 +227829,7 @@ the session's {target, port} pair together.
 
 <subcommand name="list" args="[--port <port>]" whenToUse="discover CDP endpoints and the tabs open on them"/>
 <subcommand name="open" args="<url> [--new] [--port <port>]" whenToUse="open a URL and get its tab id"/>
+<subcommand name="close" args="<target> [--port <port>]" whenToUse="close one explicitly identified background tab"/>
 <subcommand name="reset" args="<url> [--port <port>]" whenToUse="abandon a stuck tab and open a fresh one (refuses while a recording is active; reaps dead recorder handles; updates the active session's {target, port} together)"/>
 <subcommand name="network" args="<offline|online>" whenToUse="toggle connection-level network emulation for a tab"/>
 
@@ -228279,8 +228388,10 @@ function invocationLabel(method, waitEvent) {
 async function runBrowserScope(method, params, parsed, timeoutMs, deps7 = DEFAULT_BROWSER_DEPS) {
   const flagTarget = parsed.targetSource === "flag" ? parsed.target : void 0;
   const session = getActiveSession();
-  if (session?.bridgeSocket && fs17.existsSync(session.bridgeSocket)) {
-    const resp = await deps7.sendBridgeRequest(session.bridgeSocket, {
+  const bridgeSocket = session?.bridgeSocket;
+  const heldBridgeActive = Boolean(bridgeSocket && fs17.existsSync(bridgeSocket));
+  if (parsed.portSource !== "flag" && bridgeSocket && heldBridgeActive) {
+    const resp = await deps7.sendBridgeRequest(bridgeSocket, {
       method,
       params,
       targetId: flagTarget,
@@ -228304,8 +228415,9 @@ async function runBrowserScope(method, params, parsed, timeoutMs, deps7 = DEFAUL
     });
     return;
   }
+  const connectionReason = parsed.portSource === "flag" ? heldBridgeActive ? `Using explicitly selected CDP port ${parsed.port} instead of the active session bridge` : `Using explicitly selected CDP port ${parsed.port}` : "No held session bridge active";
   console.error(
-    "No held session bridge active \u2014 this one-shot connection closes when the command exits, so any browser-level grant or target enablement made here reverts immediately after."
+    `${connectionReason} \u2014 this one-shot connection closes when the command exits, so any browser-level grant or target enablement made here reverts immediately after.`
   );
   const port = parsed.port ?? await deps7.detectCdpPort();
   const { client } = await deps7.getBrowserClient(port);
@@ -228418,7 +228530,8 @@ Input:
   --params <json>              JSON-encoded params object for the method. Spec deviation: params stay inline JSON (no file indirection) \u2014 raw CDP params are small protocol-defined objects.
   --wait-event <Domain.event>  wait for (and return) the next occurrence of a protocol event; combinable with a method (the method is sent first) or usable alone.
   --browser                    route through the held connection (session start --hold) instead of a one-shot page websocket. Connection-scoped state (permission grants, domain enables) reverts the instant its connection closes \u2014 it survives across commands only inside a held session.
-  --target <id>                with --browser: attach a flattened CDP session on the held connection to this target (for target-scoped domains); without --browser: the page target to run against. 8-char id prefix accepted.
+  --port <port>                CDP endpoint. An explicit flag selects that endpoint even when an active session holds another browser connection.
+  --target <id>                with --browser: attach a flattened CDP session on the held connection to this target (for target-scoped domains), including an already-open tab adopted by \`session start --hold\` without --url; without --browser: the page target to run against. 8-char id prefix accepted.
   --timeout <ms>               event-wait timeout (default ${DEFAULT_TIMEOUT_MS}ms).
 
 Output:
@@ -230035,9 +230148,9 @@ async function collectStylesInner(ctx, styleSheetUrls, styleSheetHeaders) {
   }
   const sourceCache = /* @__PURE__ */ new Map();
   const elements = await Promise.all(
-    facts.map(async (fact3, index) => {
+    facts.map(async (fact4, index) => {
       const ref = resolved[index];
-      const computed2 = normalizeComputed(fact3.computed);
+      const computed2 = normalizeComputed(fact4.computed);
       let winningDeclarations;
       let provenanceUnavailable;
       if (ref?.nodeId !== void 0) {
@@ -230063,7 +230176,7 @@ async function collectStylesInner(ctx, styleSheetUrls, styleSheetHeaders) {
       }
       return {
         id: `s-${index}`,
-        selector: sanitizeString(fact3.cssPath),
+        selector: sanitizeString(fact4.cssPath),
         ...resolvedIdentity3(ref?.backendNodeId),
         computed: computed2,
         winningDeclarations,
@@ -231015,11 +231128,11 @@ var init_text = __esm({
                 } else {
                   rawPlatformFontFamilies = fontsResult.fonts.map((font) => font.familyName ?? "");
                   platformFonts = fontsResult.fonts.map((font) => {
-                    const fact3 = {
+                    const fact4 = {
                       familyName: sanitizeString(font.familyName),
                       isCustomFont: !!font.isCustomFont
                     };
-                    return typeof font.glyphCount === "number" ? { ...fact3, glyphCount: font.glyphCount } : fact3;
+                    return typeof font.glyphCount === "number" ? { ...fact4, glyphCount: font.glyphCount } : fact4;
                   });
                   platformFontsAvailable = true;
                   platformFontsUnavailableReason = void 0;
@@ -234869,36 +234982,36 @@ document.querySelectorAll('img, video, canvas, svg, iframe').length;`;
           resolved = facts.map(() => void 0);
         }
       }
-      const elements = facts.map((fact3, index) => {
-        const natural = fact3.naturalWidth !== null && fact3.naturalHeight !== null ? { w: fact3.naturalWidth, h: fact3.naturalHeight } : null;
+      const elements = facts.map((fact4, index) => {
+        const natural = fact4.naturalWidth !== null && fact4.naturalHeight !== null ? { w: fact4.naturalWidth, h: fact4.naturalHeight } : null;
         const intrinsicAspectRatio = natural && natural.w > 0 && natural.h > 0 ? natural.w / natural.h : null;
-        const crop = fact3.styleUnavailable ? null : computeObjectFitCrop(natural, { w: fact3.rect.width, h: fact3.rect.height }, fact3.objectFit, fact3.objectPosition);
+        const crop = fact4.styleUnavailable ? null : computeObjectFitCrop(natural, { w: fact4.rect.width, h: fact4.rect.height }, fact4.objectFit, fact4.objectPosition);
         return {
           id: `m-${index}`,
-          selector: fact3.cssPath ? sanitizeString(fact3.cssPath) : "",
+          selector: fact4.cssPath ? sanitizeString(fact4.cssPath) : "",
           ...resolvedIdentity8(resolved[index]?.backendNodeId),
-          tag: fact3.tag,
-          rect: fact3.rect,
-          visible: fact3.visible,
-          naturalWidth: fact3.naturalWidth,
-          naturalHeight: fact3.naturalHeight,
-          renderedWidth: fact3.rect.width,
-          renderedHeight: fact3.rect.height,
-          devicePixelRatio: fact3.dpr,
-          currentSrc: sanitizeOptional2(fact3.currentSrc),
-          decodeState: fact3.decodeState,
+          tag: fact4.tag,
+          rect: fact4.rect,
+          visible: fact4.visible,
+          naturalWidth: fact4.naturalWidth,
+          naturalHeight: fact4.naturalHeight,
+          renderedWidth: fact4.rect.width,
+          renderedHeight: fact4.rect.height,
+          devicePixelRatio: fact4.dpr,
+          currentSrc: sanitizeOptional2(fact4.currentSrc),
+          decodeState: fact4.decodeState,
           intrinsicAspectRatio,
-          objectFit: sanitizeOptional2(fact3.objectFit),
-          objectPosition: sanitizeOptional2(fact3.objectPosition),
+          objectFit: sanitizeOptional2(fact4.objectFit),
+          objectPosition: sanitizeOptional2(fact4.objectPosition),
           crop,
-          styleUnavailable: fact3.styleUnavailable || void 0,
-          intrinsicDimsUnavailable: fact3.intrinsicDimsUnavailable || void 0,
-          contextType: fact3.contextType,
-          backingWidth: fact3.backingWidth,
-          backingHeight: fact3.backingHeight,
-          poster: fact3.tag === "video" ? sanitizeOptional2(fact3.poster) : void 0,
-          src: fact3.tag === "iframe" ? sanitizeOptional2(fact3.src) : void 0,
-          crossOrigin: fact3.tag === "iframe" ? fact3.crossOrigin : void 0
+          styleUnavailable: fact4.styleUnavailable || void 0,
+          intrinsicDimsUnavailable: fact4.intrinsicDimsUnavailable || void 0,
+          contextType: fact4.contextType,
+          backingWidth: fact4.backingWidth,
+          backingHeight: fact4.backingHeight,
+          poster: fact4.tag === "video" ? sanitizeOptional2(fact4.poster) : void 0,
+          src: fact4.tag === "iframe" ? sanitizeOptional2(fact4.src) : void 0,
+          crossOrigin: fact4.tag === "iframe" ? fact4.crossOrigin : void 0
         };
       });
       ctx.write.json("media.json", {
@@ -235381,16 +235494,16 @@ function rectsOverlap(a, b) {
   return a.x < b.x + b.w && a.x + a.w > b.x && a.y < b.y + b.h && a.y + a.h > b.y;
 }
 function annotateUnstableFacts(facts, regions) {
-  return facts.map((fact3) => {
+  return facts.map((fact4) => {
     const caveats = [];
     for (const region of regions) {
-      const byElement = fact3.elementId !== void 0 && (region.elementIds?.includes(fact3.elementId) ?? false);
-      const byRect = fact3.rect !== void 0 && region.rect !== void 0 && rectsOverlap(fact3.rect, region.rect);
+      const byElement = fact4.elementId !== void 0 && (region.elementIds?.includes(fact4.elementId) ?? false);
+      const byRect = fact4.rect !== void 0 && region.rect !== void 0 && rectsOverlap(fact4.rect, region.rect);
       if (byElement || byRect) {
         caveats.push({ regionId: region.id, selector: region.selector, reason: region.reason });
       }
     }
-    return { fact: fact3, caveats };
+    return { fact: fact4, caveats };
   });
 }
 var fs18, path20, ArtifactResolutionError, SNAP_CONFIG, REC_CONFIG, CREATING_COMMAND_BY_FILE;
@@ -235675,7 +235788,7 @@ function errorSections(details) {
 }
 async function cmdMeasureSnap(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE12);
+    console.log(USAGE13);
     return;
   }
   const captures = [];
@@ -235725,7 +235838,7 @@ async function cmdMeasureSnap(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var fs19, path21, import_crypto2, USAGE12;
+var fs19, path21, import_crypto2, USAGE13;
 var init_snap = __esm({
   "src/cdp/commands/measure/snap.ts"() {
     fs19 = __toESM(require("fs"));
@@ -235743,7 +235856,7 @@ var init_snap = __esm({
     init_artifact();
     init_errors();
     init_render();
-    USAGE12 = `capture measure snap [url|snap] \u2014 drive the page and write one settled snapshot substrate directory
+    USAGE13 = `capture measure snap [url|snap] \u2014 drive the page and write one settled snapshot substrate directory
 
 input:
   [url|snap]                  a URL drives the page fresh; a snap id or absolute path re-captures states over that base snapshot. Outside a session a URL writes under a private one-shot session; with an active session, snapshots are written under it and later resolve by snap id
@@ -235986,7 +236099,7 @@ function checkSnapshot(ref, requested) {
   }
   const regions = unstableRegionsFor(ref);
   const annotated = annotateUnstableFacts(findings.map((f) => ({ ...f, elementId: f.elementId, rect: f.rect })), regions);
-  return { findings: annotated.map(({ fact: fact3, caveats }) => ({ ...fact3, caveats })), elementCount: elements.length, settled: meta.settled, viewport: vp };
+  return { findings: annotated.map(({ fact: fact4, caveats }) => ({ ...fact4, caveats })), elementCount: elements.length, settled: meta.settled, viewport: vp };
 }
 function writeFindingCrop(ref, finding2, index) {
   if (!finding2.rect || !artifactExists(ref, "screenshot.png")) return void 0;
@@ -236047,7 +236160,7 @@ function caveatLine(caveats) {
 }
 async function cmdMeasureCheck(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE13);
+    console.log(USAGE14);
     return;
   }
   if (parsed.positional.length > 1) {
@@ -236104,14 +236217,14 @@ async function cmdMeasureCheck(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var USAGE13, DEFAULT_FINDING_LIMIT;
+var USAGE14, DEFAULT_FINDING_LIMIT;
 var init_check2 = __esm({
   "src/cdp/commands/measure/check.ts"() {
     init_artifact();
     init_render();
     init_snap();
     init_check();
-    USAGE13 = `capture measure check [url|snap] \u2014 read threshold/fact measurements from a settled snapshot
+    USAGE14 = `capture measure check [url|snap] \u2014 read threshold/fact measurements from a settled snapshot
 
 input:
   [url|snap]      a URL creates one one-shot snapshot first; a snap id or absolute path is read without re-driving the browser
@@ -236695,7 +236808,7 @@ function provenanceLines(records) {
 }
 async function cmdMeasureDiff(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE14);
+    console.log(USAGE15);
     return;
   }
   if (parsed.positional.length > 0 || !parsed.before || !parsed.after) {
@@ -236760,13 +236873,13 @@ async function cmdMeasureDiff(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var USAGE14;
+var USAGE15;
 var init_diff3 = __esm({
   "src/cdp/commands/measure/diff.ts"() {
     init_artifact();
     init_diff2();
     init_render();
-    USAGE14 = `capture measure diff \u2014 structured before/after diff over two settled snapshots
+    USAGE15 = `capture measure diff \u2014 structured before/after diff over two settled snapshots
 
 input:
   --before <snap>   earlier snapshot id or absolute path (required; no positional target \u2014 both snapshots must already exist)
@@ -236969,7 +237082,7 @@ function errorResult(message, status) {
 }
 async function cmdMeasureCensus(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE15);
+    console.log(USAGE16);
     return;
   }
   if (parsed.positional.length) {
@@ -237000,7 +237113,7 @@ async function cmdMeasureCensus(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var fs23, USAGE15;
+var fs23, USAGE16;
 var init_census2 = __esm({
   "src/cdp/commands/measure/census.ts"() {
     fs23 = __toESM(require("fs"));
@@ -237008,7 +237121,7 @@ var init_census2 = __esm({
     init_artifact();
     init_render();
     init_census();
-    USAGE15 = `capture measure census --axis <axis> \u2014 value distributions and token-audit facts across one or more settled snapshots
+    USAGE16 = `capture measure census --axis <axis> \u2014 value distributions and token-audit facts across one or more settled snapshots
 
 input:
   --axis <axis>       color|font|spacing|radius|shadow|animation|geometry|media|queries (required)
@@ -237414,7 +237527,7 @@ function invalidInput2(message) {
 }
 async function cmdMeasureExplain(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE16);
+    console.log(USAGE17);
     return;
   }
   if (parsed.positional.length !== 1) {
@@ -237474,13 +237587,13 @@ async function cmdMeasureExplain(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var USAGE16;
+var USAGE17;
 var init_explain2 = __esm({
   "src/cdp/commands/measure/explain.ts"() {
     init_explain();
     init_artifact();
     init_render();
-    USAGE16 = `capture measure explain <snap> --selector <sel> \u2014 per-element cascade/stacking/clipping explanation over one snapshot
+    USAGE17 = `capture measure explain <snap> --selector <sel> \u2014 per-element cascade/stacking/clipping explanation over one snapshot
 
 input:
   <snap>             snapshot id in the active session or absolute artifact path (required)
@@ -237744,7 +237857,7 @@ async function cmdMeasureSweep(parsed, args) {
 async function runMeasureSweep(parsed, _args, overrides = {}) {
   const dependencies = { ...defaultDependencies, ...overrides };
   if (parsed.help) {
-    console.log(USAGE17);
+    console.log(USAGE18);
     return;
   }
   if (parsed.positional.length > 1) {
@@ -237855,7 +237968,7 @@ async function runMeasureSweep(parsed, _args, overrides = {}) {
     process.exitCode = 1;
   }
 }
-var fs25, path26, import_crypto3, USAGE17, SAMPLE_LIMIT, defaultDependencies, parsePositive;
+var fs25, path26, import_crypto3, USAGE18, SAMPLE_LIMIT, defaultDependencies, parsePositive;
 var init_sweep2 = __esm({
   "src/cdp/commands/measure/sweep.ts"() {
     fs25 = __toESM(require("fs"));
@@ -237868,7 +237981,7 @@ var init_sweep2 = __esm({
     init_render();
     init_leaf_grammar();
     init_sweep();
-    USAGE17 = `capture measure sweep [url] --axis <axis> \u2014 responsive/environment sampling with recursive bracketing of observed state changes
+    USAGE18 = `capture measure sweep [url] --axis <axis> \u2014 responsive/environment sampling with recursive bracketing of observed state changes
 
 input:
   [url]                     page to sweep; outside a session, snapshots and sweep.json are written under one private one-shot measure directory
@@ -238008,7 +238121,7 @@ function recoveryResult(err) {
 }
 async function cmdMeasureMapFocus(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE18);
+    console.log(USAGE19);
     return;
   }
   if (parsed.positional.length !== 1) {
@@ -238032,14 +238145,14 @@ async function cmdMeasureMapFocus(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var USAGE18;
+var USAGE19;
 var init_map_focus2 = __esm({
   "src/cdp/commands/measure/map-focus.ts"() {
     init_snap();
     init_map_focus();
     init_artifact();
     init_render();
-    USAGE18 = `capture measure map focus [url|snap] \u2014 keyboard traversal facts recorded in a snapshot's focus.json
+    USAGE19 = `capture measure map focus [url|snap] \u2014 keyboard traversal facts recorded in a snapshot's focus.json
 
 input:
   [url|snap]   required target: a URL creates a settled snapshot first; a snapshot id or absolute path is read without re-driving the browser
@@ -238255,7 +238368,7 @@ async function runMeasureMapScroll(parsed, deps7 = {}) {
   const captureSnap = deps7.captureSnap ?? captureMeasureSnap;
   const emit = deps7.emit ?? emitResult;
   if (parsed.help) {
-    console.log(USAGE19);
+    console.log(USAGE20);
     return;
   }
   if (parsed.positional.length > 1) {
@@ -238309,14 +238422,14 @@ async function runMeasureMapScroll(parsed, deps7 = {}) {
 async function cmdMeasureMapScroll(parsed, _args) {
   await runMeasureMapScroll(parsed);
 }
-var USAGE19;
+var USAGE20;
 var init_map_scroll2 = __esm({
   "src/cdp/commands/measure/map-scroll.ts"() {
     init_snap();
     init_artifact();
     init_render();
     init_map_scroll();
-    USAGE19 = `capture measure map scroll [url|snap] \u2014 scroll-container topology recorded in a snapshot's scroll.json
+    USAGE20 = `capture measure map scroll [url|snap] \u2014 scroll-container topology recorded in a snapshot's scroll.json
 
 input:
   [url|snap]   required target: a URL creates a settled snapshot first; a snapshot id from the active session or an absolute snapshot artifact path is read without re-driving the browser
@@ -238483,7 +238596,7 @@ function errorResult2(err) {
 }
 async function cmdMeasureMapLayers(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE20);
+    console.log(USAGE21);
     return;
   }
   if (parsed.positional.length > 1) {
@@ -238516,14 +238629,14 @@ async function cmdMeasureMapLayers(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var USAGE20;
+var USAGE21;
 var init_map_layers2 = __esm({
   "src/cdp/commands/measure/map-layers.ts"() {
     init_snap();
     init_map_layers();
     init_artifact();
     init_render();
-    USAGE20 = `capture measure map layers [url|snap] \u2014 paint/compositor facts recorded in a snapshot's layers.json
+    USAGE21 = `capture measure map layers [url|snap] \u2014 paint/compositor facts recorded in a snapshot's layers.json
 
 input:
   [url|snap]   required target: a URL creates a settled snapshot first; a snapshot id or absolute path is read without re-driving the browser
@@ -239007,7 +239120,7 @@ function recoveryResult2(err) {
 }
 async function cmdMeasureMapAx(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE21);
+    console.log(USAGE22);
     return;
   }
   if (parsed.positional.length !== 1) {
@@ -239031,14 +239144,14 @@ async function cmdMeasureMapAx(parsed, _args) {
     process.exitCode = 1;
   }
 }
-var USAGE21;
+var USAGE22;
 var init_map_ax2 = __esm({
   "src/cdp/commands/measure/map-ax.ts"() {
     init_snap();
     init_map_ax();
     init_artifact();
     init_render();
-    USAGE21 = `capture measure map ax [url|snap] \u2014 accessibility-tree facts recorded in a snapshot's ax.json joined against geometry.json
+    USAGE22 = `capture measure map ax [url|snap] \u2014 accessibility-tree facts recorded in a snapshot's ax.json joined against geometry.json
 
 input:
   [url|snap]   required target: a URL creates a settled snapshot first; a snapshot id or absolute path is read without re-driving the browser
@@ -239145,7 +239258,7 @@ capture measure map <leaf> -h    Per-leaf usage`;
 // src/cdp/commands/motion/rec.ts
 async function cmdMotionRec(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE22);
+    console.log(USAGE23);
     return;
   }
   const lifecycleError = validateLifecycleInputs(parsed);
@@ -239509,7 +239622,7 @@ function listRecordingArtifacts(recDir) {
   }
   return names.sort().map((name) => ({ name }));
 }
-var fs26, path27, crypto9, import_child_process3, deps6, USAGE22, DoActionError;
+var fs26, path27, crypto9, import_child_process3, deps6, USAGE23, DoActionError;
 var init_rec = __esm({
   "src/cdp/commands/motion/rec.ts"() {
     fs26 = __toESM(require("fs"));
@@ -239541,7 +239654,7 @@ var init_rec = __esm({
       stopComposedRecorder,
       encodeVideo: encodeVideoIfAvailable
     };
-    USAGE22 = `capture motion rec \u2014 record the page over time: composed (whatever the active session does between --start and --stop) or one-shot (one scripted action on a URL or the active session tab).
+    USAGE23 = `capture motion rec \u2014 record the page over time: composed (whatever the active session does between --start and --stop) or one-shot (one scripted action on a URL or the active session tab).
 
 input:
   [url] --do <action>       one-shot: open <url> (or record the active session tab when <url> is omitted), record one action, finalize
@@ -239854,7 +239967,7 @@ var init_mask = __esm({
 // src/cdp/commands/motion/mask.ts
 async function cmdMotionMask(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE23);
+    console.log(USAGE24);
     return;
   }
   if (parsed.positional.length !== 1) {
@@ -239916,14 +240029,14 @@ function emitCommandError2(parsed, status, message) {
   }, { json: parsed.json });
   process.exitCode = 1;
 }
-var DEFAULT_REGION_LIMIT, USAGE23;
+var DEFAULT_REGION_LIMIT, USAGE24;
 var init_mask2 = __esm({
   "src/cdp/commands/motion/mask.ts"() {
     init_mask();
     init_artifact();
     init_render();
     DEFAULT_REGION_LIMIT = 20;
-    USAGE23 = `capture motion mask <rec> \u2014 motion-diff composite image plus per-region facts over a finalized recording
+    USAGE24 = `capture motion mask <rec> \u2014 motion-diff composite image plus per-region facts over a finalized recording
 
 input:
   <rec>          recording id in the active session or an absolute recording path (required; the recording must be finalized)
@@ -240061,7 +240174,7 @@ var init_timeline = __esm({
 // src/cdp/commands/motion/timeline.ts
 async function cmdMotionTimeline(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE24);
+    console.log(USAGE25);
     return;
   }
   const recArg = parsed.positional[0];
@@ -240159,13 +240272,13 @@ function emitCommandError3(parsed, status, message, recovery, ref, state) {
   emitResult(result, { json: parsed.json });
   process.exitCode = 1;
 }
-var USAGE24;
+var USAGE25;
 var init_timeline2 = __esm({
   "src/cdp/commands/motion/timeline.ts"() {
     init_artifact();
     init_timeline();
     init_render();
-    USAGE24 = `capture motion timeline <rec> --element <sel> \u2014 per-frame geometry/scroll/property timeline for one element across a finalized recording
+    USAGE25 = `capture motion timeline <rec> --element <sel> \u2014 per-frame geometry/scroll/property timeline for one element across a finalized recording
 
 input:
   <rec>             recording id in the active session or an absolute recording path (required; the recording must be finalized)
@@ -240457,7 +240570,7 @@ var init_jank = __esm({
 // src/cdp/commands/motion/jank.ts
 async function cmdMotionJank(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE25);
+    console.log(USAGE26);
     return;
   }
   if (parsed.positional.length !== 1 || !parsed.positional[0]) {
@@ -240550,13 +240663,13 @@ function emitCommandError4(parsed, status, message, recovery) {
   emitResult(result, { json: parsed.json });
   process.exitCode = 1;
 }
-var USAGE25;
+var USAGE26;
 var init_jank2 = __esm({
   "src/cdp/commands/motion/jank.ts"() {
     init_artifact();
     init_render();
     init_jank();
-    USAGE25 = `capture motion jank <rec> \u2014 dropped-frame, long-task-record, and layout-shift facts over a finalized recording
+    USAGE26 = `capture motion jank <rec> \u2014 dropped-frame, long-task-record, and layout-shift facts over a finalized recording
 
 input:
   <rec>   recording id in the active session or an absolute recording path (required; the recording must be finalized)
@@ -240811,7 +240924,7 @@ function emitError(parsed, status, message, sections) {
 }
 async function cmdMotionResponse(parsed, _args) {
   if (parsed.help) {
-    console.log(USAGE26);
+    console.log(USAGE27);
     return;
   }
   if (parsed.positional.length !== 1) {
@@ -240852,13 +240965,13 @@ async function cmdMotionResponse(parsed, _args) {
     return emitError(parsed, "response_unavailable", err instanceof Error ? err.message : String(err));
   }
 }
-var USAGE26;
+var USAGE27;
 var init_response2 = __esm({
   "src/cdp/commands/motion/response.ts"() {
     init_render();
     init_artifact();
     init_response();
-    USAGE26 = `capture motion response <rec> \u2014 input-to-settled response timeline over a finalized recording
+    USAGE27 = `capture motion response <rec> \u2014 input-to-settled response timeline over a finalized recording
 
 input:
   <rec>                recording id in the active session or an absolute recording path (required; the recording must be finalized)
@@ -241033,6 +241146,9 @@ init_motion();
 init_cdp();
 init_lib();
 var ROOTS = ["session", "page", "tab", "measure", "motion", "cdp", "lib"];
+var GUESSABLE_HINTS = {
+  screenshot: "page shot"
+};
 var ROOT_BLOCKS = [
   COMMAND_BLOCK,
   COMMAND_BLOCK2,
@@ -241056,7 +241172,7 @@ CDP_PORT / CDP_TARGET pin the browser + tab for orchestrators \u2014 precedence:
 explicit flag > active session > env.`;
 }
 function printVersion() {
-  const declared = "1.3.13";
+  const declared = "1.3.15";
   if (declared) {
     console.log(declared);
     return;
@@ -241086,10 +241202,11 @@ async function main() {
   if (ROOTS.includes(command) || command === "__bridge-serve") {
     return cdpMain();
   }
+  const hint = GUESSABLE_HINTS[command];
   throw captureError(
     "invocation",
     "unknown_command",
-    `Unknown command ${command}; expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.`
+    hint ? `Unknown command ${command}; did you mean \`capture ${hint}\`? Expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.` : `Unknown command ${command}; expected one of the seven roots: session, page, tab, measure, motion, cdp, lib.`
   );
 }
 main().catch((error) => {