@theagent/core

Core browser automation framework with multi-adapter support for Playwright, Puppeteer, and Selenium. Provides AI-powered element detection and natural language instruction parsing.

Features

• 🎭 Multi-Adapter Support: Playwright, Puppeteer, and Selenium adapters
• 🌐 Cross-Browser Compatibility: Chrome, Firefox, Safari, Edge support
• 🤖 AI Integration: Ollama-powered natural language instruction parsing
• 🎯 Smart Element Detection: AI-powered element identification
• 📱 Responsive Testing: Multiple viewport and device simulation
• 🔍 Intelligent Fallbacks: Automatic adapter switching and error recovery
• 📊 Performance Monitoring: Built-in metrics and benchmarking
• 🛡️ Type Safety: Full TypeScript support with strict typing

Installation

npm install @theagent/core

Quick Start

import { BrowserAutomation, BrowserType } from '@theagent/core';

const automation = new BrowserAutomation({
  adapter: 'playwright',
  headless: false,
  browserType: BrowserType.CHROME,
});

// Navigate and interact
await automation.navigate('https://example.com');
await automation.execute('Take a screenshot of the page');
await automation.close();

API Reference

See the main project documentation for detailed API reference and examples.