@framers/agentos-ext-stealth-browser 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * AgentOS Stealth Browser Extension
+ *
+ * Provides stealth browser automation using puppeteer-extra with the stealth plugin
+ * to bypass anti-bot detection on sites like Amazon, eBay, LinkedIn, and Cloudflare-
+ * protected pages.
+ *
+ * Key differences from web-browser extension:
+ * - Uses puppeteer-extra instead of puppeteer-core
+ * - Applies stealth plugin for comprehensive anti-fingerprinting
+ * - Extra anti-detection Chromium launch args
+ * - Realistic user agent rotation (Chrome 120+ on macOS/Windows)
+ * - WebDriver property removal and chrome.runtime injection
+ * - Human-like typing delay defaults (50ms between keystrokes)
+ *
+ * @module @framers/agentos-ext-stealth-browser
+ * @version 1.0.0
+ * @license MIT
+ */
+import { StealthNavigateTool } from './tools/navigate.js';
+import { StealthScrapeTool } from './tools/scrape.js';
+import { StealthClickTool } from './tools/click.js';
+import { StealthTypeTool } from './tools/type.js';
+import { StealthScreenshotTool } from './tools/screenshot.js';
+import { StealthSnapshotTool } from './tools/snapshot.js';
+import type { StealthBrowserConfig } from './types.js';
+/**
+ * Extension configuration options
+ */
+export interface StealthBrowserExtensionOptions extends StealthBrowserConfig {
+    /** Extension priority in the stack */
+    priority?: number;
+}
+/**
+ * Creates the stealth browser extension pack
+ *
+ * @param context - The extension context
+ * @returns The configured extension pack
+ *
+ * @example
+ * ```typescript
+ * import { createExtensionPack } from '@framers/agentos-ext-stealth-browser';
+ *
+ * const pack = createExtensionPack({
+ *   options: {
+ *     headless: true,
+ *     timeout: 30000,
+ *     viewport: { width: 1920, height: 1080 }
+ *   },
+ *   logger: console
+ * });
+ * ```
+ */
+export declare function createExtensionPack(context: {
+    options?: Record<string, unknown>;
+    secrets?: Record<string, string>;
+    logger?: {
+        info: (...args: unknown[]) => void;
+    };
+    onActivate?: () => Promise<void>;
+    onDeactivate?: () => Promise<void>;
+    [key: string]: unknown;
+}): {
+    name: string;
+    version: string;
+    descriptors: ({
+        id: string;
+        kind: string;
+        priority: number;
+        payload: StealthNavigateTool;
+    } | {
+        id: string;
+        kind: string;
+        priority: number;
+        payload: StealthScrapeTool;
+    } | {
+        id: string;
+        kind: string;
+        priority: number;
+        payload: StealthClickTool;
+    } | {
+        id: string;
+        kind: string;
+        priority: number;
+        payload: StealthTypeTool;
+    } | {
+        id: string;
+        kind: string;
+        priority: number;
+        payload: StealthScreenshotTool;
+    } | {
+        id: string;
+        kind: string;
+        priority: number;
+        payload: StealthSnapshotTool;
+    })[];
+    /**
+     * Called when extension is activated
+     */
+    onActivate: () => Promise<void>;
+    /**
+     * Called when extension is deactivated
+     */
+    onDeactivate: () => Promise<void>;
+};
+export { StealthBrowserService } from './StealthBrowserService.js';
+export { StealthNavigateTool } from './tools/navigate.js';
+export { StealthScrapeTool } from './tools/scrape.js';
+export { StealthClickTool } from './tools/click.js';
+export { StealthTypeTool } from './tools/type.js';
+export { StealthScreenshotTool } from './tools/screenshot.js';
+export { StealthSnapshotTool } from './tools/snapshot.js';
+export * from './types.js';
+export default createExtensionPack;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,oBAAoB;IAC1E,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;KAAE,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA+DG;;OAEG;;IAQH;;OAEG;;EASN;AAGD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,cAAc,YAAY,CAAC;AAG3B,eAAe,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,139 @@
+// @ts-nocheck
+/**
+ * AgentOS Stealth Browser Extension
+ *
+ * Provides stealth browser automation using puppeteer-extra with the stealth plugin
+ * to bypass anti-bot detection on sites like Amazon, eBay, LinkedIn, and Cloudflare-
+ * protected pages.
+ *
+ * Key differences from web-browser extension:
+ * - Uses puppeteer-extra instead of puppeteer-core
+ * - Applies stealth plugin for comprehensive anti-fingerprinting
+ * - Extra anti-detection Chromium launch args
+ * - Realistic user agent rotation (Chrome 120+ on macOS/Windows)
+ * - WebDriver property removal and chrome.runtime injection
+ * - Human-like typing delay defaults (50ms between keystrokes)
+ *
+ * @module @framers/agentos-ext-stealth-browser
+ * @version 1.0.0
+ * @license MIT
+ */
+import { StealthBrowserService } from './StealthBrowserService.js';
+import { StealthNavigateTool } from './tools/navigate.js';
+import { StealthScrapeTool } from './tools/scrape.js';
+import { StealthClickTool } from './tools/click.js';
+import { StealthTypeTool } from './tools/type.js';
+import { StealthScreenshotTool } from './tools/screenshot.js';
+import { StealthSnapshotTool } from './tools/snapshot.js';
+/**
+ * Creates the stealth browser extension pack
+ *
+ * @param context - The extension context
+ * @returns The configured extension pack
+ *
+ * @example
+ * ```typescript
+ * import { createExtensionPack } from '@framers/agentos-ext-stealth-browser';
+ *
+ * const pack = createExtensionPack({
+ *   options: {
+ *     headless: true,
+ *     timeout: 30000,
+ *     viewport: { width: 1920, height: 1080 }
+ *   },
+ *   logger: console
+ * });
+ * ```
+ */
+export function createExtensionPack(context) {
+    const options = context.options || {};
+    // Initialize stealth browser service with configuration
+    const browserService = new StealthBrowserService({
+        headless: options.headless,
+        timeout: options.timeout,
+        userAgent: options.userAgent,
+        viewport: options.viewport,
+        executablePath: options.executablePath,
+        enableEvasions: options.enableEvasions,
+    });
+    // Create tool instances
+    const navigateTool = new StealthNavigateTool(browserService);
+    const scrapeTool = new StealthScrapeTool(browserService);
+    const clickTool = new StealthClickTool(browserService);
+    const typeTool = new StealthTypeTool(browserService);
+    const screenshotTool = new StealthScreenshotTool(browserService);
+    const snapshotTool = new StealthSnapshotTool(browserService);
+    return {
+        name: '@framers/agentos-ext-stealth-browser',
+        version: '1.0.0',
+        descriptors: [
+            {
+                id: navigateTool.name,
+                kind: 'tool',
+                priority: options.priority || 50,
+                payload: navigateTool,
+            },
+            {
+                id: scrapeTool.name,
+                kind: 'tool',
+                priority: options.priority || 50,
+                payload: scrapeTool,
+            },
+            {
+                id: clickTool.name,
+                kind: 'tool',
+                priority: options.priority || 50,
+                payload: clickTool,
+            },
+            {
+                id: typeTool.name,
+                kind: 'tool',
+                priority: options.priority || 50,
+                payload: typeTool,
+            },
+            {
+                id: screenshotTool.name,
+                kind: 'tool',
+                priority: options.priority || 50,
+                payload: screenshotTool,
+            },
+            {
+                id: snapshotTool.name,
+                kind: 'tool',
+                priority: options.priority || 50,
+                payload: snapshotTool,
+            },
+        ],
+        /**
+         * Called when extension is activated
+         */
+        onActivate: async () => {
+            if (context.onActivate) {
+                await context.onActivate();
+            }
+            context.logger?.info('Stealth Browser Extension activated');
+        },
+        /**
+         * Called when extension is deactivated
+         */
+        onDeactivate: async () => {
+            await browserService.close();
+            if (context.onDeactivate) {
+                await context.onDeactivate();
+            }
+            context.logger?.info('Stealth Browser Extension deactivated');
+        },
+    };
+}
+// Export types and classes for consumers
+export { StealthBrowserService } from './StealthBrowserService.js';
+export { StealthNavigateTool } from './tools/navigate.js';
+export { StealthScrapeTool } from './tools/scrape.js';
+export { StealthClickTool } from './tools/click.js';
+export { StealthTypeTool } from './tools/type.js';
+export { StealthScreenshotTool } from './tools/screenshot.js';
+export { StealthSnapshotTool } from './tools/snapshot.js';
+export * from './types.js';
+// Default export for convenience
+export default createExtensionPack;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/click.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Stealth Click Tool
+ * Click on elements in bot-protected pages with human-like behavior.
+ *
+ * @module @framers/agentos-ext-stealth-browser
+ */
+import type { ITool, JSONSchemaObject, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { StealthBrowserService } from '../StealthBrowserService.js';
+import type { ClickResult } from '../types.js';
+/**
+ * Tool for clicking elements in stealth browser
+ */
+export declare class StealthClickTool implements ITool {
+    private browserService;
+    readonly id = "stealth-browser-click-v1";
+    /** Tool call name used by the LLM / ToolExecutor. */
+    readonly name = "stealth_click";
+    readonly displayName = "Stealth Click";
+    readonly description: string;
+    readonly category = "research";
+    readonly hasSideEffects = true;
+    readonly inputSchema: JSONSchemaObject;
+    constructor(browserService: StealthBrowserService);
+    /**
+     * Execute stealth click
+     */
+    execute(input: {
+        selector: string;
+        waitForNavigation?: boolean;
+    }, _context: ToolExecutionContext): Promise<ToolExecutionResult<ClickResult>>;
+    /**
+     * Validate input
+     */
+    validateArgs(input: Record<string, any>): {
+        isValid: boolean;
+        errors?: any[];
+    };
+}
+//# sourceMappingURL=click.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"click.d.ts","sourceRoot":"","sources":["../../src/tools/click.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C;;GAEG;AACH,qBAAa,gBAAiB,YAAW,KAAK;IA4BhC,OAAO,CAAC,cAAc;IA3BlC,SAAgB,EAAE,8BAA8B;IAChD,qDAAqD;IACrD,SAAgB,IAAI,mBAAmB;IACvC,SAAgB,WAAW,mBAAmB;IAC9C,SAAgB,WAAW,SAEoD;IAC/E,SAAgB,QAAQ,cAAc;IACtC,SAAgB,cAAc,QAAQ;IAEtC,SAAgB,WAAW,EAAE,gBAAgB,CAe3C;gBAEkB,cAAc,EAAE,qBAAqB;IAEzD;;OAEG;IACG,OAAO,CACX,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAE,EACxD,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAgB5C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE;CAW/E"}

package/dist/tools/click.js

@@ -0,0 +1,72 @@
+// @ts-nocheck
+/**
+ * Stealth Click Tool
+ * Click on elements in bot-protected pages with human-like behavior.
+ *
+ * @module @framers/agentos-ext-stealth-browser
+ */
+/**
+ * Tool for clicking elements in stealth browser
+ */
+export class StealthClickTool {
+    browserService;
+    id = 'stealth-browser-click-v1';
+    /** Tool call name used by the LLM / ToolExecutor. */
+    name = 'stealth_click';
+    displayName = 'Stealth Click';
+    description = 'Click an element in the stealth browser using a CSS selector. ' +
+        'Waits for element visibility before clicking. Use for bot-protected sites.';
+    category = 'research';
+    hasSideEffects = true;
+    inputSchema = {
+        type: 'object',
+        required: ['selector'],
+        properties: {
+            selector: {
+                type: 'string',
+                description: 'CSS selector for the element to click',
+            },
+            waitForNavigation: {
+                type: 'boolean',
+                default: false,
+                description: 'Wait for page navigation after click',
+            },
+        },
+        additionalProperties: false,
+    };
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    /**
+     * Execute stealth click
+     */
+    async execute(input, _context) {
+        try {
+            const result = await this.browserService.click(input.selector, {
+                waitForNavigation: input.waitForNavigation,
+            });
+            return {
+                success: result.success,
+                output: result,
+                error: result.success ? undefined : 'Click failed',
+            };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    /**
+     * Validate input
+     */
+    validateArgs(input) {
+        const errors = [];
+        if (!input.selector) {
+            errors.push('Selector is required');
+        }
+        else if (typeof input.selector !== 'string') {
+            errors.push('Selector must be a string');
+        }
+        return errors.length === 0 ? { isValid: true } : { isValid: false, errors };
+    }
+}
+//# sourceMappingURL=click.js.map

package/dist/tools/click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click.js","sourceRoot":"","sources":["../../src/tools/click.ts"],"names":[],"mappings":"AAAA,cAAc;AACd;;;;;GAKG;AAMH;;GAEG;AACH,MAAM,OAAO,gBAAgB;IA4BP;IA3BJ,EAAE,GAAG,0BAA0B,CAAC;IAChD,qDAAqD;IACrC,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,eAAe,CAAC;IAC9B,WAAW,GACzB,gEAAgE;QAChE,4EAA4E,CAAC;IAC/D,QAAQ,GAAG,UAAU,CAAC;IACtB,cAAc,GAAG,IAAI,CAAC;IAEtB,WAAW,GAAqB;QAC9C,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,UAAU,CAAC;QACtB,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,uCAAuC;aACrD;YACD,iBAAiB,EAAE;gBACjB,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,sCAAsC;aACpD;SACF;QACD,oBAAoB,EAAE,KAAK;KAC5B,CAAC;IAEF,YAAoB,cAAqC;QAArC,mBAAc,GAAd,cAAc,CAAuB;IAAG,CAAC;IAE7D;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,KAAwD,EACxD,QAA8B;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE;gBAC7D,iBAAiB,EAAE,KAAK,CAAC,iBAAiB;aAC3C,CAAC,CAAC;YAEH,OAAO;gBACL,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc;aACnD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAA0B;QACrC,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,CAAC;aAAM,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC3C,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC9E,CAAC;CACF"}

package/dist/tools/navigate.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Stealth Navigate Tool
+ * Navigate stealth browser to a URL with anti-detection, bypassing bot protection.
+ *
+ * @module @framers/agentos-ext-stealth-browser
+ */
+import type { ITool, JSONSchemaObject, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { StealthBrowserService } from '../StealthBrowserService.js';
+import type { NavigationResult } from '../types.js';
+/**
+ * Tool for stealth navigation to URLs on bot-protected sites
+ */
+export declare class StealthNavigateTool implements ITool {
+    private browserService;
+    readonly id = "stealth-browser-navigate-v1";
+    /** Tool call name used by the LLM / ToolExecutor. */
+    readonly name = "stealth_navigate";
+    readonly displayName = "Stealth Navigate";
+    readonly description: string;
+    readonly category = "research";
+    readonly hasSideEffects = false;
+    readonly inputSchema: JSONSchemaObject;
+    constructor(browserService: StealthBrowserService);
+    /**
+     * Execute stealth navigation
+     */
+    execute(input: {
+        url: string;
+        waitFor?: 'load' | 'domcontentloaded' | 'networkidle0' | 'networkidle2';
+        returnHtml?: boolean;
+        returnText?: boolean;
+        returnLinks?: boolean;
+        maxTextLength?: number;
+    }, _context: ToolExecutionContext): Promise<ToolExecutionResult<NavigationResult>>;
+    /**
+     * Validate input
+     */
+    validateArgs(input: Record<string, any>): {
+        isValid: boolean;
+        errors?: any[];
+    };
+}
+//# sourceMappingURL=navigate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"navigate.d.ts","sourceRoot":"","sources":["../../src/tools/navigate.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;GAEG;AACH,qBAAa,mBAAoB,YAAW,KAAK;IAmDnC,OAAO,CAAC,cAAc;IAlDlC,SAAgB,EAAE,iCAAiC;IACnD,qDAAqD;IACrD,SAAgB,IAAI,sBAAsB;IAC1C,SAAgB,WAAW,sBAAsB;IACjD,SAAgB,WAAW,SAIiC;IAC5D,SAAgB,QAAQ,cAAc;IACtC,SAAgB,cAAc,SAAS;IAEvC,SAAgB,WAAW,EAAE,gBAAgB,CAoC3C;gBAEkB,cAAc,EAAE,qBAAqB;IAEzD;;OAEG;IACG,OAAO,CACX,KAAK,EAAE;QACL,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,cAAc,GAAG,cAAc,CAAC;QACxE,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EACD,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IA8DjD;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE;CAiB/E"}

package/dist/tools/navigate.js

@@ -0,0 +1,142 @@
+// @ts-nocheck
+/**
+ * Stealth Navigate Tool
+ * Navigate stealth browser to a URL with anti-detection, bypassing bot protection.
+ *
+ * @module @framers/agentos-ext-stealth-browser
+ */
+/**
+ * Tool for stealth navigation to URLs on bot-protected sites
+ */
+export class StealthNavigateTool {
+    browserService;
+    id = 'stealth-browser-navigate-v1';
+    /** Tool call name used by the LLM / ToolExecutor. */
+    name = 'stealth_navigate';
+    displayName = 'Stealth Navigate';
+    description = 'Navigate stealth browser to a URL with anti-bot-detection enabled. ' +
+        'Use this instead of browser_navigate for sites that block headless browsers ' +
+        '(Amazon, eBay, LinkedIn, Cloudflare-protected sites, etc.). ' +
+        'Returns full page text, links, and optionally raw HTML.';
+    category = 'research';
+    hasSideEffects = false;
+    inputSchema = {
+        type: 'object',
+        required: ['url'],
+        properties: {
+            url: {
+                type: 'string',
+                description: 'The URL to navigate to',
+            },
+            waitFor: {
+                type: 'string',
+                enum: ['load', 'domcontentloaded', 'networkidle0', 'networkidle2'],
+                default: 'networkidle2',
+                description: 'When to consider navigation complete',
+            },
+            returnHtml: {
+                type: 'boolean',
+                default: false,
+                description: 'Include full HTML in response',
+            },
+            returnText: {
+                type: 'boolean',
+                default: true,
+                description: 'Include extracted text in response',
+            },
+            returnLinks: {
+                type: 'boolean',
+                default: true,
+                description: 'Include all links found on the page (text + href)',
+            },
+            maxTextLength: {
+                type: 'number',
+                default: 50000,
+                description: 'Maximum characters of page text to return (default 50000)',
+            },
+        },
+        additionalProperties: false,
+    };
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    /**
+     * Execute stealth navigation
+     */
+    async execute(input, _context) {
+        try {
+            const result = await this.browserService.navigate(input.url, {
+                waitFor: input.waitFor,
+            });
+            const maxLen = typeof input.maxTextLength === 'number' && input.maxTextLength > 0
+                ? input.maxTextLength
+                : 50000;
+            const output = {
+                url: result.url,
+                status: result.status,
+                title: result.title,
+                loadTime: result.loadTime,
+                consoleMessages: result.consoleMessages,
+            };
+            if (input.returnHtml) {
+                output.html = result.html;
+            }
+            if (input.returnText !== false) {
+                const fullLen = result.text?.length || 0;
+                if (fullLen > maxLen) {
+                    output.text = result.text.slice(0, maxLen);
+                    output.textTruncated = true;
+                    output.fullTextLength = fullLen;
+                    output.truncationNote =
+                        `Page text was ${fullLen.toLocaleString()} characters, truncated to ${maxLen.toLocaleString()}. ` +
+                            `To get content from specific sections, use stealth_scrape with a CSS selector (e.g. 'footer', 'main', '#content'). ` +
+                            `Or increase maxTextLength parameter.`;
+                }
+                else {
+                    output.text = result.text;
+                }
+            }
+            // Extract and return all links from the page (default: on)
+            if (input.returnLinks !== false) {
+                try {
+                    const links = await this.browserService.evaluate(() => Array.from(document.querySelectorAll('a[href]'))
+                        .map((a) => ({
+                        text: (a.textContent || '').trim().slice(0, 200),
+                        href: a.href,
+                    }))
+                        .filter((l) => l.href && l.text));
+                    output.links = links;
+                }
+                catch {
+                    // Non-fatal — page may have restrictive CSP
+                }
+            }
+            return { success: true, output };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    /**
+     * Validate input
+     */
+    validateArgs(input) {
+        const errors = [];
+        if (!input.url) {
+            errors.push('URL is required');
+        }
+        else if (typeof input.url !== 'string') {
+            errors.push('URL must be a string');
+        }
+        else {
+            try {
+                new URL(input.url);
+            }
+            catch {
+                errors.push('Invalid URL format');
+            }
+        }
+        return errors.length === 0 ? { isValid: true } : { isValid: false, errors };
+    }
+}
+//# sourceMappingURL=navigate.js.map

package/dist/tools/navigate.js.map

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

package/dist/tools/scrape.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Stealth Scrape Tool
+ * Extract content from bot-protected pages using CSS selectors with stealth browser.
+ *
+ * @module @framers/agentos-ext-stealth-browser
+ */
+import type { ITool, JSONSchemaObject, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { StealthBrowserService } from '../StealthBrowserService.js';
+import type { ScrapeResult } from '../types.js';
+/**
+ * Tool for scraping content from bot-protected pages
+ */
+export declare class StealthScrapeTool implements ITool {
+    private browserService;
+    readonly id = "stealth-browser-scrape-v1";
+    /** Tool call name used by the LLM / ToolExecutor. */
+    readonly name = "stealth_scrape";
+    readonly displayName = "Stealth Scrape";
+    readonly description: string;
+    readonly category = "research";
+    readonly hasSideEffects = false;
+    readonly inputSchema: JSONSchemaObject;
+    constructor(browserService: StealthBrowserService);
+    /**
+     * Execute stealth scraping
+     */
+    execute(input: {
+        selector: string;
+        limit?: number;
+        attributes?: string[];
+    }, _context: ToolExecutionContext): Promise<ToolExecutionResult<ScrapeResult>>;
+    /**
+     * Validate input
+     */
+    validateArgs(input: Record<string, any>): {
+        isValid: boolean;
+        errors?: any[];
+    };
+}
+//# sourceMappingURL=scrape.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrape.d.ts","sourceRoot":"","sources":["../../src/tools/scrape.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC3G,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,qBAAa,iBAAkB,YAAW,KAAK;IAiCjC,OAAO,CAAC,cAAc;IAhClC,SAAgB,EAAE,+BAA+B;IACjD,qDAAqD;IACrD,SAAgB,IAAI,oBAAoB;IACxC,SAAgB,WAAW,oBAAoB;IAC/C,SAAgB,WAAW,SAEiD;IAC5E,SAAgB,QAAQ,cAAc;IACtC,SAAgB,cAAc,SAAS;IAEvC,SAAgB,WAAW,EAAE,gBAAgB,CAoB3C;gBAEkB,cAAc,EAAE,qBAAqB;IAEzD;;OAEG;IACG,OAAO,CACX,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,EAClE,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;IA4B7C;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE;CAiB/E"}