bedrock-agentcore 0.1.1 → 0.2.0

package/dist/src/runtime/types.d.ts

@@ -0,0 +1,429 @@
+import type { AwsCredentialIdentityProvider } from '@aws-sdk/types';
+import type { FastifyBodyParser, FastifyContentTypeParser, FastifyBaseLogger, FastifyLoggerOptions, FastifyRequest } from 'fastify';
+import { Buffer } from 'buffer';
+import { z } from 'zod';
+import type { WebSocket } from '@fastify/websocket';
+import type { SSESource } from '@fastify/sse';
+/**
+ * Context provided to handler functions for each invocation request.
+ */
+export interface RequestContext {
+    /**
+     * Unique identifier for the session making the request.
+     */
+    sessionId: string;
+    /**
+     * HTTP headers from the incoming request.
+     * Filtered to include only Authorization and Custom-* headers.
+     */
+    headers: Record<string, string>;
+    /**
+     * Workload access token for authenticating with AgentCore Identity.
+     * Set by RuntimeApp when WorkloadAccessToken header is present.
+     * Used by Identity SDK to fetch OAuth2 tokens and API keys.
+     */
+    workloadAccessToken?: string | undefined;
+    /**
+     * Request ID for tracing and log correlation.
+     * Extracted from X-Amzn-Bedrock-AgentCore-Runtime-Request-Id header
+     * or auto-generated if not provided.
+     */
+    requestId?: string | undefined;
+    /**
+     * OAuth2 callback URL for authentication flows.
+     * Extracted from OAuth2CallbackUrl header when present.
+     */
+    oauth2CallbackUrl?: string | undefined;
+    /**
+     * Request-scoped logger with automatic context (request ID, method, URL).
+     * Handlers should use this for all logging to ensure proper request correlation.
+     */
+    log: FastifyBaseLogger;
+}
+/**
+ * Handler function type for processing agent invocations.
+ *
+ * The handler accepts and returns unknown types to support
+ * arbitrary JSON payloads from AgentCore Runtime. The handler can also
+ * return an async generator for streaming responses via Server-Sent Events.
+ *
+ * @param request - The request payload from AgentCore Runtime
+ * @param context - Additional context including sessionId and headers
+ * @returns Response data (any serializable type) or async generator for streaming
+ */
+export type InvocationHandler<TRequest = unknown> = (request: TRequest, context: RequestContext) => Promise<unknown> | unknown | AsyncGenerator<SSESource, void, unknown>;
+/**
+ * WebSocket handler function type for processing WebSocket connections.
+ *
+ * @param connection - Fastify WebSocket connection object
+ * @param context - Request context including sessionId and headers
+ */
+export type WebSocketHandler = (socket: WebSocket, context: RequestContext) => Promise<void> | void;
+/**
+ * Content type parser configuration using Fastify's native types.
+ * @example
+ * ```typescript
+ * const app = new BedrockAgentCoreApp({
+ *   invocationHandler: { process: myHandler },
+ *   config: {
+ *     contentTypeParsers: [
+ *       {
+ *         contentType: 'application/xml',
+ *         parser: (request, body) => parseXML(body as string),
+ *         parseAs: 'string'
+ *       },
+ *       {
+ *         contentType: 'application/pdf',
+ *         parser: (request, body) => parsePDF(body as Buffer),
+ *         parseAs: 'buffer'
+ *       },
+ *       {
+ *         contentType: 'application/large-csv',
+ *         parser: (request, payload) => parseStreamingCSV(payload),
+ *         // parseAs omitted for stream mode (uses FastifyContentTypeParser)
+ *       }
+ *     ]
+ *   }
+ * })
+ * ```
+ */
+export interface ContentTypeParserConfig {
+    /**
+     * Content type to handle (e.g., 'application/xml', 'text/csv').
+     * Can be a string, array of strings, or RegExp.
+     */
+    contentType: string | string[] | RegExp;
+    /**
+     * Parser function to process the request body.
+     * Uses Fastify's native FastifyBodyParser for string/buffer modes,
+     * or FastifyContentTypeParser for stream mode.
+     */
+    parser: FastifyBodyParser<string | Buffer> | FastifyContentTypeParser;
+    /**
+     * How to parse the raw request body before passing to the parser function.
+     * - 'string': body is parsed as string (uses FastifyBodyParser<string>)
+     * - 'buffer': body is parsed as buffer (uses FastifyBodyParser<Buffer>)
+     * - 'stream': body is passed as raw stream (uses FastifyContentTypeParser)
+     *
+     * Defaults to 'string' when not specified.
+     */
+    parseAs?: 'string' | 'buffer' | 'stream';
+    /**
+     * The maximum payload size, in bytes, that the custom parser will accept
+     * Defaults to Fastify's global body limit (1MB default)
+     */
+    bodyLimit?: number;
+}
+/**
+ * Configuration options for BedrockAgentCoreApp.
+ */
+export interface BedrockAgentCoreAppConfig {
+    /**
+     * Logging configuration options.
+     */
+    logging?: {
+        /**
+         * Enable or disable logging.
+         * Defaults to true.
+         */
+        enabled?: boolean;
+        /**
+         * Disable automatic request/response logging.
+         *
+         * Can be:
+         * - `boolean` - Disable for all requests
+         * - `function` - Conditionally disable based on request properties
+         *
+         * When enabled, Fastify won't log "incoming request" and "request completed" messages.
+         * Manual logging with context.log still works.
+         *
+         * Defaults to `(req) =\> req.url === '/ping'` - disables logging for health checks
+         *
+         * @example
+         * ```typescript
+         * // Disable for all requests
+         * disableRequestLogging: true
+         *
+         * // Disable only for health checks (default behavior)
+         * disableRequestLogging: (request) => request.url === '/ping'
+         *
+         * // Disable for multiple endpoints
+         * disableRequestLogging: (request) => {
+         *   return ['/ping', '/health', '/metrics'].includes(request.url)
+         * }
+         *
+         * // Disable for load balancer health checks
+         * disableRequestLogging: (request) => {
+         *   return request.headers['user-agent']?.includes('ELB-HealthChecker')
+         * }
+         * ```
+         */
+        disableRequestLogging?: boolean | ((request: FastifyRequest) => boolean);
+        /**
+         * Fastify logger options.
+         *
+         * Configure log level, custom serializers, streams, and more.
+         *
+         * @see https://fastify.dev/docs/latest/Reference/Server/#logger
+         *
+         * @example
+         * ```typescript
+         * // Set log level
+         * logging: {
+         *   options: { level: 'debug' }
+         * }
+         *
+         * // Custom stream (e.g., CloudWatch)
+         * logging: {
+         *   options: {
+         *     level: 'info',
+         *     stream: cloudWatchStream
+         *   }
+         * }
+         *
+         * // Filter sensitive data
+         * logging: {
+         *   options: {
+         *     level: 'info',
+         *     serializers: {
+         *       req: (req) => ({
+         *         method: req.method,
+         *         url: req.url
+         *         // Authorization header excluded
+         *       })
+         *     }
+         *   }
+         * }
+         * ```
+         */
+        options?: FastifyLoggerOptions;
+    };
+    /**
+     * Custom content type parsers for handling custom content-types.
+     * 'application/json' and 'text/plain' are natively supported.
+     */
+    contentTypeParsers?: ContentTypeParserConfig[];
+}
+/**
+ * Parameters for BedrockAgentCoreApp constructor.
+ */
+export interface BedrockAgentCoreAppParams<TSchema extends z.ZodSchema = z.ZodSchema<unknown>> {
+    /**
+     * Invocation handler configuration with validation and typing.
+     */
+    invocationHandler: {
+        /**
+         * The function to process invocation requests.
+         */
+        process: InvocationHandler<z.infer<TSchema>>;
+        /**
+         * Optional Zod schema for request validation and TypeScript typing.
+         * When provided, validates request.body before passing to handler.
+         * When omitted, handler receives unknown request type.
+         */
+        requestSchema?: TSchema;
+    };
+    /**
+     * WebSocket handler for the /ws endpoint.
+     */
+    websocketHandler?: WebSocketHandler;
+    /**
+     * Additional configuration options.
+     */
+    config?: BedrockAgentCoreAppConfig;
+    /**
+     * Custom ping handler to determine health status.
+     */
+    pingHandler?: () => HealthStatus | Promise<HealthStatus>;
+}
+/**
+ * Health status values for the /ping endpoint.
+ */
+export type HealthStatus = 'Healthy' | 'HealthyBusy';
+/**
+ * Health check response format.
+ */
+export interface HealthCheckResponse {
+    /**
+     * Current health status of the application.
+     */
+    status: HealthStatus;
+    /**
+     * ISO 8601 timestamp of the last update.
+     */
+    time_of_last_update: string;
+}
+/**
+ * Information about a tracked async task.
+ */
+export interface AsyncTaskInfo {
+    name: string;
+    startTime: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Status information about all async tasks.
+ */
+export interface AsyncTaskStatus {
+    activeCount: number;
+    runningJobs: Array<{
+        name: string;
+        duration: number;
+    }>;
+}
+/**
+ * Default presigned URL timeout in seconds (5 minutes).
+ */
+export declare const DEFAULT_PRESIGNED_URL_TIMEOUT = 300;
+/**
+ * Maximum presigned URL timeout in seconds (5 minutes).
+ */
+export declare const MAX_PRESIGNED_URL_TIMEOUT = 300;
+/**
+ * Default AWS region.
+ */
+export declare const DEFAULT_REGION = "us-west-2";
+/**
+ * Zod schema for validating runtime ARN format.
+ *
+ * Expected format: arn:aws:bedrock-agentcore:\{region\}:\{account\}:runtime/\{runtime_id\}
+ */
+export declare const RuntimeArnSchema: z.ZodString;
+/**
+ * Parsed components of a runtime ARN.
+ */
+export interface ParsedRuntimeArn {
+    /**
+     * AWS region where the runtime is located.
+     */
+    region: string;
+    /**
+     * AWS account ID that owns the runtime.
+     */
+    accountId: string;
+    /**
+     * Unique identifier for the runtime.
+     */
+    runtimeId: string;
+}
+/**
+ * Configuration options for RuntimeClient.
+ */
+export interface RuntimeClientConfig {
+    /**
+     * AWS region where the runtime service is deployed.
+     * Defaults to process.env.AWS_REGION or 'us-west-2'.
+     */
+    region?: string;
+    /**
+     * Optional AWS credentials provider.
+     * When omitted, the SDK uses the default Node.js credential provider chain.
+     *
+     * @example
+     * Using custom credentials:
+     * ```ts
+     * import { fromIni } from '@aws-sdk/credential-providers'
+     *
+     * const client = new RuntimeClient({
+     *   region: 'us-west-2',
+     *   credentialsProvider: fromIni({ profile: 'my-profile' })
+     * })
+     * ```
+     */
+    credentialsProvider?: AwsCredentialIdentityProvider;
+}
+/**
+ * Parameters for generating WebSocket connection credentials.
+ */
+export interface GenerateWsConnectionParams {
+    /**
+     * Full runtime ARN.
+     *
+     * Example: 'arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-runtime-abc'
+     */
+    runtimeArn: string;
+    /**
+     * Optional session ID to use.
+     * If not provided, a UUID will be auto-generated.
+     */
+    sessionId?: string;
+    /**
+     * Optional endpoint name to use as 'qualifier' query parameter.
+     * If provided, adds ?qualifier=\{endpointName\} to the URL.
+     */
+    endpointName?: string;
+}
+/**
+ * Parameters for generating presigned WebSocket URL.
+ */
+export interface GeneratePresignedUrlParams {
+    /**
+     * Full runtime ARN.
+     *
+     * Example: 'arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-runtime-abc'
+     */
+    runtimeArn: string;
+    /**
+     * Optional session ID to use.
+     * If not provided, a UUID will be auto-generated.
+     */
+    sessionId?: string;
+    /**
+     * Optional endpoint name to use as 'qualifier' query parameter.
+     * If provided, adds ?qualifier=\{endpointName\} to the URL before signing.
+     */
+    endpointName?: string;
+    /**
+     * Additional query parameters to include in the presigned URL before signing.
+     *
+     * Example: \{ "customParam": "value", "anotherParam": "value2" \}
+     */
+    customHeaders?: Record<string, string>;
+    /**
+     * Seconds until URL expires.
+     * Must be between 1 and 300 seconds.
+     * Defaults to 300 seconds (5 minutes).
+     */
+    expires?: number;
+}
+/**
+ * Parameters for generating WebSocket connection with OAuth authentication.
+ */
+export interface GenerateWsConnectionOAuthParams {
+    /**
+     * Full runtime ARN.
+     *
+     * Example: 'arn:aws:bedrock-agentcore:us-west-2:123456789012:runtime/my-runtime-abc'
+     */
+    runtimeArn: string;
+    /**
+     * OAuth bearer token for authentication.
+     * Must not be empty.
+     */
+    bearerToken: string;
+    /**
+     * Optional session ID to use.
+     * If not provided, a UUID will be auto-generated.
+     */
+    sessionId?: string;
+    /**
+     * Optional endpoint name to use as 'qualifier' query parameter.
+     * If provided, adds ?qualifier=\{endpointName\} to the URL.
+     */
+    endpointName?: string;
+}
+/**
+ * WebSocket connection details with URL and authentication headers.
+ */
+export interface WebSocketConnection {
+    /**
+     * WebSocket URL (wss://) with query parameters.
+     */
+    url: string;
+    /**
+     * Authentication headers for WebSocket connection.
+     * Includes SigV4 signature and session information.
+     */
+    headers: Record<string, string>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/runtime/types.d.ts.map

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

package/dist/src/runtime/types.js

@@ -0,0 +1,26 @@
+import { Buffer } from 'buffer';
+import { z } from 'zod';
+// =============================================================================
+// RuntimeClient Types (WebSocket Client)
+// =============================================================================
+/**
+ * Default presigned URL timeout in seconds (5 minutes).
+ */
+export const DEFAULT_PRESIGNED_URL_TIMEOUT = 300;
+/**
+ * Maximum presigned URL timeout in seconds (5 minutes).
+ */
+export const MAX_PRESIGNED_URL_TIMEOUT = 300;
+/**
+ * Default AWS region.
+ */
+export const DEFAULT_REGION = 'us-west-2';
+/**
+ * Zod schema for validating runtime ARN format.
+ *
+ * Expected format: arn:aws:bedrock-agentcore:\{region\}:\{account\}:runtime/\{runtime_id\}
+ */
+export const RuntimeArnSchema = z
+    .string()
+    .regex(/^arn:aws:bedrock-agentcore:[^:]+:[^:]+:runtime\/.+$/, 'Invalid runtime ARN format. Expected: arn:aws:bedrock-agentcore:{region}:{account}:runtime/{runtime_id}');
+//# sourceMappingURL=types.js.map

package/dist/src/runtime/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/runtime/types.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA4SvB,gFAAgF;AAChF,yCAAyC;AACzC,gFAAgF;AAEhF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAA;AAEhD;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAA;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAA;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,EAAE;KACR,KAAK,CACJ,qDAAqD,EACrD,yGAAyG,CAC1G,CAAA"}

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

@@ -0,0 +1,20 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Strands SDK tool for clicking elements.
+ * Thin wrapper around PlaywrightBrowser.click()
+ *
+ * @experimental
+ */
+export declare function createClickTool(client: PlaywrightBrowser): import("@strands-agents/sdk").InvokableTool<{
+    selector: string;
+    timeout?: number | undefined;
+}, {
+    success: true;
+    message: string;
+    error?: never;
+} | {
+    success: false;
+    error: string;
+    message?: never;
+}>;
+//# sourceMappingURL=click-tool.d.ts.map

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

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

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

@@ -0,0 +1,33 @@
+import { tool } from '@strands-agents/sdk';
+import { z } from 'zod';
+/**
+ * Creates a Strands SDK tool for clicking elements.
+ * Thin wrapper around PlaywrightBrowser.click()
+ *
+ * @experimental
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-function-return-type, @typescript-eslint/explicit-module-boundary-types
+export function createClickTool(client) {
+    return tool({
+        name: 'click',
+        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'),
+        }),
+        callback: async ({ selector, timeout }) => {
+            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/strands/click-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"click-tool.js","sourceRoot":"","sources":["../../../../../../src/tools/browser/integrations/strands/click-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,eAAe,CAAC,MAAyB;IACvD,OAAO,IAAI,CAAC;QACV,IAAI,EAAE,OAAO;QACb,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,QAAQ,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;YACxC,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/strands/evaluate-tool.d.ts

@@ -0,0 +1,20 @@
+import type { PlaywrightBrowser } from '../playwright/client.js';
+/**
+ * Creates a Strands SDK tool for evaluating JavaScript.
+ * Thin wrapper around PlaywrightBrowser.evaluate()
+ *
+ * @experimental
+ */
+export declare function createEvaluateTool(client: PlaywrightBrowser): import("@strands-agents/sdk").InvokableTool<{
+    script: string;
+    args?: any[] | undefined;
+}, {
+    success: true;
+    result: any;
+    error?: never;
+} | {
+    success: false;
+    error: string;
+    result?: never;
+}>;
+//# sourceMappingURL=evaluate-tool.d.ts.map

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

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

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