bedrock-agentcore 0.0.1 → 0.2.0

package/dist/src/tools/browser/integrations/strands/evaluate-tool.js

@@ -0,0 +1,34 @@
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for evaluating JavaScript.
+ * Thin wrapper around PlaywrightBrowser.evaluate()
+ *
+ * @experimental
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createEvaluateTool(client) {
+    return tool({
+        name: 'evaluate',
+        description: 'Evaluate JavaScript code in the page context',
+        inputSchema: z.object({
+            script: z.string().describe('JavaScript code to execute'),
+            args: z.array(z.any()).optional().describe('Arguments to pass to the script'),
+        }),
+        callback: async ({ script, args }) => {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const params = { script };
+                if (args !== undefined)
+                    params.args = args;
+                const result = await client.evaluate(params);
+                return { success: true, result };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return { success: false, error: message };
+            }
+        },
+    });
+}
+//# sourceMappingURL=evaluate-tool.js.map

package/dist/src/tools/browser/integrations/strands/evaluate-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/evaluate-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;GAKG;AACH,+HAA+H;AAC/H,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YACzD,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAC9E,CAAC;QACF,QAAQ,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE;YACnC,IAAI,CAAC;gBACH,8DAA8D;gBAC9D,MAAM,MAAM,GAAqC,EAAE,MAAM,EAAE,CAAA;gBAC3D,IAAI,IAAI,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;gBAC1C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;gBAC5C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;YAClC,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/strands/get-html-tool.d.ts

@@ -0,0 +1,19 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Strands SDK tool for getting HTML content.
+ * Thin wrapper around PlaywrightBrowser.getHtml()
+ *
+ * @experimental
+ */
+export declare function createGetHtmlTool(client: PlaywrightBrowser): import("@strands-agents/sdk").InvokableTool<{
+    selector?: string | undefined;
+}, {
+    success: true;
+    html: string;
+    error?: never;
+} | {
+    success: false;
+    error: string;
+    html?: never;
+}>;
+//# sourceMappingURL=get-html-tool.d.ts.map

package/dist/src/tools/browser/integrations/strands/get-html-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-html-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/get-html-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;GAmB1D"}

package/dist/src/tools/browser/integrations/strands/get-html-tool.js

@@ -0,0 +1,32 @@
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for getting HTML content.
+ * Thin wrapper around PlaywrightBrowser.getHtml()
+ *
+ * @experimental
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createGetHtmlTool(client) {
+    return tool({
+        name: 'getHtml',
+        description: 'Get HTML content from an element or the entire page',
+        inputSchema: z.object({
+            selector: z.string().optional().describe('CSS selector for the element (omit for full page HTML)'),
+        }),
+        callback: async ({ selector }) => {
+            try {
+                const params = {};
+                if (selector !== undefined)
+                    params.selector = selector;
+                const html = await client.getHtml(params);
+                return { success: true, html };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return { success: false, error: message };
+            }
+        },
+    });
+}
+//# sourceMappingURL=get-html-tool.js.map

package/dist/src/tools/browser/integrations/strands/get-html-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-html-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/get-html-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;GAKG;AACH,+HAA+H;AAC/H,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;SACnG,CAAC;QACF,QAAQ,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAA0B,EAAE,CAAA;gBACxC,IAAI,QAAQ,KAAK,SAAS;oBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;gBACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;YAChC,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/strands/get-text-tool.d.ts

@@ -0,0 +1,19 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Strands SDK tool for getting text content.
+ * Thin wrapper around PlaywrightBrowser.getText()
+ *
+ * @experimental
+ */
+export declare function createGetTextTool(client: PlaywrightBrowser): import("@strands-agents/sdk").InvokableTool<{
+    selector?: string | undefined;
+}, {
+    success: true;
+    text: string;
+    error?: never;
+} | {
+    success: false;
+    error: string;
+    text?: never;
+}>;
+//# sourceMappingURL=get-text-tool.d.ts.map

