@ai2qa/local-agent 0.1.0

package/README.md

@@ -0,0 +1,254 @@
+# AI2QA Local Agent
+
+Universal MCP Server for browser automation. Enables both local AI tools (Claude Code, Cursor, Antigravity) and AI2QA cloud to control browsers.
+
+## Features
+
+- **Sidecar Mode**: Attach to existing Chrome sessions (preserves cookies, auth, VPN access)
+- **MCP Protocol**: Standard Model Context Protocol for AI tool integration
+- **9 Browser Tools**: navigate, click, fill, hover, press-key, screenshot, snapshot, wait, evaluate
+
+## Quick Start
+
+### 1. Install
+
+```bash
+cd ai2qa-local-agent
+npm install
+npm run build
+```
+
+### 2. Start Chrome with Remote Debugging
+
+```bash
+# macOS
+/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --remote-debugging-port=9222
+
+# Linux
+google-chrome --remote-debugging-port=9222
+
+# Windows
+"C:\Program Files\Google\Chrome\Application\chrome.exe" --remote-debugging-port=9222
+```
+
+### 3. Start the Agent
+
+```bash
+# Sidecar mode (attach to existing Chrome)
+npm start -- start --sidecar
+
+# Or with custom port
+npm start -- start --sidecar --port 9222
+```
+
+## CLI Commands
+
+```bash
+# Start with stdio (for local AI tools like Claude Code)
+ai2qa-agent start
+
+# Start with sidecar mode (default) with custom CDP port
+ai2qa-agent start --sidecar --port 9222
+
+# Start in headless mode (no visible browser window)
+ai2qa-agent start --headless
+
+# Login to AI2QA cloud (for remote orchestration)
+ai2qa-agent login <token>
+
+# Start connected to AI2QA cloud
+ai2qa-agent start --cloud
+
+# Check agent status
+ai2qa-agent status
+
+# Logout and clear credentials
+ai2qa-agent logout
+```
+
+## Claude Code Integration
+
+Add to `~/.config/claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ai2qa": {
+      "command": "node",
+      "args": ["/path/to/ai2qa-local-agent/dist/index.js", "start", "--sidecar"]
+    }
+  }
+}
+```
+
+Or after global install:
+
+```bash
+npm install -g @ai2qa/local-agent
+```
+
+Then configure:
+
+```json
+{
+  "mcpServers": {
+    "ai2qa": {
+      "command": "ai2qa-agent",
+      "args": ["start", "--sidecar"]
+    }
+  }
+}
+```
+
+## AI2QA Cloud Integration
+
+To connect your local agent to AI2QA cloud for remote test orchestration:
+
+1. **Generate a device token** from the AI2QA web UI at `https://ai2qa.com/agents`
+
+2. **Login with your token**:
+   ```bash
+   ai2qa-agent login <your-token>
+   ```
+
+3. **Start in cloud mode**:
+   ```bash
+   ai2qa-agent start --cloud
+   ```
+
+The agent will connect to AI2QA cloud and be available for running test runs from the web interface. This enables testing on internal applications behind VPNs using your local browser session.
+
+## Available Tools
+
+### navigate_page
+Navigate to a URL or perform navigation actions.
+
+```json
+{
+  "url": "https://example.com",
+  "type": "goto"  // goto, reload, back, forward
+}
+```
+
+### click
+Click on an element by selector or ref.
+
+```json
+{
+  "selector": "button#submit"
+}
+```
+
+### fill
+Fill an input field with text.
+
+```json
+{
+  "selector": "input[name='email']",
+  "value": "test@example.com"
+}
+```
+
+### hover
+Hover over an element.
+
+```json
+{
+  "selector": ".menu-trigger"
+}
+```
+
+### press_key
+Press a keyboard key.
+
+```json
+{
+  "key": "Enter",
+  "modifiers": ["Control"]
+}
+```
+
+### take_screenshot
+Capture a screenshot.
+
+```json
+{
+  "fullPage": true,
+  "format": "png"
+}
+```
+
+### take_snapshot
+Get accessibility tree/DOM snapshot for AI analysis.
+
+```json
+{
+  "verbose": true,
+  "mode": "accessibility"
+}
+```
+
+### wait_for
+Wait for element, text, or duration.
+
+```json
+{
+  "selector": ".loaded",
+  "state": "visible",
+  "timeout": 5000
+}
+```
+
+### evaluate
+Execute JavaScript in page context.
+
+```json
+{
+  "script": "document.title"
+}
+```
+
+## Development
+
+```bash
+# Build
+npm run build
+
+# Watch mode
+npm run dev
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                    AI2QA Local Agent                     │
+│                                                          │
+│  ┌─────────────┐    ┌──────────────┐    ┌────────────┐  │
+│  │   Stdio     │    │  MCP Server  │    │ WebSocket  │  │
+│  │  Transport  │───►│  (9 tools)   │◄───│ Transport  │  │
+│  └─────────────┘    └──────┬───────┘    └────────────┘  │
+│        ▲                   │                   ▲        │
+│        │                   ▼                   │        │
+│  [Claude Code]      ┌──────────────┐    [AI2QA Cloud]   │
+│  [Cursor]           │  Playwright  │                    │
+│                     │  CDP Bridge  │                    │
+│                     └──────┬───────┘                    │
+└────────────────────────────┼────────────────────────────┘
+                             │
+                             ▼
+┌────────────────────────────────────────────────────────┐
+│  Chrome (--remote-debugging-port=9222)                  │
+│  [Already logged into VPN, SSO, internal apps]         │
+└────────────────────────────────────────────────────────┘
+```
+
+## License
+
+MIT

