@cloudbase/agent-tools 0.0.2

package/dist/browser/browser_tool_unified.d.ts

@@ -0,0 +1,93 @@
+import { z } from "zod/v4";
+import { BaseTool, ToolResult } from "../utils";
+import { BrowserClientConfig } from "./browser_client_unified";
+/**
+ * Browser tool input schema
+ */
+declare const BrowserToolInputSchema: z.ZodObject<{
+    tool: z.ZodString;
+    arguments: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strip>;
+type TBrowserToolInput = z.infer<typeof BrowserToolInputSchema>;
+export interface BrowserToolResult {
+    success: boolean;
+    tool: string;
+    content?: Array<{
+        type: string;
+        text?: string;
+        data?: string;
+        mimeType?: string;
+    }>;
+    error?: string;
+}
+export type { TBrowserToolInput };
+/**
+ * Unified Browser Tool
+ *
+ * Supports both local and sandbox modes:
+ * - Local mode: Uses local Playwright MCP server
+ * - Sandbox mode: Connects to E2B sandbox browser via CDP
+ */
+export declare class UnifiedBrowserTool extends BaseTool<typeof BrowserToolInputSchema> {
+    private client;
+    private config;
+    constructor(config: BrowserClientConfig);
+    _invoke(input: TBrowserToolInput): Promise<ToolResult<BrowserToolResult>>;
+    /**
+     * List all available Playwright MCP tools
+     */
+    listAvailableTools(): Promise<any[]>;
+    navigate(url: string): Promise<ToolResult<BrowserToolResult>>;
+    snapshot(): Promise<ToolResult<BrowserToolResult>>;
+    click(element: string, ref: string): Promise<ToolResult<BrowserToolResult>>;
+    type(element: string, ref: string, text: string, options?: {
+        submit?: boolean;
+        slowly?: boolean;
+    }): Promise<ToolResult<BrowserToolResult>>;
+    screenshot(options?: {
+        fullPage?: boolean;
+        filename?: string;
+    }): Promise<ToolResult<BrowserToolResult>>;
+    waitFor(options: {
+        time?: number;
+        text?: string;
+        textGone?: string;
+    }): Promise<ToolResult<BrowserToolResult>>;
+    manageTabs(action: "list" | "create" | "close" | "select", index?: number): Promise<ToolResult<BrowserToolResult>>;
+    fillForm(fields: Array<{
+        element: string;
+        ref: string;
+        value: string;
+    }>): Promise<ToolResult<BrowserToolResult>>;
+    /**
+     * Get VNC URL (sandbox mode only)
+     */
+    getVncUrl(): string | undefined;
+    /**
+     * Get CDP URL (sandbox mode only)
+     */
+    getCdpUrl(): string | undefined;
+    /**
+     * Get connection status
+     */
+    getStatus(): {
+        isReady: boolean;
+        mode: string;
+        config: BrowserClientConfig;
+    };
+    /**
+     * Close the client connection
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a local browser tool
+ */
+export declare function createLocalBrowserTool(config?: Omit<BrowserClientConfig, "mode">): UnifiedBrowserTool;
+/**
+ * Create a sandbox browser tool
+ */
+export declare function createSandboxBrowserTool(config: Omit<BrowserClientConfig, "mode"> & {
+    apiKey: string;
+}): UnifiedBrowserTool;
+//# sourceMappingURL=browser_tool_unified.d.ts.map

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

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

package/dist/browser/browser_tool_unified.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UnifiedBrowserTool = void 0;
+exports.createLocalBrowserTool = createLocalBrowserTool;
+exports.createSandboxBrowserTool = createSandboxBrowserTool;
+const v4_1 = require("zod/v4");
+const utils_1 = require("../utils");
+const browser_client_unified_1 = require("./browser_client_unified");
+/**
+ * Browser tool input schema
+ */
+const BrowserToolInputSchema = v4_1.z.object({
+    /**
+     * The name of the Playwright MCP tool to call
+     * Examples: browser_navigate, browser_click, browser_snapshot, etc.
+     */
+    tool: v4_1.z.string(),
+    /**
+     * Arguments to pass to the tool
+     */
+    arguments: v4_1.z.record(v4_1.z.string(), v4_1.z.any()).optional(),
+});
+/**
+ * Unified Browser Tool
+ *
+ * Supports both local and sandbox modes:
+ * - Local mode: Uses local Playwright MCP server
+ * - Sandbox mode: Connects to E2B sandbox browser via CDP
+ */
+class UnifiedBrowserTool extends utils_1.BaseTool {
+    constructor(config) {
+        super({
+            name: "browser",
+            description: `Browser automation tool (${config.mode} mode) - supports all standard Playwright MCP tools like browser_navigate, browser_click, browser_snapshot, etc.`,
+            schema: BrowserToolInputSchema,
+        });
+        this.config = config;
+        this.client = new browser_client_unified_1.UnifiedBrowserClient(config);
+    }
+    async _invoke(input) {
+        try {
+            // Ensure client is connected
+            if (!this.client.isReady()) {
+                await this.client.start();
+            }
+            // Call the Playwright MCP tool
+            const mcpCall = {
+                name: input.tool,
+                arguments: input.arguments || {},
+            };
+            const result = await this.client.callTool(mcpCall);
+            return new utils_1.ToolResult({
+                success: !result.isError,
+                data: {
+                    success: !result.isError,
+                    tool: input.tool,
+                    content: result.content,
+                    error: result.isError ? "Tool execution failed" : undefined,
+                },
+            });
+        }
+        catch (error) {
+            return new utils_1.ToolResult({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                data: {
+                    success: false,
+                    tool: input.tool,
+                    error: error instanceof Error ? error.message : String(error),
+                },
+            });
+        }
+    }
+    /**
+     * List all available Playwright MCP tools
+     */
+    async listAvailableTools() {
+        if (!this.client.isReady()) {
+            await this.client.start();
+        }
+        return await this.client.listTools();
+    }
+    // Convenience methods for common operations
+    async navigate(url) {
+        return this.invoke({
+            tool: "browser_navigate",
+            arguments: { url },
+        });
+    }
+    async snapshot() {
+        return this.invoke({
+            tool: "browser_snapshot",
+        });
+    }
+    async click(element, ref) {
+        return this.invoke({
+            tool: "browser_click",
+            arguments: { element, ref },
+        });
+    }
+    async type(element, ref, text, options) {
+        return this.invoke({
+            tool: "browser_type",
+            arguments: { element, ref, text, ...options },
+        });
+    }
+    async screenshot(options) {
+        return this.invoke({
+            tool: "browser_take_screenshot",
+            arguments: options || {},
+        });
+    }
+    async waitFor(options) {
+        return this.invoke({
+            tool: "browser_wait_for",
+            arguments: options,
+        });
+    }
+    async manageTabs(action, index) {
+        return this.invoke({
+            tool: "browser_tabs",
+            arguments: { action, index },
+        });
+    }
+    async fillForm(fields) {
+        return this.invoke({
+            tool: "browser_fill_form",
+            arguments: { fields },
+        });
+    }
+    // Mode-specific methods
+    /**
+     * Get VNC URL (sandbox mode only)
+     */
+    getVncUrl() {
+        return this.client.getVncUrl();
+    }
+    /**
+     * Get CDP URL (sandbox mode only)
+     */
+    getCdpUrl() {
+        return this.client.getCdpUrl();
+    }
+    /**
+     * Get connection status
+     */
+    getStatus() {
+        return {
+            isReady: this.client.isReady(),
+            mode: this.config.mode,
+            config: this.config,
+        };
+    }
+    /**
+     * Close the client connection
+     */
+    async close() {
+        await this.client.stop();
+    }
+}
+exports.UnifiedBrowserTool = UnifiedBrowserTool;
+// Export factory functions for convenience
+/**
+ * Create a local browser tool
+ */
+function createLocalBrowserTool(config = {}) {
+    return new UnifiedBrowserTool({
+        ...config,
+        mode: "local",
+    });
+}
+/**
+ * Create a sandbox browser tool
+ */
+function createSandboxBrowserTool(config) {
+    return new UnifiedBrowserTool({
+        ...config,
+        mode: "sandbox",
+    });
+}
+//# sourceMappingURL=browser_tool_unified.js.map

package/dist/browser/browser_tool_unified.js.map

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

package/dist/browser/index.d.ts

@@ -0,0 +1,7 @@
+export { UnifiedBrowserClient, type BrowserClientConfig, type MCPToolCall, type MCPToolResult, } from "./browser_client_unified";
+export { UnifiedBrowserTool, createLocalBrowserTool, createSandboxBrowserTool, type TBrowserToolInput, } from "./browser_tool_unified";
+export { SandboxConnector, type SandboxConnectorConfig, type SandboxConnectionInfo, } from "./sandbox-connector";
+export { BrowserInstanceManager, type BrowserInstanceConfig, type BrowserInstanceInfo, } from "./browser-instance-manager";
+export { BrowserToolExecutor, type BrowserPageProvider, type BrowserToolCall, type BrowserToolResult, } from "./browser-tool-executor";
+export type { BrowserActionType, BrowserAction, BrowserActionResult, BrowserSession, BrowserToolConfig, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AAGjC,YAAY,EACV,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserToolExecutor = exports.BrowserInstanceManager = exports.SandboxConnector = exports.createSandboxBrowserTool = exports.createLocalBrowserTool = exports.UnifiedBrowserTool = exports.UnifiedBrowserClient = void 0;
+// Unified browser client and tools (recommended)
+var browser_client_unified_1 = require("./browser_client_unified");
+Object.defineProperty(exports, "UnifiedBrowserClient", { enumerable: true, get: function () { return browser_client_unified_1.UnifiedBrowserClient; } });
+var browser_tool_unified_1 = require("./browser_tool_unified");
+Object.defineProperty(exports, "UnifiedBrowserTool", { enumerable: true, get: function () { return browser_tool_unified_1.UnifiedBrowserTool; } });
+Object.defineProperty(exports, "createLocalBrowserTool", { enumerable: true, get: function () { return browser_tool_unified_1.createLocalBrowserTool; } });
+Object.defineProperty(exports, "createSandboxBrowserTool", { enumerable: true, get: function () { return browser_tool_unified_1.createSandboxBrowserTool; } });
+// Direct connection components (new architecture)
+var sandbox_connector_1 = require("./sandbox-connector");
+Object.defineProperty(exports, "SandboxConnector", { enumerable: true, get: function () { return sandbox_connector_1.SandboxConnector; } });
+var browser_instance_manager_1 = require("./browser-instance-manager");
+Object.defineProperty(exports, "BrowserInstanceManager", { enumerable: true, get: function () { return browser_instance_manager_1.BrowserInstanceManager; } });
+// Shared tool execution layer
+var browser_tool_executor_1 = require("./browser-tool-executor");
+Object.defineProperty(exports, "BrowserToolExecutor", { enumerable: true, get: function () { return browser_tool_executor_1.BrowserToolExecutor; } });
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AACjD,mEAKkC;AAJhC,8HAAA,oBAAoB,OAAA;AAMtB,+DAKgC;AAJ9B,0HAAA,kBAAkB,OAAA;AAClB,8HAAA,sBAAsB,OAAA;AACtB,gIAAA,wBAAwB,OAAA;AAI1B,kDAAkD;AAClD,yDAI6B;AAH3B,qHAAA,gBAAgB,OAAA;AAKlB,uEAIoC;AAHlC,kIAAA,sBAAsB,OAAA;AAKxB,8BAA8B;AAC9B,iEAKiC;AAJ/B,4HAAA,mBAAmB,OAAA"}

package/dist/browser/sandbox-connector.d.ts

@@ -0,0 +1,93 @@
+import { Browser, BrowserContext, Page } from "playwright";
+import { EventEmitter } from "events";
+export interface SandboxConnectorConfig {
+    apiKey: string;
+    domain?: string;
+    timeout?: number;
+    sessionId?: string;
+}
+export interface SandboxConnectionInfo {
+    sandboxId: string;
+    vncUrl: string;
+    cdpUrl: string;
+    accessToken: string;
+}
+/**
+ * SandboxConnector manages the direct connection between E2B Sandbox and Playwright
+ * Replaces the subprocess-based MCP server approach with direct CDP connection
+ */
+export declare class SandboxConnector extends EventEmitter {
+    private config;
+    private sandbox?;
+    private browser?;
+    private context?;
+    private pages;
+    private isConnected;
+    private connectionInfo?;
+    constructor(config: SandboxConnectorConfig);
+    /**
+     * Initialize the sandbox and establish CDP connection
+     */
+    connect(): Promise<void>;
+    /**
+     * Establish direct CDP connection to sandbox browser
+     */
+    private connectToBrowser;
+    /**
+     * Get Playwright Browser instance
+     */
+    getBrowser(): Browser;
+    /**
+     * Get Playwright BrowserContext instance
+     */
+    getContext(): BrowserContext;
+    /**
+     * Get Playwright Page instance by index
+     */
+    getPage(index?: number): Page;
+    /**
+     * Get all Playwright Page instances
+     */
+    getPages(): Page[];
+    /**
+     * Create new Playwright Page
+     */
+    createPage(): Promise<Page>;
+    /**
+     * Close Playwright Page by index
+     */
+    closePage(index: number): Promise<void>;
+    /**
+     * Get connection status
+     */
+    isReady(): boolean;
+    /**
+     * Get connection information
+     */
+    getConnectionInfo(): SandboxConnectionInfo | undefined;
+    /**
+     * Get VNC URL for visual debugging
+     */
+    getVncUrl(): string;
+    /**
+     * Get CDP URL for direct connection
+     */
+    getCdpUrl(): string;
+    /**
+     * Get sandbox ID
+     */
+    getSandboxId(): string | undefined;
+    /**
+     * Reconnect to sandbox if connection is lost
+     */
+    reconnect(): Promise<void>;
+    /**
+     * Disconnect and clean up resources
+     */
+    disconnect(killSandbox?: boolean): Promise<void>;
+    /**
+     * Health check for the connection
+     */
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=sandbox-connector.d.ts.map

package/dist/browser/sandbox-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox-connector.d.ts","sourceRoot":"","sources":["../../src/browser/sandbox-connector.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAiB;IACjC,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,cAAc,CAAC,CAAwB;gBAEnC,MAAM,EAAE,sBAAsB;IAK1C;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwD9B;;OAEG;YACW,gBAAgB;IA2D9B;;OAEG;IACH,UAAU,IAAI,OAAO;IAOrB;;OAEG;IACH,UAAU,IAAI,cAAc;IAO5B;;OAEG;IACH,OAAO,CAAC,KAAK,GAAE,MAAU,GAAG,IAAI;IAShC;;OAEG;IACH,QAAQ,IAAI,IAAI,EAAE;IAIlB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAWjC;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7C;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,iBAAiB,IAAI,qBAAqB,GAAG,SAAS;IAItD;;OAEG;IACH,SAAS,IAAI,MAAM;IAOnB;;OAEG;IACH,SAAS,IAAI,MAAM;IAOnB;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,SAAS;IAIlC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBhC;;OAEG;IACG,UAAU,CAAC,WAAW,GAAE,OAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B5D;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAetC"}