browserctl 0.6.0 → 0.8.0

data/examples/test_automation_practices/forms/forms.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+Browserctl.workflow "test_automation_practices/forms/forms" do
+  desc "Forms page: trigger inline validation errors, then submit a valid form"
+
+  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
+  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_forms_forms.png")
+
+  step "open forms page" do
+    open_page(:main, url: "#{base_url}/#/forms")
+    page(:main).wait("[data-test='login-form']", timeout: 10)
+  end
+
+  step "submit empty form — all three fields show errors" do
+    page(:main).click("[data-test='submit-button']")
+    page(:main).wait("[data-test='username-error']", timeout: 5)
+    username_err = page(:main).evaluate("document.querySelector('[data-test=\"username-error\"]')?.textContent?.trim()")
+    email_err    = page(:main).evaluate("document.querySelector('[data-test=\"email-error\"]')?.textContent?.trim()")
+    password_err = page(:main).evaluate("document.querySelector('[data-test=\"password-error\"]')?.textContent?.trim()")
+    assert username_err&.length&.positive?, "expected username error, got: #{username_err.inspect}"
+    assert email_err&.length&.positive?,    "expected email error, got: #{email_err.inspect}"
+    assert password_err&.length&.positive?, "expected password error, got: #{password_err.inspect}"
+  end
+
+  step "fill invalid email — email error shown" do
+    page(:main).fill("[data-test='email-input']", "not-an-email")
+    page(:main).click("[data-test='submit-button']")
+    page(:main).wait("[data-test='email-error']", timeout: 5)
+    email_err = page(:main).evaluate("document.querySelector('[data-test=\"email-error\"]')?.textContent?.trim()")
+    assert email_err&.length&.positive?, "expected email format error, got: #{email_err.inspect}"
+  end
+
+  step "fill valid credentials and submit — no errors shown" do
+    page(:main).fill("[data-test='username-input']", "testuser")
+    page(:main).fill("[data-test='email-input']", "test@example.com")
+    page(:main).fill("[data-test='password-input']", "password123")
+    page(:main).click("[data-test='submit-button']")
+    sleep 0.5
+    username_err = page(:main).evaluate("!!document.querySelector('[data-test=\"username-error\"]')")
+    email_err    = page(:main).evaluate("!!document.querySelector('[data-test=\"email-error\"]')")
+    password_err = page(:main).evaluate("!!document.querySelector('[data-test=\"password-error\"]')")
+    assert !username_err, "expected no username error on valid submit"
+    assert !email_err,    "expected no email error on valid submit"
+    assert !password_err, "expected no password error on valid submit"
+    page(:main).screenshot(path: screenshot_path)
+  end
+end

data/examples/test_automation_practices/forms/slider.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+SET_SLIDER_JS = <<~JS
+  (function(val) {
+    const el = document.querySelector('[data-test="slider"]');
+    Object.getOwnPropertyDescriptor(window.HTMLInputElement.prototype, 'value')
+          .set.call(el, val);
+    el.dispatchEvent(new Event('input', { bubbles: true }));
+    el.dispatchEvent(new Event('change', { bubbles: true }));
+  })(%<value>d)
+JS
+
+Browserctl.workflow "test_automation_practices/forms/slider" do
+  desc "Slider page: set slider to specific values via evaluate, verify displayed value updates"
+
+  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
+  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_forms_slider.png")
+
+  step "open slider page" do
+    open_page(:main, url: "#{base_url}/#/slider")
+    page(:main).wait("[data-test='slider-container']", timeout: 10)
+  end
+
+  step "set slider to 75 and verify display" do
+    page(:main).evaluate(format(SET_SLIDER_JS, value: 75))
+    sleep 0.1
+    displayed = page(:main).evaluate(
+      "document.querySelector('[data-test=\"slider-value\"]')?.textContent?.trim()"
+    )
+    assert displayed&.include?("75"), "expected slider-value to show 75, got: #{displayed.inspect}"
+  end
+
+  step "set slider to minimum (0) and verify" do
+    page(:main).evaluate(format(SET_SLIDER_JS, value: 0))
+    sleep 0.1
+    displayed = page(:main).evaluate(
+      "document.querySelector('[data-test=\"slider-value\"]')?.textContent?.trim()"
+    )
+    assert displayed&.include?("0"), "expected slider-value to show 0, got: #{displayed.inspect}"
+  end
+
+  step "set slider to maximum (100) and screenshot" do
+    page(:main).evaluate(format(SET_SLIDER_JS, value: 100))
+    sleep 0.1
+    displayed = page(:main).evaluate(
+      "document.querySelector('[data-test=\"slider-value\"]')?.textContent?.trim()"
+    )
+    assert displayed&.include?("100"), "expected slider-value to show 100, got: #{displayed.inspect}"
+    page(:main).screenshot(path: screenshot_path)
+  end
+end

