cdp-toolkit 3.1.0 → 3.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js CHANGED
@@ -802,6 +802,204 @@ var init_frames = __esm(() => {
802
802
  FRAME_SELECTOR_PAGE_ONLY_MESSAGE = "target 'frame:<substring>' selects an out-of-process iframe, and this tool is page-only " + "(closing, selecting, releasing or claiming an iframe is meaningless; these act on the embedder tab). " + `The page-only tools are ${FRAME_PAGE_ONLY_TOOLS.join(", ")}; every other tool that takes a 'target' ` + "accepts a frame: selector.";
803
803
  });
804
804
 
805
+ // src/cdp/endpoint.ts
806
+ import { readFile as readFile3 } from "node:fs/promises";
807
+ import { join as join3 } from "node:path";
808
+ async function browserWsFromPortFile(dir, base) {
809
+ const raw = await readFile3(join3(dir, "DevToolsActivePort"), "utf8").catch(() => {
810
+ return;
811
+ });
812
+ if (!raw)
813
+ return;
814
+ const [port, path] = raw.split(`
815
+ `);
816
+ if (!port?.trim() || !path?.trim())
817
+ return;
818
+ const host = new URL(base).hostname;
819
+ return `ws://${host}:${port.trim()}${path.trim()}`;
820
+ }
821
+ async function discoverBrowserWs(base) {
822
+ const dir = process.env.CDP_USER_DATA_DIR;
823
+ return dir ? browserWsFromPortFile(dir, base) : undefined;
824
+ }
825
+ async function handshake(url, timeoutMs) {
826
+ const conn = new CdpConnection(url, { timeoutMs });
827
+ try {
828
+ await conn.connect();
829
+ return true;
830
+ } catch {
831
+ return false;
832
+ } finally {
833
+ conn.close();
834
+ }
835
+ }
836
+ function detectEndpoint() {
837
+ const endpoint = currentEndpoint();
838
+ const base = endpoint.base;
839
+ const isDefault = isDefaultEndpoint(endpoint);
840
+ const hit = cached.get(base);
841
+ if (hit)
842
+ return hit;
843
+ const detection = (async () => {
844
+ const forced = isDefault ? process.env.CDP_BROWSER_WS : undefined;
845
+ if (forced)
846
+ return { transport: "browser-ws", browserWsUrl: forced };
847
+ const discovered = isDefault ? await discoverBrowserWs(base) : undefined;
848
+ if (discovered && await handshake(discovered, 5000)) {
849
+ return { transport: "browser-ws", browserWsUrl: discovered };
850
+ }
851
+ const version = await fetch(`${base}/json/version`, { signal: AbortSignal.timeout(5000) }).then((r) => r.ok ? r.json() : undefined).catch(() => {
852
+ return;
853
+ });
854
+ if (version?.webSocketDebuggerUrl) {
855
+ return { transport: "http", browserWsUrl: version.webSocketDebuggerUrl };
856
+ }
857
+ const dir = isDefault ? process.env.CDP_USER_DATA_DIR : undefined;
858
+ throw new Error(`no DevTools endpoint at ${base}: GET /json/version did not answer and ` + (dir ? `no live browser socket was named by ${dir}/DevToolsActivePort. ` : `no profile was searched — CDP_USER_DATA_DIR is unset, and no profile is ever scanned unless you name one. `) + `Set CDP_BROWSER_WS to the ws://.../devtools/browser/<uuid> URL, or CDP_USER_DATA_DIR to the profile in use.`);
859
+ })().then((info) => {
860
+ if (info.transport === "http")
861
+ cached.delete(base);
862
+ return info;
863
+ }, (error) => {
864
+ cached.delete(base);
865
+ throw error;
866
+ });
867
+ cached.set(base, detection);
868
+ return detection;
869
+ }
870
+ function forgetEndpoint() {
871
+ cached.delete(currentEndpoint().base);
872
+ }
873
+ var cached;
874
+ var init_endpoint = __esm(() => {
875
+ init_endpoints();
876
+ init_client();
877
+ cached = new Map;
878
+ });
879
+
880
+ // src/cdp/session.ts
881
+ async function acquireBrowserConn() {
882
+ if (shared) {
883
+ shared.refs++;
884
+ return shared.conn;
885
+ }
886
+ if (!opening) {
887
+ opening = (async () => {
888
+ let { browserWsUrl } = await detectEndpoint();
889
+ let conn;
890
+ try {
891
+ conn = await new CdpConnection(browserWsUrl).connect();
892
+ } catch (error) {
893
+ forgetEndpoint();
894
+ const fresh = (await detectEndpoint().catch(() => {
895
+ return;
896
+ }))?.browserWsUrl;
897
+ if (!fresh || fresh === browserWsUrl)
898
+ throw error;
899
+ browserWsUrl = fresh;
900
+ conn = await new CdpConnection(browserWsUrl).connect();
901
+ }
902
+ shared = { conn, refs: 0, url: browserWsUrl };
903
+ return conn;
904
+ })().finally(() => {
905
+ opening = undefined;
906
+ });
907
+ }
908
+ const conn = await opening;
909
+ shared.refs++;
910
+ return conn;
911
+ }
912
+ function releaseBrowserConn() {
913
+ if (!shared)
914
+ return;
915
+ shared.refs--;
916
+ if (shared.refs <= 0) {
917
+ const { conn } = shared;
918
+ shared = undefined;
919
+ conn.close();
920
+ }
921
+ }
922
+ async function withBrowserSocket(fn) {
923
+ const conn = await acquireBrowserConn();
924
+ try {
925
+ return await fn(conn);
926
+ } finally {
927
+ releaseBrowserConn();
928
+ }
929
+ }
930
+
931
+ class SessionConnection {
932
+ browser;
933
+ sessionId;
934
+ opts;
935
+ detached = false;
936
+ offs = [];
937
+ constructor(browser, sessionId, opts = {}) {
938
+ this.browser = browser;
939
+ this.sessionId = sessionId;
940
+ this.opts = opts;
941
+ }
942
+ send(method, params = {}, opts = {}) {
943
+ if (this.detached)
944
+ return Promise.reject(new CdpError("connection not open"));
945
+ return this.browser.send(method, params, {
946
+ timeoutMs: opts.timeoutMs ?? this.opts.timeoutMs,
947
+ sessionId: opts.sessionId ?? this.sessionId
948
+ });
949
+ }
950
+ on(method, handler) {
951
+ const off = this.browser.on(method, (params, sessionId) => {
952
+ if (sessionId && sessionId !== this.sessionId)
953
+ return;
954
+ handler(params, sessionId);
955
+ });
956
+ this.offs.push(off);
957
+ return off;
958
+ }
959
+ waitFor(method, predicate, timeoutMs = this.opts.timeoutMs ?? DEFAULT_TIMEOUT_MS) {
960
+ return new Promise((resolve, reject) => {
961
+ const timer = setTimeout(() => {
962
+ off();
963
+ reject(new CdpError(`waitFor('${method}') timed out after ${timeoutMs}ms`));
964
+ }, timeoutMs);
965
+ const off = this.on(method, (params) => {
966
+ if (!predicate || predicate(params)) {
967
+ clearTimeout(timer);
968
+ off();
969
+ resolve(params);
970
+ }
971
+ });
972
+ });
973
+ }
974
+ close() {
975
+ if (this.detached)
976
+ return;
977
+ this.detached = true;
978
+ for (const off of this.offs)
979
+ off();
980
+ this.offs.length = 0;
981
+ this.browser.send("Target.detachFromTarget", { sessionId: this.sessionId }).catch(() => {});
982
+ releaseBrowserConn();
983
+ }
984
+ }
985
+ async function openSession(targetId, opts = {}) {
986
+ const browser = await acquireBrowserConn();
987
+ try {
988
+ const { sessionId } = await browser.send("Target.attachToTarget", { targetId, flatten: true }, { timeoutMs: opts.timeoutMs });
989
+ if (!sessionId)
990
+ throw new CdpError(`Target.attachToTarget returned no sessionId for ${targetId}`);
991
+ return new SessionConnection(browser, sessionId, opts);
992
+ } catch (e) {
993
+ releaseBrowserConn();
994
+ throw e;
995
+ }
996
+ }
997
+ var shared, opening;
998
+ var init_session = __esm(() => {
999
+ init_client();
1000
+ init_endpoint();
1001
+ });
1002
+
805
1003
  // src/client.ts
