@web-auto/camo 0.1.3 → 0.1.4

package/src/utils/browser-service.mjs

@@ -26,7 +26,230 @@ export async function callAPI(action, payload = {}) {
 
 export async function getSessionByProfile(profileId) {
   const status = await callAPI('getStatus', {});
-  return status?.sessions?.find((s) => s.profileId === profileId) || null;
+  const activeSession = status?.sessions?.find((s) => s.profileId === profileId) || null;
+  if (activeSession) {
+    return activeSession;
+  }
+  if (!profileId) {
+    return null;
+  }
+
+  // Some browser-service builds do not populate getStatus.sessions reliably.
+  // Fallback to page:list so runtime can still attach to an active profile tab set.
+  try {
+    const pagePayload = await callAPI('page:list', { profileId });
+    const pages = Array.isArray(pagePayload?.pages)
+      ? pagePayload.pages
+      : Array.isArray(pagePayload?.data?.pages)
+        ? pagePayload.data.pages
+        : [];
+    if (!pages.length) return null;
+    const activeIndex = Number(pagePayload?.activeIndex ?? pagePayload?.data?.activeIndex);
+    const activePage = Number.isFinite(activeIndex)
+      ? pages.find((page) => Number(page?.index) === activeIndex)
+      : (pages.find((page) => page?.active) || pages[0]);
+    return {
+      profileId,
+      session_id: profileId,
+      sessionId: profileId,
+      current_url: activePage?.url || null,
+      recoveredFromPages: true,
+    };
+  } catch {
+    return null;
+  }
+}
+
+function buildDomSnapshotScript(maxDepth, maxChildren) {
+  return `(() => {
+    const MAX_DEPTH = ${maxDepth};
+    const MAX_CHILDREN = ${maxChildren};
+    const viewportWidth = Number(window.innerWidth || 0);
+    const viewportHeight = Number(window.innerHeight || 0);
+
+    const normalizeRect = (rect) => {
+      if (!rect) return null;
+      const left = Number(rect.left ?? rect.x ?? 0);
+      const top = Number(rect.top ?? rect.y ?? 0);
+      const width = Number(rect.width ?? 0);
+      const height = Number(rect.height ?? 0);
+      return {
+        left,
+        top,
+        right: left + width,
+        bottom: top + height,
+        x: left,
+        y: top,
+        width,
+        height,
+      };
+    };
+
+    const sanitizeClasses = (el) => {
+      const classAttr = typeof el.className === 'string'
+        ? el.className
+        : (el.getAttribute && el.getAttribute('class')) || '';
+      return classAttr.split(/\\s+/).filter(Boolean).slice(0, 24);
+    };
+
+    const collectAttrs = (el) => {
+      if (!el || !el.getAttribute) return null;
+      const keys = [
+        'href',
+        'src',
+        'name',
+        'type',
+        'value',
+        'placeholder',
+        'role',
+        'aria-label',
+        'aria-hidden',
+        'title',
+      ];
+      const attrs = {};
+      for (const key of keys) {
+        const value = el.getAttribute(key);
+        if (value === null || value === undefined || value === '') continue;
+        attrs[key] = String(value).slice(0, 400);
+      }
+      return Object.keys(attrs).length > 0 ? attrs : null;
+    };
+
+    const inViewport = (rect) => {
+      if (!rect) return false;
+      if (rect.width <= 0 || rect.height <= 0) return false;
+      return (
+        rect.right > 0
+        && rect.bottom > 0
+        && rect.left < viewportWidth
+        && rect.top < viewportHeight
+      );
+    };
+
+    const isRendered = (el) => {
+      try {
+        const style = window.getComputedStyle(el);
+        if (!style) return false;
+        if (style.display === 'none') return false;
+        if (style.visibility === 'hidden' || style.visibility === 'collapse') return false;
+        const opacity = Number.parseFloat(String(style.opacity || '1'));
+        if (Number.isFinite(opacity) && opacity <= 0.01) return false;
+        return true;
+      } catch {
+        return false;
+      }
+    };
+
+    const clampPoint = (value, max) => {
+      if (!Number.isFinite(value)) return 0;
+      if (max <= 1) return 0;
+      return Math.max(0, Math.min(max - 1, value));
+    };
+
+    const hitTestVisible = (el, rect) => {
+      if (!rect || viewportWidth <= 0 || viewportHeight <= 0) return false;
+      const samplePoints = [
+        [rect.left + rect.width * 0.5, rect.top + rect.height * 0.5],
+        [rect.left + rect.width * 0.2, rect.top + rect.height * 0.2],
+        [rect.left + rect.width * 0.8, rect.top + rect.height * 0.8],
+      ];
+      for (const [rawX, rawY] of samplePoints) {
+        const x = clampPoint(rawX, viewportWidth);
+        const y = clampPoint(rawY, viewportHeight);
+        const topEl = document.elementFromPoint(x, y);
+        if (!topEl) continue;
+        if (topEl === el) return true;
+        if (el.contains && el.contains(topEl)) return true;
+        if (topEl.contains && topEl.contains(el)) return true;
+      }
+      return false;
+    };
+
+    const collect = (el, depth = 0, path = 'root') => {
+      if (!el || depth > MAX_DEPTH) return null;
+      const classes = sanitizeClasses(el);
+      const rect = normalizeRect(el.getBoundingClientRect ? el.getBoundingClientRect() : null);
+      const tag = String(el.tagName || el.nodeName || '').toLowerCase();
+      const id = el.id || null;
+      const text = typeof el.textContent === 'string'
+        ? el.textContent.replace(/\\s+/g, ' ').trim()
+        : '';
+      const selector = tag
+        ? \`\${tag}\${id ? '#' + id : ''}\${classes.length ? '.' + classes.slice(0, 3).join('.') : ''}\`
+        : null;
+
+      const node = {
+        tag,
+        id,
+        classes,
+        selector,
+        path,
+      };
+      const attrs = collectAttrs(el);
+      if (attrs) node.attrs = attrs;
+      if (attrs && attrs.href) node.href = attrs.href;
+      if (rect) node.rect = rect;
+      if (text) node.textSnippet = text.slice(0, 120);
+      if (rect) {
+        const rendered = isRendered(el);
+        const withinViewport = inViewport(rect);
+        const visible = rendered && withinViewport && hitTestVisible(el, rect);
+        node.visible = visible;
+      } else {
+        node.visible = false;
+      }
+
+      const children = Array.from(el.children || []);
+      if (children.length > 0 && depth < MAX_DEPTH) {
+        node.children = [];
+        const limit = Math.min(children.length, MAX_CHILDREN);
+        for (let i = 0; i < limit; i += 1) {
+          const child = collect(children[i], depth + 1, \`\${path}/\${i}\`);
+          if (child) node.children.push(child);
+        }
+      }
+
+      return node;
+    };
+
+    const root = collect(document.body || document.documentElement, 0, 'root');
+    return {
+      dom_tree: root,
+      viewport: {
+        width: viewportWidth,
+        height: viewportHeight,
+      },
+    };
+  })()`;
+}
+
+export async function getDomSnapshotByProfile(profileId, options = {}) {
+  const maxDepth = Math.max(1, Math.min(20, Number(options.maxDepth) || 10));
+  const maxChildren = Math.max(1, Math.min(500, Number(options.maxChildren) || 120));
+  const response = await callAPI('evaluate', {
+    profileId,
+    script: buildDomSnapshotScript(maxDepth, maxChildren),
+  });
+  const payload = response?.result || response || {};
+  const tree = payload.dom_tree || null;
+  if (tree && payload.viewport && typeof payload.viewport === 'object') {
+    tree.__viewport = {
+      width: Number(payload.viewport.width) || 0,
+      height: Number(payload.viewport.height) || 0,
+    };
+  }
+  return tree;
+}
+
+export async function getViewportByProfile(profileId) {
+  const response = await callAPI('evaluate', {
+    profileId,
+    script: `(() => ({ width: Number(window.innerWidth || 0), height: Number(window.innerHeight || 0) }))()`,
+  });
+  const viewport = response?.result || response?.viewport || {};
+  const width = Number(viewport?.width) || 1280;
+  const height = Number(viewport?.height) || 720;
+  return { width, height };
 }
 
 export async function checkBrowserService() {
@@ -89,15 +312,15 @@ function scanCommonRepoRoots() {
   const roots = [
     path.join(home, 'Documents', 'github'),
     path.join(home, 'github'),
-  path.join(home, 'code'),
+    path.join(home, 'code'),
     path.join(home, 'projects'),
-  path.join('/Volumes', 'extension', 'code'),
-  path.join('C:', 'code'),
-  path.join('D:', 'code'),
-  path.join('C:', 'projects'),
-  path.join('D:', 'projects'),
-  path.join('C:', 'Users', os.userInfo().username, 'code'),
-  path.join('C:', 'Users', os.userInfo().username, 'projects'),
+    path.join('/Volumes', 'extension', 'code'),
+    path.join('C:', 'code'),
+    path.join('D:', 'code'),
+    path.join('C:', 'projects'),
+    path.join('D:', 'projects'),
+    path.join('C:', 'Users', os.userInfo().username, 'code'),
+    path.join('C:', 'Users', os.userInfo().username, 'projects'),
     path.join('C:', 'Users', os.userInfo().username, 'Documents', 'github'),
   ].filter(Boolean);
 

package/src/utils/help.mjs

@@ -115,13 +115,36 @@ EXAMPLES:
   camo stop
 
 CONTAINER FILTER & SUBSCRIPTION:
-  container filter <selector> [--profile <id>]      Filter DOM elements by CSS selector
-  container watch --selector <css>                  Watch for element changes
-  container list                                    List visible elements in viewport
+  container init [--source <dir>] [--force]         Initialize subscription dir + migrate container sets
+  container sets [--site <siteKey>]                 List migrated subscription sets
+  container register [profileId] <setId...>         Register targets (path / url+dom markers) for profile
+  container targets [profileId]                     Show registered subscription targets
+  container filter [profileId] <selector...>        Filter DOM elements by CSS selector
+  container watch [profileId] [--selector <css>]    Watch for element changes (or use registered selectors)
+  container list [profileId]                        List visible elements in viewport
+
+AUTOSCRIPT (STRATEGY LAYER):
+  autoscript scaffold xhs-unified [--output <file>]        Generate xiaohongshu unified-harvest autoscript template
+  autoscript validate <file>                        Validate autoscript schema and references
+  autoscript explain <file>                         Print normalized graph and defaults
+  autoscript snapshot <jsonl-file> [--out <snapshot-file>] Build resumable snapshot from run JSONL
+  autoscript replay <jsonl-file> [--summary-file <path>]   Rebuild summary from run JSONL
+  autoscript run <file> [--profile <id>] [--jsonl-file <path>] [--summary-file <path>]  Run autoscript runtime
+  autoscript resume <file> --snapshot <snapshot-file> [--from-node <nodeId>] [--profile <id>] [--jsonl-file <path>] [--summary-file <path>]
+  autoscript mock-run <file> --fixture <fixture.json> [--profile <id>] [--jsonl-file <path>] [--summary-file <path>]
+
+PROGRESS EVENTS:
+  events serve [--host 127.0.0.1] [--port 7788]    Start progress websocket server (/events)
+  events tail [filters...]                          Tail progress events via websocket
+  events recent [--limit 50]                        Show recent persisted events
+  events emit --event <name>                        Emit a manual test event
+  (non-events commands auto-start daemon by default)
 
 ENV:
   WEBAUTO_BROWSER_URL                       Default: http://127.0.0.1:7704
   WEBAUTO_REPO_ROOT                         Optional explicit webauto repo root
+  CAMO_PROGRESS_EVENTS_FILE                 Optional path override for progress jsonl
+  CAMO_PROGRESS_WS_HOST / CAMO_PROGRESS_WS_PORT   Progress daemon host/port (defaults: 127.0.0.1:7788)
 `);
 }