package/bin/ai2qa-agent

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+/**
+ * AI2QA Local Agent CLI Entry Point
+ */
+
+import('../dist/index.js').catch((err) => {
+    console.error('Failed to start ai2qa-agent:', err.message);
+    console.error('');
+    console.error('If you see "Cannot find module", run: npm run build');
+    process.exit(1);
+});

package/dist/browser/connection.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Browser Connection Manager
+ *
+ * Handles two connection modes:
+ * 1. Sidecar Mode: Attach to existing Chrome via CDP (for cookie/auth bypass)
+ * 2. Launch Mode: Start new browser instance (for CI/CD)
+ */
+import { Page } from 'playwright';
+/** Connection mode for the browser */
+export type ConnectionMode = 'sidecar' | 'launch';
+/** Configuration for browser connection */
+export interface BrowserConfig {
+    readonly mode: ConnectionMode;
+    readonly cdpUrl?: string;
+    readonly headless?: boolean;
+    readonly viewport?: {
+        width: number;
+        height: number;
+    };
+}
+/** Result type for operations that can fail */
+export type Result<T, E = Error> = {
+    readonly success: true;
+    readonly value: T;
+} | {
+    readonly success: false;
+    readonly error: E;
+};
+/**
+ * Browser Connection Manager
+ * Manages browser lifecycle and provides access to the active page.
+ */
+export declare class BrowserConnection {
+    private state;
+    private readonly config;
+    constructor(config?: Partial<BrowserConfig>);
+    /**
+     * Connect to browser based on configured mode.
+     * Returns Result to avoid throwing exceptions.
+     */
+    connect(): Promise<Result<Page>>;
+    /**
+     * Sidecar mode: Attach to existing Chrome via CDP.
+     * Chrome must be started with: --remote-debugging-port=9222
+     */
+    private connectSidecar;
+    /**
+     * Launch mode: Start new browser instance.
+     */
+    private launchBrowser;
+    /**
+     * Get the active page, connecting if necessary.
+     */
+    getPage(): Promise<Result<Page>>;
+    /**
+     * Check if connected to a browser.
+     */
+    isConnected(): boolean;
+    /**
+     * Get current page URL, or empty string if not connected.
+     */
+    getCurrentUrl(): Promise<string>;
+    /**
+     * Disconnect from browser.
+     * In sidecar mode, only disconnects (doesn't close Chrome).
+     * In launch mode, closes the browser.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Create a new page in the current context.
+     */
+    newPage(): Promise<Result<Page>>;
+    /**
+     * Close current page and switch to another if available.
+     */
+    closePage(): Promise<void>;
+}
+/** Factory function for creating browser connections */
+export declare function createBrowserConnection(config?: Partial<BrowserConfig>): BrowserConnection;
+//# sourceMappingURL=connection.d.ts.map

