@framers/agentos-ext-web-browser 1.1.0

package/dist/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * Web Browser Extension Types
+ * @module @framers/agentos-ext-web-browser
+ */
+/**
+ * Browser configuration options
+ */
+export interface BrowserConfig {
+    /** Run browser in headless mode */
+    headless?: boolean;
+    /** Default timeout for operations (ms) */
+    timeout?: number;
+    /** Custom user agent string */
+    userAgent?: string;
+    /** Viewport dimensions */
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    /** Executable path for browser (for puppeteer-core) */
+    executablePath?: string;
+}
+/**
+ * Result of a navigation operation
+ */
+export interface NavigationResult {
+    /** Final URL after any redirects */
+    url: string;
+    /** HTTP status code */
+    status: number;
+    /** Page title */
+    title: string;
+    /** Full HTML content */
+    html?: string;
+    /** Extracted text content */
+    text?: string;
+    /** Time taken to load (ms) */
+    loadTime: number;
+    /** Any console messages */
+    consoleMessages?: string[];
+}
+/**
+ * Result of a scrape operation
+ */
+export interface ScrapeResult {
+    /** Selector used */
+    selector: string;
+    /** Number of elements found */
+    count: number;
+    /** Extracted content */
+    elements: ScrapeElement[];
+}
+/**
+ * A single scraped element
+ */
+export interface ScrapeElement {
+    /** Element tag name */
+    tag: string;
+    /** Element text content */
+    text: string;
+    /** Element HTML content */
+    html: string;
+    /** Element attributes */
+    attributes: Record<string, string>;
+    /** Href if it's a link */
+    href?: string;
+    /** Src if it's an image/media */
+    src?: string;
+}
+/**
+ * Result of a click operation
+ */
+export interface ClickResult {
+    /** Whether click was successful */
+    success: boolean;
+    /** Element that was clicked (selector) */
+    element: string;
+    /** New URL if navigation occurred */
+    newUrl?: string;
+    /** Any text content change detected */
+    contentChanged?: boolean;
+}
+/**
+ * Result of a type operation
+ */
+export interface TypeResult {
+    /** Whether typing was successful */
+    success: boolean;
+    /** Element that received input */
+    element: string;
+    /** Text that was typed */
+    text: string;
+}
+/**
+ * Screenshot capture options
+ */
+export interface ScreenshotOptions {
+    /** Capture full scrollable page */
+    fullPage?: boolean;
+    /** CSS selector for specific element */
+    selector?: string;
+    /** Image format */
+    format?: 'png' | 'jpeg' | 'webp';
+    /** Quality for jpeg/webp (0-100) */
+    quality?: number;
+}
+/**
+ * Result of a screenshot operation
+ */
+export interface ScreenshotResult {
+    /** Base64-encoded image data */
+    data: string;
+    /** Image format */
+    format: 'png' | 'jpeg' | 'webp';
+    /** Width in pixels */
+    width: number;
+    /** Height in pixels */
+    height: number;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Page snapshot for accessibility tree
+ */
+export interface PageSnapshot {
+    /** Current URL */
+    url: string;
+    /** Page title */
+    title: string;
+    /** Simplified DOM structure */
+    elements: SnapshotElement[];
+    /** Links on the page */
+    links: {
+        text: string;
+        href: string;
+        ref: string;
+    }[];
+    /** Forms on the page */
+    forms: {
+        id?: string;
+        action?: string;
+        fields: string[];
+    }[];
+    /** Interactive elements */
+    interactable: {
+        ref: string;
+        type: string;
+        label: string;
+    }[];
+}
+/**
+ * Element in page snapshot
+ */
+export interface SnapshotElement {
+    /** Reference ID for interaction */
+    ref: string;
+    /** Element type */
+    type: string;
+    /** Accessible name/label */
+    label: string;
+    /** Role (button, link, input, etc.) */
+    role?: string;
+    /** Value for inputs */
+    value?: string;
+    /** Whether element is visible */
+    visible: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * Web Browser Extension Types
+ * @module @framers/agentos-ext-web-browser
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/manifest.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
+  "id": "com.framers.research.web-browser",
+  "name": "Web Browser Extension",
+  "version": "1.0.0",
+  "description": "Browser automation capabilities for AgentOS - navigate pages, scrape content, click links, and capture screenshots",
+  "author": {
+    "name": "Frame.dev",
+    "email": "support@frame.dev",
+    "url": "https://github.com/framersai"
+  },
+  "license": "MIT",
+  "keywords": ["browser", "scraping", "automation", "puppeteer", "playwright", "web", "navigate"],
+  "agentosVersion": "^2.0.0",
+  "categories": ["productivity", "research", "automation"],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions"
+  },
+  "extensions": [
+    {
+      "kind": "tool",
+      "id": "browserNavigate",
+      "displayName": "Navigate to URL",
+      "description": "Navigate browser to a URL and get page content",
+      "entry": "./dist/tools/navigate.js"
+    },
+    {
+      "kind": "tool",
+      "id": "browserScrape",
+      "displayName": "Scrape Content",
+      "description": "Extract content from web page using CSS selectors",
+      "entry": "./dist/tools/scrape.js"
+    },
+    {
+      "kind": "tool",
+      "id": "browserClick",
+      "displayName": "Click Element",
+      "description": "Click on an element in the current page",
+      "entry": "./dist/tools/click.js"
+    },
+    {
+      "kind": "tool",
+      "id": "browserScreenshot",
+      "displayName": "Take Screenshot",
+      "description": "Capture screenshot of current page or element",
+      "entry": "./dist/tools/screenshot.js"
+    },
+    {
+      "kind": "tool",
+      "id": "browserType",
+      "displayName": "Type Text",
+      "description": "Type text into an input field",
+      "entry": "./dist/tools/type.js"
+    }
+  ],
+  "configuration": {
+    "properties": {
+      "browser.headless": {
+        "type": "boolean",
+        "default": true,
+        "description": "Run browser in headless mode"
+      },
+      "browser.timeout": {
+        "type": "number",
+        "default": 30000,
+        "minimum": 5000,
+        "maximum": 120000,
+        "description": "Default timeout for browser operations (ms)"
+      },
+      "browser.userAgent": {
+        "type": "string",
+        "description": "Custom user agent string"
+      },
+      "browser.viewport.width": {
+        "type": "number",
+        "default": 1920,
+        "description": "Browser viewport width"
+      },
+      "browser.viewport.height": {
+        "type": "number",
+        "default": 1080,
+        "description": "Browser viewport height"
+      }
+    }
+  },
+  "dependencies": {
+    "puppeteer-core": "^22.0.0"
+  }
+}
+
+
+

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@framers/agentos-ext-web-browser",
+  "version": "1.1.0",
+  "description": "Browser automation extension for AgentOS",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "manifest.json",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "agentos",
+    "extension",
+    "browser",
+    "automation",
+    "scraping",
+    "puppeteer"
+  ],
+  "author": {
+    "name": "Framers AI",
+    "email": "team@frame.dev",
+    "url": "https://frame.dev"
+  },
+  "contributors": [
+    {
+      "name": "Johnny Dunn",
+      "email": "johnnyfived@protonmail.com",
+      "url": "https://github.com/jddunn"
+    }
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/framersai/agentos-extensions",
+    "directory": "registry/curated/research/web-browser"
+  },
+  "peerDependencies": {
+    "@framers/agentos": "^0.1.0"
+  },
+  "dependencies": {
+    "puppeteer-core": "^22.0.0",
+    "cheerio": "^1.0.0-rc.12"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}