bedrock-agentcore 0.0.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/client.d.ts

@@ -0,0 +1,125 @@
+import { BedrockAgentCoreClient } from '@aws-sdk/client-bedrock-agentcore';
+import type { BrowserClientConfig, SessionInfo, StartSessionParams, WebSocketConnection, GetSessionParams, GetSessionResponse, ListSessionsParams, ListSessionsResponse, UpdateStreamParams, UpdateStreamResponse } 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 declare class Browser {
+    readonly region: string;
+    readonly identifier: string;
+    protected _client: BedrockAgentCoreClient;
+    protected _session: SessionInfo | null;
+    private _credentialsProvider;
+    /**
+     * Creates a new BrowserClient instance.
+     *
+     * @param config - Configuration options for the client
+     */
+    constructor(config: BrowserClientConfig);
+    /**
+     * 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
+     */
+    startSession(params?: StartSessionParams): Promise<SessionInfo>;
+    /**
+     * Stops the active browser session.
+     *
+     * @throws Error if no session is active
+     */
+    stopSession(): Promise<void>;
+    /**
+     * 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'
+     * })
+     * ```
+     */
+    getSession(params?: GetSessionParams): Promise<GetSessionResponse>;
+    /**
+     * 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
+     *   })
+     * }
+     * ```
+     */
+    listSessions(params?: ListSessionsParams): Promise<ListSessionsResponse>;
+    /**
+     * 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'
+     * })
+     * ```
+     */
+    updateBrowserStream(params: UpdateStreamParams): Promise<UpdateStreamResponse>;
+    /**
+     * 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
+     */
+    generateWebSocketUrl(): Promise<WebSocketConnection>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../../src/tools/browser/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EAOvB,MAAM,mCAAmC,CAAA;AAM1C,OAAO,KAAK,EACV,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EAEpB,kBAAkB,EAClB,oBAAoB,EAErB,MAAM,YAAY,CAAA;AAGnB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,OAAO;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B,SAAS,CAAC,OAAO,EAAE,sBAAsB,CAAA;IACzC,SAAS,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAO;IAC7C,OAAO,CAAC,oBAAoB,CAAuD;IAEnF;;;;OAIG;gBACS,MAAM,EAAE,mBAAmB;IAevC;;;;;;;OAOG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,CAAC;IAqCrE;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBlC;;;;;;;;;;;;;;;;;OAiBG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsExE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,YAAY,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAiC9E;;;;;;;;;;;;;;;;;;OAkBG;IACG,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqCpF;;;;;;;OAOG;IACG,oBAAoB,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAiD3D"}