package/dist/browser/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/browser/connection.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqC,IAAI,EAAE,MAAM,YAAY,CAAC;AAErE,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAElD,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACzD;AAED,+CAA+C;AAC/C,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IACzB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,GAC7C;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAYrD;;;GAGG;AACH,qBAAa,iBAAiB;IAC1B,OAAO,CAAC,KAAK,CAIX;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAE3B,MAAM,GAAE,OAAO,CAAC,aAAa,CAAM;IAS/C;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IA0BtC;;;OAGG;YACW,cAAc;IAM5B;;OAEG;YACW,aAAa;IAO3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAOtC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAMtC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IActC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;CAenC;AAED,wDAAwD;AACxD,wBAAgB,uBAAuB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAE1F"}

package/dist/browser/connection.js

@@ -0,0 +1,165 @@
+"use strict";
+/**
+ * Browser Connection Manager
+ *
+ * Handles two connection modes:
+ * 1. Sidecar Mode: Attach to existing Chrome via CDP (for cookie/auth bypass)
+ * 2. Launch Mode: Start new browser instance (for CI/CD)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserConnection = void 0;
+exports.createBrowserConnection = createBrowserConnection;
+const playwright_1 = require("playwright");
+const DEFAULT_VIEWPORT = { width: 1920, height: 1080 };
+const DEFAULT_CDP_URL = 'http://localhost:9222';
+/**
+ * Browser Connection Manager
+ * Manages browser lifecycle and provides access to the active page.
+ */
+class BrowserConnection {
+    state = {
+        browser: null,
+        context: null,
+        page: null,
+    };
+    config;
+    constructor(config = {}) {
+        this.config = {
+            mode: config.mode ?? 'sidecar',
+            cdpUrl: config.cdpUrl ?? DEFAULT_CDP_URL,
+            headless: config.headless ?? false,
+            viewport: config.viewport ?? DEFAULT_VIEWPORT,
+        };
+    }
+    /**
+     * Connect to browser based on configured mode.
+     * Returns Result to avoid throwing exceptions.
+     */
+    async connect() {
+        try {
+            const browser = this.config.mode === 'sidecar'
+                ? await this.connectSidecar()
+                : await this.launchBrowser();
+            this.state.browser = browser;
+            // Get or create context and page
+            const contexts = browser.contexts();
+            this.state.context = contexts.length > 0
+                ? contexts[0]
+                : await browser.newContext({ viewport: this.config.viewport });
+            const pages = this.state.context.pages();
+            this.state.page = pages.length > 0
+                ? pages[0]
+                : await this.state.context.newPage();
+            return { success: true, value: this.state.page };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            return { success: false, error };
+        }
+    }
+    /**
+     * Sidecar mode: Attach to existing Chrome via CDP.
+     * Chrome must be started with: --remote-debugging-port=9222
+     */
+    async connectSidecar() {
+        const cdpUrl = this.config.cdpUrl ?? DEFAULT_CDP_URL;
+        console.error(`[BrowserConnection] Connecting to Chrome via CDP: ${cdpUrl}`);
+        return playwright_1.chromium.connectOverCDP(cdpUrl);
+    }
+    /**
+     * Launch mode: Start new browser instance.
+     */
+    async launchBrowser() {
+        console.error(`[BrowserConnection] Launching new browser (headless: ${this.config.headless})`);
+        return playwright_1.chromium.launch({
+            headless: this.config.headless,
+        });
+    }
+    /**
+     * Get the active page, connecting if necessary.
+     */
+    async getPage() {
+        if (this.state.page && !this.state.page.isClosed()) {
+            return { success: true, value: this.state.page };
+        }
+        return this.connect();
+    }
+    /**
+     * Check if connected to a browser.
+     */
+    isConnected() {
+        return this.state.browser !== null && this.state.browser.isConnected();
+    }
+    /**
+     * Get current page URL, or empty string if not connected.
+     */
+    async getCurrentUrl() {
+        const result = await this.getPage();
+        if (!result.success)
+            return '';
+        return result.value.url();
+    }
+    /**
+     * Disconnect from browser.
+     * In sidecar mode, only disconnects (doesn't close Chrome).
+     * In launch mode, closes the browser.
+     */
+    async disconnect() {
+        try {
+            if (this.state.browser) {
+                if (this.config.mode === 'launch') {
+                    await this.state.browser.close();
+                }
+                // Sidecar mode: browser.close() just disconnects without closing Chrome
+                // For CDP connections, close() is safe and doesn't terminate the browser
+            }
+        }
+        catch (err) {
+            console.error('[BrowserConnection] Error during disconnect:', err);
+        }
+        finally {
+            this.state = { browser: null, context: null, page: null };
+        }
+    }
+    /**
+     * Create a new page in the current context.
+     */
+    async newPage() {
+        if (!this.state.context) {
+            return { success: false, error: new Error('Not connected to browser') };
+        }
+        try {
+            const page = await this.state.context.newPage();
+            this.state.page = page;
+            return { success: true, value: page };
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            return { success: false, error };
+        }
+    }
+    /**
+     * Close current page and switch to another if available.
+     */
+    async closePage() {
+        if (!this.state.page)
+            return;
+        try {
+            await this.state.page.close();
+        }
+        catch {
+            // Page might already be closed
+        }
+        // Switch to another page if available
+        if (this.state.context) {
+            const pages = this.state.context.pages();
+            this.state.page = pages.length > 0 ? pages[0] : null;
+        }
+    }
+}
+exports.BrowserConnection = BrowserConnection;
+/** Factory function for creating browser connections */
+function createBrowserConnection(config) {
+    return new BrowserConnection(config);
+}
+//# sourceMappingURL=connection.js.map

