anchi-kit 1.2.1 → 1.2.2

package/.antigravity/skills/chrome-devtools/scripts/install.sh

@@ -1,83 +0,0 @@
-#!/bin/bash
-# Installation script for Chrome DevTools Agent Skill
-
-set -e
-
-echo "🚀 Installing Chrome DevTools Agent Skill..."
-echo ""
-
-# Check Node.js version
-echo "Checking Node.js version..."
-NODE_VERSION=$(node --version | cut -d'v' -f2 | cut -d'.' -f1)
-
-if [ "$NODE_VERSION" -lt 18 ]; then
-  echo "❌ Error: Node.js 18+ is required. Current version: $(node --version)"
-  echo "   Please upgrade Node.js: https://nodejs.org/"
-  exit 1
-fi
-
-echo "✓ Node.js version: $(node --version)"
-echo ""
-
-# Check for system dependencies (Linux only)
-if [[ "$OSTYPE" == "linux-gnu"* ]]; then
-  echo "Checking system dependencies (Linux)..."
-
-  # Check for critical Chrome dependencies
-  MISSING_DEPS=()
-
-  if ! ldconfig -p | grep -q libnss3.so; then
-    MISSING_DEPS+=("libnss3")
-  fi
-
-  if ! ldconfig -p | grep -q libnspr4.so; then
-    MISSING_DEPS+=("libnspr4")
-  fi
-
-  if ! ldconfig -p | grep -q libgbm.so; then
-    MISSING_DEPS+=("libgbm1")
-  fi
-
-  if [ ${#MISSING_DEPS[@]} -gt 0 ]; then
-    echo "⚠️  Missing system dependencies: ${MISSING_DEPS[*]}"
-    echo ""
-    echo "   Chrome/Chromium requires system libraries to run."
-    echo "   Install them with:"
-    echo ""
-    echo "   ./install-deps.sh"
-    echo ""
-    echo "   Or manually:"
-    echo "   sudo apt-get install -y libnss3 libnspr4 libgbm1 libasound2t64 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2"
-    echo ""
-
-    read -p "   Continue anyway? (y/N) " -n 1 -r
-    echo ""
-    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-      echo "Installation cancelled."
-      exit 1
-    fi
-  else
-    echo "✓ System dependencies found"
-  fi
-  echo ""
-elif [[ "$OSTYPE" == "darwin"* ]]; then
-  echo "Platform: macOS (no system dependencies needed)"
-  echo ""
-elif [[ "$OSTYPE" == "msys" ]] || [[ "$OSTYPE" == "cygwin" ]]; then
-  echo "Platform: Windows (no system dependencies needed)"
-  echo ""
-fi
-
-# Install Node.js dependencies
-echo "Installing Node.js dependencies..."
-npm install
-
-echo ""
-echo "✅ Installation complete!"
-echo ""
-echo "Test the installation:"
-echo "  node navigate.js --url https://example.com"
-echo ""
-echo "For more information:"
-echo "  cat README.md"
-echo ""

package/.antigravity/skills/chrome-devtools/scripts/lib/browser.js

@@ -1,122 +0,0 @@
-/**
- * Shared browser utilities for Chrome DevTools scripts
- */
-import puppeteer from 'puppeteer';
-import debug from 'debug';
-
-const log = debug('chrome-devtools:browser');
-
-let browserInstance = null;
-let pageInstance = null;
-
-/**
- * Launch or connect to browser
- */
-export async function getBrowser(options = {}) {
-  if (browserInstance && browserInstance.isConnected()) {
-    log('Reusing existing browser instance');
-    return browserInstance;
-  }
-
-  const launchOptions = {
-    headless: options.headless !== false,
-    args: [
-      '--no-sandbox',
-      '--disable-setuid-sandbox',
-      '--disable-dev-shm-usage',
-      ...(options.args || [])
-    ],
-    defaultViewport: options.viewport || {
-      width: 1920,
-      height: 1080
-    },
-    ...options
-  };
-
-  if (options.browserUrl || options.wsEndpoint) {
-    log('Connecting to existing browser');
-    browserInstance = await puppeteer.connect({
-      browserURL: options.browserUrl,
-      browserWSEndpoint: options.wsEndpoint
-    });
-  } else {
-    log('Launching new browser');
-    browserInstance = await puppeteer.launch(launchOptions);
-  }
-
-  return browserInstance;
-}
-
-/**
- * Get current page or create new one
- */
-export async function getPage(browser) {
-  if (pageInstance && !pageInstance.isClosed()) {
-    log('Reusing existing page');
-    return pageInstance;
-  }
-
-  const pages = await browser.pages();
-  if (pages.length > 0) {
-    pageInstance = pages[0];
-  } else {
-    pageInstance = await browser.newPage();
-  }
-
-  return pageInstance;
-}
-
-/**
- * Close browser
- */
-export async function closeBrowser() {
-  if (browserInstance) {
-    await browserInstance.close();
-    browserInstance = null;
-    pageInstance = null;
-  }
-}
-
-/**
- * Parse command line arguments
- */
-export function parseArgs(argv, options = {}) {
-  const args = {};
-
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-
-    if (arg.startsWith('--')) {
-      const key = arg.slice(2);
-      const nextArg = argv[i + 1];
-
-      if (nextArg && !nextArg.startsWith('--')) {
-        args[key] = nextArg;
-        i++;
-      } else {
-        args[key] = true;
-      }
-    }
-  }
-
-  return args;
-}
-
-/**
- * Output JSON result
- */
-export function outputJSON(data) {
-  console.log(JSON.stringify(data, null, 2));
-}
-
-/**
- * Output error
- */
-export function outputError(error) {
-  console.error(JSON.stringify({
-    success: false,
-    error: error.message,
-    stack: error.stack
-  }, null, 2));
-  process.exit(1);
-}

package/.antigravity/skills/chrome-devtools/scripts/lib/selector.js

@@ -1,178 +0,0 @@
-/**
- * Shared selector parsing and validation library
- * Supports CSS and XPath selectors with security validation
- */
-
-/**
- * Parse and validate selector
- * @param {string} selector - CSS or XPath selector
- * @returns {{type: 'css'|'xpath', selector: string}}
- * @throws {Error} If XPath contains injection patterns
- */
-export function parseSelector(selector) {
-  if (!selector || typeof selector !== 'string') {
-    throw new Error('Selector must be a non-empty string');
-  }
-
-  // Detect XPath selectors
-  if (selector.startsWith('/') || selector.startsWith('(//')) {
-    // XPath injection prevention
-    validateXPath(selector);
-    return { type: 'xpath', selector };
-  }
-
-  // CSS selector
-  return { type: 'css', selector };
-}
-
-/**
- * Validate XPath selector for security
- * @param {string} xpath - XPath expression to validate
- * @throws {Error} If XPath contains dangerous patterns
- */
-function validateXPath(xpath) {
-  const dangerous = [
-    'javascript:',
-    '<script',
-    'onerror=',
-    'onload=',
-    'onclick=',
-    'onmouseover=',
-    'eval(',
-    'Function(',
-    'constructor(',
-  ];
-
-  const lower = xpath.toLowerCase();
-  for (const pattern of dangerous) {
-    if (lower.includes(pattern.toLowerCase())) {
-      throw new Error(`Potential XPath injection detected: ${pattern}`);
-    }
-  }
-
-  // Additional validation: check for extremely long selectors (potential DoS)
-  if (xpath.length > 1000) {
-    throw new Error('XPath selector too long (max 1000 characters)');
-  }
-}
-
-/**
- * Wait for element based on selector type
- * @param {Object} page - Puppeteer page instance
- * @param {{type: string, selector: string}} parsed - Parsed selector
- * @param {Object} options - Wait options (visible, timeout)
- * @returns {Promise<void>}
- */
-export async function waitForElement(page, parsed, options = {}) {
-  const defaultOptions = {
-    visible: true,
-    timeout: 5000,
-    ...options
-  };
-
-  if (parsed.type === 'xpath') {
-    // Use locator API for XPath (Puppeteer v24+)
-    const locator = page.locator(`::-p-xpath(${parsed.selector})`);
-    // setVisibility and setTimeout are the locator options
-    await locator
-      .setVisibility(defaultOptions.visible ? 'visible' : null)
-      .setTimeout(defaultOptions.timeout)
-      .wait();
-  } else {
-    await page.waitForSelector(parsed.selector, defaultOptions);
-  }
-}
-
-/**
- * Click element based on selector type
- * @param {Object} page - Puppeteer page instance
- * @param {{type: string, selector: string}} parsed - Parsed selector
- * @returns {Promise<void>}
- */
-export async function clickElement(page, parsed) {
-  if (parsed.type === 'xpath') {
-    // Use locator API for XPath (Puppeteer v24+)
-    const locator = page.locator(`::-p-xpath(${parsed.selector})`);
-    await locator.click();
-  } else {
-    await page.click(parsed.selector);
-  }
-}
-
-/**
- * Type into element based on selector type
- * @param {Object} page - Puppeteer page instance
- * @param {{type: string, selector: string}} parsed - Parsed selector
- * @param {string} value - Text to type
- * @param {Object} options - Type options (delay, clear)
- * @returns {Promise<void>}
- */
-export async function typeIntoElement(page, parsed, value, options = {}) {
-  if (parsed.type === 'xpath') {
-    // Use locator API for XPath (Puppeteer v24+)
-    const locator = page.locator(`::-p-xpath(${parsed.selector})`);
-
-    // Clear if requested
-    if (options.clear) {
-      await locator.fill('');
-    }
-
-    await locator.fill(value);
-  } else {
-    // CSS selector
-    if (options.clear) {
-      await page.$eval(parsed.selector, el => el.value = '');
-    }
-
-    await page.type(parsed.selector, value, { delay: options.delay || 0 });
-  }
-}
-
-/**
- * Get element handle based on selector type
- * @param {Object} page - Puppeteer page instance
- * @param {{type: string, selector: string}} parsed - Parsed selector
- * @returns {Promise<ElementHandle|null>}
- */
-export async function getElement(page, parsed) {
-  if (parsed.type === 'xpath') {
-    // For XPath, use page.evaluate with XPath evaluation
-    // This returns the first matching element
-    const element = await page.evaluateHandle((xpath) => {
-      const result = document.evaluate(
-        xpath,
-        document,
-        null,
-        XPathResult.FIRST_ORDERED_NODE_TYPE,
-        null
-      );
-      return result.singleNodeValue;
-    }, parsed.selector);
-
-    // Convert JSHandle to ElementHandle
-    const elementHandle = element.asElement();
-    return elementHandle;
-  } else {
-    return await page.$(parsed.selector);
-  }
-}
-
-/**
- * Get enhanced error message for selector failures
- * @param {Error} error - Original error
- * @param {string} selector - Selector that failed
- * @returns {Error} Enhanced error with troubleshooting tips
- */
-export function enhanceError(error, selector) {
-  if (error.message.includes('waiting for selector') ||
-      error.message.includes('waiting for XPath') ||
-      error.message.includes('No node found')) {
-    error.message += '\n\nTroubleshooting:\n' +
-      '1. Use snapshot.js to find correct selector: node snapshot.js --url <url>\n' +
-      '2. Try XPath selector: //button[text()="Click"] or //button[contains(text(),"Click")]\n' +
-      '3. Check element is visible on page (not display:none or hidden)\n' +
-      '4. Increase --timeout value: --timeout 10000\n' +
-      '5. Change wait strategy: --wait-until load or --wait-until domcontentloaded';
-  }
-  return error;
-}

package/.antigravity/skills/chrome-devtools/scripts/navigate.js

@@ -1,46 +0,0 @@
-#!/usr/bin/env node
-/**
- * Navigate to a URL
- * Usage: node navigate.js --url https://example.com [--wait-until networkidle2] [--timeout 30000]
- */
-import { getBrowser, getPage, closeBrowser, parseArgs, outputJSON, outputError } from './lib/browser.js';
-
-async function navigate() {
-  const args = parseArgs(process.argv.slice(2));
-
-  if (!args.url) {
-    outputError(new Error('--url is required'));
-    return;
-  }
-
-  try {
-    const browser = await getBrowser({
-      headless: args.headless !== 'false'
-    });
-
-    const page = await getPage(browser);
-
-    const options = {
-      waitUntil: args['wait-until'] || 'networkidle2',
-      timeout: parseInt(args.timeout || '30000')
-    };
-
-    await page.goto(args.url, options);
-
-    const result = {
-      success: true,
-      url: page.url(),
-      title: await page.title()
-    };
-
-    outputJSON(result);
-
-    if (args.close !== 'false') {
-      await closeBrowser();
-    }
-  } catch (error) {
-    outputError(error);
-  }
-}
-
-navigate();

package/.antigravity/skills/chrome-devtools/scripts/network.js

@@ -1,102 +0,0 @@
-#!/usr/bin/env node
-/**
- * Monitor network requests
- * Usage: node network.js --url https://example.com [--types xhr,fetch] [--output requests.json]
- */
-import { getBrowser, getPage, closeBrowser, parseArgs, outputJSON, outputError } from './lib/browser.js';
-import fs from 'fs/promises';
-
-async function monitorNetwork() {
-  const args = parseArgs(process.argv.slice(2));
-
-  if (!args.url) {
-    outputError(new Error('--url is required'));
-    return;
-  }
-
-  try {
-    const browser = await getBrowser({
-      headless: args.headless !== 'false'
-    });
-
-    const page = await getPage(browser);
-
-    const requests = [];
-    const filterTypes = args.types ? args.types.split(',').map(t => t.toLowerCase()) : null;
-
-    // Monitor requests
-    page.on('request', (request) => {
-      const resourceType = request.resourceType().toLowerCase();
-
-      if (!filterTypes || filterTypes.includes(resourceType)) {
-        requests.push({
-          id: request._requestId || requests.length,
-          url: request.url(),
-          method: request.method(),
-          resourceType: resourceType,
-          headers: request.headers(),
-          postData: request.postData(),
-          timestamp: Date.now()
-        });
-      }
-    });
-
-    // Monitor responses
-    const responses = new Map();
-    page.on('response', async (response) => {
-      const request = response.request();
-      const resourceType = request.resourceType().toLowerCase();
-
-      if (!filterTypes || filterTypes.includes(resourceType)) {
-        try {
-          responses.set(request._requestId || request.url(), {
-            status: response.status(),
-            statusText: response.statusText(),
-            headers: response.headers(),
-            fromCache: response.fromCache(),
-            timing: response.timing()
-          });
-        } catch (e) {
-          // Ignore errors for some response types
-        }
-      }
-    });
-
-    // Navigate
-    await page.goto(args.url, {
-      waitUntil: args['wait-until'] || 'networkidle2'
-    });
-
-    // Merge requests with responses
-    const combined = requests.map(req => ({
-      ...req,
-      response: responses.get(req.id) || responses.get(req.url) || null
-    }));
-
-    const result = {
-      success: true,
-      url: page.url(),
-      requestCount: combined.length,
-      requests: combined
-    };
-
-    if (args.output) {
-      await fs.writeFile(args.output, JSON.stringify(result, null, 2));
-      outputJSON({
-        success: true,
-        output: args.output,
-        requestCount: combined.length
-      });
-    } else {
-      outputJSON(result);
-    }
-
-    if (args.close !== 'false') {
-      await closeBrowser();
-    }
-  } catch (error) {
-    outputError(error);
-  }
-}
-
-monitorNetwork();

package/.antigravity/skills/chrome-devtools/scripts/package.json

@@ -1,15 +0,0 @@
-{
-  "name": "chrome-devtools-scripts",
-  "version": "1.0.0",
-  "description": "Browser automation scripts for Chrome DevTools Agent Skill",
-  "type": "module",
-  "scripts": {},
-  "dependencies": {
-    "puppeteer": "^24.15.0",
-    "debug": "^4.4.0",
-    "yargs": "^17.7.2"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  }
-}

package/.antigravity/skills/chrome-devtools/scripts/performance.js

@@ -1,145 +0,0 @@
-#!/usr/bin/env node
-/**
- * Measure performance metrics and record trace
- * Usage: node performance.js --url https://example.com [--trace trace.json] [--metrics]
- */
-import { getBrowser, getPage, closeBrowser, parseArgs, outputJSON, outputError } from './lib/browser.js';
-import fs from 'fs/promises';
-
-async function measurePerformance() {
-  const args = parseArgs(process.argv.slice(2));
-
-  if (!args.url) {
-    outputError(new Error('--url is required'));
-    return;
-  }
-
-  try {
-    const browser = await getBrowser({
-      headless: args.headless !== 'false'
-    });
-
-    const page = await getPage(browser);
-
-    // Start tracing if requested
-    if (args.trace) {
-      await page.tracing.start({
-        path: args.trace,
-        categories: [
-          'devtools.timeline',
-          'disabled-by-default-devtools.timeline',
-          'disabled-by-default-devtools.timeline.frame'
-        ]
-      });
-    }
-
-    // Navigate
-    await page.goto(args.url, {
-      waitUntil: 'networkidle2'
-    });
-
-    // Stop tracing
-    if (args.trace) {
-      await page.tracing.stop();
-    }
-
-    // Get performance metrics
-    const metrics = await page.metrics();
-
-    // Get Core Web Vitals
-    const vitals = await page.evaluate(() => {
-      return new Promise((resolve) => {
-        const vitals = {
-          LCP: null,
-          FID: null,
-          CLS: 0,
-          FCP: null,
-          TTFB: null
-        };
-
-        // LCP
-        try {
-          new PerformanceObserver((list) => {
-            const entries = list.getEntries();
-            if (entries.length > 0) {
-              const lastEntry = entries[entries.length - 1];
-              vitals.LCP = lastEntry.renderTime || lastEntry.loadTime;
-            }
-          }).observe({ entryTypes: ['largest-contentful-paint'], buffered: true });
-        } catch (e) {}
-
-        // CLS
-        try {
-          new PerformanceObserver((list) => {
-            list.getEntries().forEach((entry) => {
-              if (!entry.hadRecentInput) {
-                vitals.CLS += entry.value;
-              }
-            });
-          }).observe({ entryTypes: ['layout-shift'], buffered: true });
-        } catch (e) {}
-
-        // FCP
-        try {
-          const paintEntries = performance.getEntriesByType('paint');
-          const fcpEntry = paintEntries.find(e => e.name === 'first-contentful-paint');
-          if (fcpEntry) {
-            vitals.FCP = fcpEntry.startTime;
-          }
-        } catch (e) {}
-
-        // TTFB
-        try {
-          const [navigationEntry] = performance.getEntriesByType('navigation');
-          if (navigationEntry) {
-            vitals.TTFB = navigationEntry.responseStart - navigationEntry.requestStart;
-          }
-        } catch (e) {}
-
-        // Wait a bit for metrics to stabilize
-        setTimeout(() => resolve(vitals), 1000);
-      });
-    });
-
-    // Get resource timing
-    const resources = await page.evaluate(() => {
-      return performance.getEntriesByType('resource').map(r => ({
-        name: r.name,
-        type: r.initiatorType,
-        duration: r.duration,
-        size: r.transferSize,
-        startTime: r.startTime
-      }));
-    });
-
-    const result = {
-      success: true,
-      url: page.url(),
-      metrics: {
-        ...metrics,
-        JSHeapUsedSizeMB: (metrics.JSHeapUsedSize / 1024 / 1024).toFixed(2),
-        JSHeapTotalSizeMB: (metrics.JSHeapTotalSize / 1024 / 1024).toFixed(2)
-      },
-      vitals: vitals,
-      resources: {
-        count: resources.length,
-        totalDuration: resources.reduce((sum, r) => sum + r.duration, 0),
-        items: args.resources === 'true' ? resources : undefined
-      }
-    };
-
-    if (args.trace) {
-      result.trace = args.trace;
-    }
-
-    outputJSON(result);
-
-    if (args.close !== 'false') {
-      await closeBrowser();
-    }
-  } catch (error) {
-    outputError(error);
-  }
-}
-
-measurePerformance();