data/examples/test_automation_practices/interactions/context_menu.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+Browserctl.workflow "test_automation_practices/interactions/context_menu" do
+  desc "Context menu page: trigger via dispatched contextmenu event, click each action, dismiss"
+
+  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
+  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_context_menu.png")
+
+  step "open context menu page" do
+    open_page(:main, url: "#{base_url}/#/context-menu")
+    page(:main).wait("[data-test='context-menu-trigger']", timeout: 10)
+  end
+
+  step "trigger context menu via dispatched event — menu appears" do
+    page(:main).evaluate(<<~JS)
+      document.querySelector('[data-test="context-menu-trigger"]').dispatchEvent(
+        new MouseEvent('contextmenu', { bubbles: true, cancelable: true, clientX: 200, clientY: 300 })
+      )
+    JS
+    page(:main).wait("[data-test='context-menu']", timeout: 5)
+    visible = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu\"]')")
+    assert visible, "expected context-menu to appear after right-click event"
+  end
+
+  step "all three menu items are present" do
+    has_edit       = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu-edit\"]')")
+    has_delete     = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu-delete\"]')")
+    has_properties = page(:main).evaluate("!!document.querySelector('[data-test=\"context-menu-properties\"]')")
+    assert has_edit,       "expected context-menu-edit to be present"
+    assert has_delete,     "expected context-menu-delete to be present"
+    assert has_properties, "expected context-menu-properties to be present"
+    page(:main).screenshot(path: screenshot_path)
+  end
+
+  step "click Edit — menu closes" do
+    page(:main).click("[data-test='context-menu-edit']")
+    sleep 0.2
+    gone = page(:main).evaluate("!document.querySelector('[data-test=\"context-menu\"]')")
+    assert gone, "expected context-menu to close after clicking Edit"
+  end
+
+  step "re-open and dismiss by clicking outside" do
+    page(:main).evaluate(<<~JS)
+      document.querySelector('[data-test="context-menu-trigger"]').dispatchEvent(
+        new MouseEvent('contextmenu', { bubbles: true, cancelable: true, clientX: 200, clientY: 300 })
+      )
+    JS
+    page(:main).wait("[data-test='context-menu']", timeout: 5)
+    page(:main).evaluate("document.querySelector('[data-test=\"context-menu-area\"]').click()")
+    sleep 0.2
+    gone = page(:main).evaluate("!document.querySelector('[data-test=\"context-menu\"]')")
+    assert gone, "expected context-menu to close after clicking outside"
+  end
+end

