mirror of
https://github.com/priyanshujain/sanderling.git
synced 2026-10-02 19:17:10 +00:00
* feat(ltl): add Now/Next/Eventually/Implies/Or/And/Not formulas Replace the fold-with-latch evaluator with a residual-formula reducer. Each Observe() instantiates a fresh obligation from the root (stripping an outer Always), reduces each pending obligation against current state, latches Violated on first failure, and surfaces Pending verdicts for deferred obligations. Existing Always/Pure/Thunk tests continue to pass. * feat(ltl): support relative duration for eventually().within() * feat(proto): add Swipe, PressKey, RecentLogs RPCs * feat(verifier,runner): formula handles, new action kinds, rich state - verifier: add formula-spec registry; bindNow/bindNext/bindEventually with chainable .implies/.or/.and/.not and .within(n,unit) on eventually; bindFrom for uniform sampling. bindAlways keeps accepting plain predicates. - verifier: store lastTree, lastAction, step time, logs, exceptions on the Verifier; SnapshotInput replaces the (snapshots, tree) pair. stateObject now produces state.lastAction/time/logs/exceptions matching the TS State type. - verifier: make taps/swipes/waitOnce/pressKey built-in generators actually fire; taps picks a clickable, enabled element from the last hierarchy. - agent: add exceptions field to Message wire format. - driver: add Swipe/PressKey/RecentLogs to Driver interface; wire maestro client and mock driver. LogEntry exposed for runner consumption. - runner: apply Swipe/PressKey/Wait actions; collect logcat and exceptions; pass lastAction and step time into PushSnapshot. * feat(spec-api): LTL operators, new actions, richer State - ltl.ts exports now/next/eventually; always overload accepts a Formula - types.ts: Formula gains implies/or/and/not; EventuallyFormula adds .within; State gains lastAction/time/logs/exceptions; Swipe/PressKey/Wait action types - actions.ts: Swipe/PressKey/Wait/from constructors; waitOnce + pressKey default generators - tests exercise the chaining, sampling, and new actions through a recorded fake runtime * feat(sidecar): add swipe, pressKey, recentLogs RPC handlers * feat(sdk-android): capture uncaught exceptions Install a default uncaught handler on Uatu.start, chained with any existing handler so Android's crash reporter still runs. Expose Uatu.reportError for callers to forward caught throwables. A bounded circular buffer (default 50) drains into each STATE message's new exceptions field. Protocol.kt serializes/deserializes the field, matching the Go wire format added to internal/agent/protocol.go. * feat(spec-api): add @uatu/spec/defaults/properties bundle * feat(sample-app): exercise new LTL operators + defaults spec.ts now imports eventually/next/now/from from @uatu/spec and noUncaughtExceptions from @uatu/spec/defaults/properties. It declares three properties that exercise the new surface: - accountCountNonNegative: plain always() safety - addAccountAdvances: always(now(x).implies(next(y))) - eventuallyLoggedIn: eventually(p).within(30, "seconds") - noUncaughtExceptions: imported default The weighted actions root uses from() for random phone/name sampling and entries for taps/swipes/waitOnce/pressKey built-ins. SampleApplication gains a debug hook gated on the system property uatu.inject_error so the e2e run can synthesize an Uatu.reportError and verify noUncaughtExceptions violates. cmd/uatu/test_run.go adds a subpath alias so specs importing "@uatu/spec/defaults/properties" resolve against the in-tree source when running from the uatu checkout. The spec-integration tests swap the old click-counter fixtures for the new login hierarchy. * feat(trace): record swipe/key/wait details + exceptions trace.Step gains an Exceptions array so the trace captures the class/message/stackTrace for each SDK-reported throwable in a step. trace.Action gains FromX/FromY/ToX/ToY/Key/DurationMillis so the full payload of Swipe/PressKey/Wait actions is visible in trace.jsonl. sample-app's debug error hook now gates on ApplicationInfo.DEBUGGABLE instead of a system property (adb setprop fails on non-rooted emulators).
101 lines
2.1 KiB
Protocol Buffer
101 lines
2.1 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
package uatu.driver.v1;
|
|
|
|
option go_package = "github.com/priyanshujain/uatu/proto/driverpb;driverpb";
|
|
option java_package = "dev.uatu.driver.v1";
|
|
option java_multiple_files = true;
|
|
|
|
service Driver {
|
|
rpc Launch(LaunchRequest) returns (Empty);
|
|
rpc Terminate(Empty) returns (Empty);
|
|
|
|
rpc Tap(Point) returns (Empty);
|
|
rpc TapSelector(Selector) returns (Empty);
|
|
rpc InputText(Text) returns (Empty);
|
|
rpc Swipe(SwipeRequest) returns (Empty);
|
|
rpc PressKey(PressKeyRequest) returns (Empty);
|
|
|
|
rpc Screenshot(Empty) returns (Image);
|
|
rpc Hierarchy(Empty) returns (HierarchyJSON);
|
|
rpc RecentLogs(RecentLogsRequest) returns (LogEntries);
|
|
|
|
rpc WaitForIdle(Duration) returns (Empty);
|
|
rpc Health(Empty) returns (HealthStatus);
|
|
}
|
|
|
|
message Empty {}
|
|
|
|
message LaunchRequest {
|
|
string bundle_id = 1;
|
|
bool clear_state = 2;
|
|
// Optional "<pkg>/<activity>" component to pass to `am start -n`. Needed
|
|
// when an app declares multiple MAIN+LAUNCHER activities where the first
|
|
// one reported by `pm dump` is an alias whose target class is disabled.
|
|
string launcher_activity = 3;
|
|
}
|
|
|
|
message Point {
|
|
int32 x = 1;
|
|
int32 y = 2;
|
|
}
|
|
|
|
message Text {
|
|
string value = 1;
|
|
}
|
|
|
|
message Selector {
|
|
string value = 1;
|
|
}
|
|
|
|
message Image {
|
|
bytes png = 1;
|
|
int32 width = 2;
|
|
int32 height = 3;
|
|
}
|
|
|
|
message HierarchyJSON {
|
|
string json = 1;
|
|
}
|
|
|
|
message Duration {
|
|
int64 millis = 1;
|
|
}
|
|
|
|
message HealthStatus {
|
|
bool ready = 1;
|
|
string version = 2;
|
|
string platform = 3;
|
|
}
|
|
|
|
message SwipeRequest {
|
|
Point from = 1;
|
|
Point to = 2;
|
|
int64 duration_millis = 3;
|
|
}
|
|
|
|
message PressKeyRequest {
|
|
// Logical key name. Supported: "back", "home", "enter", "tab", "up",
|
|
// "down", "left", "right".
|
|
string key = 1;
|
|
}
|
|
|
|
message RecentLogsRequest {
|
|
// Lower bound as unix-epoch milliseconds; entries at or after this are
|
|
// returned.
|
|
int64 since_unix_millis = 1;
|
|
// Minimum level: "E", "W", or "I". Empty defaults to "E".
|
|
string level_at_least = 2;
|
|
}
|
|
|
|
message LogEntries {
|
|
repeated LogEntry entries = 1;
|
|
}
|
|
|
|
message LogEntry {
|
|
int64 unix_millis = 1;
|
|
string level = 2;
|
|
string tag = 3;
|
|
string message = 4;
|
|
}
|