package/dist/src/tools/browser/integrations/strands/get-text-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-text-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/get-text-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;;;;GAKG;AAEH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;GAmB1D"}

package/dist/src/tools/browser/integrations/strands/get-text-tool.js

@@ -0,0 +1,32 @@
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for getting text content.
+ * Thin wrapper around PlaywrightBrowser.getText()
+ *
+ * @experimental
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createGetTextTool(client) {
+    return tool({
+        name: 'getText',
+        description: 'Get text content from an element or the entire page',
+        inputSchema: z.object({
+            selector: z.string().optional().describe('CSS selector for the element (omit for full page text)'),
+        }),
+        callback: async ({ selector }) => {
+            try {
+                const params = {};
+                if (selector !== undefined)
+                    params.selector = selector;
+                const text = await client.getText(params);
+                return { success: true, text };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return { success: false, error: message };
+            }
+        },
+    });
+}
+//# sourceMappingURL=get-text-tool.js.map

package/dist/src/tools/browser/integrations/strands/get-text-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-text-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/get-text-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;GAKG;AACH,+HAA+H;AAC/H,MAAM,UAAU,iBAAiB,CAAC,MAAyB;IACzD,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,qDAAqD;QAClE,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;SACnG,CAAC;QACF,QAAQ,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAA0B,EAAE,CAAA;gBACxC,IAAI,QAAQ,KAAK,SAAS;oBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;gBACtD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;gBACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;YAChC,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/strands/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Strands SDK Browser Tool Integration
+ *
+ * **⚠️ EXPERIMENTAL:** This integration uses the Strands TypeScript SDK, which is
+ * currently experimental and subject to breaking changes. See
+ * https://strandsagents.com/latest/documentation/docs/user-guide/quickstart/typescript/
+ *
+ * This module provides Strands SDK integration for the AWS Bedrock AgentCore Browser service.
+ * It follows the three-layer architecture:
+ * - User Application Layer (Strands SDK)
+ * - Integration Layer (this module - thin wrappers)
+ * - Base Client Layer (BrowserClient - all browser logic)
+ * - AWS SDK Layer (\@aws-sdk/client-bedrock-agentcore)
+ *
+ * @experimental
+ */
+export { BrowserTools } from './tools.js';
+export { createNavigateTool } from './navigate-tool.js';
+export { createClickTool } from './click-tool.js';
+export { createTypeTool } from './type-tool.js';
+export { createGetTextTool } from './get-text-tool.js';
+export { createGetHtmlTool } from './get-html-tool.js';
+export { createScreenshotTool } from './screenshot-tool.js';
+export { createEvaluateTool } from './evaluate-tool.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,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"}

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

@@ -0,0 +1,25 @@
+/**
+ * Strands SDK Browser Tool Integration
+ *
+ * **⚠️ EXPERIMENTAL:** This integration uses the Strands TypeScript SDK, which is
+ * currently experimental and subject to breaking changes. See
+ * https://strandsagents.com/latest/documentation/docs/user-guide/quickstart/typescript/
+ *
+ * This module provides Strands SDK integration for the AWS Bedrock AgentCore Browser service.
+ * It follows the three-layer architecture:
+ * - User Application Layer (Strands SDK)
+ * - Integration Layer (this module - thin wrappers)
+ * - Base Client Layer (BrowserClient - all browser logic)
+ * - AWS SDK Layer (\@aws-sdk/client-bedrock-agentcore)
+ *
+ * @experimental
+ */
+export { BrowserTools } from './tools.js';
+export { createNavigateTool } from './navigate-tool.js';
+export { createClickTool } from './click-tool.js';
+export { createTypeTool } from './type-tool.js';
+export { createGetTextTool } from './get-text-tool.js';
+export { createGetHtmlTool } from './get-html-tool.js';
+export { createScreenshotTool } from './screenshot-tool.js';
+export { createEvaluateTool } from './evaluate-tool.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,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"}

