@web-auto/camo 0.1.3 → 0.1.5

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/config.mjs

@@ -6,6 +6,7 @@ import os from 'node:os';
 export const CONFIG_DIR = path.join(os.homedir(), '.webauto');
 export const PROFILES_DIR = path.join(CONFIG_DIR, 'profiles');
 export const CONFIG_FILE = path.join(CONFIG_DIR, 'camo-cli.json');
+export const PROFILE_META_FILE = 'camo-profile.json';
 export const BROWSER_SERVICE_URL = process.env.WEBAUTO_BROWSER_URL || 'http://127.0.0.1:7704';
 
 export function ensureDir(p) {
@@ -55,13 +56,13 @@ export function createProfile(profileId) {
   if (!isValidProfileId(profileId)) {
     throw new Error('Invalid profileId. Use only letters, numbers, dot, underscore, dash.');
   }
-  const profileDir = path.join(PROFILES_DIR, profileId);
+  const profileDir = getProfileDir(profileId);
   if (fs.existsSync(profileDir)) throw new Error(`Profile already exists: ${profileId}`);
   ensureDir(profileDir);
 }
 
 export function deleteProfile(profileId) {
-  const profileDir = path.join(PROFILES_DIR, profileId);
+  const profileDir = getProfileDir(profileId);
   if (!fs.existsSync(profileDir)) throw new Error(`Profile not found: ${profileId}`);
   fs.rmSync(profileDir, { recursive: true, force: true });
 }
@@ -82,6 +83,61 @@ export function getDefaultProfile() {
   return loadConfig().defaultProfile;
 }
 
+export function getProfileDir(profileId) {
+  return path.join(PROFILES_DIR, String(profileId || '').trim());
+}
+
+export function getProfileMetaFile(profileId) {
+  return path.join(getProfileDir(profileId), PROFILE_META_FILE);
+}
+
+function loadProfileMeta(profileId) {
+  if (!isValidProfileId(profileId)) return {};
+  return readJson(getProfileMetaFile(profileId)) || {};
+}
+
+function saveProfileMeta(profileId, patch) {
+  if (!isValidProfileId(profileId)) return null;
+  const profileDir = getProfileDir(profileId);
+  ensureDir(profileDir);
+  const current = loadProfileMeta(profileId);
+  const next = {
+    ...current,
+    ...patch,
+    updatedAt: Date.now(),
+  };
+  writeJson(getProfileMetaFile(profileId), next);
+  return next;
+}
+
+export function getProfileWindowSize(profileId) {
+  const meta = loadProfileMeta(profileId);
+  const width = Number(meta?.window?.width);
+  const height = Number(meta?.window?.height);
+  if (!Number.isFinite(width) || !Number.isFinite(height)) return null;
+  if (width < 320 || height < 240) return null;
+  return {
+    width: Math.floor(width),
+    height: Math.floor(height),
+    updatedAt: Number(meta?.window?.updatedAt) || Number(meta?.updatedAt) || null,
+  };
+}
+
+export function setProfileWindowSize(profileId, width, height) {
+  const parsedWidth = Number(width);
+  const parsedHeight = Number(height);
+  if (!Number.isFinite(parsedWidth) || !Number.isFinite(parsedHeight)) return null;
+  if (parsedWidth < 320 || parsedHeight < 240) return null;
+  const now = Date.now();
+  return saveProfileMeta(profileId, {
+    window: {
+      width: Math.floor(parsedWidth),
+      height: Math.floor(parsedHeight),
+      updatedAt: now,
+    },
+  });
+}
+
 const START_SCRIPT_REL = path.join('runtime', 'infra', 'utils', 'scripts', 'service', 'start-browser-service.mjs');
 
 export function hasStartScript(root) {

package/src/utils/help.mjs

@@ -24,7 +24,7 @@ CONFIG:
 
 BROWSER CONTROL:
   init                                      Ensure camoufox + ensure browser-service daemon
-  start [profileId] [--url <url>] [--headless]
+  start [profileId] [--url <url>] [--headless] [--width <w> --height <h>]
   stop [profileId]
   status [profileId]
   list                                      Alias of status
@@ -91,6 +91,7 @@ EXAMPLES:
   camo profile create myprofile
   camo profile default myprofile
   camo start --url https://example.com
+  camo start myprofile --width 1920 --height 1020
   camo goto https://www.xiaohongshu.com
   camo scroll --down --amount 500
   camo click "#search-input"
@@ -115,13 +116,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)
 `);
 }