@deeeed/metamask-harness 0.78.0 → 0.80.0

package/adapters/extension/lib/slot-title.cjs

@@ -1,292 +0,0 @@
-'use strict';
-
-/**
- * Operator slot title for headed extension Chrome.
- *
- * Chrome's window label is the active tab's document.title. Farmslot stamps
- * home.html to "<slot-id> — MetaMask" so operators can tell which slot owns a
- * window when several farms run side by side.
- *
- * Stamping is best-effort: missing slot context or an uninspectable tab must
- * never fail launch/readiness. A MutationObserver keeps the prefix across
- * MetaMask SPA title resets.
- */
-
-const fs = require('node:fs');
-const http = require('node:http');
-const path = require('node:path');
-
-function sanitizeSlotId(value) {
-  const slotId = typeof value === 'string' ? value.trim() : '';
-  return /^[A-Za-z0-9._:-]{1,64}$/u.test(slotId) ? slotId : '';
-}
-
-function readSlotId(target, runtimeDir) {
-  for (const key of ['RECIPE_SLOT_ID', 'SLOT_ID', 'FARMSLOT_SLOT_ID']) {
-    const value = sanitizeSlotId(process.env[key]);
-    if (value) return value;
-  }
-  if (!target || !runtimeDir) return '';
-  try {
-    const runtimeContext = JSON.parse(
-      fs.readFileSync(path.join(target, runtimeDir, 'agentic-runtime.json'), 'utf8'),
-    );
-    return sanitizeSlotId(runtimeContext.slotId);
-  } catch {
-    // Standalone harness users do not need a custom browser title.
-    return '';
-  }
-}
-
-/**
- * Serialized page-evaluation callback. Must stay a plain function (no closure).
- */
-function applyPersistentSlotTitle(slot) {
-  // Inline sanitize because the serialized function cannot call Node helpers.
-  const id =
-    typeof slot === 'string' && /^[A-Za-z0-9._:-]{1,64}$/u.test(slot.trim())
-      ? slot.trim()
-      : '';
-  if (!id) return document.title;
-  window.__farmslotSlotId = id;
-
-  const stripSlotPrefixes = (title) => {
-    let base = String(title || 'MetaMask');
-    // Accept em dash, en dash, or hyphen — historical stampers mixed them.
-    for (let i = 0; i < 32; i += 1) {
-      const stripped = base.replace(/^.+?\s+[—–-]\s+/u, '');
-      if (stripped === base) break;
-      base = stripped;
-    }
-    return base || 'MetaMask';
-  };
-
-  const desiredTitle = () => {
-    const id = window.__farmslotSlotId;
-    if (!id) return document.title;
-    return `${id} — ${stripSlotPrefixes(document.title)}`;
-  };
-
-  const setTitle = () => {
-    if (window.__farmslotSlotTitleLock) {
-      window.__farmslotSlotTitlePending = true;
-      return;
-    }
-    const next = desiredTitle();
-    if (document.title === next) return;
-    window.__farmslotSlotTitleLock = true;
-    try {
-      document.title = next;
-    } finally {
-      // Release after the title mutation is delivered so the observer cannot
-      // re-enter and stack prefixes while React also mutates the DOM. If a
-      // mutation arrived while locked, re-apply once after unlock.
-      queueMicrotask(() => {
-        window.__farmslotSlotTitleLock = false;
-        if (window.__farmslotSlotTitlePending) {
-          window.__farmslotSlotTitlePending = false;
-          setTitle();
-        }
-      });
-    }
-  };
-
-  setTitle();
-  if (!window.__farmslotSlotTitleObserver) {
-    let node = document.querySelector('title');
-    if (!node) {
-      node = document.createElement('title');
-      (document.head || document.documentElement).appendChild(node);
-    }
-    window.__farmslotSlotTitleObserver = new MutationObserver(setTitle);
-    // Observe only the <title> element — watching head/documentElement with
-    // subtree:true re-fires on every React DOM mutation and can livelock CDP.
-    window.__farmslotSlotTitleObserver.observe(node, {
-      childList: true,
-      characterData: true,
-      subtree: true,
-    });
-  }
-  return document.title;
-}
-
-function buildStampExpression(slotId) {
-  const slot = sanitizeSlotId(slotId);
-  if (!slot) return 'document.title';
-  // Single source of truth: serialize the Playwright callback for CDP evaluate.
-  return `(${applyPersistentSlotTitle.toString()})(${JSON.stringify(slot)})`;
-}
-
-function assertLocalUrl(url) {
-  if (!/^http:\/\/127\.0\.0\.1:\d+\//u.test(url)) {
-    throw new Error(`slot-title: refusing non-local URL: ${url}`);
-  }
-}
-
-function assertLocalWebSocketUrl(url) {
-  if (!/^ws:\/\/(?:127\.0\.0\.1|localhost):\d+\//u.test(String(url))) {
-    throw new Error(`slot-title: refusing non-local websocket URL: ${url}`);
-  }
-}
-
-function httpJson(url, timeoutMs = 3000) {
-  assertLocalUrl(url);
-  return new Promise((resolve, reject) => {
-    const req = http.get(url, (res) => {
-      let data = '';
-      res.setEncoding('utf8');
-      res.on('data', (chunk) => {
-        data += chunk;
-      });
-      res.on('end', () => {
-        try {
-          resolve(JSON.parse(data));
-        } catch (err) {
-          reject(new Error(`invalid JSON from ${url}: ${err.message}`));
-        }
-      });
-    });
-    req.setTimeout(timeoutMs, () => {
-      req.destroy(new Error(`timeout from ${url}`));
-    });
-    req.on('error', reject);
-  });
-}
-
-function resolveWebSocket(target) {
-  try {
-    // Prefer the target checkout's ws, then the harness install.
-    const { createRequire } = require('node:module');
-    const req = createRequire(__filename);
-    if (target) {
-      try {
-        return req(req.resolve('ws', { paths: [target] }));
-      } catch {
-        // Fall through to harness / global.
-      }
-    }
-    return req('ws');
-  } catch {
-    return typeof WebSocket === 'function' ? WebSocket : null;
-  }
-}
-
-async function cdpEvaluate(target, webSocketDebuggerUrl, expression, timeoutMs = 5000) {
-  assertLocalWebSocketUrl(webSocketDebuggerUrl);
-  const WebSocketImpl = resolveWebSocket(target);
-  if (!WebSocketImpl) return { skipped: true, reason: 'WebSocket unavailable' };
-  return new Promise((resolve, reject) => {
-    const ws = new WebSocketImpl(webSocketDebuggerUrl);
-    const timer = setTimeout(() => {
-      try {
-        ws.close();
-      } catch {
-        // Best-effort timeout cleanup.
-      }
-      reject(new Error('timeout evaluating extension page via CDP'));
-    }, timeoutMs);
-    const onOpen = () => {
-      ws.send(
-        JSON.stringify({
-          id: 1,
-          method: 'Runtime.evaluate',
-          params: { expression, awaitPromise: true, returnByValue: true },
-        }),
-      );
-    };
-    const onMessage = (event) => {
-      const raw = event?.data ?? event;
-      const msg = JSON.parse(Buffer.isBuffer(raw) ? raw.toString('utf8') : String(raw));
-      if (msg.id !== 1) return;
-      clearTimeout(timer);
-      ws.close();
-      if (msg.error) {
-        reject(new Error(msg.error.message || JSON.stringify(msg.error)));
-        return;
-      }
-      resolve(msg.result?.result?.value ?? null);
-    };
-    const onError = (err) => {
-      clearTimeout(timer);
-      reject(new Error(`CDP websocket error while stamping slot title: ${err?.message || err || 'unknown'}`));
-    };
-    if (typeof ws.on === 'function') {
-      ws.on('open', onOpen);
-      ws.on('message', onMessage);
-      ws.on('error', onError);
-    } else {
-      ws.addEventListener('open', onOpen);
-      ws.addEventListener('message', onMessage);
-      ws.addEventListener('error', onError);
-    }
-  });
-}
-
-function isHomePage(target, extensionId) {
-  if (!target || target.type !== 'page' || typeof target.url !== 'string') return false;
-  if (!target.url.startsWith(`chrome-extension://${extensionId}/`)) return false;
-  return target.url.includes('/home.html');
-}
-
-/**
- * Stamp every inspectable home.html tab for this extension over CDP.
- * Attached tabs (no webSocketDebuggerUrl) are skipped — another client owns them.
- */
-async function stampHomeTabsViaCdp(options) {
-  const {
-    target = process.cwd(),
-    cdpPort,
-    extensionId,
-    slotId: slotIdOption,
-    runtimeDir,
-  } = options || {};
-  const slotId = sanitizeSlotId(slotIdOption) || readSlotId(target, runtimeDir);
-  const empty = { slotId: slotId || '', stamped: 0, skipped: 0, titles: [] };
-  if (!slotId || !cdpPort || !extensionId) return empty;
-
-  let targets;
-  try {
-    targets = await httpJson(`http://127.0.0.1:${cdpPort}/json/list`);
-  } catch {
-    return empty;
-  }
-  if (!Array.isArray(targets)) return empty;
-
-  const homes = targets.filter((t) => isHomePage(t, extensionId));
-  const titles = [];
-  let stamped = 0;
-  let skipped = 0;
-  const expression = buildStampExpression(slotId);
-
-  for (const home of homes) {
-    if (typeof home.webSocketDebuggerUrl !== 'string') {
-      skipped += 1;
-      continue;
-    }
-    try {
-      const title = await cdpEvaluate(target, home.webSocketDebuggerUrl, expression);
-      if (title && typeof title === 'object' && title.skipped) {
-        skipped += 1;
-        continue;
-      }
-      if (typeof title === 'string') {
-        titles.push(title);
-        stamped += 1;
-      } else {
-        skipped += 1;
-      }
-    } catch {
-      skipped += 1;
-    }
-  }
-
-  return { slotId, stamped, skipped, titles };
-}
-
-module.exports = {
-  sanitizeSlotId,
-  readSlotId,
-  applyPersistentSlotTitle,
-  buildStampExpression,
-  stampHomeTabsViaCdp,
-};