package/dist/src/tools/browser/integrations/strands/navigate-tool.d.ts

@@ -0,0 +1,21 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Strands SDK tool for browser navigation.
+ * Thin wrapper around PlaywrightBrowser.navigate()
+ *
+ * @experimental
+ */
+export declare function createNavigateTool(client: PlaywrightBrowser): import("@strands-agents/sdk").InvokableTool<{
+    url: string;
+    waitUntil?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout?: number | undefined;
+}, {
+    success: true;
+    message: string;
+    error?: never;
+} | {
+    success: false;
+    error: string;
+    message?: never;
+}>;
+//# sourceMappingURL=navigate-tool.d.ts.map

package/dist/src/tools/browser/integrations/strands/navigate-tool.d.ts.map

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

package/dist/src/tools/browser/integrations/strands/navigate-tool.js

@@ -0,0 +1,41 @@
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for browser navigation.
+ * Thin wrapper around PlaywrightBrowser.navigate()
+ *
+ * @experimental
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createNavigateTool(client) {
+    return tool({
+        name: 'navigate',
+        description: 'Navigate to a URL in the browser',
+        inputSchema: z.object({
+            url: z.string().url().describe('URL to navigate to'),
+            waitUntil: z
+                .enum(['load', 'domcontentloaded', 'networkidle'])
+                .optional()
+                .describe('When to consider navigation successful'),
+            timeout: z.number().positive().optional().describe('Maximum navigation time in milliseconds'),
+        }),
+        callback: async ({ url, waitUntil, timeout }) => {
+            try {
+                const params = {
+                    url,
+                };
+                if (waitUntil !== undefined)
+                    params.waitUntil = waitUntil;
+                if (timeout !== undefined)
+                    params.timeout = timeout;
+                await client.navigate(params);
+                return { success: true, message: `Navigated to ${url}` };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return { success: false, error: message };
+            }
+        },
+    });
+}
+//# sourceMappingURL=navigate-tool.js.map

package/dist/src/tools/browser/integrations/strands/navigate-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigate-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/navigate-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;GAKG;AACH,+HAA+H;AAC/H,MAAM,UAAU,kBAAkB,CAAC,MAAyB;IAC1D,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,kCAAkC;QAC/C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAC;YACpD,SAAS,EAAE,CAAC;iBACT,IAAI,CAAC,CAAC,MAAM,EAAE,kBAAkB,EAAE,aAAa,CAAC,CAAC;iBACjD,QAAQ,EAAE;iBACV,QAAQ,CAAC,wCAAwC,CAAC;YACrD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;SAC9F,CAAC;QACF,QAAQ,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;YAC9C,IAAI,CAAC;gBACH,MAAM,MAAM,GAA+F;oBACzG,GAAG;iBACJ,CAAA;gBACD,IAAI,SAAS,KAAK,SAAS;oBAAE,MAAM,CAAC,SAAS,GAAG,SAAS,CAAA;gBACzD,IAAI,OAAO,KAAK,SAAS;oBAAE,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;gBACnD,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;gBAC7B,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,gBAAgB,GAAG,EAAE,EAAE,CAAA;YAC1D,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/strands/screenshot-tool.d.ts

@@ -0,0 +1,29 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Strands SDK tool for taking screenshots.
+ * Thin wrapper around PlaywrightBrowser.screenshot()
+ *
+ * @experimental
+ */
+export declare function createScreenshotTool(client: PlaywrightBrowser): import("@strands-agents/sdk").InvokableTool<{
+    path?: string | undefined;
+    fullPage?: boolean | undefined;
+    type?: "png" | "jpeg" | undefined;
+    encoding?: "base64" | "binary" | undefined;
+}, {
+    success: true;
+    message: string;
+    screenshot: string;
+    error?: never;
+} | {
+    success: true;
+    message: string;
+    screenshot?: never;
+    error?: never;
+} | {
+    success: false;
+    error: string;
+    message?: never;
+    screenshot?: never;
+}>;
+//# sourceMappingURL=screenshot-tool.d.ts.map

