agent-browser 0.3.1 → 0.3.3

package/src/types.ts

@@ -1,913 +0,0 @@
-import type { Page, Browser, BrowserContext } from 'playwright-core';
-
-// Base command structure
-export interface BaseCommand {
-  id: string;
-  action: string;
-}
-
-// Action-specific command types
-export interface LaunchCommand extends BaseCommand {
-  action: 'launch';
-  headless?: boolean;
-  viewport?: { width: number; height: number };
-  browser?: 'chromium' | 'firefox' | 'webkit';
-}
-
-export interface NavigateCommand extends BaseCommand {
-  action: 'navigate';
-  url: string;
-  waitUntil?: 'load' | 'domcontentloaded' | 'networkidle';
-}
-
-export interface ClickCommand extends BaseCommand {
-  action: 'click';
-  selector: string;
-  button?: 'left' | 'right' | 'middle';
-  clickCount?: number;
-  delay?: number;
-}
-
-export interface TypeCommand extends BaseCommand {
-  action: 'type';
-  selector: string;
-  text: string;
-  delay?: number;
-  clear?: boolean;
-}
-
-export interface FillCommand extends BaseCommand {
-  action: 'fill';
-  selector: string;
-  value: string;
-}
-
-export interface CheckCommand extends BaseCommand {
-  action: 'check';
-  selector: string;
-}
-
-export interface UncheckCommand extends BaseCommand {
-  action: 'uncheck';
-  selector: string;
-}
-
-export interface UploadCommand extends BaseCommand {
-  action: 'upload';
-  selector: string;
-  files: string | string[];
-}
-
-export interface DoubleClickCommand extends BaseCommand {
-  action: 'dblclick';
-  selector: string;
-}
-
-export interface FocusCommand extends BaseCommand {
-  action: 'focus';
-  selector: string;
-}
-
-export interface DragCommand extends BaseCommand {
-  action: 'drag';
-  source: string;
-  target: string;
-}
-
-export interface FrameCommand extends BaseCommand {
-  action: 'frame';
-  selector?: string;
-  name?: string;
-  url?: string;
-}
-
-export interface MainFrameCommand extends BaseCommand {
-  action: 'mainframe';
-}
-
-export interface GetByRoleCommand extends BaseCommand {
-  action: 'getbyrole';
-  role: string;
-  name?: string;
-  subaction: 'click' | 'fill' | 'check' | 'hover';
-  value?: string;
-}
-
-export interface GetByTextCommand extends BaseCommand {
-  action: 'getbytext';
-  text: string;
-  exact?: boolean;
-  subaction: 'click' | 'hover';
-}
-
-export interface GetByLabelCommand extends BaseCommand {
-  action: 'getbylabel';
-  label: string;
-  subaction: 'click' | 'fill' | 'check';
-  value?: string;
-}
-
-export interface GetByPlaceholderCommand extends BaseCommand {
-  action: 'getbyplaceholder';
-  placeholder: string;
-  subaction: 'click' | 'fill';
-  value?: string;
-}
-
-export interface CookiesGetCommand extends BaseCommand {
-  action: 'cookies_get';
-  urls?: string[];
-}
-
-export interface CookiesSetCommand extends BaseCommand {
-  action: 'cookies_set';
-  cookies: Array<{
-    name: string;
-    value: string;
-    url?: string;
-    domain?: string;
-    path?: string;
-    expires?: number;
-    httpOnly?: boolean;
-    secure?: boolean;
-    sameSite?: 'Strict' | 'Lax' | 'None';
-  }>;
-}
-
-export interface CookiesClearCommand extends BaseCommand {
-  action: 'cookies_clear';
-}
-
-export interface StorageGetCommand extends BaseCommand {
-  action: 'storage_get';
-  key?: string;
-  type: 'local' | 'session';
-}
-
-export interface StorageSetCommand extends BaseCommand {
-  action: 'storage_set';
-  key: string;
-  value: string;
-  type: 'local' | 'session';
-}
-
-export interface StorageClearCommand extends BaseCommand {
-  action: 'storage_clear';
-  type: 'local' | 'session';
-}
-
-export interface DialogCommand extends BaseCommand {
-  action: 'dialog';
-  response: 'accept' | 'dismiss';
-  promptText?: string;
-}
-
-export interface PdfCommand extends BaseCommand {
-  action: 'pdf';
-  path: string;
-  format?:
-    | 'Letter'
-    | 'Legal'
-    | 'Tabloid'
-    | 'Ledger'
-    | 'A0'
-    | 'A1'
-    | 'A2'
-    | 'A3'
-    | 'A4'
-    | 'A5'
-    | 'A6';
-}
-
-// Network interception
-export interface RouteCommand extends BaseCommand {
-  action: 'route';
-  url: string;
-  response?: {
-    status?: number;
-    body?: string;
-    contentType?: string;
-    headers?: Record<string, string>;
-  };
-  abort?: boolean;
-}
-
-export interface UnrouteCommand extends BaseCommand {
-  action: 'unroute';
-  url?: string; // If not provided, remove all routes
-}
-
-// Request inspection
-export interface RequestsCommand extends BaseCommand {
-  action: 'requests';
-  filter?: string; // URL pattern to filter
-  clear?: boolean;
-}
-
-// Download handling
-export interface DownloadCommand extends BaseCommand {
-  action: 'download';
-  selector: string;
-  path: string;
-}
-
-// Geolocation
-export interface GeolocationCommand extends BaseCommand {
-  action: 'geolocation';
-  latitude: number;
-  longitude: number;
-  accuracy?: number;
-}
-
-// Permissions
-export interface PermissionsCommand extends BaseCommand {
-  action: 'permissions';
-  permissions: string[];
-  grant: boolean;
-}
-
-// Viewport
-export interface ViewportCommand extends BaseCommand {
-  action: 'viewport';
-  width: number;
-  height: number;
-}
-
-// User agent
-export interface UserAgentCommand extends BaseCommand {
-  action: 'useragent';
-  userAgent: string;
-}
-
-// Emulate device
-export interface DeviceCommand extends BaseCommand {
-  action: 'device';
-  device: string;
-}
-
-// Go back/forward
-export interface BackCommand extends BaseCommand {
-  action: 'back';
-}
-
-export interface ForwardCommand extends BaseCommand {
-  action: 'forward';
-}
-
-export interface ReloadCommand extends BaseCommand {
-  action: 'reload';
-}
-
-// Get URL/Title
-export interface UrlCommand extends BaseCommand {
-  action: 'url';
-}
-
-export interface TitleCommand extends BaseCommand {
-  action: 'title';
-}
-
-// Attribute/Property/Text
-export interface GetAttributeCommand extends BaseCommand {
-  action: 'getattribute';
-  selector: string;
-  attribute: string;
-}
-
-export interface GetTextCommand extends BaseCommand {
-  action: 'gettext';
-  selector: string;
-}
-
-export interface IsVisibleCommand extends BaseCommand {
-  action: 'isvisible';
-  selector: string;
-}
-
-export interface IsEnabledCommand extends BaseCommand {
-  action: 'isenabled';
-  selector: string;
-}
-
-export interface IsCheckedCommand extends BaseCommand {
-  action: 'ischecked';
-  selector: string;
-}
-
-export interface CountCommand extends BaseCommand {
-  action: 'count';
-  selector: string;
-}
-
-// Bounding box
-export interface BoundingBoxCommand extends BaseCommand {
-  action: 'boundingbox';
-  selector: string;
-}
-
-// More semantic locators
-export interface GetByAltTextCommand extends BaseCommand {
-  action: 'getbyalttext';
-  text: string;
-  exact?: boolean;
-  subaction: 'click' | 'hover';
-}
-
-export interface GetByTitleCommand extends BaseCommand {
-  action: 'getbytitle';
-  text: string;
-  exact?: boolean;
-  subaction: 'click' | 'hover';
-}
-
-export interface GetByTestIdCommand extends BaseCommand {
-  action: 'getbytestid';
-  testId: string;
-  subaction: 'click' | 'fill' | 'check' | 'hover';
-  value?: string;
-}
-
-// Nth element selection
-export interface NthCommand extends BaseCommand {
-  action: 'nth';
-  selector: string;
-  index: number; // 0-based, or -1 for last
-  subaction: 'click' | 'fill' | 'check' | 'hover' | 'text';
-  value?: string;
-}
-
-// Wait for URL
-export interface WaitForUrlCommand extends BaseCommand {
-  action: 'waitforurl';
-  url: string;
-  timeout?: number;
-}
-
-// Wait for load state
-export interface WaitForLoadStateCommand extends BaseCommand {
-  action: 'waitforloadstate';
-  state: 'load' | 'domcontentloaded' | 'networkidle';
-  timeout?: number;
-}
-
-// Set HTML content
-export interface SetContentCommand extends BaseCommand {
-  action: 'setcontent';
-  html: string;
-}
-
-// Timezone emulation
-export interface TimezoneCommand extends BaseCommand {
-  action: 'timezone';
-  timezone: string;
-}
-
-// Locale emulation
-export interface LocaleCommand extends BaseCommand {
-  action: 'locale';
-  locale: string;
-}
-
-// HTTP basic auth
-export interface HttpCredentialsCommand extends BaseCommand {
-  action: 'credentials';
-  username: string;
-  password: string;
-}
-
-// Fine-grained mouse control
-export interface MouseMoveCommand extends BaseCommand {
-  action: 'mousemove';
-  x: number;
-  y: number;
-}
-
-export interface MouseDownCommand extends BaseCommand {
-  action: 'mousedown';
-  button?: 'left' | 'right' | 'middle';
-}
-
-export interface MouseUpCommand extends BaseCommand {
-  action: 'mouseup';
-  button?: 'left' | 'right' | 'middle';
-}
-
-// Bring to front
-export interface BringToFrontCommand extends BaseCommand {
-  action: 'bringtofront';
-}
-
-// Wait for JS function to return truthy
-export interface WaitForFunctionCommand extends BaseCommand {
-  action: 'waitforfunction';
-  expression: string;
-  timeout?: number;
-}
-
-// Scroll element into view
-export interface ScrollIntoViewCommand extends BaseCommand {
-  action: 'scrollintoview';
-  selector: string;
-}
-
-// Add init script (runs on every navigation)
-export interface AddInitScriptCommand extends BaseCommand {
-  action: 'addinitscript';
-  script: string;
-}
-
-// Keyboard down/up (hold keys)
-export interface KeyDownCommand extends BaseCommand {
-  action: 'keydown';
-  key: string;
-}
-
-export interface KeyUpCommand extends BaseCommand {
-  action: 'keyup';
-  key: string;
-}
-
-// Insert text (without key events)
-export interface InsertTextCommand extends BaseCommand {
-  action: 'inserttext';
-  text: string;
-}
-
-// Multi-select dropdown
-export interface MultiSelectCommand extends BaseCommand {
-  action: 'multiselect';
-  selector: string;
-  values: string[];
-}
-
-// Wait for download
-export interface WaitForDownloadCommand extends BaseCommand {
-  action: 'waitfordownload';
-  path?: string;
-  timeout?: number;
-}
-
-// Get response body from intercepted request
-export interface ResponseBodyCommand extends BaseCommand {
-  action: 'responsebody';
-  url: string;
-  timeout?: number;
-}
-
-// Video recording
-export interface VideoStartCommand extends BaseCommand {
-  action: 'video_start';
-  path: string;
-}
-
-export interface VideoStopCommand extends BaseCommand {
-  action: 'video_stop';
-}
-
-// Tracing
-export interface TraceStartCommand extends BaseCommand {
-  action: 'trace_start';
-  screenshots?: boolean;
-  snapshots?: boolean;
-}
-
-export interface TraceStopCommand extends BaseCommand {
-  action: 'trace_stop';
-  path: string;
-}
-
-// HAR recording
-export interface HarStartCommand extends BaseCommand {
-  action: 'har_start';
-}
-
-export interface HarStopCommand extends BaseCommand {
-  action: 'har_stop';
-  path: string;
-}
-
-// Storage state (auth persistence)
-export interface StorageStateSaveCommand extends BaseCommand {
-  action: 'state_save';
-  path: string;
-}
-
-export interface StorageStateLoadCommand extends BaseCommand {
-  action: 'state_load';
-  path: string;
-}
-
-// Console logs
-export interface ConsoleCommand extends BaseCommand {
-  action: 'console';
-  clear?: boolean;
-}
-
-// Page errors
-export interface ErrorsCommand extends BaseCommand {
-  action: 'errors';
-  clear?: boolean;
-}
-
-// Keyboard shortcuts
-export interface KeyboardCommand extends BaseCommand {
-  action: 'keyboard';
-  keys: string; // e.g., "Control+a", "Shift+Tab"
-}
-
-// Mouse wheel
-export interface WheelCommand extends BaseCommand {
-  action: 'wheel';
-  deltaX?: number;
-  deltaY?: number;
-  selector?: string;
-}
-
-// Touch events
-export interface TapCommand extends BaseCommand {
-  action: 'tap';
-  selector: string;
-}
-
-// Clipboard
-export interface ClipboardCommand extends BaseCommand {
-  action: 'clipboard';
-  operation: 'copy' | 'paste' | 'read';
-  text?: string;
-}
-
-// Highlight element (for debugging)
-export interface HighlightCommand extends BaseCommand {
-  action: 'highlight';
-  selector: string;
-}
-
-// Clear input
-export interface ClearCommand extends BaseCommand {
-  action: 'clear';
-  selector: string;
-}
-
-// Select all text
-export interface SelectAllCommand extends BaseCommand {
-  action: 'selectall';
-  selector: string;
-}
-
-// Inner text vs text content
-export interface InnerTextCommand extends BaseCommand {
-  action: 'innertext';
-  selector: string;
-}
-
-export interface InnerHtmlCommand extends BaseCommand {
-  action: 'innerhtml';
-  selector: string;
-}
-
-// Input value
-export interface InputValueCommand extends BaseCommand {
-  action: 'inputvalue';
-  selector: string;
-}
-
-// Set input value directly (without events)
-export interface SetValueCommand extends BaseCommand {
-  action: 'setvalue';
-  selector: string;
-  value: string;
-}
-
-// Dispatch event
-export interface DispatchEventCommand extends BaseCommand {
-  action: 'dispatch';
-  selector: string;
-  event: string;
-  eventInit?: Record<string, unknown>;
-}
-
-// Evaluate handle (for complex JS)
-export interface EvaluateHandleCommand extends BaseCommand {
-  action: 'evalhandle';
-  script: string;
-}
-
-// Expose function
-export interface ExposeFunctionCommand extends BaseCommand {
-  action: 'expose';
-  name: string;
-}
-
-// Add script/style tag
-export interface AddScriptCommand extends BaseCommand {
-  action: 'addscript';
-  content?: string;
-  url?: string;
-}
-
-export interface AddStyleCommand extends BaseCommand {
-  action: 'addstyle';
-  content?: string;
-  url?: string;
-}
-
-// Emulate media
-export interface EmulateMediaCommand extends BaseCommand {
-  action: 'emulatemedia';
-  media?: 'screen' | 'print' | null;
-  colorScheme?: 'light' | 'dark' | 'no-preference' | null;
-  reducedMotion?: 'reduce' | 'no-preference' | null;
-  forcedColors?: 'active' | 'none' | null;
-}
-
-// Set offline mode
-export interface OfflineCommand extends BaseCommand {
-  action: 'offline';
-  offline: boolean;
-}
-
-// Set extra HTTP headers
-export interface HeadersCommand extends BaseCommand {
-  action: 'headers';
-  headers: Record<string, string>;
-}
-
-// Pause execution (for debugging)
-export interface PauseCommand extends BaseCommand {
-  action: 'pause';
-}
-
-export interface PressCommand extends BaseCommand {
-  action: 'press';
-  key: string;
-  selector?: string;
-}
-
-export interface ScreenshotCommand extends BaseCommand {
-  action: 'screenshot';
-  path?: string;
-  fullPage?: boolean;
-  selector?: string;
-  format?: 'png' | 'jpeg';
-  quality?: number;
-}
-
-export interface SnapshotCommand extends BaseCommand {
-  action: 'snapshot';
-}
-
-export interface EvaluateCommand extends BaseCommand {
-  action: 'evaluate';
-  script: string;
-  args?: unknown[];
-}
-
-export interface WaitCommand extends BaseCommand {
-  action: 'wait';
-  selector?: string;
-  timeout?: number;
-  state?: 'attached' | 'detached' | 'visible' | 'hidden';
-}
-
-export interface ScrollCommand extends BaseCommand {
-  action: 'scroll';
-  selector?: string;
-  x?: number;
-  y?: number;
-  direction?: 'up' | 'down' | 'left' | 'right';
-  amount?: number;
-}
-
-export interface SelectCommand extends BaseCommand {
-  action: 'select';
-  selector: string;
-  values: string | string[];
-}
-
-export interface HoverCommand extends BaseCommand {
-  action: 'hover';
-  selector: string;
-}
-
-export interface ContentCommand extends BaseCommand {
-  action: 'content';
-  selector?: string;
-}
-
-export interface CloseCommand extends BaseCommand {
-  action: 'close';
-}
-
-// Tab/Window commands
-export interface TabNewCommand extends BaseCommand {
-  action: 'tab_new';
-}
-
-export interface TabListCommand extends BaseCommand {
-  action: 'tab_list';
-}
-
-export interface TabSwitchCommand extends BaseCommand {
-  action: 'tab_switch';
-  index: number;
-}
-
-export interface TabCloseCommand extends BaseCommand {
-  action: 'tab_close';
-  index?: number;
-}
-
-export interface WindowNewCommand extends BaseCommand {
-  action: 'window_new';
-  viewport?: { width: number; height: number };
-}
-
-// Union of all command types
-export type Command =
-  | LaunchCommand
-  | NavigateCommand
-  | ClickCommand
-  | TypeCommand
-  | FillCommand
-  | CheckCommand
-  | UncheckCommand
-  | UploadCommand
-  | DoubleClickCommand
-  | FocusCommand
-  | DragCommand
-  | FrameCommand
-  | MainFrameCommand
-  | GetByRoleCommand
-  | GetByTextCommand
-  | GetByLabelCommand
-  | GetByPlaceholderCommand
-  | PressCommand
-  | ScreenshotCommand
-  | SnapshotCommand
-  | EvaluateCommand
-  | WaitCommand
-  | ScrollCommand
-  | SelectCommand
-  | HoverCommand
-  | ContentCommand
-  | CloseCommand
-  | TabNewCommand
-  | TabListCommand
-  | TabSwitchCommand
-  | TabCloseCommand
-  | WindowNewCommand
-  | CookiesGetCommand
-  | CookiesSetCommand
-  | CookiesClearCommand
-  | StorageGetCommand
-  | StorageSetCommand
-  | StorageClearCommand
-  | DialogCommand
-  | PdfCommand
-  | RouteCommand
-  | UnrouteCommand
-  | RequestsCommand
-  | DownloadCommand
-  | GeolocationCommand
-  | PermissionsCommand
-  | ViewportCommand
-  | UserAgentCommand
-  | DeviceCommand
-  | BackCommand
-  | ForwardCommand
-  | ReloadCommand
-  | UrlCommand
-  | TitleCommand
-  | GetAttributeCommand
-  | GetTextCommand
-  | IsVisibleCommand
-  | IsEnabledCommand
-  | IsCheckedCommand
-  | CountCommand
-  | BoundingBoxCommand
-  | VideoStartCommand
-  | VideoStopCommand
-  | TraceStartCommand
-  | TraceStopCommand
-  | HarStartCommand
-  | HarStopCommand
-  | StorageStateSaveCommand
-  | StorageStateLoadCommand
-  | ConsoleCommand
-  | ErrorsCommand
-  | KeyboardCommand
-  | WheelCommand
-  | TapCommand
-  | ClipboardCommand
-  | HighlightCommand
-  | ClearCommand
-  | SelectAllCommand
-  | InnerTextCommand
-  | InnerHtmlCommand
-  | InputValueCommand
-  | SetValueCommand
-  | DispatchEventCommand
-  | EvaluateHandleCommand
-  | ExposeFunctionCommand
-  | AddScriptCommand
-  | AddStyleCommand
-  | EmulateMediaCommand
-  | OfflineCommand
-  | HeadersCommand
-  | PauseCommand
-  | GetByAltTextCommand
-  | GetByTitleCommand
-  | GetByTestIdCommand
-  | NthCommand
-  | WaitForUrlCommand
-  | WaitForLoadStateCommand
-  | SetContentCommand
-  | TimezoneCommand
-  | LocaleCommand
-  | HttpCredentialsCommand
-  | MouseMoveCommand
-  | MouseDownCommand
-  | MouseUpCommand
-  | BringToFrontCommand
-  | WaitForFunctionCommand
-  | ScrollIntoViewCommand
-  | AddInitScriptCommand
-  | KeyDownCommand
-  | KeyUpCommand
-  | InsertTextCommand
-  | MultiSelectCommand
-  | WaitForDownloadCommand
-  | ResponseBodyCommand;
-
-// Response types
-export interface SuccessResponse<T = unknown> {
-  id: string;
-  success: true;
-  data: T;
-}
-
-export interface ErrorResponse {
-  id: string;
-  success: false;
-  error: string;
-}
-
-export type Response<T = unknown> = SuccessResponse<T> | ErrorResponse;
-
-// Data types for specific responses
-export interface NavigateData {
-  url: string;
-  title: string;
-}
-
-export interface ScreenshotData {
-  path?: string;
-  base64?: string;
-}
-
-export interface SnapshotData {
-  snapshot: string;
-}
-
-export interface EvaluateData {
-  result: unknown;
-}
-
-export interface ContentData {
-  html: string;
-}
-
-export interface TabInfo {
-  index: number;
-  url: string;
-  title: string;
-  active: boolean;
-}
-
-export interface TabListData {
-  tabs: TabInfo[];
-  active: number;
-}
-
-export interface TabNewData {
-  index: number;
-  total: number;
-}
-
-export interface TabSwitchData {
-  index: number;
-  url: string;
-  title: string;
-}
-
-export interface TabCloseData {
-  closed: number;
-  remaining: number;
-}
-
-// Browser state
-export interface BrowserState {
-  browser: Browser | null;
-  context: BrowserContext | null;
-  page: Page | null;
-}