Crate smix_driver 

smix-driver — the decide layer.

Wraps HttpRunnerClient (sense + act IPC) with host-side resolve dispatch. The default path is: SDK call → driver.tap → tree() → resolve_selector() → centroid → runner.tap_at_norm_coord() (Apple native event chain).

Failure model

All methods return Result<T, ExpectationFailure> — AI-readable rendering lives in smix-error.

Implicit wait

tap includes a 5s poll-and-retry loop: if the first resolve_selector returns None, sleep 250 ms then re-fetch tree + re-resolve, up to a 5s total budget. Once a candidate is found we tap the same frame to avoid a split-fetch race.

Structs

ActOutcome

What an act did, as opposed to what it attempted.

AndroidDriver

Android Driver impl. Wraps HttpRunnerClient connecting to the Kotlin runner via adb-forwarded port (default 28080, configurable via AndroidDriver::new(port)).

CaptureSpan

When a captured frame’s pixels were sampled, as an interval.

HitElement

One element, as either side describes it.

HttpRunnerClient

IosDriver

Driver wrapping HttpRunnerClient with host-side resolve dispatch.

OcrFrame

Normalized OCR bounding box returned by HttpRunnerClient::find_text_by_ocr. Coordinates are normalized to [0, 1] in UIKit coord space (top-left origin, y-down). Apple Vision’s native bbox is bottom-left origin + y-up — the swift handler converts before returning so all consumers see UIKit coords.

PressTiming

What the runner reported about when a press was actually held, paired with what the host observed about the round trip.

SystemPopup

One system-popup discovered on the screen (alert / sheet / banner).

Enums

ActVerdict

What an act turned out to have done.

FramePlacement

Where a captured frame sits relative to the press.

IncludeScope

include scope literal — currently only all-windows (system popups pierce the app frame).

Orientation

Sim device orientation. Driver-level type; SDK exposes a 1:1 MaestroOrientation mirror for maestro yaml literal alignment.

Platform

Platform identifier for cross-platform dispatch.

RunnerScrollSelector

Reduced selector shape used by /scroll (text-or-id only; complex selectors are host-side-resolved before reaching the runner).

RunnerTransportError

Transport-level failure (network, non-2xx, malformed body). Mirrors TS RunnerTransportError 1:1.

TapMode

POST /tap mode discriminator.

Traits

Driver

Sense + act capabilities for a single device. Two-trait architecture pair with smix_sdk::DeviceControl (sim/host control in smix-sdk).

Functions

front_app_of

The bundle id this description was taken from, read off the a11y tree’s root identifier.

host_now_ms

Wall clock in milliseconds, for anchoring a press window and the captures taken alongside it to the same timeline.

press_frame_placement

Was this frame captured while the touch was down?

tap_landed_within

Did the touch land inside the element it aimed at?

Type Aliases

SimctlDriver

Back-compat alias. SimctlDriver was renamed to IosDriver for cross-platform naming; this alias keeps existing imports use smix_driver::SimctlDriver compiling.