@framers/agentos-ext-browser-automation 0.1.0

package/dist/captcha/CaptchaSolver.js

@@ -0,0 +1,91 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview 2captcha integration for solving CAPTCHAs.
+ *
+ * Supports reCAPTCHA v2/v3, hCaptcha, Cloudflare Turnstile, and image captchas.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptchaSolver = void 0;
+class CaptchaSolver {
+    constructor(apiKey) {
+        this.name = '2captcha';
+        this.baseUrl = 'https://2captcha.com';
+        this.apiKey = apiKey;
+    }
+    async solveRecaptchaV2(siteKey, pageUrl) {
+        return this.solve({
+            method: 'userrecaptcha',
+            googlekey: siteKey,
+            pageurl: pageUrl,
+        });
+    }
+    async solveRecaptchaV3(siteKey, pageUrl, action = 'verify') {
+        return this.solve({
+            method: 'userrecaptcha',
+            googlekey: siteKey,
+            pageurl: pageUrl,
+            version: 'v3',
+            action,
+            min_score: '0.7',
+        });
+    }
+    async solveHCaptcha(siteKey, pageUrl) {
+        return this.solve({
+            method: 'hcaptcha',
+            sitekey: siteKey,
+            pageurl: pageUrl,
+        });
+    }
+    async solveTurnstile(siteKey, pageUrl) {
+        return this.solve({
+            method: 'turnstile',
+            sitekey: siteKey,
+            pageurl: pageUrl,
+        });
+    }
+    async solveImage(imageBase64) {
+        const result = await this.solve({
+            method: 'base64',
+            body: imageBase64,
+        });
+        return result.token;
+    }
+    async getBalance() {
+        const url = `${this.baseUrl}/res.php?key=${this.apiKey}&action=getbalance&json=1`;
+        const res = await fetch(url);
+        const data = await res.json();
+        return parseFloat(data.request) || 0;
+    }
+    // ── Internal ──
+    async solve(params) {
+        const start = Date.now();
+        // Submit task
+        const submitUrl = `${this.baseUrl}/in.php`;
+        const body = new URLSearchParams({ key: this.apiKey, json: '1', ...params });
+        const submitRes = await fetch(submitUrl, { method: 'POST', body });
+        const submitData = await submitRes.json();
+        if (submitData.status !== 1) {
+            throw new Error(`2captcha submit failed: ${submitData.request}`);
+        }
+        const taskId = submitData.request;
+        // Poll for result
+        const resultUrl = `${this.baseUrl}/res.php?key=${this.apiKey}&action=get&id=${taskId}&json=1`;
+        const maxAttempts = 60;
+        const pollInterval = 5000;
+        for (let i = 0; i < maxAttempts; i++) {
+            await new Promise((r) => setTimeout(r, pollInterval));
+            const res = await fetch(resultUrl);
+            const data = await res.json();
+            if (data.status === 1) {
+                return { token: data.request, solveTimeMs: Date.now() - start };
+            }
+            if (data.request !== 'CAPCHA_NOT_READY') {
+                throw new Error(`2captcha solve failed: ${data.request}`);
+            }
+        }
+        throw new Error('2captcha solve timed out');
+    }
+}
+exports.CaptchaSolver = CaptchaSolver;
+//# sourceMappingURL=CaptchaSolver.js.map

package/dist/captcha/CaptchaSolver.js.map

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

package/dist/captcha/ICaptchaProvider.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Interface for captcha solving services.
+ */
+export interface CaptchaSolution {
+    token: string;
+    solveTimeMs: number;
+}
+export interface ICaptchaProvider {
+    readonly name: string;
+    solveRecaptchaV2(siteKey: string, pageUrl: string): Promise<CaptchaSolution>;
+    solveRecaptchaV3(siteKey: string, pageUrl: string, action?: string): Promise<CaptchaSolution>;
+    solveHCaptcha(siteKey: string, pageUrl: string): Promise<CaptchaSolution>;
+    solveTurnstile(siteKey: string, pageUrl: string): Promise<CaptchaSolution>;
+    solveImage(imageBase64: string): Promise<string>;
+    getBalance(): Promise<number>;
+}
+//# sourceMappingURL=ICaptchaProvider.d.ts.map