package/dist/src/tools/browser/integrations/strands/screenshot-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-tool.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/screenshot-tool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAEhE;;;;;GAKG;AAEH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;GAsC7D"}

package/dist/src/tools/browser/integrations/strands/screenshot-tool.js

@@ -0,0 +1,52 @@
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for taking screenshots.
+ * Thin wrapper around PlaywrightBrowser.screenshot()
+ *
+ * @experimental
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createScreenshotTool(client) {
+    return tool({
+        name: 'screenshot',
+        description: 'Take a screenshot of the page',
+        inputSchema: z.object({
+            path: z.string().optional().describe('Path to save the screenshot file'),
+            fullPage: z.boolean().optional().describe('Capture the full scrollable page'),
+            type: z.enum(['png', 'jpeg']).optional().describe('Image type'),
+            encoding: z.enum(['base64', 'binary']).optional().describe('Encoding format'),
+        }),
+        callback: async ({ path, fullPage, type, encoding }) => {
+            try {
+                const params = {};
+                if (path !== undefined)
+                    params.path = path;
+                if (fullPage !== undefined)
+                    params.fullPage = fullPage;
+                if (type !== undefined)
+                    params.type = type;
+                if (encoding !== undefined)
+                    params.encoding = encoding;
+                const screenshot = await client.screenshot(params);
+                const isBase64 = encoding === 'base64';
+                if (isBase64 && typeof screenshot === 'string') {
+                    return {
+                        success: true,
+                        message: path ? `Screenshot saved to ${path}` : 'Screenshot captured',
+                        screenshot,
+                    };
+                }
+                return {
+                    success: true,
+                    message: path ? `Screenshot saved to ${path}` : 'Screenshot captured',
+                };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown error';
+                return { success: false, error: message };
+            }
+        },
+    });
+}
+//# sourceMappingURL=screenshot-tool.js.map