data/examples/test_automation_practices/interactions/drag_drop.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+Browserctl.workflow "test_automation_practices/interactions/drag_drop" do
+  desc "Drag-drop page: reorder items via keyboard (Space to pick up, Arrow to move, Space to drop)"
+
+  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
+  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_drag_drop.png")
+
+  step "open drag-drop page and read initial order" do
+    open_page(:main, url: "#{base_url}/#/drag-drop")
+    page(:main).wait("[data-test='drag-drop-list']", timeout: 10)
+    items = page(:main).evaluate(
+      "Array.from(document.querySelectorAll('[data-test=\"drag-drop-list\"] li')).map(el => el.textContent?.trim())"
+    )
+    store(:initial_order, items)
+    assert items.length == 5, "expected 5 items in drag-drop list, got: #{items.length}"
+  end
+
+  step "focus first item and move it down one position via keyboard" do
+    page(:main).evaluate(
+      "document.querySelectorAll('[data-test=\"drag-drop-list\"] li')[0].focus()"
+    )
+    sleep 0.1
+    page(:main).press("Space")
+    sleep 0.1
+    page(:main).press("ArrowDown")
+    sleep 0.1
+    page(:main).press("Space")
+    sleep 0.2
+  end
+
+  step "verify first item moved to second position" do
+    initial = fetch(:initial_order)
+    current = page(:main).evaluate(
+      "Array.from(document.querySelectorAll('[data-test=\"drag-drop-list\"] li')).map(el => el.textContent?.trim())"
+    )
+    assert current[1] == initial[0],
+           "expected '#{initial[0]}' at index 1 after move down, got order: #{current.inspect}"
+    page(:main).screenshot(path: screenshot_path)
+  end
+end

data/examples/test_automation_practices/interactions/exit_intent.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+Browserctl.workflow "test_automation_practices/interactions/exit_intent" do
+  desc "Exit intent page: trigger modal by dispatching mouseleave at viewport top, test all dismiss paths"
+
+  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
+  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_exit_intent.png")
+
+  step "open exit intent page" do
+    open_page(:main, url: "#{base_url}/#/exit-intent")
+    sleep 0.5
+  end
+
+  step "trigger exit intent — modal appears" do
+    page(:main).evaluate(<<~JS)
+      document.dispatchEvent(
+        new MouseEvent('mouseleave', { bubbles: true, cancelable: true, clientY: -1 })
+      )
+    JS
+    page(:main).wait("[data-test='exit-modal']", timeout: 5)
+    visible = page(:main).evaluate("!!document.querySelector('[data-test=\"exit-modal\"]')")
+    assert visible, "expected exit-modal to appear after mouseleave event"
+    page(:main).screenshot(path: screenshot_path)
+  end
+
+  step "dismiss via X close button — modal disappears" do
+    page(:main).click("[data-test='close-modal']")
+    sleep 0.2
+    gone = page(:main).evaluate("!document.querySelector('[data-test=\"exit-modal\"]')")
+    assert gone, "expected exit-modal to close after clicking X"
+  end
+
+  step "re-trigger and dismiss via No thanks" do
+    page(:main).navigate("#{base_url}/#/exit-intent")
+    sleep 0.5
+    page(:main).evaluate(<<~JS)
+      document.dispatchEvent(
+        new MouseEvent('mouseleave', { bubbles: true, cancelable: true, clientY: -1 })
+      )
+    JS
+    page(:main).wait("[data-test='exit-modal']", timeout: 5)
+    page(:main).click("[data-test='modal-no']")
+    sleep 0.2
+    gone = page(:main).evaluate("!document.querySelector('[data-test=\"exit-modal\"]')")
+    assert gone, "expected exit-modal to close after clicking No thanks"
+  end
+end

data/examples/test_automation_practices/interactions/hover.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+Browserctl.workflow "test_automation_practices/interactions/hover" do
+  desc "Hover states page: move mouse over each figure, verify overlay content appears on each"
+
+  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
+  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_hover.png")
+
+  step "open hover states page" do
+    open_page(:main, url: "#{base_url}/#/hover")
+    page(:main).wait("[data-test='hover-example']", timeout: 10)
+  end
+
+  step "hover over each figure and verify caption appears" do
+    [1, 2, 3].each do |i|
+      page(:main).hover("[data-test='hover-figure-#{i}']")
+      sleep 0.2
+      caption = page(:main).evaluate(
+        "!!document.querySelector('[data-test=\"hover-caption-#{i}\"]')"
+      )
+      assert caption, "expected caption to appear on figure #{i} after hover"
+    end
+  end
+
+  step "screenshot the hovered state" do
+    page(:main).hover("[data-test='hover-figure-2']")
+    sleep 0.2
+    page(:main).screenshot(path: screenshot_path)
+  end
+end

