Struct ComputerAct 

pub struct ComputerAct {

    pub name: Option<String>,
    pub pid: Option<u32>,
    pub selector: Option<String>,
    pub nth: Option<usize>,
    pub action: Option<ActAction>,
    pub value: Option<String>,
    pub numeric_value: Option<f64>,
    pub range: Option<Vec<u32>>,
    pub timeout_ms: Option<u64>,
    pub surface: Option<SurfaceKind>,
    pub key: Option<String>,
    pub text: Option<String>,
    pub held: Option<Vec<String>>,
    pub wait: Option<u64>,
    pub then: Option<Box<ComputerAct>>,
}

Input for computer_act — ONE step of a semantic pipeline: either an accessibility action on the element matched by selector, a keyboard action (key/text), or a wait pause — chained via then with shell && semantics.

Fields

name: Option<String>

Application name (exact match, e.g. ‘Safari’). Provide name or pid. Semantic-action steps only.

pid: Option<u32>

Application process ID. Provide name or pid. Semantic-action steps only.

selector: Option<String>

CSS-like selector for the target element, e.g. button[name='OK']. Required on a semantic-action step; absent on keyboard/wait steps.

nth: Option<usize>

1-based match index when selector matches multiple elements (default 1).

action: Option<ActAction>

Action to perform (default press). Semantic-action steps only.

value: Option<String>

Text for set_value, type_text and perform_action.

numeric_value: Option<f64>

Number for set_numeric_value.

range: Option<Vec<u32>>

[start, end] (0-based; end EXCLUSIVE — [0, 3] selects three characters, matching the AT-SPI convention) for select_text.

timeout_ms: Option<u64>

How long to wait for the app AND a visible+enabled element match, in milliseconds (default 3000). Unlike computer_snapshot/computer_screenshot, actions auto-wait for actionability.

surface: Option<SurfaceKind>

Target an OS SHELL SURFACE instead of an application (mutually exclusive with name/pid): the menu bar, Dock/taskbar/panel, tray status items, the desktop, or a flyout open right now. Semantic steps only — a surface has no process to type into; keyboard steps in the same chain still need an element step to have set focus.

key: Option<String>

Key to tap, by name: single characters (lowercase — for uppercase hold shift) or named keys (enter, escape, tab, space, backspace, delete, insert, up, down, left, right, home, end, pageup, pagedown, f1..f12). Types into whatever holds keyboard focus NOW.

text: Option<String>

Literal text to type into the focused element. Mutually exclusive with key.

held: Option<Vec<String>>

Modifier keys held while tapping key (shift, ctrl, alt, meta) — e.g. key a + held: ["ctrl"] = select all. text rejects held.

wait: Option<u64>

Milliseconds to WAIT as a STANDALONE step (no other fields): gives the app time to settle before the next step acts. Capped at 10 s.

then: Option<Box<ComputerAct>>

Optional NEXT step of the pipeline, executed only if this step succeeded. Same shape as this step, recursively.

Trait Implementations

impl Clone for ComputerAct

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ComputerAct

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ComputerAct

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ComputerAct

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for ComputerAct

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.