@bctrl/sdk 1.0.1

package/dist/contracts/drivers/puppeteer.js

@@ -0,0 +1,941 @@
+/**
+ * AUTO-GENERATED FILE - DO NOT EDIT
+ *
+ * Generated from: packages/automation-spec/src/drivers/puppeteer/options.ts
+ * Run `pnpm generate:sdk-contracts` to regenerate.
+ */
+/**
+ * Puppeteer-specific option schemas
+ *
+ * These match the real Puppeteer API 1:1.
+ * @see https://pptr.dev/api
+ */
+import { z } from 'zod';
+// ============================================================================
+// Puppeteer Wait Until Values
+// ============================================================================
+export const PuppeteerWaitUntilSchema = z.enum([
+    'load',
+    'domcontentloaded',
+    'networkidle0',
+    'networkidle2',
+]);
+// waitUntil can be a single value or array of values
+export const PuppeteerWaitUntilOptionSchema = z.union([
+    PuppeteerWaitUntilSchema,
+    z.array(PuppeteerWaitUntilSchema),
+]);
+// ============================================================================
+// Navigation Options
+// ============================================================================
+export const PuppeteerGotoOptionsSchema = z.object({
+    waitUntil: PuppeteerWaitUntilOptionSchema.optional(),
+    timeout: z.number().nonnegative().optional(),
+    referer: z.string().optional(),
+    referrerPolicy: z.string().optional(),
+});
+export const PuppeteerWaitForNavigationOptionsSchema = z.object({
+    waitUntil: PuppeteerWaitUntilOptionSchema.optional(),
+    timeout: z.number().nonnegative().optional(),
+});
+// ReloadOptions extends WaitForOptions - https://pptr.dev/api/puppeteer.reloadoptions
+export const PuppeteerReloadOptionsSchema = PuppeteerWaitForNavigationOptionsSchema.extend({
+    ignoreCache: z.boolean().optional(),
+});
+// WaitForNetworkIdleOptions - https://pptr.dev/api/puppeteer.waitfornetworkidleoptions
+export const PuppeteerWaitForNetworkIdleOptionsSchema = z.object({
+    /** Maximum number of concurrent network connections to be considered inactive. Default: 0 */
+    concurrency: z.number().int().nonnegative().optional(),
+    /** Time in milliseconds the network should be idle. Default: 500 */
+    idleTime: z.number().nonnegative().optional(),
+    /** Maximum wait time in milliseconds. Pass 0 to disable timeout. Default: 30000 */
+    timeout: z.number().nonnegative().optional(),
+});
+// ============================================================================
+// HTTP Response (serialized for RPC)
+// ============================================================================
+// RemoteAddress - https://pptr.dev/api/puppeteer.remoteaddress
+export const PuppeteerRemoteAddressSchema = z.object({
+    ip: z.string().optional(),
+    port: z.number().optional(),
+});
+// SecurityDetails - https://pptr.dev/api/puppeteer.securitydetails
+export const PuppeteerSecurityDetailsSchema = z.object({
+    issuer: z.string(),
+    protocol: z.string(),
+    subjectName: z.string(),
+    validFrom: z.number(),
+    validTo: z.number(),
+    subjectAlternativeNames: z.array(z.string()),
+});
+// ResourceTiming - https://developer.chrome.com/docs/devtools/network/reference/#timing
+// Based on CDP Network.ResourceTiming
+export const PuppeteerResourceTimingSchema = z.object({
+    requestTime: z.number(),
+    proxyStart: z.number(),
+    proxyEnd: z.number(),
+    dnsStart: z.number(),
+    dnsEnd: z.number(),
+    connectStart: z.number(),
+    connectEnd: z.number(),
+    sslStart: z.number(),
+    sslEnd: z.number(),
+    workerStart: z.number(),
+    workerReady: z.number(),
+    workerFetchStart: z.number(),
+    workerRespondWithSettled: z.number(),
+    sendStart: z.number(),
+    sendEnd: z.number(),
+    pushStart: z.number(),
+    pushEnd: z.number(),
+    receiveHeadersStart: z.number(),
+    receiveHeadersEnd: z.number(),
+});
+// HTTPResponse (serialized for RPC) - https://pptr.dev/api/puppeteer.httpresponse
+// Extended with responseId for RPC tracking and all synchronous properties serialized
+export const PuppeteerHTTPResponseSchema = z.object({
+    responseId: z.string(),
+    url: z.string(),
+    status: z.number(),
+    statusText: z.string(),
+    headers: z.record(z.string(), z.string()),
+    ok: z.boolean(),
+    fromCache: z.boolean(),
+    fromServiceWorker: z.boolean(),
+    remoteAddress: PuppeteerRemoteAddressSchema.optional(),
+    securityDetails: PuppeteerSecurityDetailsSchema.optional(),
+    timing: PuppeteerResourceTimingSchema.optional(),
+    // References for related objects (fetched via RPC if needed)
+    requestId: z.string().optional(),
+    frameId: z.string().optional(),
+});
+// ============================================================================
+// Mouse Options
+// ============================================================================
+// MouseButton - https://pptr.dev/api/puppeteer.mousebutton
+export const PuppeteerMouseButtonSchema = z.enum(['left', 'right', 'middle', 'back', 'forward']);
+// Point - https://pptr.dev/api/puppeteer.point
+export const PuppeteerPointSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+});
+// Offset - https://pptr.dev/api/puppeteer.offset
+export const PuppeteerOffsetSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+});
+// MouseOptions - https://pptr.dev/api/puppeteer.mouseoptions
+export const PuppeteerMouseOptionsSchema = z.object({
+    button: PuppeteerMouseButtonSchema.optional(),
+    clickCount: z.number().int().positive().optional(), // deprecated
+});
+// MouseClickOptions extends MouseOptions - https://pptr.dev/api/puppeteer.mouseclickoptions
+export const PuppeteerMouseClickOptionsSchema = PuppeteerMouseOptionsSchema.extend({
+    count: z.number().int().positive().optional(),
+    delay: z.number().nonnegative().optional(),
+});
+// ClickOptions extends MouseClickOptions - https://pptr.dev/api/puppeteer.clickoptions
+export const PuppeteerClickOptionsSchema = PuppeteerMouseClickOptionsSchema.extend({
+    offset: PuppeteerOffsetSchema.optional(),
+    /** @experimental If true, highlights the click location for debugging. */
+    debugHighlight: z.boolean().optional(),
+});
+// MouseMoveOptions - https://pptr.dev/api/puppeteer.mousemoveoptions
+export const PuppeteerMouseMoveOptionsSchema = z.object({
+    steps: z.number().int().positive().optional(),
+});
+// MouseWheelOptions - https://pptr.dev/api/puppeteer.mousewheeloptions
+export const PuppeteerMouseWheelOptionsSchema = z.object({
+    deltaX: z.number().optional(),
+    deltaY: z.number().optional(),
+});
+// DragData - https://chromedevtools.github.io/devtools-protocol/tot/Input/#type-DragData
+// Used by drag, dragEnter, dragOver, drop methods
+export const PuppeteerDragDataItemSchema = z.object({
+    mimeType: z.string(),
+    data: z.string(),
+    title: z.string().optional(),
+    baseURL: z.string().optional(),
+});
+export const PuppeteerDragDataSchema = z.object({
+    items: z.array(PuppeteerDragDataItemSchema),
+    files: z.array(z.string()).optional(),
+    dragOperationsMask: z.number().int(),
+});
+// KeyboardTypeOptions - https://pptr.dev/api/puppeteer.keyboardtypeoptions
+export const PuppeteerKeyboardTypeOptionsSchema = z.object({
+    delay: z.number().nonnegative().optional(),
+});
+// KeyDownOptions - https://pptr.dev/api/puppeteer.keydownoptions
+export const PuppeteerKeyDownOptionsSchema = z.object({
+    text: z.string().optional(),
+    commands: z.array(z.string()).optional(),
+});
+// KeyPressOptions - https://pptr.dev/api/puppeteer.keypressoptions
+export const PuppeteerKeyPressOptionsSchema = z.object({
+    delay: z.number().nonnegative().optional(),
+    text: z.string().optional(),
+    commands: z.array(z.string()).optional(),
+});
+// ============================================================================
+// Wait Options
+// ============================================================================
+export const PuppeteerWaitForOptionsSchema = z.object({
+    timeout: z.number().positive().optional(),
+    visible: z.boolean().optional(),
+    hidden: z.boolean().optional(),
+});
+// ============================================================================
+// Screenshot Options
+// ============================================================================
+// ScreenshotClip extends BoundingBox - https://pptr.dev/api/puppeteer.screenshotclip
+export const PuppeteerScreenshotClipSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+    width: z.number().positive(),
+    height: z.number().positive(),
+    scale: z.number().positive().optional(), // default: 1
+});
+// Keep alias for backwards compatibility
+/** @deprecated Use PuppeteerScreenshotClipSchema instead */
+export const PuppeteerClipRegionSchema = PuppeteerScreenshotClipSchema;
+// ImageFormat - https://pptr.dev/api/puppeteer.imageformat
+export const PuppeteerImageFormatSchema = z.enum(['png', 'jpeg', 'webp']);
+export const PuppeteerScreenshotOptionsSchema = z.object({
+    path: z.string().optional(),
+    type: PuppeteerImageFormatSchema.optional(),
+    quality: z.number().int().min(0).max(100).optional(),
+    fullPage: z.boolean().optional(),
+    clip: PuppeteerScreenshotClipSchema.optional(),
+    omitBackground: z.boolean().optional(),
+    encoding: z.enum(['base64', 'binary']).optional(),
+    captureBeyondViewport: z.boolean().optional(),
+    fromSurface: z.boolean().optional(), // default: true - capture from surface rather than view
+    optimizeForSpeed: z.boolean().optional(), // default: false
+});
+// ============================================================================
+// PDF Options
+// ============================================================================
+export const PuppeteerPDFMarginSchema = z.object({
+    top: z.union([z.string(), z.number()]).optional(),
+    right: z.union([z.string(), z.number()]).optional(),
+    bottom: z.union([z.string(), z.number()]).optional(),
+    left: z.union([z.string(), z.number()]).optional(),
+});
+// PaperFormat - https://pptr.dev/api/puppeteer.paperformat
+export const PuppeteerPaperFormatSchema = z.enum([
+    'letter',
+    'legal',
+    'tabloid',
+    'ledger',
+    'a0',
+    'a1',
+    'a2',
+    'a3',
+    'a4',
+    'a5',
+    'a6',
+]);
+export const PuppeteerPDFOptionsSchema = z.object({
+    path: z.string().optional(),
+    scale: z.number().positive().optional(),
+    displayHeaderFooter: z.boolean().optional(),
+    headerTemplate: z.string().optional(),
+    footerTemplate: z.string().optional(),
+    printBackground: z.boolean().optional(),
+    landscape: z.boolean().optional(),
+    pageRanges: z.string().optional(),
+    format: z.union([PuppeteerPaperFormatSchema, z.string()]).optional(),
+    width: z.union([z.string(), z.number()]).optional(),
+    height: z.union([z.string(), z.number()]).optional(),
+    margin: PuppeteerPDFMarginSchema.optional(),
+    preferCSSPageSize: z.boolean().optional(),
+    omitBackground: z.boolean().optional(),
+    timeout: z.number().nonnegative().optional(), // 0 disables timeout
+    /** @experimental Generate a document outline. */
+    outline: z.boolean().optional(),
+    /** @experimental Generate a tagged (accessible) PDF. Default: true */
+    tagged: z.boolean().optional(),
+    /** Wait for document.fonts.ready before generating PDF. Default: true */
+    waitForFonts: z.boolean().optional(),
+});
+// ============================================================================
+// Viewport Options
+// ============================================================================
+export const PuppeteerViewportSchema = z.object({
+    width: z.number().int().positive(),
+    height: z.number().int().positive(),
+    deviceScaleFactor: z.number().positive().optional(),
+    isMobile: z.boolean().optional(),
+    hasTouch: z.boolean().optional(),
+    isLandscape: z.boolean().optional(),
+});
+// ============================================================================
+// Cookie Options
+// ============================================================================
+// CookiePartitionKey - https://pptr.dev/api/puppeteer.cookiepartitionkey
+// Represents a cookie partition key in Chrome
+export const PuppeteerCookiePartitionKeySchema = z.object({
+    sourceOrigin: z.string(), // Required - site of top-level URL
+    hasCrossSiteAncestor: z.boolean().optional(), // Chrome only
+});
+// CookieSameSite - https://pptr.dev/api/puppeteer.cookiesamesite
+export const PuppeteerCookieSameSiteSchema = z.enum(['Strict', 'Lax', 'None']);
+// CookiePriority - https://pptr.dev/api/puppeteer.cookiepriority
+export const PuppeteerCookiePrioritySchema = z.enum(['Low', 'Medium', 'High']);
+// CookieSourceScheme - https://pptr.dev/api/puppeteer.cookiesourcescheme
+export const PuppeteerCookieSourceSchemeSchema = z.enum(['Unset', 'NonSecure', 'Secure']);
+// Cookie - returned by cookies() method
+export const PuppeteerCookieSchema = z.object({
+    name: z.string(),
+    value: z.string(),
+    domain: z.string().optional(),
+    path: z.string().optional(),
+    expires: z.number().optional(),
+    httpOnly: z.boolean().optional(),
+    secure: z.boolean().optional(),
+    sameSite: PuppeteerCookieSameSiteSchema.optional(),
+});
+// CookieData - for browser.setCookie() - https://pptr.dev/api/puppeteer.cookiedata
+export const PuppeteerCookieDataSchema = z.object({
+    name: z.string(),
+    value: z.string(),
+    domain: z.string(),
+    path: z.string().optional(),
+    expires: z.number().optional(),
+    httpOnly: z.boolean().optional(),
+    secure: z.boolean().optional(),
+    sameSite: PuppeteerCookieSameSiteSchema.optional(),
+    priority: PuppeteerCookiePrioritySchema.optional(),
+    sameParty: z.boolean().optional(),
+    sourceScheme: PuppeteerCookieSourceSchemeSchema.optional(),
+    partitionKey: z.union([PuppeteerCookiePartitionKeySchema, z.string()]).optional(),
+});
+// DeleteCookiesRequest - for deleteMatchingCookies() - https://pptr.dev/api/puppeteer.deletecookiesrequest
+export const PuppeteerDeleteCookiesRequestSchema = z.object({
+    name: z.string(),
+    domain: z.string().optional(),
+    path: z.string().optional(),
+    url: z.string().optional(),
+    partitionKey: z.union([PuppeteerCookiePartitionKeySchema, z.string()]).optional(),
+});
+// ============================================================================
+// Window Options
+// ============================================================================
+// WindowState - https://pptr.dev/api/puppeteer.windowstate
+export const PuppeteerWindowStateSchema = z.enum([
+    'normal',
+    'minimized',
+    'maximized',
+    'fullscreen',
+]);
+// WindowBounds - https://pptr.dev/api/puppeteer.windowbounds
+export const PuppeteerWindowBoundsSchema = z.object({
+    left: z.number().optional(),
+    top: z.number().optional(),
+    width: z.number().optional(),
+    height: z.number().optional(),
+    windowState: PuppeteerWindowStateSchema.optional(),
+});
+// ============================================================================
+// Target Options
+// ============================================================================
+// TargetType - https://pptr.dev/api/puppeteer.targettype
+export const PuppeteerTargetTypeSchema = z.enum([
+    'background_page',
+    'browser',
+    'other',
+    'page',
+    'service_worker',
+    'shared_worker',
+    'webview',
+]);
+// Target (serialized for RPC) - https://pptr.dev/api/puppeteer.target
+export const PuppeteerTargetSchema = z.object({
+    targetId: z.string(),
+    type: PuppeteerTargetTypeSchema,
+    url: z.string(),
+    title: z.string().optional(),
+    attached: z.boolean().optional(),
+    openerId: z.string().optional(),
+    browserContextId: z.string().optional(),
+});
+// WaitForTargetOptions - https://pptr.dev/api/puppeteer.waitfortargetoptions
+// Note: AbortSignal cannot be serialized over RPC, so it's omitted
+export const PuppeteerWaitForTargetOptionsSchema = z.object({
+    timeout: z.number().optional(), // default 30000ms, 0 to disable
+});
+// TargetFilter - for RPC-based waitForTarget (replaces predicate function)
+// Since functions can't be serialized, we use filter criteria instead
+export const PuppeteerTargetFilterSchema = z.object({
+    type: PuppeteerTargetTypeSchema.optional(),
+    url: z.string().optional(), // exact match or regex pattern
+    urlPattern: z.string().optional(), // regex pattern for URL matching
+});
+// ============================================================================
+// Browser Context Options
+// ============================================================================
+// DownloadPolicy - https://pptr.dev/api/puppeteer.downloadpolicy
+export const PuppeteerDownloadPolicySchema = z.enum(['deny', 'allow', 'allowAndName', 'default']);
+// DownloadBehavior - https://pptr.dev/api/puppeteer.downloadbehavior
+export const PuppeteerDownloadBehaviorSchema = z.object({
+    policy: PuppeteerDownloadPolicySchema,
+    downloadPath: z.string().optional(),
+});
+// BrowserContextOptions - https://pptr.dev/api/puppeteer.browsercontextoptions
+export const PuppeteerBrowserContextOptionsSchema = z.object({
+    /** Proxy server with optional port to use for all requests. */
+    proxyServer: z.string().optional(),
+    /** Bypass the proxy for the given list of hosts. */
+    proxyBypassList: z.array(z.string()).optional(),
+    /** Behavior definition for when downloading a file. */
+    downloadBehavior: PuppeteerDownloadBehaviorSchema.optional(),
+});
+// ============================================================================
+// Permission Options
+// ============================================================================
+// Permission - https://pptr.dev/api/puppeteer.permission
+export const PuppeteerPermissionSchema = z.enum([
+    'geolocation',
+    'midi',
+    'notifications',
+    'camera',
+    'microphone',
+    'background-sync',
+    'ambient-light-sensor',
+    'accelerometer',
+    'gyroscope',
+    'magnetometer',
+    'accessibility-events',
+    'clipboard-read',
+    'clipboard-write',
+    'clipboard-sanitized-write',
+    'payment-handler',
+    'persistent-storage',
+    'idle-detection',
+    'midi-sysex',
+]);
+// ============================================================================
+// Geolocation Options
+// ============================================================================
+export const PuppeteerGeolocationSchema = z.object({
+    latitude: z.number().min(-90).max(90),
+    longitude: z.number().min(-180).max(180),
+    accuracy: z.number().positive().optional(),
+});
+// ============================================================================
+// Bounding Box Result
+// ============================================================================
+export const PuppeteerBoundingBoxSchema = z.object({
+    x: z.number(),
+    y: z.number(),
+    width: z.number(),
+    height: z.number(),
+});
+// ============================================================================
+// Box Model
+// ============================================================================
+// BoxModel - https://pptr.dev/api/puppeteer.boxmodel
+export const PuppeteerBoxModelSchema = z.object({
+    content: z.array(PuppeteerPointSchema),
+    padding: z.array(PuppeteerPointSchema),
+    border: z.array(PuppeteerPointSchema),
+    margin: z.array(PuppeteerPointSchema),
+    width: z.number(),
+    height: z.number(),
+});
+// ============================================================================
+// Autofill Options
+// ============================================================================
+// CreditCard - https://pptr.dev/api/puppeteer.elementhandle.autofill
+export const PuppeteerCreditCardSchema = z.object({
+    number: z.string(),
+    name: z.string(),
+    expiryMonth: z.string(),
+    expiryYear: z.string(),
+    cvc: z.string(),
+});
+// AutofillData - https://pptr.dev/api/puppeteer.elementhandle.autofill
+export const PuppeteerAutofillDataSchema = z.object({
+    creditCard: PuppeteerCreditCardSchema,
+});
+// ============================================================================
+// Wait for Selector Options
+// ============================================================================
+// WaitForSelectorOptions - https://pptr.dev/api/puppeteer.waitforselectoroptions
+export const PuppeteerWaitForSelectorOptionsSchema = z.object({
+    visible: z.boolean().optional(),
+    hidden: z.boolean().optional(),
+    timeout: z.number().optional(),
+});
+// ============================================================================
+// Frame Add Script/Style Tag Options
+// ============================================================================
+// FrameAddScriptTagOptions - https://pptr.dev/api/puppeteer.frameaddscripttagoptions
+export const PuppeteerFrameAddScriptTagOptionsSchema = z.object({
+    url: z.string().optional(),
+    path: z.string().optional(),
+    content: z.string().optional(),
+    type: z.string().optional(),
+    id: z.string().optional(),
+});
+// FrameAddStyleTagOptions - https://pptr.dev/api/puppeteer.frameaddstyletagoptions
+export const PuppeteerFrameAddStyleTagOptionsSchema = z.object({
+    url: z.string().optional(),
+    path: z.string().optional(),
+    content: z.string().optional(),
+});
+// ============================================================================
+// Select Option
+// ============================================================================
+export const PuppeteerSelectOptionSchema = z.object({
+    value: z.string().optional(),
+    label: z.string().optional(),
+    index: z.number().int().optional(),
+});
+// ============================================================================
+// Serialized Element (for RPC)
+// ============================================================================
+export const PuppeteerSerializedElementSchema = z.object({
+    tagName: z.string(),
+    id: z.string().optional(),
+    className: z.string().optional(),
+    textContent: z.string().optional(),
+    innerText: z.string().optional(),
+    innerHTML: z.string().optional(),
+    attributes: z.record(z.string(), z.string()).optional(),
+});
+// ============================================================================
+// Device Emulation
+// ============================================================================
+// Device - https://pptr.dev/api/puppeteer.device
+export const PuppeteerDeviceSchema = z.object({
+    name: z.string(),
+    userAgent: z.string(),
+    viewport: PuppeteerViewportSchema,
+});
+// ============================================================================
+// Idle State Emulation
+// ============================================================================
+// IdleOverrides - for emulateIdleState
+export const PuppeteerIdleOverridesSchema = z.object({
+    isUserActive: z.boolean(),
+    isScreenUnlocked: z.boolean(),
+});
+// ============================================================================
+// Media Features
+// ============================================================================
+// MediaFeature - for emulateMediaFeatures
+export const PuppeteerMediaFeatureSchema = z.object({
+    name: z.string(),
+    value: z.string(),
+});
+// ============================================================================
+// Network Conditions
+// ============================================================================
+// NetworkConditions - for emulateNetworkConditions
+export const PuppeteerNetworkConditionsSchema = z.object({
+    download: z.number(), // Download speed (bytes/s), -1 to disable
+    upload: z.number(), // Upload speed (bytes/s), -1 to disable
+    latency: z.number(), // Latency (ms)
+});
+// ============================================================================
+// HTTP Request (serialized for RPC)
+// ============================================================================
+// ResourceType - https://pptr.dev/api/puppeteer.resourcetype
+export const PuppeteerResourceTypeSchema = z.enum([
+    'document',
+    'stylesheet',
+    'image',
+    'media',
+    'font',
+    'script',
+    'texttrack',
+    'xhr',
+    'fetch',
+    'prefetch',
+    'eventsource',
+    'websocket',
+    'manifest',
+    'signedexchange',
+    'ping',
+    'cspviolationreport',
+    'preflight',
+    'other',
+]);
+// ErrorCode - https://pptr.dev/api/puppeteer.errorcode
+// Network error codes for HTTPRequest.abort()
+export const PuppeteerErrorCodeSchema = z.enum([
+    'aborted',
+    'accessdenied',
+    'addressunreachable',
+    'blockedbyclient',
+    'blockedbyresponse',
+    'connectionaborted',
+    'connectionclosed',
+    'connectionfailed',
+    'connectionrefused',
+    'connectionreset',
+    'internetdisconnected',
+    'namenotresolved',
+    'timedout',
+    'failed',
+]);
+// InterceptResolutionAction - https://pptr.dev/api/puppeteer.interceptresolutionaction
+export const PuppeteerInterceptResolutionActionSchema = z.enum([
+    'abort',
+    'already-handled',
+    'continue',
+    'disabled',
+    'none',
+    'respond',
+]);
+// InterceptResolutionState - https://pptr.dev/api/puppeteer.interceptresolutionstate
+export const PuppeteerInterceptResolutionStateSchema = z.object({
+    action: PuppeteerInterceptResolutionActionSchema,
+    priority: z.number().optional(),
+});
+// ContinueRequestOverrides - https://pptr.dev/api/puppeteer.continuerequestoverrides
+export const PuppeteerContinueRequestOverridesSchema = z.object({
+    url: z.string().optional(),
+    method: z.string().optional(),
+    postData: z.string().optional(),
+    headers: z.record(z.string(), z.string()).optional(),
+});
+// ResponseForRequest - https://pptr.dev/api/puppeteer.responseforrequest
+export const PuppeteerResponseForRequestSchema = z.object({
+    status: z.number(),
+    headers: z.record(z.string(), z.unknown()).optional(),
+    contentType: z.string().optional(),
+    body: z.union([z.string(), z.instanceof(Uint8Array)]).optional(),
+});
+// Initiator - CDP Network.Initiator type
+// @see https://chromedevtools.github.io/devtools-protocol/tot/Network/#type-Initiator
+export const PuppeteerInitiatorTypeSchema = z.enum([
+    'parser',
+    'script',
+    'preload',
+    'SignedExchange',
+    'preflight',
+    'other',
+]);
+export const PuppeteerInitiatorSchema = z.object({
+    type: PuppeteerInitiatorTypeSchema,
+    url: z.string().optional(),
+    lineNumber: z.number().optional(),
+    columnNumber: z.number().optional(),
+    requestId: z.string().optional(),
+});
+// HTTPRequest (serialized) - https://pptr.dev/api/puppeteer.httprequest
+// Extended to include requestId for RPC tracking
+export const PuppeteerHTTPRequestSchema = z.object({
+    requestId: z.string(),
+    url: z.string(),
+    method: z.string(),
+    headers: z.record(z.string(), z.string()),
+    postData: z.string().optional(),
+    hasPostData: z.boolean().optional(),
+    resourceType: PuppeteerResourceTypeSchema,
+    isNavigationRequest: z.boolean(),
+    initiator: PuppeteerInitiatorSchema.optional(),
+    redirectChain: z.array(z.string()).optional(), // Array of requestIds
+    responseId: z.string().optional(), // Reference to associated response
+    frameId: z.string().optional(), // Reference to frame that initiated
+});
+// ============================================================================
+// Frame (serialized for RPC)
+// ============================================================================
+// Frame (serialized) - https://pptr.dev/api/puppeteer.frame
+export const PuppeteerFrameSchema = z.object({
+    frameId: z.string(),
+    url: z.string(),
+    name: z.string().optional(),
+    parentFrameId: z.string().optional(),
+    isDetached: z.boolean().optional(),
+    isOOPFrame: z.boolean().optional(),
+});
+// ============================================================================
+// WebWorker (serialized for RPC)
+// ============================================================================
+// WebWorker (serialized) - https://pptr.dev/api/puppeteer.webworker
+export const PuppeteerWebWorkerSchema = z.object({
+    workerId: z.string(),
+    url: z.string(),
+});
+// ============================================================================
+// RemoteObject (CDP Protocol types for JSHandle)
+// ============================================================================
+// RemoteObjectType - from CDP Protocol.Runtime.RemoteObject.type
+// @see https://chromedevtools.github.io/devtools-protocol/tot/Runtime/#type-RemoteObject
+export const PuppeteerRemoteObjectTypeSchema = z.enum([
+    'object',
+    'function',
+    'undefined',
+    'string',
+    'number',
+    'boolean',
+    'symbol',
+    'bigint',
+]);
+// RemoteObjectSubtype - from CDP Protocol.Runtime.RemoteObject.subtype
+export const PuppeteerRemoteObjectSubtypeSchema = z.enum([
+    'array',
+    'null',
+    'node',
+    'regexp',
+    'date',
+    'map',
+    'set',
+    'weakmap',
+    'weakset',
+    'iterator',
+    'generator',
+    'error',
+    'proxy',
+    'promise',
+    'typedarray',
+    'arraybuffer',
+    'dataview',
+    'webassemblymemory',
+    'wasmvalue',
+]);
+// RemoteObject - CDP Protocol.Runtime.RemoteObject (simplified for RPC)
+export const PuppeteerRemoteObjectSchema = z.object({
+    type: PuppeteerRemoteObjectTypeSchema,
+    subtype: PuppeteerRemoteObjectSubtypeSchema.optional(),
+    className: z.string().optional(),
+    value: z.unknown().optional(),
+    unserializableValue: z.string().optional(),
+    description: z.string().optional(),
+    objectId: z.string().optional(),
+});
+// ============================================================================
+// Vision Deficiency
+// ============================================================================
+export const PuppeteerVisionDeficiencySchema = z.enum([
+    'none',
+    'achromatopsia',
+    'blurredVision',
+    'deuteranopia',
+    'protanopia',
+    'tritanopia',
+]);
+// SerializedAXNode Zod schema
+export const PuppeteerSerializedAXNodeSchema = z.lazy(() => z.object({
+    // Required - the role of the node (e.g., 'button', 'heading', 'link')
+    role: z.string(),
+    // Common properties
+    name: z.string().optional(),
+    value: z.union([z.string(), z.number()]).optional(),
+    description: z.string().optional(),
+    keyshortcuts: z.string().optional(),
+    roledescription: z.string().optional(),
+    valuetext: z.string().optional(),
+    url: z.string().optional(),
+    // Boolean state properties
+    disabled: z.boolean().optional(),
+    expanded: z.boolean().optional(),
+    focused: z.boolean().optional(),
+    modal: z.boolean().optional(),
+    multiline: z.boolean().optional(),
+    multiselectable: z.boolean().optional(),
+    readonly: z.boolean().optional(),
+    required: z.boolean().optional(),
+    selected: z.boolean().optional(),
+    // Mixed state properties (can be boolean or 'mixed')
+    checked: z.union([z.boolean(), z.literal('mixed')]).optional(),
+    pressed: z.union([z.boolean(), z.literal('mixed')]).optional(),
+    // Numeric properties
+    level: z.number().optional(),
+    valuemin: z.number().optional(),
+    valuemax: z.number().optional(),
+    // Enum properties
+    autocomplete: z.enum(['none', 'inline', 'list', 'both']).optional(),
+    haspopup: z.enum(['false', 'menu', 'listbox', 'tree', 'grid', 'dialog']).optional(),
+    invalid: z.enum(['grammar', 'spelling', 'page', 'step', 'true', 'false']).optional(),
+    orientation: z.enum(['vertical', 'horizontal']).optional(),
+    // Recursive children
+    children: z.array(PuppeteerSerializedAXNodeSchema).optional(),
+}));
+// SnapshotOptions - https://pptr.dev/api/puppeteer.snapshotoptions
+// Options for Accessibility.snapshot()
+export const PuppeteerSnapshotOptionsSchema = z.object({
+    /**
+     * Prune uninteresting nodes from the tree.
+     * @default true
+     */
+    interestingOnly: z.boolean().optional(),
+    /**
+     * Root element handle to get the accessibility tree for.
+     * Note: For RPC, we use an element handle ID string instead of the actual ElementHandle.
+     * If not provided, defaults to the root node of the entire page.
+     */
+    root: z.string().optional(),
+});
+// ============================================================================
+// Tracing Options
+// ============================================================================
+// TracingOptions - https://pptr.dev/api/puppeteer.tracingoptions
+export const PuppeteerTracingOptionsSchema = z.object({
+    categories: z.array(z.string()).optional(),
+    path: z.string().optional(),
+    screenshots: z.boolean().optional(),
+});
+// ============================================================================
+// Dialog Options
+// ============================================================================
+// DialogType - https://pptr.dev/api/puppeteer.dialog
+export const PuppeteerDialogTypeSchema = z.enum(['alert', 'confirm', 'prompt', 'beforeunload']);
+// Dialog (serialized for RPC) - https://pptr.dev/api/puppeteer.dialog
+export const PuppeteerDialogSchema = z.object({
+    dialogId: z.string(),
+    type: PuppeteerDialogTypeSchema,
+    message: z.string(),
+    defaultValue: z.string(),
+});
+// ============================================================================
+// ConsoleMessage Options
+// ============================================================================
+// ConsoleMessageType - https://pptr.dev/api/puppeteer.consolemessagetype
+export const PuppeteerConsoleMessageTypeSchema = z.enum([
+    'log',
+    'debug',
+    'info',
+    'error',
+    'warn',
+    'dir',
+    'dirxml',
+    'table',
+    'trace',
+    'clear',
+    'startGroup',
+    'startGroupCollapsed',
+    'endGroup',
+    'assert',
+    'profile',
+    'profileEnd',
+    'count',
+    'timeEnd',
+    'verbose',
+]);
+// ConsoleMessageLocation - https://pptr.dev/api/puppeteer.consolemessagelocation
+export const PuppeteerConsoleMessageLocationSchema = z.object({
+    url: z.string().optional(),
+    lineNumber: z.number().optional(),
+    columnNumber: z.number().optional(),
+});
+// ConsoleMessage (serialized for RPC) - https://pptr.dev/api/puppeteer.consolemessage
+export const PuppeteerConsoleMessageSchema = z.object({
+    type: PuppeteerConsoleMessageTypeSchema,
+    text: z.string(),
+    location: PuppeteerConsoleMessageLocationSchema,
+    stackTrace: z.array(PuppeteerConsoleMessageLocationSchema),
+    args: z.array(z.unknown()), // Serialized JSON values (JSHandles can't be serialized)
+});
+// ============================================================================
+// TouchHandle (serialized for RPC)
+// ============================================================================
+// TouchHandle - https://pptr.dev/api/puppeteer.touchhandle
+// Serialized version for RPC - contains touch ID to track the touch on the server
+export const PuppeteerTouchHandleSchema = z.object({
+    touchId: z.string(),
+});
+// ============================================================================
+// Locator Options
+// ============================================================================
+// VisibilityOption - https://pptr.dev/api/puppeteer.visibilityoption
+export const PuppeteerVisibilityOptionSchema = z.enum(['visible', 'hidden']).nullable();
+// ActionOptions - base for all locator actions
+// Note: AbortSignal cannot be serialized over RPC, so it's omitted
+export const PuppeteerActionOptionsSchema = z.object({
+    timeout: z.number().nonnegative().optional(),
+});
+// LocatorScrollOptions extends ActionOptions
+export const PuppeteerLocatorScrollOptionsSchema = PuppeteerActionOptionsSchema.extend({
+    scrollLeft: z.number().optional(),
+    scrollTop: z.number().optional(),
+});
+// LocatorClickOptions extends ClickOptions (which extends MouseClickOptions)
+// https://pptr.dev/api/puppeteer.locatorclickoptions
+export const PuppeteerLocatorClickOptionsSchema = PuppeteerClickOptionsSchema.extend({
+    timeout: z.number().nonnegative().optional(),
+});
+// ============================================================================
+// Coverage Options
+// ============================================================================
+// CSSCoverageOptions - https://pptr.dev/api/puppeteer.csscoverageoptions
+export const PuppeteerCSSCoverageOptionsSchema = z.object({
+    resetOnNavigation: z.boolean().optional(),
+});
+// JSCoverageOptions - https://pptr.dev/api/puppeteer.jscoverageoptions
+export const PuppeteerJSCoverageOptionsSchema = z.object({
+    resetOnNavigation: z.boolean().optional(),
+    reportAnonymousScripts: z.boolean().optional(),
+    includeRawScriptCoverage: z.boolean().optional(),
+    useBlockCoverage: z.boolean().optional(),
+});
+// CoverageRange - part of CoverageEntry
+export const PuppeteerCoverageRangeSchema = z.object({
+    start: z.number(),
+    end: z.number(),
+});
+// CoverageEntry - https://pptr.dev/api/puppeteer.coverageentry
+export const PuppeteerCoverageEntrySchema = z.object({
+    url: z.string(),
+    text: z.string(),
+    ranges: z.array(PuppeteerCoverageRangeSchema),
+});
+// JSCoverageEntry extends CoverageEntry - https://pptr.dev/api/puppeteer.jscoverageentry
+// Note: rawScriptCoverage is from CDP Protocol.Profiler.ScriptCoverage, simplified for RPC
+export const PuppeteerJSCoverageEntrySchema = PuppeteerCoverageEntrySchema.extend({
+    rawScriptCoverage: z
+        .object({
+        scriptId: z.string(),
+        url: z.string(),
+        functions: z.array(z.object({
+            functionName: z.string(),
+            ranges: z.array(z.object({
+                startOffset: z.number(),
+                endOffset: z.number(),
+                count: z.number(),
+            })),
+            isBlockCoverage: z.boolean(),
+        })),
+    })
+        .optional(),
+});
+// PageEvent - https://pptr.dev/api/puppeteer.pageevent
+export const PuppeteerPageEventSchema = z.enum([
+    'close',
+    'console',
+    'dialog',
+    'domcontentloaded',
+    'error',
+    'frameattached',
+    'framedetached',
+    'framenavigated',
+    'load',
+    'metrics',
+    'pageerror',
+    'popup',
+    'request',
+    'requestfailed',
+    'requestfinished',
+    'requestservedfromcache',
+    'response',
+    'workercreated',
+    'workerdestroyed',
+]);
+// BrowserEvent - https://pptr.dev/api/puppeteer.browserevent
+export const PuppeteerBrowserEventSchema = z.enum([
+    'disconnected',
+    'targetchanged',
+    'targetcreated',
+    'targetdestroyed',
+]);
+// BrowserContextEvent - https://pptr.dev/api/puppeteer.browsercontextevent
+export const PuppeteerBrowserContextEventSchema = z.enum([
+    'targetchanged',
+    'targetcreated',
+    'targetdestroyed',
+]);