data/examples/test_automation_practices/interactions/key_press.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+Browserctl.workflow "test_automation_practices/interactions/key_press" do
+  desc "Key press page: fire real keyboard events via press, verify last-key display and history list update"
+
+  param :base_url,        default: "https://moatazeldebsy.github.io/test-automation-practices"
+  param :screenshot_path, default: File.expand_path(".browserctl/screenshots/tap_interactions_key_press.png")
+
+  step "open key press page" do
+    open_page(:main, url: "#{base_url}/#/key-press")
+  end
+
+  step "fire key events and verify last-key display" do
+    keys = %w[A B C D E]
+    keys.each do |key|
+      page(:main).press(key)
+      sleep 0.1
+    end
+
+    last = page(:main).evaluate(
+      "document.querySelector('[data-test=\"last-key-pressed\"]')?.innerText?.trim()"
+    )
+    assert last == keys.last, "expected last key '#{keys.last}', got: #{last.inspect}"
+    store(:keys, keys)
+  end
+
+  step "verify key history contains the most recent keys" do
+    keys = fetch(:keys)
+    history = page(:main).evaluate(
+      "Array.from(document.querySelectorAll('[data-test^=\"key-\"]')).map(el => el.innerText?.trim())"
+    )
+    # The site retains only the last 4 keys in the history list; assert those
+    keys.last(4).each do |key|
+      assert history.any? { |entry| entry&.include?(key) }, "expected '#{key}' in history, got: #{history.inspect}"
+    end
+    page(:main).screenshot(path: screenshot_path)
+  end
+end

data/lib/browserctl/client.rb

@@ -123,6 +123,11 @@ module Browserctl
     # @return [Hash] `{ ok: true, devtools_url: }` or `{ error: }`
     def devtools(name)             = call("devtools", name: name)
 
+    # Brings the named page's tab to front. Only works when browserd was started with --headed.
+    # @param name [String] logical page name
+    # @return [Hash] `{ ok: true }` or `{ error: }`
+    def page_focus(name) = call("page_focus", name: name)
+
     # Stores a value in the daemon-scoped key-value store.
     # @param key [String] storage key
     # @param value [Object] value to store (must be JSON-serialisable)
@@ -225,6 +230,43 @@ module Browserctl
       call("storage_delete", name: name, stores: stores)
     end
 
+    # Fires a keydown + keyup event for the given key name on a page.
+    # @param name [String] logical page name
+    # @param key [String] key name e.g. "Enter", "Tab", "Escape", "ArrowDown"
+    # @return [Hash] `{ ok: true }` or `{ error: }`
+    def press(name, key)          = call("press",  name: name, key: key)
+
+    # Moves the mouse to the centre of the element matched by selector.
+    # @param name [String] logical page name
+    # @param selector [String] CSS selector
+    # @return [Hash] `{ ok: true }` or `{ error: }`
+    def hover(name, selector)     = call("hover",  name: name, selector: selector)
+
+    # Sets a file-input element to the given file path.
+    # @param name [String] logical page name
+    # @param selector [String] CSS selector for the file input
+    # @param path [String] absolute or relative file path
+    # @return [Hash] `{ ok: true }` or `{ error: }`
+    def upload(name, selector, path) = call("upload", name: name, selector: selector, path: path)
+
+    # Sets a <select> element's value and fires a change event.
+    # @param name [String] logical page name
+    # @param selector [String] CSS selector for the select element
+    # @param value [String] option value to select
+    # @return [Hash] `{ ok: true }` or `{ error: }`
+    def select(name, selector, value) = call("select", name: name, selector: selector, value: value)
+
+    # Pre-registers a one-shot handler to accept the next JS dialog on a page.
+    # @param name [String] logical page name
+    # @param text [String, nil] prompt text for window.prompt dialogs (ignored for alert/confirm)
+    # @return [Hash] `{ ok: true }` or `{ error: }`
+    def dialog_accept(name, text: nil) = call("dialog_accept", name: name, text: text)
+
+    # Pre-registers a one-shot handler to dismiss the next JS dialog on a page.
+    # @param name [String] logical page name
+    # @return [Hash] `{ ok: true }` or `{ error: }`
+    def dialog_dismiss(name)           = call("dialog_dismiss", name: name)
+
     # Saves the current browser state (cookies, localStorage, open pages) to a named session.
     # @param session_name [String] name for the saved session
     # @return [Hash] `{ ok: true, path:, pages: N, cookies: N }` or `{ error: }`

