bedrock-agentcore 0.0.1 → 0.2.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/vercel-ai/tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAsB,MAAM,gBAAgB,CAAA;AAC1F,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAmB;IAEjC;;OAEG;IACH,SAAgB,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;IAE/D;;OAEG;IACH,SAAgB,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;IAEzD;;OAEG;IACH,SAAgB,IAAI,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;IAEvD;;OAEG;IACH,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;IAE7D;;OAEG;IACH,SAAgB,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;IAE7D;;OAEG;IACH,SAAgB,UAAU,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;IAEnE;;OAEG;IACH,SAAgB,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;IAE/D;;;;;;;;;OASG;IACH,SAAgB,KAAK,EAAE;QACrB,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;QAC/C,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAA;QACzC,IAAI,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,CAAA;QACvC,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;QAC7C,OAAO,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAA;QAC7C,UAAU,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAA;QACnD,QAAQ,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;KAChD,CAAA;gBAEW,MAAM,GAAE,mBAAwB;IAwB5C;;;;;;;;;OASG;IACG,YAAY,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOhF;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;;OAMG;IACH,SAAS,IAAI,iBAAiB;CAG/B"}

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

@@ -0,0 +1,145 @@
+/**
+ * Unified BrowserTools for Vercel AI SDK
+ *
+ * Provides browser automation tools and session management in one class.
+ * Thin wrapper around PlaywrightBrowser - all logic lives in the Playwright integration.
+ */
+import { PlaywrightBrowser } from '../playwright/client.js';
+import { createNavigateTool } from './navigate-tool.js';
+import { createClickTool } from './click-tool.js';
+import { createTypeTool } from './type-tool.js';
+import { createGetTextTool } from './get-text-tool.js';
+import { createGetHtmlTool } from './get-html-tool.js';
+import { createScreenshotTool } from './screenshot-tool.js';
+import { createEvaluateTool } from './evaluate-tool.js';
+/**
+ * BrowserTools - All-in-one browser automation for Vercel AI SDK
+ *
+ * Provides browser automation tools and session management.
+ * All browser logic is in PlaywrightBrowser - this is just a thin wrapper.
+ *
+ * @example
+ * ```typescript
+ * import { BrowserTools } from 'bedrock-agentcore/browser/vercel-ai'
+ * import { ToolLoopAgent } from 'ai'
+ * import { bedrock } from '@ai-sdk/amazon-bedrock'
+ *
+ * // Create tools instance
+ * const browser = new BrowserTools({ region: 'us-west-2' })
+ *
+ * // Start session (optional - automatically started on first use)
+ * await browser.startSession()
+ *
+ * // Create agent with browser tools
+ * const agent = new ToolLoopAgent({
+ *   model: bedrock('global.anthropic.claude-sonnet-4-20250514-v1:0'),
+ *   tools: browser.tools,
+ * })
+ *
+ * // Or use client directly
+ * await browser.getClient().navigate({ url: 'https://example.com' })
+ *
+ * // Clean up when done
+ * await browser.stopSession()
+ * ```
+ */
+export class BrowserTools {
+    client;
+    /**
+     * Tool for navigating to URLs
+     */
+    navigate;
+    /**
+     * Tool for clicking elements
+     */
+    click;
+    /**
+     * Tool for typing text
+     */
+    type;
+    /**
+     * Tool for getting text content
+     */
+    getText;
+    /**
+     * Tool for getting HTML
+     */
+    getHtml;
+    /**
+     * Tool for taking screenshots
+     */
+    screenshot;
+    /**
+     * Tool for evaluating JavaScript
+     */
+    evaluate;
+    /**
+     * All tools in an object for easy spreading into agent config
+     *
+     * @example
+     * ```typescript
+     * const agent = new ToolLoopAgent({
+     *   tools: browser.tools, // spreads all browser tools
+     * })
+     * ```
+     */
+    tools;
+    constructor(config = {}) {
+        this.client = new PlaywrightBrowser(config);
+        // Create all tools - each is a thin wrapper around client methods
+        this.navigate = createNavigateTool(this.client);
+        this.click = createClickTool(this.client);
+        this.type = createTypeTool(this.client);
+        this.getText = createGetTextTool(this.client);
+        this.getHtml = createGetHtmlTool(this.client);
+        this.screenshot = createScreenshotTool(this.client);
+        this.evaluate = createEvaluateTool(this.client);
+        // Create tools object for easy spreading
+        this.tools = {
+            navigate: this.navigate,
+            click: this.click,
+            type: this.type,
+            getText: this.getText,
+            getHtml: this.getHtml,
+            screenshot: this.screenshot,
+            evaluate: this.evaluate,
+        };
+    }
+    /**
+     * Start a browser session
+     *
+     * Sessions are automatically started on first tool use, but you can
+     * call this explicitly to start the session upfront.
+     *
+     * @param sessionName - Optional session name for AWS
+     * @param timeout - Optional session timeout in seconds (default: 3600, max: 28800)
+     * @returns Session information
+     */
+    async startSession(sessionName, timeout) {
+        const params = {};
+        if (sessionName !== undefined)
+            params.sessionName = sessionName;
+        if (timeout !== undefined)
+            params.timeout = timeout;
+        return this.client.startSession(Object.keys(params).length > 0 ? params : undefined);
+    }
+    /**
+     * Stop the current browser session
+     *
+     * Call this when you're done using the tools to clean up resources.
+     */
+    async stopSession() {
+        await this.client.stopSession();
+    }
+    /**
+     * Get the underlying PlaywrightBrowser
+     *
+     * Provides direct access to the client for advanced use cases.
+     *
+     * @returns The PlaywrightBrowser instance
+     */
+    getClient() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=tools.js.map

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

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

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

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

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

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

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

@@ -0,0 +1,35 @@
+import { tool } from 'ai';
+import { z } from 'zod';
+/**
+ * Creates a Vercel AI tool for typing text.
+ * Thin wrapper around PlaywrightBrowser.type()
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createTypeTool(client) {
+    return tool({
+        description: 'Type text into an input element',
+        inputSchema: z.object({
+            selector: z.string().describe('CSS selector for the input element'),
+            text: z.string().describe('Text to type'),
+            delay: z.number().positive().optional().describe('Time to wait between key presses in milliseconds'),
+            timeout: z.number().positive().optional().describe('Maximum time in milliseconds'),
+        }),
+        execute: async ({ selector, text, delay, timeout }) => {
+            'use step';
+            try {
+                const params = { selector, text };
+                if (delay !== undefined)
+                    params.delay = delay;
+                if (timeout !== undefined)
+                    params.timeout = timeout;
+                await client.type(params);
+                return { success: true, message: `Typed text into ${selector}` };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return { success: false, error: message };
+            }
+        },
+    });
+}
+//# sourceMappingURL=type-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/vercel-ai/type-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,cAAc,CAAC,MAAyB;IACtD,OAAO,IAAI,CAAC;QACV,WAAW,EAAE,iCAAiC;QAC9C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YACnE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;YACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YACpG,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,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;YACpD,UAAU,CAAA;YACV,IAAI,CAAC;gBACH,MAAM,MAAM,GAAyE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;gBACvG,IAAI,KAAK,KAAK,SAAS;oBAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAA;gBAC7C,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;gBACnD,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,QAAQ,EAAE,EAAE,CAAA;YAClE,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/types.d.ts

@@ -0,0 +1,336 @@
+import type { AwsCredentialIdentityProvider } from '@aws-sdk/types';
+/**
+ * Default browser identifier for system browser.
+ */
+export declare const DEFAULT_IDENTIFIER = "aws.browser.v1";
+/**
+ * Default session name.
+ */
+export declare const DEFAULT_SESSION_NAME = "default";
+/**
+ * Default session timeout in seconds (1 hour).
+ */
+export declare const DEFAULT_TIMEOUT = 3600;
+/**
+ * Default AWS region.
+ */
+export declare const DEFAULT_REGION = "us-west-2";
+/**
+ * Configuration options for BrowserClient.
+ */
+export interface BrowserClientConfig {
+    /**
+     * AWS region where the browser service is deployed.
+     * Defaults to process.env.AWS_REGION or 'us-west-2'.
+     */
+    region?: string;
+    /**
+     * Browser identifier to use for sessions.
+     * Defaults to 'aws.browser.v1' for system browser.
+     */
+    identifier?: string;
+    /**
+     * Optional AWS credentials provider.
+     * When omitted, the SDK uses the default Node.js credential provider chain.
+     *
+     * @example
+     * Using Vercel OIDC credentials:
+     * ```ts
+     * import { vercelOidcAwsCredentials } from '\@vercel/oidc-aws-credentials-provider'
+     *
+     * const browser = new BrowserClient(\{
+     *   region: process.env.AWS_REGION || 'us-west-2',
+     *   credentialsProvider: vercelOidcAwsCredentials()
+     * \})
+     * ```
+     */
+    credentialsProvider?: AwsCredentialIdentityProvider;
+}
+/**
+ * Parameters for starting a browser session.
+ */
+export interface StartSessionParams {
+    /**
+     * Optional name for the browser session.
+     * If not provided, defaults to 'default'.
+     */
+    sessionName?: string;
+    /**
+     * Session timeout in seconds.
+     * Valid range: 1-28800 seconds (1 second to 8 hours).
+     * Defaults to 3600 seconds (1 hour).
+     */
+    timeout?: number;
+    /**
+     * Viewport dimensions for the browser.
+     */
+    viewport?: ViewportConfig;
+}
+/**
+ * Viewport configuration for browser sessions.
+ */
+export interface ViewportConfig {
+    /**
+     * Viewport width in pixels.
+     */
+    width: number;
+    /**
+     * Viewport height in pixels.
+     */
+    height: number;
+}
+/**
+ * Information about an active browser session.
+ */
+export interface SessionInfo {
+    /**
+     * Name of the session.
+     */
+    sessionName: string;
+    /**
+     * Unique session identifier assigned by AWS.
+     */
+    sessionId: string;
+    /**
+     * Timestamp when the session was created.
+     */
+    createdAt: Date;
+    /**
+     * Optional description of the session.
+     */
+    description?: string;
+}
+/**
+ * Parameters for getting browser session details.
+ */
+export interface GetSessionParams {
+    /**
+     * Browser identifier.
+     * Uses current instance identifier if not provided.
+     */
+    browserId?: string;
+    /**
+     * Session ID to query.
+     * Uses current active session ID if not provided.
+     */
+    sessionId?: string;
+}
+/**
+ * Stream endpoint information for browser sessions.
+ */
+export interface StreamInfo {
+    /**
+     * WebSocket endpoint URL for the stream.
+     */
+    streamEndpoint?: string;
+    /**
+     * Status of the stream.
+     */
+    streamStatus?: string;
+}
+/**
+ * Live view stream information for browser sessions.
+ */
+export interface LiveViewStreamInfo {
+    /**
+     * WebSocket endpoint URL for the live view stream.
+     */
+    streamEndpoint?: string;
+}
+/**
+ * Browser session streams for automation and live viewing.
+ */
+export interface BrowserSessionStreams {
+    /**
+     * Automation stream for browser control.
+     */
+    automationStream?: StreamInfo;
+    /**
+     * Live view stream for viewing browser state.
+     */
+    liveViewStream?: LiveViewStreamInfo;
+}
+/**
+ * Detailed session information returned by getSession.
+ */
+export interface GetSessionResponse {
+    /**
+     * AWS-assigned session identifier.
+     */
+    sessionId: string;
+    /**
+     * Browser identifier.
+     */
+    browserIdentifier: string;
+    /**
+     * Session name.
+     */
+    name: string;
+    /**
+     * Session status.
+     * Common values: 'READY', 'TERMINATED'
+     */
+    status: string;
+    /**
+     * Timestamp when session was created.
+     */
+    createdAt: Date;
+    /**
+     * Timestamp when session was last updated.
+     */
+    lastUpdatedAt: Date;
+    /**
+     * Session timeout in seconds.
+     */
+    sessionTimeoutSeconds: number;
+    /**
+     * Stream endpoints for browser automation and live viewing.
+     */
+    streams?: BrowserSessionStreams;
+}
+/**
+ * Parameters for listing browser sessions.
+ */
+export interface ListSessionsParams {
+    /**
+     * Browser identifier.
+     * Uses current instance identifier if not provided.
+     */
+    browserId?: string;
+    /**
+     * Filter by session status.
+     * Common values: 'READY', 'TERMINATED'
+     */
+    status?: string;
+    /**
+     * Maximum number of results to return (1-100).
+     * Defaults to 10
+     */
+    maxResults?: number;
+    /**
+     * Pagination token for fetching next page of results.
+     */
+    nextToken?: string;
+}
+/**
+ * Summary information for a browser session in list results.
+ */
+export interface SessionSummary {
+    /**
+     * AWS-assigned session identifier.
+     */
+    sessionId: string;
+    /**
+     * Session name.
+     */
+    name: string;
+    /**
+     * Session status.
+     * Common values: 'READY', 'TERMINATED'
+     */
+    status: string;
+    /**
+     * Timestamp when session was created.
+     */
+    createdAt: Date;
+    /**
+     * Timestamp when session was last updated.
+     */
+    lastUpdatedAt: Date;
+}
+/**
+ * Response from listing browser sessions.
+ */
+export interface ListSessionsResponse {
+    /**
+     * List of session summaries.
+     */
+    items: SessionSummary[];
+    /**
+     * Token for fetching next page of results.
+     * Present if there are more results available.
+     */
+    nextToken?: string;
+}
+/**
+ * Parameters for updating the browser automation stream.
+ */
+export interface UpdateStreamParams {
+    /**
+     * Browser identifier.
+     * Uses current instance identifier if not provided.
+     */
+    browserId?: string;
+    /**
+     * Session ID.
+     * Uses current active session ID if not provided.
+     */
+    sessionId?: string;
+    /**
+     * New stream status for the automation stream.
+     * 'ENABLED' to enable the stream, 'DISABLED' to disable it.
+     */
+    streamStatus: 'ENABLED' | 'DISABLED';
+}
+/**
+ * Response from updating a browser stream.
+ */
+export interface UpdateStreamResponse {
+    /**
+     * Stream endpoint URL.
+     */
+    streamEndpoint?: string;
+    /**
+     * Updated stream status.
+     */
+    streamStatus?: string;
+}
+/**
+ * WebSocket connection details for browser automation.
+ */
+export interface WebSocketConnection {
+    /**
+     * WebSocket URL (wss://) for connecting to the browser.
+     */
+    url: string;
+    /**
+     * HTTP headers required for WebSocket authentication.
+     * Includes Authorization, X-Amz-Date, and security token headers.
+     */
+    headers: Record<string, string>;
+}
+/**
+ * Session status information.
+ */
+export interface SessionStatus {
+    /**
+     * Current status of the session.
+     */
+    status: 'READY' | 'TERMINATED' | 'TERMINATING';
+    /**
+     * Timestamp when the session was created.
+     */
+    createdAt?: Date;
+    /**
+     * Timestamp when the session was last updated.
+     */
+    updatedAt?: Date;
+}
+/**
+ * Result of a browser operation.
+ */
+export interface BrowserOperationResult {
+    /**
+     * Whether the operation succeeded.
+     */
+    success: boolean;
+    /**
+     * Error message if the operation failed.
+     */
+    error?: string;
+    /**
+     * Additional data returned from the operation.
+     */
+    data?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * Default browser identifier for system browser.
+ */
+export const DEFAULT_IDENTIFIER = 'aws.browser.v1';
+/**
+ * Default session name.
+ */
+export const DEFAULT_SESSION_NAME = 'default';
+/**
+ * Default session timeout in seconds (1 hour).
+ */
+export const DEFAULT_TIMEOUT = 3600;
+/**
+ * Default AWS region.
+ */
+export const DEFAULT_REGION = 'us-west-2';
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/tools/browser/types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAA;AAElD;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAA;AAE7C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAA"}