Class: Daytona::ComputerUse::Keyboard

Inherits:
Object
  • Object
show all
Defined in:
lib/daytona/computer_use.rb

Overview

Keyboard operations for computer use functionality.

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(sandbox_id:, toolbox_api:) ⇒ Keyboard

Returns a new instance of Keyboard.

Parameters:

  • sandbox_id (String) —

    The ID of the sandbox

  • toolbox_api (DaytonaToolboxApiClient::ComputerUseApi) —

    API client for sandbox operations



129
130
131
132
 
# File 'lib/daytona/computer_use.rb', line 129

def initialize(sandbox_id:, toolbox_api:)
  @sandbox_id = sandbox_id
  @toolbox_api = toolbox_api
end

Instance Attribute Details

#sandbox_id ⇒ String (readonly)

Returns The ID of the sandbox.

Returns:

  • (String) —

    The ID of the sandbox



122
123
124
 
# File 'lib/daytona/computer_use.rb', line 122

def sandbox_id
  @sandbox_id
end

#toolbox_api ⇒ DaytonaToolboxApiClient::ComputerUseApi (readonly)

Returns API client for sandbox operations.

Returns:

  • (DaytonaToolboxApiClient::ComputerUseApi) —

    API client for sandbox operations



125
126
127
 
# File 'lib/daytona/computer_use.rb', line 125

def toolbox_api
  @toolbox_api
end

Instance Method Details

#hotkey(keys:) ⇒ void

This method returns an undefined value.

Presses a hotkey combination.

Examples:

# Copy
sandbox.computer_use.keyboard.hotkey("ctrl+c")

# Paste
sandbox.computer_use.keyboard.hotkey("ctrl+v")

# Alt+Tab
sandbox.computer_use.keyboard.hotkey("alt+tab")

Parameters:

  • keys (String) —

    The hotkey combination (e.g., ‘ctrl+c’, ‘alt+tab’, ‘cmd+shift+t’)

Raises:



191
192
193
194
195
196
 
# File 'lib/daytona/computer_use.rb', line 191

def hotkey(keys:)
  request = DaytonaToolboxApiClient::KeyboardHotkeyRequest.new(keys:)
  toolbox_api.press_hotkey(request)
rescue StandardError => e
  raise Sdk::Error, "Failed to press hotkey: #{e.message}"
end

#press(key:, modifiers: nil) ⇒ void

This method returns an undefined value.

Presses a key with optional modifiers.

Examples:

# Press Enter
sandbox.computer_use.keyboard.press("Return")

# Press Ctrl+C
sandbox.computer_use.keyboard.press("c", modifiers: ["ctrl"])

# Press Ctrl+Shift+T
sandbox.computer_use.keyboard.press("t", modifiers: ["ctrl", "shift"])

Parameters:

  • key (String) —

    The key to press (e.g., ‘Enter’, ‘Escape’, ‘Tab’, ‘a’, ‘A’)

  • modifiers (Array<String>, nil) (defaults to: nil) —

    Modifier keys (‘ctrl’, ‘alt’, ‘meta’, ‘shift’)

Raises:



169
170
171
172
173
174
 
# File 'lib/daytona/computer_use.rb', line 169

def press(key:, modifiers: nil)
  request = DaytonaToolboxApiClient::KeyboardPressRequest.new(key:, modifiers: modifiers || [])
  toolbox_api.press_key(request)
rescue StandardError => e
  raise Sdk::Error, "Failed to press key: #{e.message}"
end

#type(text:, delay: nil) ⇒ void

This method returns an undefined value.

Types the specified text.

Examples:

sandbox.computer_use.keyboard.type("Hello, World!")

# With delay between characters
sandbox.computer_use.keyboard.type("Slow typing", delay: 100)

Parameters:

  • text (String) —

    The text to type

  • delay (Integer, nil) (defaults to: nil) —

    Delay between characters in milliseconds

Raises:



146
147
148
149
150
151
 
# File 'lib/daytona/computer_use.rb', line 146

def type(text:, delay: nil)
  request = DaytonaToolboxApiClient::KeyboardTypeRequest.new(text:, delay:)
  toolbox_api.type_text(request)
rescue StandardError => e
  raise Sdk::Error, "Failed to type text: #{e.message}"
end