806
1004
  class CdpConnection {
807
1005
  wsUrl;
@@ -934,12 +1132,47 @@ async function httpJson(path) {
934
1132
  throw new CdpError(`${path} -> HTTP ${res.status}`);
935
1133
  return await res.json();
936
1134
  }
937
- function listTargets() {
938
- return httpJson("/json/list");
1135
+ async function getTargetsOverBrowserWs() {
1136
+ const { targetInfos } = await withBrowserSocket((conn) => conn.send("Target.getTargets", { filter: [{}] }));
1137
+ return targetInfos.map((t) => ({
1138
+ id: t.targetId,
1139
+ type: t.type,
1140
+ title: t.title,
1141
+ url: t.url,
1142
+ webSocketDebuggerUrl: "",
1143
+ ...t.openerId ? { parentId: t.openerId } : {}
1144
+ }));
1145
+ }
1146
+ async function listTargets() {
1147
+ const base = currentEndpoint().base;
1148
+ if (knownTransports.get(base) === "browser-ws")
1149
+ return getTargetsOverBrowserWs();
1150
+ try {
1151
+ const listing = await httpJson("/json/list");
1152
+ knownTransports.set(base, "http");
1153
+ return listing;
1154
+ } catch (httpError) {
1155
+ const detected = await detectEndpoint().catch(() => {
1156
+ return;
1157
+ });
1158
+ if (detected?.transport !== "browser-ws")
1159
+ throw httpError;
1160
+ const targets = await getTargetsOverBrowserWs().catch(() => {
1161
+ throw httpError;
1162
+ });
1163
+ knownTransports.set(base, "browser-ws");
1164
+ return targets;
1165
+ }
939
1166
  }
940
1167
  async function browserWsUrl() {
941
- const v = await httpJson("/json/version");
942
- return v.webSocketDebuggerUrl;
1168
+ if (knownTransports.get(currentEndpoint().base) !== "browser-ws") {
1169
+ const version = await httpJson("/json/version").catch(() => {
1170
+ return;
1171
+ });
1172
+ if (version?.webSocketDebuggerUrl)
1173
+ return version.webSocketDebuggerUrl;
1174
+ }
1175
+ return (await detectEndpoint()).browserWsUrl;
943
1176
  }
944
1177
  async function resolveTarget(selector, opts = {}) {
945
1178
  const targets = await listTargets();
@@ -1021,7 +1254,7 @@ async function openBrowser(opts = {}) {
1021
1254
  }
1022
1255
  async function openPage(selector, opts = {}) {
1023
1256
  const target = await resolveTarget(selector, { lease: opts.lease });
1024
- const conn = await new CdpConnection(target.webSocketDebuggerUrl, opts).connect();
1257
+ const conn = target.webSocketDebuggerUrl ? await new CdpConnection(target.webSocketDebuggerUrl, opts).connect() : await openSession(target.id, opts);
1025
1258
  return { conn, target };
1026
1259
  }
1027
1260
  async function withPage(selector, fn, opts = {}) {
@@ -1032,13 +1265,16 @@ async function withPage(selector, fn, opts = {}) {
1032
1265
  conn.close();
1033
1266
  }
1034
1267
  }
1035
- var BASE, DEFAULT_TIMEOUT_MS, CdpError;
1268
+ var BASE, DEFAULT_TIMEOUT_MS, CdpError, knownTransports;
1036
1269
  var init_client = __esm(() => {
1037
1270
  init_leases();
1038
1271
  init_origins();
1039
1272
  init_endpoints();
1040
1273
  init_workers();
1041
1274
  init_frames();
1275
+ init_endpoint();
1276
+ init_session();
1277
+ init_session();
1042
1278
  BASE = (() => {
1043
1279
  try {
1044
1280
  return defaultEndpoint().base;
@@ -1057,6 +1293,7 @@ var init_client = __esm(() => {
1057
1293
  this.name = "CdpError";
1058
1294
  }
1059
1295
  };
1296
+ knownTransports = new Map;
1060
1297
  });
1061
1298
 
1062
1299
  // src/activity.ts
@@ -1373,8 +1610,8 @@ var init_network_mock = __esm(() => {
1373
1610
  });
1374
1611
 
1375
1612
  // src/driver.ts
1376
- import { mkdir as mkdir3, readFile as readFile3, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
1377
- import { join as join3 } from "node:path";
1613
+ import { mkdir as mkdir3, readFile as readFile4, unlink as unlink3, writeFile as writeFile3 } from "node:fs/promises";
1614
+ import { join as join4 } from "node:path";
1378
1615
  function isDriverError(e) {
1379
1616
  return e instanceof Error && typeof e.code === "string";
1380
1617
  }
@@ -1390,11 +1627,11 @@ function isTiledCapture(delivery) {
1390
1627
  return delivery.tiled === true;
1391
1628
  }
1392
1629
  function viewportRecordFile(scheme, targetId) {
1393
- return join3(leaseDir(), `viewport-${scheme}-${targetId.replace(/[^A-Za-z0-9._-]/g, "_")}.json`);
1630
+ return join4(leaseDir(), `viewport-${scheme}-${targetId.replace(/[^A-Za-z0-9._-]/g, "_")}.json`);
1394
1631
  }
1395
1632
  async function readViewportRecord(scheme, targetId) {
1396
1633
  try {
1397
- const raw = JSON.parse(await readFile3(viewportRecordFile(scheme, targetId), "utf8"));
1634
+ const raw = JSON.parse(await readFile4(viewportRecordFile(scheme, targetId), "utf8"));
1398
1635
  if (typeof raw?.width !== "number" || typeof raw?.height !== "number")
1399
1636
  return;
1400
1637
  return {
@@ -1445,8 +1682,324 @@ var init_driver = __esm(() => {
1445
1682
  };
1446
1683
  });
1447
1684
 
1685
+ // src/bidi/snapshot.ts
1686
+ async function takeStampedSnapshot(evaluate) {
1687
+ const raw = await evaluate(buildSnapshotFunctionSource());
1688
+ return coerceSnapshotResult(raw);
1689
+ }
1690
+ function coerceSnapshotResult(raw) {
1691
+ if (typeof raw !== "object" || raw === null || typeof raw.snapshot !== "string" || typeof raw.nodeCount !== "number") {
1692
+ throw new Error("takeStampedSnapshot: evaluate() returned an unexpected shape");
1693
+ }
1694
+ return { snapshot: raw.snapshot, nodeCount: raw.nodeCount };
1695
+ }
1696
+ function buildSnapshotFunctionSource() {
1697
+ return `function() {
1698
+ var STAMP_ATTR = ${JSON.stringify(STAMP_ATTR)};
1699
+ var MAX_NAME_LENGTH = ${MAX_NAME_LENGTH};
1700
+ var lines = [];
1701
+ var nodeCount = 0;
1702
+
1703
+ // THE UID CODEC (driver.ts) documents a bidi payload as exactly 12 lowercase hex chars,
1704
+ // /^[0-9a-f]{12}$/. Build it from two padded random blocks so the length is exact regardless
1705
+ // of the random value drawn, never from string concatenation that could come up short.
1706
+ function nextStamp() {
1707
+ var hi = Math.floor(Math.random() * 0x100000000).toString(16).padStart(8, "0");
1708
+ var lo = Math.floor(Math.random() * 0x10000).toString(16).padStart(4, "0");
1709
+ return hi + lo;
1710
+ }
1711
+
1712
+ function stampOf(el) {
1713
+ var existing = el.getAttribute(STAMP_ATTR);
1714
+ if (existing) return existing;
1715
+ var stamp = nextStamp();
1716
+ el.setAttribute(STAMP_ATTR, stamp);
1717
+ return stamp;
1718
+ }
1719
+
1720
+ // skipSizeCheck exempts <option>/<optgroup> from the zero-size prune: a
1721
+ // closed select's popup is unpainted (0x0) though its options are still
1722
+ // present and pickable. Other visibility rules still apply to them.
1723
+ function isVisible(el, skipSizeCheck) {
1724
+ if (el.hidden) return false;
1725
+ if (el.getAttribute("aria-hidden") === "true") return false;
1726
+ var style;
1727
+ try {
1728
+ style = el.ownerDocument.defaultView.getComputedStyle(el);
1729
+ } catch (e) {
1730
+ style = null;
1731
+ }
1732
+ if (style) {
1733
+ if (style.display === "none" || style.visibility === "hidden") return false;
1734
+ }
1735
+ if (!skipSizeCheck) {
1736
+ var rect = el.getBoundingClientRect();
1737
+ if (rect.width === 0 && rect.height === 0) return false;
1738
+ }
1739
+ return true;
1740
+ }
1741
+
1742
+ ${ACCNAME_HELPERS_SOURCE}
1743
+
1744
+ function headingLevel(el) {
1745
+ var m = /^H([1-6])$/.exec(el.tagName);
1746
+ return m ? m[1] : null;
1747
+ }
1748
+
1749
+ function currentValue(el) {
1750
+ var tag = el.tagName;
1751
+ if (tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT") {
1752
+ return el.value;
1753
+ }
1754
+ if (el.isContentEditable) return textOf(el);
1755
+ return undefined;
1756
+ }
1757
+
1758
+ function isChecked(el) {
1759
+ var tag = el.tagName;
1760
+ if (tag === "INPUT") {
1761
+ var type = (el.getAttribute("type") || "").toLowerCase();
1762
+ if (type === "checkbox" || type === "radio") return !!el.checked;
1763
+ }
1764
+ var aria = el.getAttribute("aria-checked");
1765
+ if (aria === "true") return true;
1766
+ return false;
1767
+ }
1768
+
1769
+ function describeNode(el, role) {
1770
+ var contentNamed = !!CONTENT_NAMED_ROLES[role];
1771
+ var name = accessibleName(el, contentNamed);
1772
+ var extras = [];
1773
+ var value = currentValue(el);
1774
+ if (value !== undefined && value !== "") extras.push("value=" + JSON.stringify(String(value)));
1775
+ if (isChecked(el)) extras.push("checked=true");
1776
+ if (el.tagName === "OPTION" && el.selected) extras.push("selected");
1777
+ var href = el.getAttribute("href");
1778
+ if (href) extras.push("url=" + href);
1779
+ if (el.disabled || el.getAttribute("aria-disabled") === "true") extras.push("disabled");
1780
+ var level = headingLevel(el);
1781
+ if (level) extras.push("level=" + level);
1782
+ var label = name ? " " + JSON.stringify(name) : "";
1783
+ var extra = extras.length ? " [" + extras.join(" ") + "]" : "";
1784
+ return { role: role, label: label, extra: extra, name: name };
1785
+ }
1786
+
1787
+ // Traverses light DOM, open shadow roots, and same-origin iframe documents.
1788
+ // A cross-origin iframe throws on contentDocument access; caught and
1789
+ // skipped rather than aborting the whole walk, and noted in a comment
1790
+ // here rather than silently vanishing from the tree without a trace.
1791
+ function walk(root, depth) {
1792
+ var children = root.children ? Array.prototype.slice.call(root.children) : [];
1793
+ for (var i = 0; i < children.length; i++) {
1794
+ var el = children[i];
1795
+ var isSelectChild = el.tagName === "OPTION" || el.tagName === "OPTGROUP";
1796
+ if (!isVisible(el, isSelectChild)) continue;
1797
+
1798
+ var role = implicitRole(el);
1799
+ var isLandmarkOrControl = !!role;
1800
+ var described = null;
1801
+ if (isLandmarkOrControl) {
1802
+ described = describeNode(el, role);
1803
+ }
1804
+
1805
+ var hasContent = described && (described.name || described.extra);
1806
+ var isStructural = isLandmarkOrControl && (hasContent || isInteractiveRole(role) || isLandmarkRole(role));
1807
+
1808
+ // Role-less visible leaf text (measured vs Chrome's take_snapshot,
1809
+ // which keeps a StaticText under a generic wrapper for this case,
1810
+ // e.g. a plain status <div>). Only a leaf (no element children, so
1811
+ // its text is not already captured by a nested control/label).
1812
+ var hasElementChildren = !!(el.children && el.children.length > 0);
1813
+ var leafName = !isStructural && !hasElementChildren ? truncate(textOf(el)) : "";
1814
+ var isLeafText = !!leafName;
1815
+
1816
+ var nextDepth = depth;
1817
+ if (isStructural || isLeafText) {
1818
+ var stamp = stampOf(el);
1819
+ var indent = new Array(depth + 1).join(" ");
1820
+ var lineTail = isStructural
1821
+ ? described.role + described.label + described.extra
1822
+ : "text " + JSON.stringify(leafName);
1823
+ lines.push(indent + "[" + stamp + "] " + lineTail);
1824
+ nodeCount += 1;
1825
+ nextDepth = depth + 1;
1826
+ }
1827
+
1828
+ if (el.shadowRoot) {
1829
+ walk(el.shadowRoot, nextDepth);
1830
+ } else if (el.tagName === "IFRAME") {
1831
+ try {
1832
+ var doc = el.contentDocument;
1833
+ if (doc && doc.body) walk(doc.body, nextDepth);
1834
+ } catch (e) {
1835
+ // cross-origin iframe: intentionally skipped, not silently merged
1836
+ // into the parent tree as though it were empty.
1837
+ }
1838
+ } else {
1839
+ walk(el, nextDepth);
1840
+ }
1841
+ }
1842
+ }
1843
+
1844
+ function isInteractiveRole(role) {
1845
+ return (
1846
+ role === "button" ||
1847
+ role === "link" ||
1848
+ role === "textbox" ||
1849
+ role === "searchbox" ||
1850
+ role === "checkbox" ||
1851
+ role === "radio" ||
1852
+ role === "combobox" ||
1853
+ role === "listbox" ||
1854
+ role === "option" ||
1855
+ role === "slider" ||
1856
+ role === "spinbutton" ||
1857
+ role === "progressbar" ||
1858
+ role === "meter"
1859
+ );
1860
+ }
1861
+
1862
+ function isLandmarkRole(role) {
1863
+ return (
1864
+ role === "navigation" ||
1865
+ role === "main" ||
1866
+ role === "form" ||
1867
+ role === "dialog" ||
1868
+ role === "region" ||
1869
+ role === "heading" ||
1870
+ role === "list" ||
1871
+ role === "listitem" ||
1872
+ role === "table" ||
1873
+ role === "row" ||
1874
+ role === "cell" ||
1875
+ role === "columnheader" ||
1876
+ role === "img"
1877
+ );
1878
+ }
1879
+
1880
+ walk(document.body, 0);
1881
+ return { snapshot: lines.join("\\n"), nodeCount: nodeCount };
1882
+ }`;
1883
+ }
1884
+ var STAMP_ATTR = "data-cdp-uid", ACCNAME_HELPERS_SOURCE = `
1885
+ function truncate(s) {
1886
+ s = s.trim().replace(/\\s+/g, " ");
1887
+ if (s.length > MAX_NAME_LENGTH) return s.slice(0, MAX_NAME_LENGTH - 1) + "\\u2026";
1888
+ return s;
1889
+ }
1890
+
1891
+ function textOf(el) {
1892
+ return el.textContent || "";
1893
+ }
1894
+
1895
+ function idRefsText(doc, ids) {
1896
+ var parts = [];
1897
+ var list = ids.trim().split(/\\s+/);
1898
+ for (var i = 0; i < list.length; i++) {
1899
+ var ref = doc.getElementById(list[i]);
1900
+ if (ref) parts.push(textOf(ref));
1901
+ }
1902
+ return parts.join(" ").trim();
1903
+ }
1904
+
1905
+ // Text of a <label>, minus any nested form control's own content: a
1906
+ // label that WRAPS its control ("<label>Color <select>...</select></label>")
1907
+ // would otherwise include every option's text in the control's own name.
1908
+ function labelOwnText(label) {
1909
+ var clone = label.cloneNode(true);
1910
+ var controls = clone.querySelectorAll("input, select, textarea, button");
1911
+ for (var i = 0; i < controls.length; i++) {
1912
+ controls[i].parentNode.removeChild(controls[i]);
1913
+ }
1914
+ return textOf(clone);
1915
+ }
1916
+
1917
+ // Guard: without this, an <option> inside a labelled <select> would
1918
+ // inherit the select's own label via closest("label"), not its text.
1919
+ var LABELABLE_TAGS = { INPUT: 1, TEXTAREA: 1, SELECT: 1, BUTTON: 1, METER: 1, OUTPUT: 1, PROGRESS: 1 };
1920
+
1921
+ function nativeLabelText(el) {
1922
+ if (!LABELABLE_TAGS[el.tagName]) return "";
1923
+ var doc = el.ownerDocument;
1924
+ if (el.id) {
1925
+ var forLabel = doc.querySelector('label[for="' + el.id + '"]');
1926
+ if (forLabel) return labelOwnText(forLabel);
1927
+ }
1928
+ var ancestor = el.closest ? el.closest("label") : null;
1929
+ if (ancestor) return labelOwnText(ancestor);
1930
+ return "";
1931
+ }
1932
+
1933
+ // Reduced accname: aria-labelledby, then aria-label, then native label,
1934
+ // then alt/title/placeholder, then trimmed own text for content-named
1935
+ // elements. Not the full W3C accname algorithm (no recursive traversal
1936
+ // rules for nested presentational content) but covers the common cases.
1937
+ function accessibleName(el, contentNamed) {
1938
+ var doc = el.ownerDocument;
1939
+ var labelledby = el.getAttribute("aria-labelledby");
1940
+ if (labelledby) {
1941
+ var viaIds = idRefsText(doc, labelledby);
1942
+ if (viaIds) return truncate(viaIds);
1943
+ }
1944
+ var ariaLabel = el.getAttribute("aria-label");
1945
+ if (ariaLabel && ariaLabel.trim()) return truncate(ariaLabel);
1946
+ var native = nativeLabelText(el);
1947
+ if (native && native.trim()) return truncate(native);
1948
+ var alt = el.getAttribute("alt");
1949
+ if (alt && alt.trim()) return truncate(alt);
1950
+ var title = el.getAttribute("title");
1951
+ if (title && title.trim()) return truncate(title);
1952
+ var placeholder = el.getAttribute("placeholder");
1953
+ if (placeholder && placeholder.trim()) return truncate(placeholder);
1954
+ if (contentNamed) {
1955
+ var text = textOf(el);
1956
+ if (text && text.trim()) return truncate(text);
1957
+ }
1958
+ return "";
1959
+ }
1960
+
1961
+ var IMPLICIT_ROLE_BY_TAG = {
1962
+ A: "link", BUTTON: "button", NAV: "navigation", MAIN: "main", FORM: "form", DIALOG: "dialog",
1963
+ UL: "list", OL: "list", LI: "listitem", TABLE: "table", TR: "row", TD: "cell", TH: "columnheader",
1964
+ SELECT: "combobox", OPTION: "option", TEXTAREA: "textbox", IMG: "img",
1965
+ H1: "heading", H2: "heading", H3: "heading", H4: "heading", H5: "heading", H6: "heading",
1966
+ PROGRESS: "progressbar", METER: "meter"
1967
+ };
1968
+
1969
+ var INPUT_TYPE_ROLE = {
1970
+ button: "button", submit: "button", reset: "button", checkbox: "checkbox", radio: "radio",
1971
+ range: "slider", number: "spinbutton", search: "searchbox", email: "textbox", tel: "textbox",
1972
+ url: "textbox", password: "textbox", text: "textbox", image: "button"
1973
+ };
1974
+
1975
+ var CONTENT_NAMED_ROLES = {
1976
+ button: true, link: true, heading: true, option: true, cell: true,
1977
+ columnheader: true, listitem: true, menuitem: true, tab: true
1978
+ };
1979
+
1980
+ function implicitRole(el) {
1981
+ var explicit = el.getAttribute("role");
1982
+ if (explicit) return explicit;
1983
+ var tag = el.tagName;
1984
+ if (tag === "INPUT") {
1985
+ var type = (el.getAttribute("type") || "text").toLowerCase();
1986
+ return INPUT_TYPE_ROLE[type] || "textbox";
1987
+ }
1988
+ if (tag === "A" && !el.getAttribute("href")) return "";
1989
+ if (Object.prototype.hasOwnProperty.call(IMPLICIT_ROLE_BY_TAG, tag)) {
1990
+ return IMPLICIT_ROLE_BY_TAG[tag];
1991
+ }
1992
+ // Deliberate divergence: Chrome's real AX tree says "generic" here,
1993
+ // but "textbox" is the useful signal an agent needs. Chrome is out of
1994
+ // step, do not "fix" this toward parity.
1995
+ if (el.isContentEditable) return "textbox";
1996
+ return "";
1997
+ }
1998
+ `, MAX_NAME_LENGTH = 120;
1999
+
1448
2000
  // src/cdp/driver.ts
1449
2001
  init_client();
2002
+ init_session();
1450
2003
  init_leases();
1451
2004
  init_endpoints();
1452
2005
  init_activity();
@@ -1910,6 +2463,7 @@ var CDP_CAPABILITIES = new Set([
1910
2463
  "locate.xpath",
1911
2464
  "capture.screencast",
1912
2465
  "input.raw",
2466
+ "input.modifierClick",
1913
2467
  "input.html5Drag",
1914
2468
  "emulate.focus",
1915
2469
  "browser.downloads",
@@ -2534,9 +3088,17 @@ function beaconKey(targetId) {
2534
3088
  const backend = chromeLeaseBackend(currentEndpoint());
2535
3089
  return backend === "chrome" ? targetId : `${backend}\x00${targetId}`;
2536
3090
  }
2537
- async function targetWsUrl(targetId) {
3091
+ async function openTargetConn(targetId, opts = {}) {
2538
3092
  const hit = (await listTargets()).find((t) => t.id === targetId);
2539
- return hit?.webSocketDebuggerUrl;
3093
+ if (!hit)
3094
+ return;
3095
+ if (!hit.webSocketDebuggerUrl)
3096
+ return openSession(targetId, opts).catch(() => {
3097
+ return;
3098
+ });
3099
+ return new CdpConnection(hit.webSocketDebuggerUrl, opts).connect().catch(() => {
3100
+ return;
3101
+ });
2540
3102
  }
2541
3103
  async function readBeaconOver(conn) {
2542
3104
  try {
@@ -2661,12 +3223,7 @@ class CdpBrowserDriver {
2661
3223
  return true;
2662
3224
  beaconSessions.drop(key);
2663
3225
  }
2664
- const wsUrl = await targetWsUrl(targetId).catch(() => {
2665
- return;
2666
- });
2667
- if (!wsUrl)
2668
- return false;
2669
- const conn = await new CdpConnection(wsUrl).connect().catch(() => {
3226
+ const conn = await openTargetConn(targetId).catch(() => {
2670
3227
  return;
2671
3228
  });
2672
3229
  if (!conn)
@@ -2691,12 +3248,7 @@ class CdpBrowserDriver {
2691
3248
  return value;
2692
3249
  beaconSessions.drop(key);
2693
3250
  }
2694
- const wsUrl = await targetWsUrl(targetId).catch(() => {
2695
- return;
2696
- });
2697
- if (!wsUrl)
2698
- return null;
2699
- const conn = await new CdpConnection(wsUrl).connect().catch(() => {
3251
+ const conn = await openTargetConn(targetId).catch(() => {
2700
3252
  return;
2701
3253
  });
2702
3254
  if (!conn)
@@ -2711,17 +3263,11 @@ class CdpBrowserDriver {
2711
3263
  const held = beaconSessions.get(beaconKey(targetId));
2712
3264
  if (held)
2713
3265
  return probeOver(held, timeoutMs);
2714
- const wsUrl = await targetWsUrl(targetId).catch(() => {
3266
+ const conn = await openTargetConn(targetId, { timeoutMs }).catch(() => {
2715
3267
  return;
2716
3268
  });
2717
- if (!wsUrl)
2718
- return { responsive: false, beaconTs: null };
2719
- const conn = new CdpConnection(wsUrl, { timeoutMs });
2720
- try {
2721
- await conn.connect();
2722
- } catch {
3269
+ if (!conn)
2723
3270
  return { responsive: false, beaconTs: null };
2724
- }
2725
3271
  try {
2726
3272
  return await probeOver(conn, timeoutMs);
2727
3273
  } finally {
@@ -2797,7 +3343,7 @@ async function reapStaleAgentTabs(driver, backend) {
2797
3343
  // src/shared-tools.ts
2798
3344
  init_driver();
2799
3345
  import { mkdir as mkdir5, writeFile as writeFile4 } from "node:fs/promises";
2800
- import { dirname as dirname2, join as join4 } from "node:path";
3346
+ import { dirname as dirname2, join as join5 } from "node:path";
2801
3347
 
2802
3348
  // src/png.ts
2803
3349
  import { once } from "node:events";
@@ -3502,7 +4048,7 @@ async function closePage(driver, args) {
3502
4048
  }
3503
4049
  async function writeSelectedFile(id) {
3504
4050
  await mkdir5(STATE_DIR, { recursive: true });
3505
- await writeFile4(join4(STATE_DIR, "selected"), id, "utf8");
4051
+ await writeFile4(join5(STATE_DIR, "selected"), id, "utf8");
3506
4052
  }
3507
4053
  async function selectPage(driver, args) {
3508
4054
  if (args.target === undefined || args.target === "")
@@ -3566,7 +4112,7 @@ function serializeForSink(value) {
3566
4112
  return json ?? "null";
3567
4113
  }
3568
4114
  async function writeJsonSink(savePath, value) {
3569
- const path = savePath.startsWith("/") ? savePath : join4(ARTIFACT_DIR, savePath);
4115
+ const path = savePath.startsWith("/") ? savePath : join5(ARTIFACT_DIR, savePath);
3570
4116
  await mkdir5(dirname2(path), { recursive: true });
3571
4117
  const json = serializeForSink(value);
3572
4118
  await writeFile4(path, json, "utf8");
@@ -3710,10 +4256,45 @@ async function takeSnapshot(driver, args = {}) {
3710
4256
  `), target: target3(page.info), nodeCount: nodes.length };
3711
4257
  });
3712
4258
  }
4259
+ function describeElementSource() {
4260
+ return `function() {
4261
+ var MAX_NAME_LENGTH = ${MAX_NAME_LENGTH};
4262
+ ${ACCNAME_HELPERS_SOURCE}
4263
+ var el = this;
4264
+ if (!el || el.nodeType !== 1) return null;
4265
+ var role = implicitRole(el);
4266
+ var name = accessibleName(el, !!CONTENT_NAMED_ROLES[role]);
4267
+ if (!name) name = truncate(el.innerText || el.textContent || "");
4268
+ return (role || el.tagName.toLowerCase()) + (name ? " " + JSON.stringify(name) : "");
4269
+ }`;
4270
+ }
4271
+ var DESCRIBE_TIMEOUT_MS = 2000;
4272
+ async function describeElement(page, loc) {
4273
+ let timer;
4274
+ try {
4275
+ const timeout = new Promise((r) => {
4276
+ timer = setTimeout(() => r(undefined), DESCRIBE_TIMEOUT_MS);
4277
+ });
4278
+ const desc = await Promise.race([page.callOnElement(loc, describeElementSource()), timeout]);
4279
+ return typeof desc === "string" && desc.length > 0 ? desc : undefined;
4280
+ } catch {
4281
+ return;
4282
+ } finally {
4283
+ clearTimeout(timer);
4284
+ }
4285
+ }
4286
+ function isElementLocator(d) {
4287
+ return !("x" in d) && !("dx" in d);
4288
+ }
4289
+ function elementField(element) {
4290
+ return element === undefined ? {} : { element };
4291
+ }
3713
4292
  async function click(driver, args) {
4293
+ const loc = locatorOf(args);
3714
4294
  return withPage2(driver, args.target, async (page) => {
3715
- const { x, y } = await page.click(locatorOf(args), { button: args.button ?? "left", clickCount: args.clickCount ?? 1, modifiers: args.modifiers });
3716
- return { clicked: true, x, y };
4295
+ const element = await describeElement(page, loc);
4296
+ const { x, y } = await page.click(loc, { button: args.button ?? "left", clickCount: args.clickCount ?? 1, modifiers: args.modifiers });
4297
+ return { clicked: true, ...elementField(element), x, y };
3717
4298
  });
3718
4299
  }
3719
4300
  function resolveScrollAnchor(args) {
@@ -3749,9 +4330,11 @@ async function scroll(driver, args) {
3749
4330
  });
3750
4331
  }
3751
4332
  async function hover(driver, args) {
4333
+ const loc = locatorOf(args);
3752
4334
  return withPage2(driver, args.target, async (page) => {
3753
- const { x, y } = await page.hover(locatorOf(args));
3754
- return { hovered: true, x, y };
4335
+ const element = await describeElement(page, loc);
4336
+ const { x, y } = await page.hover(loc);
4337
+ return { hovered: true, ...elementField(element), x, y };
3755
4338
  });
3756
4339
  }
3757
4340
  function resolveDragTo(to) {
@@ -3817,16 +4400,29 @@ async function drag(driver, args) {
3817
4400
  const steps = resolveDragSteps(args.steps);
3818
4401
  const mode = resolveDragMode(args.mode, driver.capabilities);
3819
4402
  return withPage2(driver, args.target, async (page) => {
3820
- const { from, to } = await page.drag(locatorOf(args.from), destination, { mode, steps });
3821
- return { dragged: true, mode, steps, from, to };
4403
+ const fromLoc = locatorOf(args.from);
4404
+ const element = await describeElement(page, fromLoc);
4405
+ const targetElement = isElementLocator(destination) ? await describeElement(page, destination) : undefined;
4406
+ const { from, to } = await page.drag(fromLoc, destination, { mode, steps });
4407
+ return {
4408
+ dragged: true,
4409
+ ...elementField(element),
4410
+ ...targetElement === undefined ? {} : { target_element: targetElement },
4411
+ mode,
4412
+ steps,
4413
+ from,
4414
+ to
4415
+ };
3822
4416
  });
3823
4417
  }
3824
4418
  async function fill(driver, args) {
3825
4419
  if (typeof args.value !== "string")
3826
4420
  throw new SharedToolError("fill requires a string { value }");
4421
+ const loc = locatorOf(args);
3827
4422
  return withPage2(driver, args.target, async (page) => {
3828
- await page.setValue(locatorOf(args), args.value);
3829
- return { filled: true, value: args.value };
4423
+ const element = await describeElement(page, loc);
4424
+ await page.setValue(loc, args.value);
4425
+ return { filled: true, ...elementField(element), value: args.value };
3830
4426
  });
3831
4427
  }
3832
4428
  async function fillForm(driver, args) {
@@ -3834,21 +4430,26 @@ async function fillForm(driver, args) {
3834
4430
  throw new SharedToolError("fill_form requires a non-empty { fields } array");
3835
4431
  return withPage2(driver, args.target, async (page) => {
3836
4432
  let filled = 0;
4433
+ const elements = [];
3837
4434
  for (const f of args.fields) {
3838
4435
  if (typeof f.value !== "string")
3839
4436
  throw new SharedToolError("each fill_form field requires a string value");
3840
- await page.setValue(locatorOf(f), f.value);
4437
+ const loc = locatorOf(f);
4438
+ elements.push(await describeElement(page, loc) ?? null);
4439
+ await page.setValue(loc, f.value);
3841
4440
  filled++;
3842
4441
  }
3843
- return { filled, fields: args.fields.length };
4442
+ return { filled, fields: args.fields.length, elements };
3844
4443
  });
3845
4444
  }
3846
4445
  async function typeText(driver, args) {
3847
4446
  if (typeof args.text !== "string")
3848
4447
  throw new SharedToolError("type_text requires a string { text }");
4448
+ const loc = locatorOf(args);
3849
4449
  return withPage2(driver, args.target, async (page) => {
3850
- await page.typeText(locatorOf(args), args.text);
3851
- return { typed: true, text: args.text };
4450
+ const element = await describeElement(page, loc);
4451
+ await page.typeText(loc, args.text);
4452
+ return { typed: true, ...elementField(element), text: args.text };
3852
4453
  });
3853
4454
  }
3854
4455
  async function pressKey(driver, args) {
@@ -3866,8 +4467,10 @@ async function uploadFile(driver, args) {
3866
4467
  throw new SharedToolError("upload_file requires { files } as a non-empty path or array of paths");
3867
4468
  }
3868
4469
  return withPage2(driver, args.target, async (page) => {
3869
- await page.setFiles(locatorOf(args), files);
3870
- return { uploaded: files };
4470
+ const loc = locatorOf(args);
4471
+ const element = await describeElement(page, loc);
4472
+ await page.setFiles(loc, files);
4473
+ return { uploaded: files, ...elementField(element) };
3871
4474
  });
3872
4475
  }
3873
4476
  function stamp() {
@@ -3881,7 +4484,7 @@ function resolveScreenshotScale(scale, capabilities) {
3881
4484
  throw new SharedToolError(`take_screenshot: 'scale' must be a finite number greater than 0 and at most ${MAX_SCREENSHOT_SCALE} (default 1)`);
3882
4485
  }
3883
4486
  if (scale !== 1 && !capabilities.has("screenshot.scale")) {
3884
- throw new SharedToolError("take_screenshot: 'scale' is not supported by this backend (WebDriver BiDi's browsingContext.captureScreenshot has no scale parameter). " + `Call emulate with deviceScaleFactor:${scale} first and capture at scale 1, or use --browser chrome for a per-capture scale.`);
4487
+ throw new SharedToolError("take_screenshot: 'scale' is not supported by this backend (no per-capture scale primitive). " + `Call emulate with deviceScaleFactor:${scale} first and capture at scale 1, or use --browser chrome for a per-capture scale.`);
3885
4488
  }
3886
4489
  return scale;
3887
4490
  }
@@ -3981,7 +4584,7 @@ async function takeScreenshot(driver, args = {}) {
3981
4584
  return withPage2(driver, args.target, async (page) => {
3982
4585
  const clip = args.uid !== undefined || args.selector ? locatorOf(args) : undefined;
3983
4586
  const ext = format === "jpeg" ? "jpg" : "png";
3984
- const path = args.savePath ?? join4(ARTIFACT_DIR, `screenshot-${page.info.id.slice(0, 8)}-${stamp()}.${ext}`);
4587
+ const path = args.savePath ?? join5(ARTIFACT_DIR, `screenshot-${page.info.id.slice(0, 8)}-${stamp()}.${ext}`);
3985
4588
  const stitch = async (banded) => {
3986
4589
  if (format !== "png")
3987
4590
  throw tiledCaptureRefusal("format", banded);
@@ -4206,7 +4809,7 @@ var LEASE_TOOLS = {
4206
4809
 
4207
4810
  // src/tools/console.ts
4208
4811
  init_client();
4209
- import { readFile as readFile4 } from "node:fs/promises";
4812
+ import { readFile as readFile5 } from "node:fs/promises";
4210
4813
 
4211
4814
  // src/tools/recorder.ts
4212
4815
  init_client();
@@ -4409,7 +5012,7 @@ function lineToEntry(line, index) {
4409
5012
  async function readConsoleEntries(file) {
4410
5013
  let raw;
4411
5014
  try {
4412
- raw = await readFile4(file, "utf8");
5015
+ raw = await readFile5(file, "utf8");
4413
5016
  } catch {
4414
5017
  return [];
4415
5018
  }
@@ -4467,7 +5070,7 @@ async function getConsoleMessage(args = {}) {
4467
5070
 
4468
5071
  // src/tools/network.ts
4469
5072
  init_client();
4470
- import { readFile as readFile5 } from "node:fs/promises";
5073
+ import { readFile as readFile6 } from "node:fs/promises";
4471
5074
  var DEFAULT_CAPTURE_MS2 = 2500;
4472
5075
  function asHeaders(v) {
4473
5076
  if (!v || typeof v !== "object")
@@ -4534,7 +5137,7 @@ function correlate(lines) {
4534
5137
  async function readNetworkRequests(file) {
4535
5138
  let raw;
4536
5139
  try {
4537
- raw = await readFile5(file, "utf8");
5140
+ raw = await readFile6(file, "utf8");
4538
5141
  } catch {
4539
5142
  return [];
4540
5143
  }
@@ -4619,8 +5222,8 @@ async function getNetworkRequest(args = {}) {
4619
5222
 
4620
5223
  // src/tools/performance.ts
4621
5224
  init_client();
4622
- import { mkdir as mkdir7, readFile as readFile6, writeFile as writeFile6, stat, unlink as unlink4 } from "node:fs/promises";
4623
- import { join as join5 } from "node:path";
5225
+ import { mkdir as mkdir7, readFile as readFile7, writeFile as writeFile6, stat, unlink as unlink4 } from "node:fs/promises";
5226
+ import { join as join6 } from "node:path";
4624
5227
  var ARTIFACT_DIR2 = process.env.CDP_ARTIFACT_DIR ?? "/tmp/cdp-toolkit";
4625
5228
  var STATE_DIR2 = process.env.CDP_STATE_DIR ?? "/tmp/cdp-toolkit";
4626
5229
  var DEFAULT_CATEGORIES = [
@@ -4638,7 +5241,7 @@ function shortId(id) {
4638
5241
  return id.slice(0, 8);
4639
5242
  }
4640
5243
  function stateFilePath() {
4641
- return join5(STATE_DIR2, "trace-state.json");
5244
+ return join6(STATE_DIR2, "trace-state.json");
4642
5245
  }
4643
5246
  function bufferTraceData(conn, sink) {
4644
5247
  return conn.on("Tracing.dataCollected", (params) => {
@@ -4661,7 +5264,7 @@ async function endTrace(conn, sink, timeoutMs = 30000) {
4661
5264
  }
4662
5265
  async function writeTrace(events, targetId) {
4663
5266
  await mkdir7(ARTIFACT_DIR2, { recursive: true });
4664
- const path = join5(ARTIFACT_DIR2, `trace-${shortId(targetId)}-${stamp2()}.json`);
5267
+ const path = join6(ARTIFACT_DIR2, `trace-${shortId(targetId)}-${stamp2()}.json`);
4665
5268
  const body = JSON.stringify({ traceEvents: events, metadata: { source: "cdp-toolkit" } });
4666
5269
  await writeFile6(path, body, "utf8");
4667
5270
  const { size } = await stat(path);
@@ -4704,7 +5307,7 @@ async function performanceStopTrace(args = {}) {
4704
5307
  if (!entry) {
4705
5308
  let hint = "";
4706
5309
  try {
4707
- const raw = await readFile6(stateFilePath(), "utf8");
5310
+ const raw = await readFile7(stateFilePath(), "utf8");
4708
5311
  const state = JSON.parse(raw);
4709
5312
  hint = state.pid === process.pid ? ` (state file lists target ${shortId(state.targetId)} but its live connection is gone)` : ` (trace was started by a DIFFERENT process pid=${state.pid}; live recordings cannot cross process boundaries)`;
4710
5313
  } catch {}
@@ -4834,7 +5437,7 @@ async function performanceAnalyzeInsight(args = {}) {
4834
5437
  }
4835
5438
  let raw;
4836
5439
  try {
4837
- raw = await readFile6(args.tracePath, "utf8");
5440
+ raw = await readFile7(args.tracePath, "utf8");
4838
5441
  } catch (err) {
4839
5442
  throw new CdpError(`cannot read trace file '${args.tracePath}': ${err.message}`);
4840
5443
  }
@@ -4854,7 +5457,7 @@ async function performanceAnalyzeInsight(args = {}) {
4854
5457
  init_client();
4855
5458
  import { spawn } from "node:child_process";
4856
5459
  import { mkdir as mkdir8, rm as rm2, stat as stat2, writeFile as writeFile7 } from "node:fs/promises";
4857
- import { join as join6 } from "node:path";
5460
+ import { join as join7 } from "node:path";
4858
5461
  var ARTIFACT_DIR3 = process.env.CDP_ARTIFACT_DIR ?? "/tmp/cdp-toolkit";
4859
5462
  var FFMPEG_BIN = process.env.CDP_FFMPEG ?? "ffmpeg";
4860
5463
  function frameDurationsMs(ledger, stopWallclockMs) {
@@ -4970,6 +5573,22 @@ function selectEncoder(encodersOutput) {
4970
5573
  }
4971
5574
  throw new CdpError(`ffmpeg reports none of the supported video encoders (${ENCODER_LADDER.map((c) => c.encoder).join(", ")}). ` + "Install a full ffmpeg build: 'brew install ffmpeg' (macOS) or 'apt install ffmpeg' (Debian/Ubuntu).");
4972
5575
  }
5576
+ function supportsFpsMode(versionOutput) {
5577
+ const m = /ffmpeg version n?(\d+)\.(\d+)/.exec(versionOutput);
5578
+ if (!m)
5579
+ return /ffmpeg version N-/.test(versionOutput) ? true : undefined;
5580
+ const major = Number(m[1]);
5581
+ const minor = Number(m[2]);
5582
+ return major > 5 || major === 5 && minor >= 1;
5583
+ }
5584
+ function chooseFpsMode(versionOutput, helpOutput) {
5585
+ const byVersion = versionOutput === undefined ? undefined : supportsFpsMode(versionOutput);
5586
+ if (byVersion !== undefined)
5587
+ return byVersion;
5588
+ if (helpOutput !== undefined && /-vsync\b|-fps_mode\b/.test(helpOutput))
5589
+ return /-fps_mode\b/.test(helpOutput);
5590
+ return true;
5591
+ }
4973
5592
  function buildFfmpegArgs(manifestPath, outPath, choice) {
4974
5593
  return [
4975
5594
  "-hide_banner",
@@ -4982,8 +5601,7 @@ function buildFfmpegArgs(manifestPath, outPath, choice) {
4982
5601
  "0",
4983
5602
  "-i",
4984
5603
  manifestPath,
4985
- "-vsync",
4986
- "vfr",
5604
+ ...choice.fpsMode ? ["-fps_mode", "vfr"] : ["-vsync", "vfr"],
4987
5605
  "-vf",
4988
5606
  "scale=trunc(iw/2)*2:trunc(ih/2)*2",
4989
5607
  "-c:v",
@@ -5025,8 +5643,19 @@ async function probeEncoder() {
5025
5643
  }
5026
5644
  if (res.code !== 0)
5027
5645
  throw new CdpError(`${FFMPEG_MISSING} ('-encoders' exited ${res.code}: ${res.stderr.trim().slice(0, 300)})`);
5028
- return selectEncoder(`${res.stdout}
5646
+ const choice = selectEncoder(`${res.stdout}
5029
5647
  ${res.stderr}`);
5648
+ const output = async (args) => {
5649
+ const r = await run(FFMPEG_BIN, args).catch(() => {
5650
+ return;
5651
+ });
5652
+ return r && r.code === 0 ? `${r.stdout}
5653
+ ${r.stderr}` : undefined;
5654
+ };
5655
+ const version = await output(["-version"]);
5656
+ const byVersion = version === undefined ? undefined : supportsFpsMode(version);
5657
+ const help = byVersion === undefined ? await output(["-hide_banner", "-h", "full"]) : undefined;
5658
+ return { ...choice, fpsMode: chooseFpsMode(version, help) };
5030
5659
  })();
5031
5660
  encoderProbe.catch(() => {
5032
5661
  encoderProbe = undefined;
@@ -5075,7 +5704,7 @@ async function startScreenRecording(args = {}) {
5075
5704
  conn.close();
5076
5705
  throw err;
5077
5706
  }
5078
- const spoolDir = join6(ARTIFACT_DIR3, `screencast-${shortId2(target.id)}-${stamp3()}`);
5707
+ const spoolDir = join7(ARTIFACT_DIR3, `screencast-${shortId2(target.id)}-${stamp3()}`);
5079
5708
  try {
5080
5709
  await mkdir8(spoolDir, { recursive: true });
5081
5710
  } catch (err) {
@@ -5118,7 +5747,7 @@ async function startScreenRecording(args = {}) {
5118
5747
  seq += 1;
5119
5748
  const file = `frame-${String(seq).padStart(6, "0")}.${ext}`;
5120
5749
  rec.ledger.push({ file, timestamp, width: size.width, height: size.height });
5121
- rec.writes = rec.writes.then(() => writeFile7(join6(spoolDir, file), buf)).catch(() => {
5750
+ rec.writes = rec.writes.then(() => writeFile7(join7(spoolDir, file), buf)).catch(() => {
5122
5751
  rec.dropped += 1;
5123
5752
  rec.unwritten.add(file);
5124
5753
  });
@@ -5182,9 +5811,9 @@ async function stopScreenRecording(args = {}) {
5182
5811
  throw new CdpError(`screen recording captured 0 frames for target ${shortId2(rec.target.id)}. Chrome emits a screencast frame only on repaint: a fully backgrounded or occluded tab may never paint. Retry with bringToFront:true, or drive the page while recording.`);
5183
5812
  }
5184
5813
  await mkdir8(ARTIFACT_DIR3, { recursive: true });
5185
- const outPath = args.savePath ?? join6(ARTIFACT_DIR3, `screen-recording-${shortId2(rec.target.id)}-${stamp3()}.mp4`);
5814
+ const outPath = args.savePath ?? join7(ARTIFACT_DIR3, `screen-recording-${shortId2(rec.target.id)}-${stamp3()}.mp4`);
5186
5815
  const frames = coalesceToConcatGrid(ledger, stoppedAt);
5187
- const manifestPath = join6(rec.spoolDir, "frames.ffconcat");
5816
+ const manifestPath = join7(rec.spoolDir, "frames.ffconcat");
5188
5817
  await writeFile7(manifestPath, buildConcatManifest(frames), "utf8");
5189
5818
  const durationMs = frames.reduce((total, f) => total + f.durationMs, 0);
5190
5819
  const { width, height } = evenDimensions(ledger[0].width, ledger[0].height);
@@ -5218,7 +5847,7 @@ ffmpeg said: ${res.stderr.trim().slice(0, 800)}`);
5218
5847
  // src/tools/heap.ts
5219
5848
  init_client();
5220
5849
  import { mkdir as mkdir9, writeFile as writeFile8 } from "node:fs/promises";
5221
- import { join as join7 } from "node:path";
5850
+ import { join as join8 } from "node:path";
5222
5851
  var ARTIFACT_DIR4 = process.env.CDP_ARTIFACT_DIR ?? "/tmp/cdp-toolkit";
5223
5852
  function stamp4(targetId) {
5224
5853
  const short = targetId.slice(0, 8);
@@ -5244,7 +5873,7 @@ async function takeHeapsnapshot(args = {}) {
5244
5873
  throw new Error("HeapProfiler.takeHeapSnapshot produced no chunks");
5245
5874
  }
5246
5875
  await mkdir9(ARTIFACT_DIR4, { recursive: true });
5247
- const path = args.savePath ? args.savePath.startsWith("/") ? args.savePath : join7(ARTIFACT_DIR4, args.savePath) : join7(ARTIFACT_DIR4, `take_heapsnapshot-${stamp4(target.id)}.heapsnapshot`);
5876
+ const path = args.savePath ? args.savePath.startsWith("/") ? args.savePath : join8(ARTIFACT_DIR4, args.savePath) : join8(ARTIFACT_DIR4, `take_heapsnapshot-${stamp4(target.id)}.heapsnapshot`);
5248
5877
  await writeFile8(path, snapshot, "utf8");
5249
5878
  const bytes = Buffer.byteLength(snapshot, "utf8");
5250
5879
  return {
@@ -5260,7 +5889,7 @@ async function takeHeapsnapshot(args = {}) {
5260
5889
  init_client();
5261
5890
  init_endpoints();
5262
5891
  import { spawn as spawn2 } from "node:child_process";
5263
- import { mkdir as mkdir10, readFile as readFile7, stat as stat3 } from "node:fs/promises";
5892
+ import { mkdir as mkdir10, readFile as readFile8, stat as stat3 } from "node:fs/promises";
5264
5893
  var ARTIFACT_DIR5 = process.env.CDP_ARTIFACT_DIR ?? "/tmp/cdp-toolkit";
5265
5894
  function cdpPort() {
5266
5895
  const base = currentEndpoint().base;
@@ -5350,7 +5979,7 @@ async function lighthouseAudit(args) {
5350
5979
  }
5351
5980
  let raw;
5352
5981
  try {
5353
- raw = await readFile7(outPath, "utf8");
5982
+ raw = await readFile8(outPath, "utf8");
5354
5983
  } catch {
5355
5984
  raw = undefined;
5356
5985
  }
@@ -5540,15 +6169,15 @@ async function clickFocusGated(args) {
5540
6169
  // src/tools/downloads.ts
5541
6170
  init_client();
5542
6171
  import { readdir as readdir3, rename as rename2, stat as stat4 } from "node:fs/promises";
5543
- import { basename, extname, join as join9 } from "node:path";
6172
+ import { basename, extname, join as join10 } from "node:path";
5544
6173
 
5545
6174
  // src/tools/browser-session.ts
5546
6175
  init_client();
5547
6176
  init_endpoints();
5548
6177
  import { mkdir as mkdir11 } from "node:fs/promises";
5549
- import { join as join8 } from "node:path";
6178
+ import { join as join9 } from "node:path";
5550
6179
  var ARTIFACT_DIR6 = process.env.CDP_ARTIFACT_DIR ?? "/tmp/cdp-toolkit";
5551
- var DOWNLOADS_DIR = join8(ARTIFACT_DIR6, "downloads");
6180
+ var DOWNLOADS_DIR = join9(ARTIFACT_DIR6, "downloads");
5552
6181
  var DOWNLOAD_BUFFER_LIMIT = 50;
5553
6182
  var sessions2 = new Map;
5554
6183
  function sessionKey() {
@@ -5715,7 +6344,7 @@ async function waitForDownload(args = {}) {
5715
6344
  const taken = new Set(await readdir3(DOWNLOADS_DIR).catch(() => []));
5716
6345
  taken.delete(basename(rec.filePath));
5717
6346
  const finalName = nextFreeName(suggestedFilename, taken);
5718
- const path = join9(DOWNLOADS_DIR, finalName);
6347
+ const path = join10(DOWNLOADS_DIR, finalName);
5719
6348
  await rename2(rec.filePath, path);
5720
6349
  const bytes = (await stat4(path)).size;
5721
6350
  return { path, suggestedFilename, bytes, ...rec.url ? { url: rec.url } : {}, target };
@@ -5774,7 +6403,7 @@ async function grantPermissions(args = {}) {
5774
6403
  // src/tools/extract.ts
5775
6404
  init_client();
5776
6405
  import { mkdir as mkdir12, writeFile as writeFile9 } from "node:fs/promises";
5777
- import { dirname as dirname3, join as join10 } from "node:path";
6406
+ import { dirname as dirname3, join as join11 } from "node:path";
5778
6407
  var ARTIFACT_DIR7 = process.env.CDP_ARTIFACT_DIR ?? "/tmp/cdp-toolkit";
5779
6408
  var DEFAULT_BASE_URL = "http://127.0.0.1:8090/v1";
5780
6409
  var DEFAULT_MODEL = "schematron";
@@ -6175,7 +6804,7 @@ async function extractPage(driver, args) {
6175
6804
  };
6176
6805
  if (args.savePath === undefined || args.savePath === "")
6177
6806
  return result;
6178
- const path = args.savePath.startsWith("/") ? args.savePath : join10(ARTIFACT_DIR7, args.savePath);
6807
+ const path = args.savePath.startsWith("/") ? args.savePath : join11(ARTIFACT_DIR7, args.savePath);
6179
6808
  await mkdir12(dirname3(path), { recursive: true });
6180
6809
  const json = JSON.stringify(result, null, 2);
6181
6810
  await writeFile9(path, json, "utf8");