@framers/agentos-ext-browser-automation 0.1.0

package/dist/tools/WaitTool.d.ts

@@ -0,0 +1,41 @@
+import type { BrowserService } from '../BrowserService.js';
+export declare class WaitTool {
+    private browser;
+    readonly id = "browserWait";
+    readonly name = "browserWait";
+    readonly displayName = "Wait for Condition";
+    readonly description = "Wait for a CSS selector to appear/disappear, or wait for a specified duration.";
+    readonly category = "browser";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = false;
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            selector: {
+                type: string;
+                description: string;
+            };
+            timeout: {
+                type: string;
+                description: string;
+                default: number;
+            };
+            state: {
+                type: string;
+                enum: string[];
+                description: string;
+                default: string;
+            };
+        };
+    };
+    constructor(browser: BrowserService);
+    execute(args: {
+        selector?: string;
+        timeout?: number;
+        state?: 'visible' | 'hidden' | 'attached' | 'detached';
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=WaitTool.d.ts.map

package/dist/tools/WaitTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaitTool.d.ts","sourceRoot":"","sources":["../../src/tools/WaitTool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,qBAAa,QAAQ;IAuBP,OAAO,CAAC,OAAO;IAtB3B,QAAQ,CAAC,EAAE,iBAAiB;IAC5B,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,wBAAwB;IAC5C,QAAQ,CAAC,WAAW,oFAAoF;IACxG,QAAQ,CAAC,QAAQ,aAAa;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,cAAc,SAAS;IAEhC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;MAYlB;gBAEkB,OAAO,EAAE,cAAc;IAErC,OAAO,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAQpK"}

package/dist/tools/WaitTool.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaitTool = void 0;
+class WaitTool {
+    constructor(browser) {
+        this.browser = browser;
+        this.id = 'browserWait';
+        this.name = 'browserWait';
+        this.displayName = 'Wait for Condition';
+        this.description = 'Wait for a CSS selector to appear/disappear, or wait for a specified duration.';
+        this.category = 'browser';
+        this.version = '0.1.0';
+        this.hasSideEffects = false;
+        this.inputSchema = {
+            type: 'object',
+            properties: {
+                selector: { type: 'string', description: 'CSS selector to wait for (omit for time-based wait)' },
+                timeout: { type: 'number', description: 'Maximum wait time in milliseconds', default: 30000 },
+                state: {
+                    type: 'string',
+                    enum: ['visible', 'hidden', 'attached', 'detached'],
+                    description: 'Element state to wait for',
+                    default: 'visible',
+                },
+            },
+        };
+    }
+    async execute(args) {
+        try {
+            await this.browser.wait(args);
+            return { success: true };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+}
+exports.WaitTool = WaitTool;
+//# sourceMappingURL=WaitTool.js.map

package/dist/tools/WaitTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WaitTool.js","sourceRoot":"","sources":["../../src/tools/WaitTool.ts"],"names":[],"mappings":";;;AAGA,MAAa,QAAQ;IAuBnB,YAAoB,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAtBlC,OAAE,GAAG,aAAa,CAAC;QACnB,SAAI,GAAG,aAAa,CAAC;QACrB,gBAAW,GAAG,oBAAoB,CAAC;QACnC,gBAAW,GAAG,gFAAgF,CAAC;QAC/F,aAAQ,GAAG,SAAS,CAAC;QACrB,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,KAAK,CAAC;QAEvB,gBAAW,GAAG;YACrB,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;gBAChG,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE,OAAO,EAAE,KAAK,EAAE;gBAC7F,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC;oBACnD,WAAW,EAAE,2BAA2B;oBACxC,OAAO,EAAE,SAAS;iBACnB;aACF;SACF,CAAC;IAE4C,CAAC;IAE/C,KAAK,CAAC,OAAO,CAAC,IAAqG;QACjH,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAQ,EAAE,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAjCD,4BAiCC"}

package/manifest.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
+  "id": "com.framers.system.browser-automation",
+  "name": "Browser Automation Extension",
+  "version": "0.1.0",
+  "description": "Full browser automation for autonomous agents — navigate URLs, interact with DOM elements, capture screenshots, solve captchas, and rotate proxies. Powered by Playwright with persistent session support.",
+  "categories": ["system", "automation", "browser"],
+  "sdk": "playwright",
+  "extensions": [
+    { "kind": "tool", "id": "browserNavigate", "displayName": "Navigate to URL" },
+    { "kind": "tool", "id": "browserClick", "displayName": "Click Element" },
+    { "kind": "tool", "id": "browserFill", "displayName": "Fill Input" },
+    { "kind": "tool", "id": "browserScreenshot", "displayName": "Take Screenshot" },
+    { "kind": "tool", "id": "browserExtract", "displayName": "Extract Content" },
+    { "kind": "tool", "id": "browserWait", "displayName": "Wait for Condition" },
+    { "kind": "tool", "id": "browserScroll", "displayName": "Scroll Page" },
+    { "kind": "tool", "id": "browserSnapshot", "displayName": "Page Snapshot" },
+    { "kind": "tool", "id": "browserEvaluate", "displayName": "Evaluate JavaScript" },
+    { "kind": "tool", "id": "browserSession", "displayName": "Manage Session" }
+  ],
+  "requiredSecrets": [],
+  "optionalSecrets": ["twocaptcha.apiKey", "proxy.config"],
+  "features": [
+    "Navigate to any URL with full page rendering",
+    "Click elements by CSS selector, text content, or ARIA role",
+    "Fill forms and interact with inputs",
+    "Capture full-page or element screenshots",
+    "Extract text, HTML, or structured data from DOM",
+    "Wait for selectors, navigation, or custom conditions",
+    "Smart page snapshot — inventory of all interactive elements",
+    "Execute arbitrary JavaScript in page context",
+    "Persistent login sessions via cookie/localStorage storage",
+    "CAPTCHA solving via 2captcha (reCAPTCHA, hCaptcha, Turnstile)",
+    "Proxy rotation with sticky sessions and geo-targeting",
+    "Auto-screenshot on errors for debugging"
+  ],
+  "configuration": {
+    "properties": {
+      "browser.headless": {
+        "type": "boolean",
+        "default": true,
+        "description": "Run browser in headless mode"
+      },
+      "browser.timeout": {
+        "type": "number",
+        "default": 30000,
+        "description": "Default navigation timeout in milliseconds"
+      },
+      "browser.userDataDir": {
+        "type": "string",
+        "description": "Path to persistent browser profile directory"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@framers/agentos-ext-browser-automation",
+  "version": "0.1.0",
+  "description": "Full browser automation extension for AgentOS — provides agents with autonomous web navigation, DOM interaction, screenshotting, captcha solving, and proxy rotation via Playwright.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "manifest.json"
+  ],
+  "peerDependencies": {
+    "@framers/agentos": "^0.5.2"
+  },
+  "dependencies": {
+    "playwright": "^1.50.0"
+  },
+  "optionalDependencies": {
+    "2captcha-ts": "^1.3.0"
+  },
+  "devDependencies": {
+    "@framers/agentos": "^0.6.6",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions",
+    "directory": "registry/curated/system/browser-automation"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "clean": "rm -rf dist"
+  }
+}