package/dist/captcha/ICaptchaProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICaptchaProvider.d.ts","sourceRoot":"","sources":["../../src/captcha/ICaptchaProvider.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7E,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC9F,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC1E,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC3E,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC/B"}

package/dist/captcha/ICaptchaProvider.js

@@ -0,0 +1,7 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview Interface for captcha solving services.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ICaptchaProvider.js.map

package/dist/captcha/ICaptchaProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICaptchaProvider.js","sourceRoot":"","sources":["../../src/captcha/ICaptchaProvider.ts"],"names":[],"mappings":";AAAA,cAAc;AACd;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Browser Automation Extension for AgentOS.
+ *
+ * Provides 10 tools for autonomous web browsing: navigation, DOM interaction,
+ * screenshots, content extraction, page snapshots, JS evaluation, and session
+ * management. Includes optional CAPTCHA solving and proxy rotation.
+ *
+ * @module @framers/agentos-ext-browser-automation
+ */
+import { BrowserService } from './BrowserService.js';
+import { CaptchaSolver } from './captcha/CaptchaSolver.js';
+import { ProxyManager } from './proxy/ProxyManager.js';
+export interface BrowserAutomationOptions {
+    headless?: boolean;
+    timeout?: number;
+    userDataDir?: string;
+    proxyServer?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    secrets?: Record<string, string>;
+}
+export interface ExtensionContext {
+    options?: Record<string, unknown>;
+    secrets?: Record<string, string>;
+}
+export interface ExtensionPack {
+    name: string;
+    version: string;
+    descriptors: Array<{
+        id: string;
+        kind: string;
+        priority?: number;
+        enableByDefault?: boolean;
+        payload: unknown;
+    }>;
+    onActivate?: () => Promise<void>;
+    onDeactivate?: () => Promise<void>;
+}
+export declare function createExtensionPack(context: ExtensionContext): ExtensionPack;
+export { BrowserService } from './BrowserService.js';
+export type { BrowserConfig, NavigationResult, PageSnapshot, InteractiveElement, FormInfo, LinkInfo, PageFeedback, StorageState } from './BrowserService.js';
+export { CaptchaSolver } from './captcha/CaptchaSolver.js';
+export type { ICaptchaProvider, CaptchaSolution } from './captcha/ICaptchaProvider.js';
+export { ProxyManager } from './proxy/ProxyManager.js';
+export type { IProxyProvider, ProxyConfig, ProxyRotationConfig } from './proxy/IProxyProvider.js';
+export { NavigateTool } from './tools/NavigateTool.js';
+export { ClickTool } from './tools/ClickTool.js';
+export { FillTool } from './tools/FillTool.js';
+export { ScreenshotTool } from './tools/ScreenshotTool.js';
+export { ExtractTool } from './tools/ExtractTool.js';
+export { WaitTool } from './tools/WaitTool.js';
+export { ScrollTool } from './tools/ScrollTool.js';
+export { PageSnapshotTool } from './tools/PageSnapshotTool.js';
+export { EvaluateTool } from './tools/EvaluateTool.js';
+export { SessionTool } from './tools/SessionTool.js';
+/** Get the shared browser instance (available after extension activation). */
+export declare function getSharedBrowser(): BrowserService | null;
+/** Get the shared captcha solver (available if API key is configured). */
+export declare function getSharedCaptcha(): CaptchaSolver | null;
+/** Get the shared proxy manager (available if proxy config is set). */
+export declare function getSharedProxy(): ProxyManager | null;
+//# 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;;;;;;;;GAQG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAYrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAMD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,KAAK,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAcD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAuE5E;AAMD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,kBAAkB,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC7J,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,8EAA8E;AAC9E,wBAAgB,gBAAgB,IAAI,cAAc,GAAG,IAAI,CAExD;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD;AAED,uEAAuE;AACvE,wBAAgB,cAAc,IAAI,YAAY,GAAG,IAAI,CAEpD"}