package/dist/src/tools/browser/integrations/strands/screenshot-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/screenshot-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAA;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;GAKG;AACH,+HAA+H;AAC/H,MAAM,UAAU,oBAAoB,CAAC,MAAyB;IAC5D,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,+BAA+B;QAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YACxE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;YAC7E,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YAC/D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;SAC9E,CAAC;QACF,QAAQ,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;YACrD,IAAI,CAAC;gBACH,MAAM,MAAM,GAAiG,EAAE,CAAA;gBAC/G,IAAI,IAAI,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;gBAC1C,IAAI,QAAQ,KAAK,SAAS;oBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;gBACtD,IAAI,IAAI,KAAK,SAAS;oBAAE,MAAM,CAAC,IAAI,GAAG,IAAI,CAAA;gBAC1C,IAAI,QAAQ,KAAK,SAAS;oBAAE,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAA;gBACtD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;gBAClD,MAAM,QAAQ,GAAG,QAAQ,KAAK,QAAQ,CAAA;gBAEtC,IAAI,QAAQ,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBAC/C,OAAO;wBACL,OAAO,EAAE,IAAa;wBACtB,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC,qBAAqB;wBACrE,UAAU;qBACX,CAAA;gBACH,CAAC;gBAED,OAAO;oBACL,OAAO,EAAE,IAAa;oBACtB,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC,CAAC,qBAAqB;iBACtE,CAAA;YACH,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,KAAc,EAAE,KAAK,EAAE,OAAO,EAAE,CAAA;YACpD,CAAC;QACH,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/tools/browser/integrations/strands/tools.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Unified BrowserTools for Strands 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 type { BrowserClientConfig, SessionInfo } from '../../types.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 Strands 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/experimental/browser/strands'
+ * import { Agent, BedrockModel } from '@strands-agents/sdk'
+ *
+ * // 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 Agent({
+ *   model: new BedrockModel({ modelId: '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 declare class BrowserTools {
+    private client;
+    /**
+     * Tool for navigating to URLs
+     */
+    readonly navigate: ReturnType<typeof createNavigateTool>;
+    /**
+     * Tool for clicking elements
+     */
+    readonly click: ReturnType<typeof createClickTool>;
+    /**
+     * Tool for typing text
+     */
+    readonly type: ReturnType<typeof createTypeTool>;
+    /**
+     * Tool for getting text content
+     */
+    readonly getText: ReturnType<typeof createGetTextTool>;
+    /**
+     * Tool for getting HTML
+     */
+    readonly getHtml: ReturnType<typeof createGetHtmlTool>;
+    /**
+     * Tool for taking screenshots
+     */
+    readonly screenshot: ReturnType<typeof createScreenshotTool>;
+    /**
+     * Tool for evaluating JavaScript
+     */
+    readonly evaluate: ReturnType<typeof createEvaluateTool>;
+    /**
+     * All tools in an array for easy spreading into agent config
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({
+     *   tools: browser.tools, // spreads all browser tools
+     * })
+     *
+     * // Or combine with other tools
+     * const agent = new Agent({
+     *   tools: [...codeInterpreter.tools, ...browser.tools],
+     * })
+     * ```
+     */
+    readonly tools: Array<ReturnType<typeof createNavigateTool> | ReturnType<typeof createClickTool> | ReturnType<typeof createTypeTool> | ReturnType<typeof createGetTextTool> | ReturnType<typeof createGetHtmlTool> | ReturnType<typeof createScreenshotTool> | ReturnType<typeof createEvaluateTool>>;
+    constructor(config?: BrowserClientConfig);
+    /**
+     * 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
+     */
+    startSession(sessionName?: string, timeout?: number): Promise<SessionInfo>;
+    /**
+     * Stop the current browser session
+     *
+     * Call this when you're done using the tools to clean up resources.
+     */
+    stopSession(): Promise<void>;
+    /**
+     * Get the underlying PlaywrightBrowser
+     *
+     * Provides direct access to the client for advanced use cases.
+     *
+     * @returns The PlaywrightBrowser instance
+     */
+    getClient(): PlaywrightBrowser;
+}
+//# sourceMappingURL=tools.d.ts.map

package/dist/src/tools/browser/integrations/strands/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;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;;;;;;;;;;;;;;OAcG;IACH,SAAgB,KAAK,EAAE,KAAK,CACxB,UAAU,CAAC,OAAO,kBAAkB,CAAC,GACrC,UAAU,CAAC,OAAO,eAAe,CAAC,GAClC,UAAU,CAAC,OAAO,cAAc,CAAC,GACjC,UAAU,CAAC,OAAO,iBAAiB,CAAC,GACpC,UAAU,CAAC,OAAO,iBAAiB,CAAC,GACpC,UAAU,CAAC,OAAO,oBAAoB,CAAC,GACvC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CACxC,CAAA;gBAEW,MAAM,GAAE,mBAAwB;IAgB5C;;;;;;;;;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/strands/tools.js

@@ -0,0 +1,141 @@
+/**
+ * Unified BrowserTools for Strands 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 Strands 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/experimental/browser/strands'
+ * import { Agent, BedrockModel } from '@strands-agents/sdk'
+ *
+ * // 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 Agent({
+ *   model: new BedrockModel({ modelId: '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 array for easy spreading into agent config
+     *
+     * @example
+     * ```typescript
+     * const agent = new Agent({
+     *   tools: browser.tools, // spreads all browser tools
+     * })
+     *
+     * // Or combine with other tools
+     * const agent = new Agent({
+     *   tools: [...codeInterpreter.tools, ...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 array for Strands SDK (uses arrays, not objects)
+        this.tools = [this.navigate, this.click, this.type, this.getText, this.getHtml, this.screenshot, 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