data/lib/browserctl/commands/ask.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require_relative "cli_output"
+
+module Browserctl
+  module Commands
+    module Ask
+      extend CliOutput
+
+      def self.run(args)
+        abort "usage: browserctl ask <prompt>" if args.empty?
+
+        prompt = args.join(" ")
+        $stderr.print("[browserctl] #{prompt} ")
+        value = $stdin.gets.chomp
+        print_result({ ok: true, value: value })
+      end
+    end
+  end
+end

data/lib/browserctl/commands/dialog.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "cli_output"
+
+module Browserctl
+  module Commands
+    module Dialog
+      extend CliOutput
+
+      USAGE = "Usage: browserctl dialog <accept|dismiss> <page> [text]"
+
+      def self.run(client, args)
+        sub = args.shift or abort USAGE
+        case sub
+        when "accept"  then run_accept(client, args)
+        when "dismiss" then run_dismiss(client, args)
+        else abort "unknown dialog subcommand '#{sub}'\n#{USAGE}"
+        end
+      end
+
+      def self.run_accept(client, args)
+        name = args.shift or abort "usage: browserctl dialog accept <page> [text]"
+        text = args.shift
+        print_result(client.dialog_accept(name, text: text))
+      end
+
+      def self.run_dismiss(client, args)
+        name = args.shift or abort "usage: browserctl dialog dismiss <page>"
+        print_result(client.dialog_dismiss(name))
+      end
+    end
+  end
+end

data/lib/browserctl/commands/page.rb

@@ -40,7 +40,7 @@ module Browserctl
 
       def self.run_focus(client, args)
         name = args.shift or abort "usage: browserctl page focus <name>"
-        print_result(client.call("page_focus", name: name))
+        print_result(client.page_focus(name))
       end
     end
   end

data/lib/browserctl/errors.rb

@@ -22,4 +22,7 @@ module Browserctl
   class DomainNotAllowed < Error; def self.default_code = "domain_not_allowed" end
   class TimeoutError     < Error; def self.default_code = "timeout"            end
   class KeyNotFound      < Error; def self.default_code = "key_not_found"      end
+
+  class WorkflowError < StandardError; end
+  class SecretResolverError < WorkflowError; end
 end

data/lib/browserctl/secret_resolver_registry.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "errors"
+
+module Browserctl
+  class SecretResolverRegistry
+    @mutex    = Mutex.new
+    @registry = {}
+
+    def self.register(resolver_class)
+      instance = resolver_class.new
+      @mutex.synchronize { @registry[resolver_class.scheme] = instance }
+    end
+
+    def self.resolve(secret_ref)
+      scheme, reference = secret_ref.split("://", 2)
+      resolver = @mutex.synchronize { @registry[scheme] }
+      raise SecretResolverError, "unknown secret resolver scheme '#{scheme}'" unless resolver
+      unless resolver.available?
+        raise SecretResolverError,
+              "'#{scheme}://' resolver is not available in this environment"
+      end
+
+      resolver.resolve(reference)
+    rescue SecretResolverError
+      raise
+    rescue StandardError => e
+      raise SecretResolverError, "secret resolution failed for #{secret_ref.inspect}: #{e.message}"
+    end
+
+    def self.registered?(scheme)
+      @mutex.synchronize { @registry.key?(scheme) }
+    end
+
+    def self.reset!
+      @mutex.synchronize { @registry.clear }
+    end
+  end
+end