package/dist/browser/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/browser/connection.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Configuration Management
+ *
+ * Handles loading/saving agent configuration including:
+ * - Cloud connection settings
+ * - Device token storage
+ * - Agent identity
+ */
+/** Agent configuration */
+export interface AgentConfig {
+    /** Unique agent identifier */
+    agentId: string;
+    /** Device name for identification */
+    deviceName: string;
+    /** AI2QA cloud WebSocket URL */
+    cloudUrl: string;
+    /** Encrypted device token */
+    encryptedToken?: string;
+    /** Token expiration timestamp */
+    tokenExpiresAt?: string;
+}
+/**
+ * Load agent configuration from disk.
+ */
+export declare function loadConfig(): AgentConfig;
+/**
+ * Save agent configuration to disk.
+ */
+export declare function saveConfig(config: Partial<AgentConfig>): void;
+/**
+ * Store device token securely.
+ */
+export declare function storeToken(token: string, expiresAt?: Date): void;
+/**
+ * Retrieve stored device token.
+ */
+export declare function getToken(): string | null;
+/**
+ * Check if agent is logged in (has valid token).
+ */
+export declare function isLoggedIn(): boolean;
+/**
+ * Clear stored token (logout).
+ */
+export declare function clearToken(): void;
+/**
+ * Get cloud connection config.
+ */
+export declare function getCloudConfig(): {
+    url: string;
+    token: string;
+    agentId: string;
+} | null;
+/**
+ * Set cloud URL.
+ */
+export declare function setCloudUrl(url: string): void;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,0BAA0B;AAC1B,MAAM,WAAW,WAAW;IACxB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iCAAiC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAwFD;;GAEG;AACH,wBAAgB,UAAU,IAAI,WAAW,CAkBxC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAO7D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,IAAI,GAAG,IAAI,CAShE;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAwBxC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAKjC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAavF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE7C"}