bedrock-agentcore 0.0.1 → 0.2.0

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

@@ -0,0 +1,320 @@
+import { BedrockAgentCoreClient, StartBrowserSessionCommand, StopBrowserSessionCommand, GetBrowserSessionCommand, ListBrowserSessionsCommand, UpdateBrowserStreamCommand, } from '@aws-sdk/client-bedrock-agentcore';
+import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
+import { HttpRequest } from '@smithy/protocol-http';
+import { SignatureV4 } from '@smithy/signature-v4';
+import { Sha256 } from '@aws-crypto/sha256-js';
+import { DEFAULT_IDENTIFIER, DEFAULT_SESSION_NAME, DEFAULT_TIMEOUT, DEFAULT_REGION } from './types.js';
+/**
+ * Base client for AWS Bedrock AgentCore Browser service.
+ *
+ * Provides core AWS SDK operations for browser session management and WebSocket connectivity.
+ * This client handles session lifecycle and authentication but does not include browser
+ * automation methods. Use PlaywrightBrowser for full browser automation capabilities.
+ *
+ * @example
+ * ```typescript
+ * const browser = new Browser({ region: 'us-east-1' })
+ *
+ * // Start a session
+ * const session = await browser.startSession({ sessionName: 'my-session' })
+ *
+ * // Get WebSocket URL for custom browser integration
+ * const wsConnection = await browser.generateWebSocketUrl()
+ *
+ * // Stop the session
+ * await browser.stopSession()
+ * ```
+ */
+export class Browser {
+    region;
+    identifier;
+    _client;
+    _session = null;
+    _credentialsProvider = undefined;
+    /**
+     * Creates a new BrowserClient instance.
+     *
+     * @param config - Configuration options for the client
+     */
+    constructor(config) {
+        this.region = config.region ?? process.env.AWS_REGION ?? DEFAULT_REGION;
+        this.identifier = config.identifier ?? DEFAULT_IDENTIFIER;
+        this._credentialsProvider = config.credentialsProvider;
+        this._client = new BedrockAgentCoreClient({
+            region: this.region,
+            ...(this._credentialsProvider && { credentials: this._credentialsProvider }),
+        });
+    }
+    // ===========================
+    // Session Management
+    // ===========================
+    /**
+     * Starts a new browser session.
+     *
+     * @param params - Optional parameters for session configuration
+     * @returns Information about the started session
+     *
+     * @throws Error if a session is already active
+     */
+    async startSession(params) {
+        if (this._session) {
+            throw new Error('Session already active. Call stopSession() first.');
+        }
+        const sessionName = params?.sessionName ?? DEFAULT_SESSION_NAME;
+        const sessionTimeoutSeconds = params?.timeout ?? DEFAULT_TIMEOUT;
+        // Prepare command input
+        const input = {
+            browserIdentifier: this.identifier,
+            name: sessionName,
+            sessionTimeoutSeconds: sessionTimeoutSeconds,
+            viewPort: params?.viewport
+                ? {
+                    width: params.viewport.width,
+                    height: params.viewport.height,
+                }
+                : undefined,
+        };
+        // Start the session
+        const command = new StartBrowserSessionCommand(input);
+        const response = await this._client.send(command);
+        // Store session info
+        const sessionInfo = {
+            sessionName,
+            sessionId: response.sessionId,
+            createdAt: response.createdAt ?? new Date(),
+        };
+        this._session = sessionInfo;
+        return sessionInfo;
+    }
+    /**
+     * Stops the active browser session.
+     *
+     * @throws Error if no session is active
+     */
+    async stopSession() {
+        if (!this._session) {
+            // Silently succeed if no session (idempotent)
+            return;
+        }
+        // Stop the AWS session
+        const command = new StopBrowserSessionCommand({
+            browserIdentifier: this.identifier,
+            sessionId: this._session.sessionId,
+        });
+        await this._client.send(command);
+        // Clear session state
+        this._session = null;
+    }
+    /**
+     * Get detailed information about a browser session.
+     *
+     * @param params - Optional parameters specifying which session to query
+     * @returns Detailed session information
+     *
+     * @example
+     * ```typescript
+     * // Get current active session details
+     * const sessionInfo = await browser.getSession()
+     * console.log(`Session status: ${sessionInfo.status}`)
+     *
+     * // Get details for a specific session
+     * const sessionInfo = await browser.getSession({
+     *   sessionId: 'specific-session-id'
+     * })
+     * ```
+     */
+    async getSession(params) {
+        const browserId = params?.browserId ?? this.identifier;
+        const sessionId = params?.sessionId ?? this._session?.sessionId;
+        if (!browserId || !sessionId) {
+            throw new Error('Browser ID and Session ID must be provided or available from current session. ' +
+                'Start a session first or provide explicit IDs.');
+        }
+        const command = new GetBrowserSessionCommand({
+            browserIdentifier: browserId,
+            sessionId,
+        });
+        const response = await this._client.send(command);
+        // Parse streams if present - using type extension for fields not in SDK types yet
+        const responseWithExtras = response;
+        const responseData = {
+            sessionId: response.sessionId,
+            browserIdentifier: response.browserIdentifier,
+            name: response.name,
+            status: response.status ?? 'UNKNOWN',
+            createdAt: response.createdAt,
+            lastUpdatedAt: responseWithExtras.lastUpdatedAt ?? response.createdAt,
+            sessionTimeoutSeconds: response.sessionTimeoutSeconds,
+        };
+        // Add streams if present
+        if (responseWithExtras.streams) {
+            const streams = {};
+            const autoStream = responseWithExtras.streams.automationStream;
+            if (autoStream?.streamEndpoint) {
+                const streamInfo = {
+                    streamEndpoint: autoStream.streamEndpoint,
+                };
+                if (autoStream.streamStatus) {
+                    streamInfo.streamStatus = autoStream.streamStatus;
+                }
+                streams.automationStream = streamInfo;
+            }
+            const liveStream = responseWithExtras.streams.liveViewStream;
+            if (liveStream?.streamEndpoint) {
+                streams.liveViewStream = {
+                    streamEndpoint: liveStream.streamEndpoint,
+                };
+            }
+            responseData.streams = streams;
+        }
+        return responseData;
+    }
+    /**
+     * List browser sessions for this browser.
+     *
+     * @param params - Optional filtering and pagination parameters
+     * @returns List of session summaries with optional pagination token
+     *
+     * @example
+     * ```typescript
+     * // List all active sessions
+     * const response = await browser.listSessions({ status: 'READY' })
+     * for (const session of response.items) {
+     *   console.log(`Session ${session.sessionId}: ${session.status}`)
+     * }
+     *
+     * // Paginate through results
+     * let response = await browser.listSessions({ maxResults: 10 })
+     * while (response.nextToken) {
+     *   response = await browser.listSessions({
+     *     maxResults: 10,
+     *     nextToken: response.nextToken
+     *   })
+     * }
+     * ```
+     */
+    async listSessions(params) {
+        const browserId = params?.browserId ?? this.identifier;
+        if (!browserId) {
+            throw new Error('Browser ID must be provided or available from configuration');
+        }
+        const command = new ListBrowserSessionsCommand({
+            browserIdentifier: browserId,
+            ...(params?.status && {
+                status: params.status,
+            }),
+            ...(params?.maxResults && { maxResults: params.maxResults }),
+            ...(params?.nextToken && { nextToken: params.nextToken }),
+        });
+        const response = await this._client.send(command);
+        const items = response.items?.map((item) => ({
+            sessionId: item.sessionId,
+            name: item.name,
+            status: item.status ?? 'UNKNOWN',
+            createdAt: item.createdAt,
+            lastUpdatedAt: item.lastUpdatedAt,
+        })) ?? [];
+        return {
+            items,
+            ...(response.nextToken && { nextToken: response.nextToken }),
+        };
+    }
+    /**
+     * Update the browser automation stream status.
+     *
+     * @param params - Stream update parameters
+     * @returns Updated stream information
+     *
+     * @example
+     * ```typescript
+     * // Enable automation stream
+     * const result = await browser.updateBrowserStream({
+     *   streamStatus: 'ENABLED'
+     * })
+     *
+     * // Disable automation stream
+     * await browser.updateBrowserStream({
+     *   streamStatus: 'DISABLED'
+     * })
+     * ```
+     */
+    async updateBrowserStream(params) {
+        const browserId = params.browserId ?? this.identifier;
+        const sessionId = params.sessionId ?? this._session?.sessionId;
+        if (!browserId || !sessionId) {
+            throw new Error('Browser ID and Session ID must be provided or available from current session. ' +
+                'Start a session first or provide explicit IDs.');
+        }
+        const command = new UpdateBrowserStreamCommand({
+            browserIdentifier: browserId,
+            sessionId,
+            streamUpdate: {
+                automationStreamUpdate: {
+                    streamStatus: params.streamStatus,
+                },
+            },
+        });
+        const response = await this._client.send(command);
+        // Extract the updated stream information from the response
+        const automationStream = response.streams?.automationStream;
+        const result = {};
+        if (automationStream?.streamEndpoint) {
+            result.streamEndpoint = automationStream.streamEndpoint;
+        }
+        if (automationStream?.streamStatus) {
+            result.streamStatus = automationStream.streamStatus;
+        }
+        return result;
+    }
+    /**
+     * Generates a WebSocket URL and authentication headers for browser automation.
+     * Uses AWS Signature Version 4 to sign the WebSocket connection request.
+     *
+     * @returns WebSocket connection details with URL and authentication headers
+     *
+     * @throws Error if no session is active
+     */
+    async generateWebSocketUrl() {
+        if (!this._session) {
+            throw new Error('No active session. Call startSession() first.');
+        }
+        // Construct WebSocket URL
+        const host = `bedrock-agentcore.${this.region}.amazonaws.com`;
+        const path = `/browser-streams/${this.identifier}/sessions/${this._session.sessionId}/automation`;
+        const wsUrl = `wss://${host}${path}`;
+        // Obtain AWS credentials for SigV4 signing of WebSocket connection
+        // Use provided credentials or fall back to default chain
+        const credentialsProvider = this._credentialsProvider ?? fromNodeProviderChain();
+        const credentials = await credentialsProvider();
+        // Create HTTP request for signing
+        const request = new HttpRequest({
+            protocol: 'wss:',
+            hostname: host,
+            path,
+            method: 'GET',
+            headers: {
+                host,
+            },
+        });
+        // Sign the request using SigV4
+        const signer = new SignatureV4({
+            service: 'bedrock-agentcore',
+            region: this.region,
+            credentials,
+            sha256: Sha256,
+        });
+        const signedRequest = await signer.sign(request);
+        // Extract headers for WebSocket connection
+        const headers = {};
+        for (const [key, value] of Object.entries(signedRequest.headers)) {
+            if (typeof value === 'string') {
+                headers[key] = value;
+            }
+        }
+        return {
+            url: wsUrl,
+            headers,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

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

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

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

@@ -0,0 +1,4 @@
+export { Browser } from './client.js';
+export type { BrowserClientConfig, SessionInfo, StartSessionParams, ViewportConfig, WebSocketConnection, SessionStatus, BrowserOperationResult, } from './types.js';
+export { DEFAULT_IDENTIFIER, DEFAULT_SESSION_NAME, DEFAULT_TIMEOUT } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/tools/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,YAAY,EACV,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

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

@@ -0,0 +1,3 @@
+export { Browser } from './client.js';
+export { DEFAULT_IDENTIFIER, DEFAULT_SESSION_NAME, DEFAULT_TIMEOUT } from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/tools/browser/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AAUrC,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

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

@@ -0,0 +1,147 @@
+import { Browser } from '../../client.js';
+import type { BrowserClientConfig } from '../../types.js';
+import type { NavigateParams, ClickParams, TypeParams, GetTextParams, GetHtmlParams, ScreenshotParams, EvaluateParams, CookieParams, WaitForSelectorParams, FillParams, IsVisibleParams } from './types.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 declare class PlaywrightBrowser extends Browser {
+    private _playwrightBrowser;
+    private _playwrightPage;
+    /**
+     * Creates a new PlaywrightBrowser instance.
+     *
+     * @param config - Configuration options for the client
+     */
+    constructor(config: BrowserClientConfig);
+    /**
+     * Stops the active browser session and closes Playwright connections.
+     */
+    stopSession(): Promise<void>;
+    /**
+     * Navigates to a URL.
+     * Automatically creates a session and connects if needed.
+     *
+     * @param params - Navigation parameters
+     */
+    navigate(params: NavigateParams): Promise<void>;
+    /**
+     * Clicks an element on the page.
+     *
+     * @param params - Click parameters
+     */
+    click(params: ClickParams): Promise<void>;
+    /**
+     * Types text into an input element.
+     *
+     * @param params - Type parameters
+     */
+    type(params: TypeParams): Promise<void>;
+    /**
+     * Gets text content from an element or the page.
+     *
+     * @param params - GetText parameters
+     * @returns Text content
+     */
+    getText(params?: GetTextParams): Promise<string>;
+    /**
+     * Gets HTML content from an element or the page.
+     *
+     * @param params - GetHtml parameters
+     * @returns HTML content
+     */
+    getHtml(params?: GetHtmlParams): Promise<string>;
+    /**
+     * Takes a screenshot of the page.
+     *
+     * @param params - Screenshot parameters
+     * @returns Screenshot as base64 string or Buffer
+     */
+    screenshot(params?: ScreenshotParams): Promise<globalThis.Buffer | string>;
+    /**
+     * Evaluates JavaScript code in the page context.
+     *
+     * @param params - Evaluate parameters
+     * @returns Result of the evaluation
+     */
+    evaluate(params: EvaluateParams): Promise<any>;
+    /**
+     * Navigates back in browser history.
+     */
+    back(): Promise<void>;
+    /**
+     * Navigates forward in browser history.
+     */
+    forward(): Promise<void>;
+    /**
+     * Refreshes the current page.
+     */
+    refresh(): Promise<void>;
+    /**
+     * Gets all cookies.
+     *
+     * @returns Array of cookies
+     */
+    getCookies(): Promise<any[]>;
+    /**
+     * Sets cookies.
+     *
+     * @param params - Cookie parameters
+     */
+    setCookies(params: CookieParams): Promise<void>;
+    /**
+     * Presses a keyboard key.
+     *
+     * @param key - Key name (e.g., 'Enter', 'Tab', 'Escape')
+     */
+    pressKey(key: string): Promise<void>;
+    /**
+     * Waits for an element to be present in the DOM.
+     *
+     * @param params - WaitForSelector parameters
+     */
+    waitForSelector(params: WaitForSelectorParams): Promise<void>;
+    /**
+     * Fills an input element with text (clears existing value first).
+     * More reliable than type() for forms.
+     *
+     * @param params - Fill parameters
+     */
+    fill(params: FillParams): Promise<void>;
+    /**
+     * Checks if an element is visible on the page.
+     *
+     * @param params - IsVisible parameters
+     * @returns true if element is visible, false otherwise
+     */
+    isVisible(params: IsVisibleParams): Promise<boolean>;
+    /**
+     * Ensures a session exists and Playwright is connected.
+     */
+    private _ensureConnected;
+    /**
+     * Connects to the browser via Playwright WebSocket.
+     */
+    private _connectPlaywright;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/playwright/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,UAAU,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,UAAU,EACV,eAAe,EAChB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,iBAAkB,SAAQ,OAAO;IAE5C,OAAO,CAAC,kBAAkB,CAAY;IAEtC,OAAO,CAAC,eAAe,CAAY;IAEnC;;;;OAIG;gBACS,MAAM,EAAE,mBAAmB;IAIvC;;OAEG;IACY,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3C;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD;;;;OAIG;IACG,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAO/C;;;;OAIG;IACG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C;;;;;OAKG;IACG,OAAO,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D;;;;;OAKG;IACG,OAAO,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAY1D;;;;;OAKG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;IAUhF;;;;;OAKG;IAEG,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAKpD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;;;OAIG;IAEG,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAKlC;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrD;;;;OAIG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1C;;;;OAIG;IACG,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQnE;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7C;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB1D;;OAEG;YACW,gBAAgB;IAY9B;;OAEG;YACW,kBAAkB;CAkCjC"}