data/lib/browserctl/secret_resolvers/base.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Browserctl
+  module SecretResolvers
+    class Base
+      def self.scheme
+        raise NotImplementedError, "#{name}.scheme not implemented"
+      end
+
+      def available? = true
+
+      def resolve(_reference)
+        raise NotImplementedError, "#{self.class.name}#resolve not implemented"
+      end
+    end
+  end
+end

data/lib/browserctl/secret_resolvers/env.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Browserctl
+  module SecretResolvers
+    class Env < Base
+      def self.scheme = "env"
+
+      def resolve(reference)
+        ENV.fetch(reference) { raise SecretResolverError, "env var '#{reference}' is not set" }
+      end
+    end
+  end
+end

data/lib/browserctl/secret_resolvers/macos_keychain.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module Browserctl
+  module SecretResolvers
+    class MacOSKeychain < Base
+      def self.scheme = "keychain"
+
+      def available?
+        RUBY_PLATFORM.include?("darwin") && system("which security > /dev/null 2>&1")
+      end
+
+      def resolve(reference)
+        service, account = reference.split("/", 2)
+        if account.nil?
+          raise SecretResolverError,
+                "keychain reference must be 'service/account', got: #{reference.inspect}"
+        end
+
+        result, status = Open3.capture2("security", "find-generic-password",
+                                        "-a", account, "-s", service, "-w")
+        raise SecretResolverError, "keychain item not found: #{reference}" unless status.success?
+
+        result.chomp
+      end
+    end
+  end
+end

data/lib/browserctl/secret_resolvers/one_password.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module Browserctl
+  module SecretResolvers
+    class OnePassword < Base
+      def self.scheme = "op"
+
+      def available?
+        system("which op > /dev/null 2>&1")
+      end
+
+      def resolve(reference)
+        result, status = Open3.capture2("op", "read", "op://#{reference}")
+        raise SecretResolverError, "1Password item not found: op://#{reference}" unless status.success?
+
+        result.chomp
+      end
+    end
+  end
+end

data/lib/browserctl/secret_resolvers.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+require_relative "secret_resolver_registry"
+require_relative "secret_resolvers/base"
+require_relative "secret_resolvers/env"
+require_relative "secret_resolvers/macos_keychain"
+require_relative "secret_resolvers/one_password"
+
+Browserctl::SecretResolverRegistry.register(Browserctl::SecretResolvers::Env)
+Browserctl::SecretResolverRegistry.register(Browserctl::SecretResolvers::MacOSKeychain)
+Browserctl::SecretResolverRegistry.register(Browserctl::SecretResolvers::OnePassword)
+
+user_resolvers = File.expand_path("~/.browserctl/resolvers.rb")
+load user_resolvers if File.exist?(user_resolvers)

data/lib/browserctl/server/command_dispatcher.rb

@@ -11,6 +11,7 @@ require_relative "handlers/devtools"
 require_relative "handlers/daemon_control"
 require_relative "handlers/storage"
 require_relative "handlers/session"
+require_relative "handlers/interaction"
 require_relative "../detectors"
 require_relative "../policy"
 
@@ -25,6 +26,7 @@ module Browserctl
     include Handlers::DaemonControl
     include Handlers::Storage
     include Handlers::Session
+    include Handlers::Interaction
 
     COMMAND_MAP = {
       "page_open" => :cmd_page_open,
@@ -55,6 +57,12 @@ module Browserctl
       "storage_export" => :cmd_storage_export,
       "storage_import" => :cmd_storage_import,
       "storage_delete" => :cmd_storage_delete,
+      "press" => :cmd_press,
+      "hover" => :cmd_hover,
+      "upload" => :cmd_upload,
+      "select" => :cmd_select,
+      "dialog_accept" => :cmd_dialog_accept,
+      "dialog_dismiss" => :cmd_dialog_dismiss,
       "session_save" => :cmd_session_save,
       "session_load" => :cmd_session_load,
       "session_list" => :cmd_session_list,