bedrock-agentcore 0.0.1 → 0.1.1

package/dist/src/tools/browser/integrations/playwright/client.js

@@ -0,0 +1,324 @@
+import { Browser } from '../../client.js';
+/**
+ * Playwright-based browser automation client for AWS Bedrock AgentCore Browser service.
+ *
+ * Extends Browser with full browser automation capabilities using Playwright.
+ * Provides methods for navigation, interaction, content extraction, and JavaScript execution.
+ *
+ * Sessions are automatically created on first use and Playwright connections are
+ * managed internally.
+ *
+ * @example
+ * ```typescript
+ * const browser = new PlaywrightBrowser({ region: 'us-east-1' })
+ *
+ * // Direct usage (auto-creates session)
+ * await browser.navigate({ url: 'https://example.com' })
+ * await browser.click({ selector: 'button' })
+ * const text = await browser.getText({ selector: 'h1' })
+ *
+ * // Explicit session management
+ * await browser.startSession({ sessionName: 'my-session' })
+ * await browser.navigate({ url: 'https://example.com' })
+ * await browser.stopSession()
+ * ```
+ */
+export class PlaywrightBrowser extends Browser {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _playwrightBrowser = null; // Playwright Browser instance
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    _playwrightPage = null; // Playwright Page instance
+    /**
+     * Creates a new PlaywrightBrowser instance.
+     *
+     * @param config - Configuration options for the client
+     */
+    constructor(config) {
+        super(config);
+    }
+    /**
+     * Stops the active browser session and closes Playwright connections.
+     */
+    async stopSession() {
+        // Close Playwright connections first
+        try {
+            if (this._playwrightBrowser) {
+                await this._playwrightBrowser.close();
+                this._playwrightBrowser = null;
+                this._playwrightPage = null;
+            }
+        }
+        catch (error) {
+            // Log but don't fail on Playwright cleanup errors
+            console.warn('Error closing Playwright browser:', error);
+        }
+        // Call parent stopSession to clean up AWS session
+        await super.stopSession();
+    }
+    // ===========================
+    // Browser Automation
+    // ===========================
+    /**
+     * Navigates to a URL.
+     * Automatically creates a session and connects if needed.
+     *
+     * @param params - Navigation parameters
+     */
+    async navigate(params) {
+        await this._ensureConnected();
+        await this._playwrightPage.goto(params.url, {
+            waitUntil: params.waitUntil ?? 'domcontentloaded',
+            timeout: params.timeout,
+        });
+    }
+    /**
+     * Clicks an element on the page.
+     *
+     * @param params - Click parameters
+     */
+    async click(params) {
+        await this._ensureConnected();
+        await this._playwrightPage.click(params.selector, {
+            timeout: params.timeout,
+        });
+    }
+    /**
+     * Types text into an input element.
+     *
+     * @param params - Type parameters
+     */
+    async type(params) {
+        await this._ensureConnected();
+        await this._playwrightPage.type(params.selector, params.text, {
+            delay: params.delay,
+            timeout: params.timeout,
+        });
+    }
+    /**
+     * Gets text content from an element or the page.
+     *
+     * @param params - GetText parameters
+     * @returns Text content
+     */
+    async getText(params = {}) {
+        await this._ensureConnected();
+        if (params.selector) {
+            const element = await this._playwrightPage.$(params.selector);
+            if (!element) {
+                throw new Error(`Element not found: ${params.selector}`);
+            }
+            return (await element.textContent()) ?? '';
+        }
+        return (await this._playwrightPage.textContent('body')) ?? '';
+    }
+    /**
+     * Gets HTML content from an element or the page.
+     *
+     * @param params - GetHtml parameters
+     * @returns HTML content
+     */
+    async getHtml(params = {}) {
+        await this._ensureConnected();
+        if (params.selector) {
+            const element = await this._playwrightPage.$(params.selector);
+            if (!element) {
+                throw new Error(`Element not found: ${params.selector}`);
+            }
+            return await element.innerHTML();
+        }
+        return await this._playwrightPage.content();
+    }
+    /**
+     * Takes a screenshot of the page.
+     *
+     * @param params - Screenshot parameters
+     * @returns Screenshot as base64 string or Buffer
+     */
+    async screenshot(params) {
+        await this._ensureConnected();
+        const screenshot = await this._playwrightPage.screenshot({
+            path: params?.path,
+            fullPage: params?.fullPage ?? false,
+            type: params?.type ?? 'png',
+        });
+        return params?.encoding === 'base64' ? screenshot.toString('base64') : screenshot;
+    }
+    /**
+     * Evaluates JavaScript code in the page context.
+     *
+     * @param params - Evaluate parameters
+     * @returns Result of the evaluation
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async evaluate(params) {
+        await this._ensureConnected();
+        return await this._playwrightPage.evaluate(params.script, params.args);
+    }
+    /**
+     * Navigates back in browser history.
+     */
+    async back() {
+        await this._ensureConnected();
+        try {
+            // Try with networkidle first, which is more reliable for dynamic sites
+            await this._playwrightPage.goBack({ waitUntil: 'networkidle', timeout: 30000 });
+        }
+        catch {
+            // If networkidle times out, try with load
+            try {
+                await this._playwrightPage.goBack({ waitUntil: 'load', timeout: 30000 });
+            }
+            catch {
+                // If still failing, just trigger the navigation without waiting
+                await this._playwrightPage.evaluate('window.history.back()');
+            }
+        }
+    }
+    /**
+     * Navigates forward in browser history.
+     */
+    async forward() {
+        await this._ensureConnected();
+        try {
+            // Try with networkidle first, which is more reliable for dynamic sites
+            await this._playwrightPage.goForward({ waitUntil: 'networkidle', timeout: 30000 });
+        }
+        catch {
+            // If networkidle times out, try with load
+            try {
+                await this._playwrightPage.goForward({ waitUntil: 'load', timeout: 30000 });
+            }
+            catch {
+                // If still failing, just trigger the navigation without waiting
+                await this._playwrightPage.evaluate('window.history.forward()');
+            }
+        }
+    }
+    /**
+     * Refreshes the current page.
+     */
+    async refresh() {
+        await this._ensureConnected();
+        await this._playwrightPage.reload();
+    }
+    /**
+     * Gets all cookies.
+     *
+     * @returns Array of cookies
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async getCookies() {
+        await this._ensureConnected();
+        return await this._playwrightPage.context().cookies();
+    }
+    /**
+     * Sets cookies.
+     *
+     * @param params - Cookie parameters
+     */
+    async setCookies(params) {
+        await this._ensureConnected();
+        await this._playwrightPage.context().addCookies(params.cookies);
+    }
+    /**
+     * Presses a keyboard key.
+     *
+     * @param key - Key name (e.g., 'Enter', 'Tab', 'Escape')
+     */
+    async pressKey(key) {
+        await this._ensureConnected();
+        await this._playwrightPage.keyboard.press(key);
+    }
+    /**
+     * Waits for an element to be present in the DOM.
+     *
+     * @param params - WaitForSelector parameters
+     */
+    async waitForSelector(params) {
+        await this._ensureConnected();
+        await this._playwrightPage.waitForSelector(params.selector, {
+            timeout: params.timeout ?? 30000,
+            state: params.state ?? (params.visible !== false ? 'visible' : 'attached'),
+        });
+    }
+    /**
+     * Fills an input element with text (clears existing value first).
+     * More reliable than type() for forms.
+     *
+     * @param params - Fill parameters
+     */
+    async fill(params) {
+        await this._ensureConnected();
+        await this._playwrightPage.fill(params.selector, params.value, {
+            timeout: params.timeout,
+        });
+    }
+    /**
+     * Checks if an element is visible on the page.
+     *
+     * @param params - IsVisible parameters
+     * @returns true if element is visible, false otherwise
+     */
+    async isVisible(params) {
+        await this._ensureConnected();
+        try {
+            const element = await this._playwrightPage.$(params.selector);
+            if (!element) {
+                return false;
+            }
+            return await element.isVisible();
+        }
+        catch {
+            return false;
+        }
+    }
+    // ===========================
+    // Private Helper Methods
+    // ===========================
+    /**
+     * Ensures a session exists and Playwright is connected.
+     */
+    async _ensureConnected() {
+        // Ensure session exists
+        if (!this._session) {
+            await this.startSession();
+        }
+        // Ensure Playwright connection exists
+        if (!this._playwrightBrowser || !this._playwrightPage) {
+            await this._connectPlaywright();
+        }
+    }
+    /**
+     * Connects to the browser via Playwright WebSocket.
+     */
+    async _connectPlaywright() {
+        if (!this._session) {
+            throw new Error('No active session');
+        }
+        // Dynamically import Playwright
+        const { chromium } = await import('playwright');
+        // Get WebSocket connection details
+        const wsConnection = await this.generateWebSocketUrl();
+        // Connect to browser via CDP
+        this._playwrightBrowser = await chromium.connectOverCDP({
+            endpointURL: wsConnection.url,
+            headers: wsConnection.headers,
+        });
+        // Get the default context and page
+        const contexts = this._playwrightBrowser.contexts();
+        if (contexts.length === 0) {
+            throw new Error('No browser contexts available');
+        }
+        const context = contexts[0];
+        const pages = context.pages();
+        if (pages.length === 0) {
+            // Create a new page if none exist
+            this._playwrightPage = await context.newPage();
+        }
+        else {
+            // Use the first page
+            this._playwrightPage = pages[0];
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/tools/browser/integrations/playwright/client.js.map

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

package/dist/src/tools/browser/integrations/playwright/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Playwright Browser Integration
+ *
+ * This module provides Playwright-based browser automation for AWS Bedrock AgentCore Browser service.
+ * It extends the base Browser with full browser automation capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { PlaywrightBrowser } from '@aws-sdk/bedrock-agentcore-sdk/browser/playwright'
+ *
+ * const browser = new PlaywrightBrowser({ region: 'us-west-2' })
+ * await browser.navigate({ url: 'https://example.com' })
+ * await browser.click({ selector: 'button' })
+ * const text = await browser.getText({ selector: 'h1' })
+ * await browser.stopSession()
+ * ```
+ */
+export { PlaywrightBrowser } from './client.js';
+export type { NavigateParams, ClickParams, TypeParams, GetTextParams, GetHtmlParams, ScreenshotParams, EvaluateParams, CookieParams, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/tools/browser/integrations/playwright/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/playwright/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/src/tools/browser/integrations/playwright/index.js

@@ -0,0 +1,19 @@
+/**
+ * Playwright Browser Integration
+ *
+ * This module provides Playwright-based browser automation for AWS Bedrock AgentCore Browser service.
+ * It extends the base Browser with full browser automation capabilities.
+ *
+ * @example
+ * ```typescript
+ * import { PlaywrightBrowser } from '@aws-sdk/bedrock-agentcore-sdk/browser/playwright'
+ *
+ * const browser = new PlaywrightBrowser({ region: 'us-west-2' })
+ * await browser.navigate({ url: 'https://example.com' })
+ * await browser.click({ selector: 'button' })
+ * const text = await browser.getText({ selector: 'h1' })
+ * await browser.stopSession()
+ * ```
+ */
+export { PlaywrightBrowser } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/src/tools/browser/integrations/playwright/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/playwright/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA"}

package/dist/src/tools/browser/integrations/playwright/types.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Parameters for navigate operation.
+ */
+export interface NavigateParams {
+    /**
+     * URL to navigate to.
+     */
+    url: string;
+    /**
+     * When to consider navigation successful.
+     */
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
+    /**
+     * Maximum navigation time in milliseconds.
+     */
+    timeout?: number;
+}
+/**
+ * Parameters for click operation.
+ */
+export interface ClickParams {
+    /**
+     * CSS selector for the element to click.
+     */
+    selector: string;
+    /**
+     * Maximum time in milliseconds.
+     */
+    timeout?: number;
+}
+/**
+ * Parameters for type operation.
+ */
+export interface TypeParams {
+    /**
+     * CSS selector for the input element.
+     */
+    selector: string;
+    /**
+     * Text to type.
+     */
+    text: string;
+    /**
+     * Time to wait between key presses in milliseconds.
+     */
+    delay?: number;
+    /**
+     * Maximum time in milliseconds.
+     */
+    timeout?: number;
+}
+/**
+ * Parameters for getText operation.
+ */
+export interface GetTextParams {
+    /**
+     * CSS selector for the element. If omitted, returns all page text.
+     */
+    selector?: string;
+}
+/**
+ * Parameters for getHtml operation.
+ */
+export interface GetHtmlParams {
+    /**
+     * CSS selector for the element. If omitted, returns full page HTML.
+     */
+    selector?: string;
+}
+/**
+ * Parameters for screenshot operation.
+ */
+export interface ScreenshotParams {
+    /**
+     * Path to save the screenshot file.
+     */
+    path?: string;
+    /**
+     * Capture the full scrollable page.
+     */
+    fullPage?: boolean;
+    /**
+     * Image type.
+     */
+    type?: 'png' | 'jpeg';
+    /**
+     * Encoding format.
+     */
+    encoding?: 'base64' | 'binary';
+}
+/**
+ * Parameters for evaluate operation.
+ */
+export interface EvaluateParams {
+    /**
+     * JavaScript code to execute.
+     */
+    script: string;
+    /**
+     * Arguments to pass to the script.
+     */
+    args?: any[];
+}
+/**
+ * Parameters for cookie operations.
+ */
+export interface CookieParams {
+    /**
+     * Array of cookie objects to set.
+     */
+    cookies: Array<{
+        name: string;
+        value: string;
+        domain?: string;
+        path?: string;
+        expires?: number;
+        httpOnly?: boolean;
+        secure?: boolean;
+        sameSite?: 'Strict' | 'Lax' | 'None';
+    }>;
+}
+/**
+ * Parameters for waitForSelector operation.
+ */
+export interface WaitForSelectorParams {
+    /**
+     * CSS selector to wait for.
+     */
+    selector: string;
+    /**
+     * Maximum time in milliseconds to wait.
+     */
+    timeout?: number;
+    /**
+     * Wait for element to be visible (default: true).
+     */
+    visible?: boolean;
+    /**
+     * Wait for element state.
+     */
+    state?: 'attached' | 'detached' | 'visible' | 'hidden';
+}
+/**
+ * Parameters for fill operation.
+ */
+export interface FillParams {
+    /**
+     * CSS selector for the input element.
+     */
+    selector: string;
+    /**
+     * Text to fill.
+     */
+    value: string;
+    /**
+     * Maximum time in milliseconds.
+     */
+    timeout?: number;
+}
+/**
+ * Parameters for isVisible operation.
+ */
+export interface IsVisibleParams {
+    /**
+     * CSS selector for the element.
+     */
+    selector: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/tools/browser/integrations/playwright/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/playwright/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,GAAG,aAAa,CAAA;IAEvD;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IAEH,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,GAAG,MAAM,CAAA;KACrC,CAAC,CAAA;CACH;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAA;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CACjB"}

package/dist/src/tools/browser/integrations/playwright/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/tools/browser/integrations/playwright/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/playwright/types.ts"],"names":[],"mappings":""}

package/dist/src/tools/browser/integrations/vercel-ai/click-tool.d.ts

@@ -0,0 +1,18 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Vercel AI tool for clicking elements.
+ * Thin wrapper around PlaywrightBrowser.click()
+ */
+export declare function createClickTool(client: PlaywrightBrowser): import("ai").Tool<{
+    selector: string;
+    timeout?: number | undefined;
+}, {
+    success: boolean;
+    message: string;
+    error?: never;
+} | {
+    success: boolean;
+    error: string;
+    message?: never;
+}>;
+//# sourceMappingURL=click-tool.d.ts.map

package/dist/src/tools/browser/integrations/vercel-ai/click-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/vercel-ai/click-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;;GAGG;AAEH,wBAAgB,eAAe,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;;GAoBxD"}

package/dist/src/tools/browser/integrations/vercel-ai/click-tool.js

@@ -0,0 +1,31 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+/**
+ * Creates a Vercel AI tool for clicking elements.
+ * Thin wrapper around PlaywrightBrowser.click()
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createClickTool(client) {
+    return tool({
+        description: 'Click an element on the page',
+        inputSchema: z.object({
+            selector: z.string().describe('CSS selector for the element to click'),
+            timeout: z.number().positive().optional().describe('Maximum time in milliseconds'),
+        }),
+        execute: async ({ selector, timeout }) => {
+            'use step';
+            try {
+                const params = { selector };
+                if (timeout !== undefined)
+                    params.timeout = timeout;
+                await client.click(params);
+                return { success: true, message: `Clicked element: ${selector}` };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return { success: false, error: message };
+            }
+        },
+    });
+}
+//# sourceMappingURL=click-tool.js.map

package/dist/src/tools/browser/integrations/vercel-ai/click-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/vercel-ai/click-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAA;AACzB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;GAGG;AACH,+HAA+H;AAC/H,MAAM,UAAU,eAAe,CAAC,MAAyB;IACvD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,8BAA8B;QAC3C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACtE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;SACnF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;YACvC,UAAU,CAAA;YACV,IAAI,CAAC;gBACH,MAAM,MAAM,GAA2C,EAAE,QAAQ,EAAE,CAAA;gBACnE,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;gBACnD,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;gBAC1B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,oBAAoB,QAAQ,EAAE,EAAE,CAAA;YACnE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;gBACxE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;YAC3C,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/tools/browser/integrations/vercel-ai/evaluate-tool.d.ts

@@ -0,0 +1,18 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Vercel AI tool for evaluating JavaScript.
+ * Thin wrapper around PlaywrightBrowser.evaluate()
+ */
+export declare function createEvaluateTool(client: PlaywrightBrowser): import("ai").Tool<{
+    script: string;
+    args?: any[] | undefined;
+}, {
+    success: boolean;
+    result: any;
+    error?: never;
+} | {
+    success: boolean;
+    error: string;
+    result?: never;
+}>;
+//# sourceMappingURL=evaluate-tool.d.ts.map

package/dist/src/tools/browser/integrations/vercel-ai/evaluate-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/vercel-ai/evaluate-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;;GAGG;AAEH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;;GAqB3D"}