package/dist/index.js

@@ -0,0 +1,148 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview Browser Automation Extension for AgentOS.
+ *
+ * Provides 10 tools for autonomous web browsing: navigation, DOM interaction,
+ * screenshots, content extraction, page snapshots, JS evaluation, and session
+ * management. Includes optional CAPTCHA solving and proxy rotation.
+ *
+ * @module @framers/agentos-ext-browser-automation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionTool = exports.EvaluateTool = exports.PageSnapshotTool = exports.ScrollTool = exports.WaitTool = exports.ExtractTool = exports.ScreenshotTool = exports.FillTool = exports.ClickTool = exports.NavigateTool = exports.ProxyManager = exports.CaptchaSolver = exports.BrowserService = void 0;
+exports.createExtensionPack = createExtensionPack;
+exports.getSharedBrowser = getSharedBrowser;
+exports.getSharedCaptcha = getSharedCaptcha;
+exports.getSharedProxy = getSharedProxy;
+const BrowserService_js_1 = require("./BrowserService.js");
+const NavigateTool_js_1 = require("./tools/NavigateTool.js");
+const ClickTool_js_1 = require("./tools/ClickTool.js");
+const FillTool_js_1 = require("./tools/FillTool.js");
+const ScreenshotTool_js_1 = require("./tools/ScreenshotTool.js");
+const ExtractTool_js_1 = require("./tools/ExtractTool.js");
+const WaitTool_js_1 = require("./tools/WaitTool.js");
+const ScrollTool_js_1 = require("./tools/ScrollTool.js");
+const PageSnapshotTool_js_1 = require("./tools/PageSnapshotTool.js");
+const EvaluateTool_js_1 = require("./tools/EvaluateTool.js");
+const SessionTool_js_1 = require("./tools/SessionTool.js");
+const CaptchaSolver_js_1 = require("./captcha/CaptchaSolver.js");
+const ProxyManager_js_1 = require("./proxy/ProxyManager.js");
+// ---------------------------------------------------------------------------
+// Singleton browser instance (shared across all tools)
+// ---------------------------------------------------------------------------
+let sharedBrowser = null;
+let sharedCaptcha = null;
+let sharedProxy = null;
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+function createExtensionPack(context) {
+    const opts = (context.options ?? {});
+    const secrets = opts.secrets ?? context.secrets ?? {};
+    // Resolve config
+    const config = {
+        headless: opts.headless ?? true,
+        timeout: opts.timeout ?? 30000,
+        userDataDir: opts.userDataDir,
+        proxyServer: opts.proxyServer,
+        viewport: opts.viewport ?? { width: 1280, height: 720 },
+    };
+    // Create shared service
+    const browser = new BrowserService_js_1.BrowserService(config);
+    sharedBrowser = browser;
+    // Optional captcha solver
+    const captchaKey = secrets['twocaptcha.apiKey'] ?? process.env.TWOCAPTCHA_API_KEY;
+    if (captchaKey) {
+        sharedCaptcha = new CaptchaSolver_js_1.CaptchaSolver(captchaKey);
+    }
+    // Optional proxy manager
+    const proxyConfig = secrets['proxy.config'] ?? process.env.PROXY_CONFIG;
+    if (proxyConfig) {
+        try {
+            const parsed = JSON.parse(proxyConfig);
+            sharedProxy = new ProxyManager_js_1.ProxyManager(parsed);
+        }
+        catch {
+            // Invalid proxy config — skip
+        }
+    }
+    // Create tools
+    const navigateTool = new NavigateTool_js_1.NavigateTool(browser);
+    const clickTool = new ClickTool_js_1.ClickTool(browser);
+    const fillTool = new FillTool_js_1.FillTool(browser);
+    const screenshotTool = new ScreenshotTool_js_1.ScreenshotTool(browser);
+    const extractTool = new ExtractTool_js_1.ExtractTool(browser);
+    const waitTool = new WaitTool_js_1.WaitTool(browser);
+    const scrollTool = new ScrollTool_js_1.ScrollTool(browser);
+    const snapshotTool = new PageSnapshotTool_js_1.PageSnapshotTool(browser);
+    const evaluateTool = new EvaluateTool_js_1.EvaluateTool(browser);
+    const sessionTool = new SessionTool_js_1.SessionTool(browser);
+    return {
+        name: '@framers/agentos-ext-browser-automation',
+        version: '0.1.0',
+        descriptors: [
+            { id: 'browserNavigate', kind: 'tool', priority: 50, payload: navigateTool },
+            { id: 'browserClick', kind: 'tool', priority: 50, payload: clickTool },
+            { id: 'browserFill', kind: 'tool', priority: 50, payload: fillTool },
+            { id: 'browserScreenshot', kind: 'tool', priority: 50, payload: screenshotTool },
+            { id: 'browserExtract', kind: 'tool', priority: 50, payload: extractTool },
+            { id: 'browserWait', kind: 'tool', priority: 50, payload: waitTool },
+            { id: 'browserScroll', kind: 'tool', priority: 50, payload: scrollTool },
+            { id: 'browserSnapshot', kind: 'tool', priority: 50, payload: snapshotTool },
+            { id: 'browserEvaluate', kind: 'tool', priority: 50, payload: evaluateTool },
+            { id: 'browserSession', kind: 'tool', priority: 50, payload: sessionTool },
+        ],
+        onActivate: async () => {
+            await browser.initialize();
+        },
+        onDeactivate: async () => {
+            await browser.shutdown();
+            sharedBrowser = null;
+            sharedCaptcha = null;
+            sharedProxy = null;
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Public exports
+// ---------------------------------------------------------------------------
+var BrowserService_js_2 = require("./BrowserService.js");
+Object.defineProperty(exports, "BrowserService", { enumerable: true, get: function () { return BrowserService_js_2.BrowserService; } });
+var CaptchaSolver_js_2 = require("./captcha/CaptchaSolver.js");
+Object.defineProperty(exports, "CaptchaSolver", { enumerable: true, get: function () { return CaptchaSolver_js_2.CaptchaSolver; } });
+var ProxyManager_js_2 = require("./proxy/ProxyManager.js");
+Object.defineProperty(exports, "ProxyManager", { enumerable: true, get: function () { return ProxyManager_js_2.ProxyManager; } });
+var NavigateTool_js_2 = require("./tools/NavigateTool.js");
+Object.defineProperty(exports, "NavigateTool", { enumerable: true, get: function () { return NavigateTool_js_2.NavigateTool; } });
+var ClickTool_js_2 = require("./tools/ClickTool.js");
+Object.defineProperty(exports, "ClickTool", { enumerable: true, get: function () { return ClickTool_js_2.ClickTool; } });
+var FillTool_js_2 = require("./tools/FillTool.js");
+Object.defineProperty(exports, "FillTool", { enumerable: true, get: function () { return FillTool_js_2.FillTool; } });
+var ScreenshotTool_js_2 = require("./tools/ScreenshotTool.js");
+Object.defineProperty(exports, "ScreenshotTool", { enumerable: true, get: function () { return ScreenshotTool_js_2.ScreenshotTool; } });
+var ExtractTool_js_2 = require("./tools/ExtractTool.js");
+Object.defineProperty(exports, "ExtractTool", { enumerable: true, get: function () { return ExtractTool_js_2.ExtractTool; } });
+var WaitTool_js_2 = require("./tools/WaitTool.js");
+Object.defineProperty(exports, "WaitTool", { enumerable: true, get: function () { return WaitTool_js_2.WaitTool; } });
+var ScrollTool_js_2 = require("./tools/ScrollTool.js");
+Object.defineProperty(exports, "ScrollTool", { enumerable: true, get: function () { return ScrollTool_js_2.ScrollTool; } });
+var PageSnapshotTool_js_2 = require("./tools/PageSnapshotTool.js");
+Object.defineProperty(exports, "PageSnapshotTool", { enumerable: true, get: function () { return PageSnapshotTool_js_2.PageSnapshotTool; } });
+var EvaluateTool_js_2 = require("./tools/EvaluateTool.js");
+Object.defineProperty(exports, "EvaluateTool", { enumerable: true, get: function () { return EvaluateTool_js_2.EvaluateTool; } });
+var SessionTool_js_2 = require("./tools/SessionTool.js");
+Object.defineProperty(exports, "SessionTool", { enumerable: true, get: function () { return SessionTool_js_2.SessionTool; } });
+/** Get the shared browser instance (available after extension activation). */
+function getSharedBrowser() {
+    return sharedBrowser;
+}
+/** Get the shared captcha solver (available if API key is configured). */
+function getSharedCaptcha() {
+    return sharedCaptcha;
+}
+/** Get the shared proxy manager (available if proxy config is set). */
+function getSharedProxy() {
+    return sharedProxy;
+}
+//# 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/proxy/IProxyProvider.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Interface for proxy services.
+ */
+export interface ProxyConfig {
+    server: string;
+    username?: string;
+    password?: string;
+}
+export interface ProxyRotationConfig {
+    providers: ProxyConfig[];
+    rotationStrategy: 'round-robin' | 'random' | 'sticky';
+    stickyDurationMs?: number;
+    geoTarget?: string;
+}
+export interface IProxyProvider {
+    getProxy(): ProxyConfig;
+    rotateProxy(): ProxyConfig;
+    markFailed(server: string): void;
+}
+//# sourceMappingURL=IProxyProvider.d.ts.map

package/dist/proxy/IProxyProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProxyProvider.d.ts","sourceRoot":"","sources":["../../src/proxy/IProxyProvider.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,gBAAgB,EAAE,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACtD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,IAAI,WAAW,CAAC;IACxB,WAAW,IAAI,WAAW,CAAC;IAC3B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC"}

package/dist/proxy/IProxyProvider.js

@@ -0,0 +1,7 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview Interface for proxy services.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IProxyProvider.js.map

package/dist/proxy/IProxyProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IProxyProvider.js","sourceRoot":"","sources":["../../src/proxy/IProxyProvider.ts"],"names":[],"mappings":";AAAA,cAAc;AACd;;GAEG"}

package/dist/proxy/ProxyManager.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Proxy rotation manager with round-robin, random, and sticky strategies.
+ */
+import type { IProxyProvider, ProxyConfig, ProxyRotationConfig } from './IProxyProvider.js';
+export declare class ProxyManager implements IProxyProvider {
+    private config;
+    private currentIndex;
+    private failedServers;
+    private stickyProxy;
+    private stickyExpiry;
+    constructor(config: ProxyRotationConfig);
+    getProxy(): ProxyConfig;
+    rotateProxy(): ProxyConfig;
+    markFailed(server: string): void;
+    getStats(): {
+        total: number;
+        available: number;
+        failed: number;
+    };
+}
+//# sourceMappingURL=ProxyManager.d.ts.map

package/dist/proxy/ProxyManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyManager.d.ts","sourceRoot":"","sources":["../../src/proxy/ProxyManager.ts"],"names":[],"mappings":"AACA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE5F,qBAAa,YAAa,YAAW,cAAc;IACjD,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAAa;gBAErB,MAAM,EAAE,mBAAmB;IAIvC,QAAQ,IAAI,WAAW;IAoCvB,WAAW,IAAI,WAAW;IAO1B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAOhC,QAAQ,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;CAOjE"}

package/dist/proxy/ProxyManager.js

@@ -0,0 +1,67 @@
+"use strict";
+// @ts-nocheck
+/**
+ * @fileoverview Proxy rotation manager with round-robin, random, and sticky strategies.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProxyManager = void 0;
+class ProxyManager {
+    constructor(config) {
+        this.currentIndex = 0;
+        this.failedServers = new Set();
+        this.stickyProxy = null;
+        this.stickyExpiry = 0;
+        this.config = config;
+    }
+    getProxy() {
+        const { rotationStrategy, stickyDurationMs } = this.config;
+        if (rotationStrategy === 'sticky' && this.stickyProxy && Date.now() < this.stickyExpiry) {
+            return this.stickyProxy;
+        }
+        const available = this.config.providers.filter((p) => !this.failedServers.has(p.server));
+        if (available.length === 0) {
+            // Reset failed list if all are failed
+            this.failedServers.clear();
+            return this.config.providers[0];
+        }
+        let proxy;
+        switch (rotationStrategy) {
+            case 'random':
+                proxy = available[Math.floor(Math.random() * available.length)];
+                break;
+            case 'sticky':
+                proxy = available[0];
+                this.stickyProxy = proxy;
+                this.stickyExpiry = Date.now() + (stickyDurationMs ?? 300000);
+                break;
+            case 'round-robin':
+            default:
+                this.currentIndex = this.currentIndex % available.length;
+                proxy = available[this.currentIndex];
+                this.currentIndex++;
+                break;
+        }
+        return proxy;
+    }
+    rotateProxy() {
+        this.stickyProxy = null;
+        this.stickyExpiry = 0;
+        this.currentIndex++;
+        return this.getProxy();
+    }
+    markFailed(server) {
+        this.failedServers.add(server);
+        if (this.stickyProxy?.server === server) {
+            this.stickyProxy = null;
+        }
+    }
+    getStats() {
+        return {
+            total: this.config.providers.length,
+            available: this.config.providers.filter((p) => !this.failedServers.has(p.server)).length,
+            failed: this.failedServers.size,
+        };
+    }
+}
+exports.ProxyManager = ProxyManager;
+//# sourceMappingURL=ProxyManager.js.map

package/dist/proxy/ProxyManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProxyManager.js","sourceRoot":"","sources":["../../src/proxy/ProxyManager.ts"],"names":[],"mappings":";AAAA,cAAc;AACd;;GAEG;;;AAIH,MAAa,YAAY;IAOvB,YAAY,MAA2B;QAL/B,iBAAY,GAAG,CAAC,CAAC;QACjB,kBAAa,GAAgB,IAAI,GAAG,EAAE,CAAC;QACvC,gBAAW,GAAuB,IAAI,CAAC;QACvC,iBAAY,GAAW,CAAC,CAAC;QAG/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,QAAQ;QACN,MAAM,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3D,IAAI,gBAAgB,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACxF,OAAO,IAAI,CAAC,WAAW,CAAC;QAC1B,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QACzF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,sCAAsC;YACtC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,KAAkB,CAAC;QAEvB,QAAQ,gBAAgB,EAAE,CAAC;YACzB,KAAK,QAAQ;gBACX,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;gBAChE,MAAM;YACR,KAAK,QAAQ;gBACX,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;gBACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,gBAAgB,IAAI,MAAO,CAAC,CAAC;gBAC/D,MAAM;YACR,KAAK,aAAa,CAAC;YACnB;gBACE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC;gBACzD,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBACrC,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM;QACV,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,WAAW;QACT,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;YACxC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,QAAQ;QACN,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM;YACnC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;YACxF,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI;SAChC,CAAC;IACJ,CAAC;CACF;AApED,oCAoEC"}

package/dist/tools/ClickTool.d.ts

@@ -0,0 +1,38 @@
+import type { BrowserService } from '../BrowserService.js';
+export declare class ClickTool {
+    private browser;
+    readonly id = "browserClick";
+    readonly name = "browserClick";
+    readonly displayName = "Click Element";
+    readonly description = "Click an element on the page by CSS selector, text content, or ARIA role.";
+    readonly category = "browser";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = true;
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            selector: {
+                type: string;
+                description: string;
+            };
+            text: {
+                type: string;
+                description: string;
+            };
+            role: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(browser: BrowserService);
+    execute(args: {
+        selector?: string;
+        text?: string;
+        role?: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=ClickTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ClickTool.d.ts","sourceRoot":"","sources":["../../src/tools/ClickTool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,qBAAa,SAAS;IAkBR,OAAO,CAAC,OAAO;IAjB3B,QAAQ,CAAC,EAAE,kBAAkB;IAC7B,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,mBAAmB;IACvC,QAAQ,CAAC,WAAW,+EAA+E;IACnG,QAAQ,CAAC,QAAQ,aAAa;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,cAAc,QAAQ;IAE/B,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;MAOlB;gBAEkB,OAAO,EAAE,cAAc;IAErC,OAAO,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAQxH"}

package/dist/tools/ClickTool.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClickTool = void 0;
+class ClickTool {
+    constructor(browser) {
+        this.browser = browser;
+        this.id = 'browserClick';
+        this.name = 'browserClick';
+        this.displayName = 'Click Element';
+        this.description = 'Click an element on the page by CSS selector, text content, or ARIA role.';
+        this.category = 'browser';
+        this.version = '0.1.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            properties: {
+                selector: { type: 'string', description: 'CSS selector of the element to click' },
+                text: { type: 'string', description: 'Text content of the element to click' },
+                role: { type: 'string', description: 'ARIA role of the element (e.g., "button", "link")' },
+            },
+        };
+    }
+    async execute(args) {
+        try {
+            const clicked = await this.browser.click(args);
+            return { success: clicked };
+        }
+        catch (err) {
+            return { success: false, error: err.message };
+        }
+    }
+}
+exports.ClickTool = ClickTool;
+//# sourceMappingURL=ClickTool.js.map

package/dist/tools/ClickTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClickTool.js","sourceRoot":"","sources":["../../src/tools/ClickTool.ts"],"names":[],"mappings":";;;AAGA,MAAa,SAAS;IAkBpB,YAAoB,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;QAjBlC,OAAE,GAAG,cAAc,CAAC;QACpB,SAAI,GAAG,cAAc,CAAC;QACtB,gBAAW,GAAG,eAAe,CAAC;QAC9B,gBAAW,GAAG,2EAA2E,CAAC;QAC1F,aAAQ,GAAG,SAAS,CAAC;QACrB,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,IAAI,CAAC;QAEtB,gBAAW,GAAG;YACrB,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;gBACjF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;gBAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;aAC3F;SACF,CAAC;IAE4C,CAAC;IAE/C,KAAK,CAAC,OAAO,CAAC,IAAyD;QACrE,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QAC9B,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;AA5BD,8BA4BC"}

package/dist/tools/EvaluateTool.d.ts

@@ -0,0 +1,30 @@
+import type { BrowserService } from '../BrowserService.js';
+export declare class EvaluateTool {
+    private browser;
+    readonly id = "browserEvaluate";
+    readonly name = "browserEvaluate";
+    readonly displayName = "Evaluate JavaScript";
+    readonly description = "Execute arbitrary JavaScript code in the browser page context and return the result.";
+    readonly category = "browser";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = true;
+    readonly inputSchema: {
+        type: "object";
+        properties: {
+            script: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(browser: BrowserService);
+    execute(args: {
+        script: string;
+    }): Promise<{
+        success: boolean;
+        data?: unknown;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=EvaluateTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EvaluateTool.d.ts","sourceRoot":"","sources":["../../src/tools/EvaluateTool.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,qBAAa,YAAY;IAiBX,OAAO,CAAC,OAAO;IAhB3B,QAAQ,CAAC,EAAE,qBAAqB;IAChC,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,yBAAyB;IAC7C,QAAQ,CAAC,WAAW,0FAA0F;IAC9G,QAAQ,CAAC,QAAQ,aAAa;IAC9B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,cAAc,QAAQ;IAE/B,QAAQ,CAAC,WAAW;;;;;;;;;MAMlB;gBAEkB,OAAO,EAAE,cAAc;IAErC,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAQvG"}