8000 GitHub - oxhq/stasis: Controlled Servo runtime for deterministic open-act-settle-inspect automation · GitHub
[go: up one dir, main page]

Skip to content
oxhqPublic

About

Controlled Servo runtime for deterministic open-act-settle-inspect automation

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

57,847 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
< 8000 div class="react-directory-truncate">uv.lock
 
 

Stasis

Stasis is an experimental Servo-based runtime for executing a supported web application as a controlled event system. The checked-in native and TypeScript package sources target the 0.3.3 corrective train. They retain frozen controlled-webapp-v1 and controlled-web-session-v1 behavior, with controlled-web-session-v1 still the default, and add the separately selected, versioned controlled-web-session-v2 contract.

Source version and package CI are not publication proof. v0.2.1 and @oxhq/stasis@0.2.1 remain the last fully qualified predecessor. v0.3.0 is immutable disqualified release evidence after its macOS anonymous-consumer failure. The immutable v0.3.1 GitHub release is also disqualified: automatic npm prepublication failed in the packed SDK's cookie-replacement settlement, and @oxhq/stasis@0.3.1 was never published. The immutable v0.3.2 GitHub release is likewise disqualified: its release-event macOS public-package verifier timed out during cookie-replacement settlement before npm publication, so @oxhq/stasis@0.3.2 was never published. Version 0.3.3 is the stable successor only when its exact tag, release, registry package, provenance, and anonymous public-consumer evidence exist. Verify those public artifacts rather than inferring release status from this checkout.

Bounded performance evidence

A separate immutable benchmark release measured the exact Stasis v0.3.3 product at source revision 48c5a718a9ddd63f496e45307e1484974ccf8587 on two frozen, correctness-gated workloads. Each result below is one single-host observation using ten alternating AB/BA pairs after one untimed warm-up per implementation.

Frozen workload Published observation Fresh-host replication
Cypress RWA authentication, Windows 2022 CI-only bundle Median duration: Cypress 17499.546000 ms vs Stasis 3890.592700 ms; median paired Cypress/Stasis ratio 4.479108x (raw) Median duration: Cypress 20974.414150 ms vs Stasis 5553.314200 ms; median paired Cypress/Stasis ratio 3.761166x (raw)
Crawlee deterministic 20-page crawl, Ubuntu 22.04 Median duration: Crawlee 2195.796579 ms vs Stasis 2378.866899 ms; median paired Crawlee/Stasis ratio 0.929559x (raw) Median duration: Crawlee 2272.683301 ms vs Stasis 2409.138217 ms; median paired Crawlee/Stasis ratio 0.948109x (raw)

In each run, all 20 timed RWA observations completed the complete frozen 8/8 authentication intents. That is not all 45 RWA tests, Cypress API equivalence, or exact browser-semantic equivalence. All 10/10 crawl pairs were exact-equivalent at 20/20 pages, and no timed failure was discarded. Original and replication hosts and the Windows/Ubuntu tracks are not pooled; these workload-specific exploratory observations do not support a general speed claim. The Windows result used a qualification-only bundle and does not add Windows to the managed release platforms. See the replication report and checksums.

Linux release prerequisite

The immutable Stasis v0.3.3 Linux x86-64 runtime dynamically loads libEGL.so.1 during graphics initialization. On Ubuntu 22.04, install it before using the release archive directly or through @oxhq/stasis:

sudo apt-get update
sudo apt-get install --yes --no-install-recommends libegl1

The v0.3.3 archive's INSTALL.txt and NATIVE-LIBRARIES.txt omitted this dynamically loaded prerequisite. The archive and executable bytes are unchanged. Source builds that run ./mach bootstrap already install it.

Start with STASIS.md for the product boundary, the v0.3 controlled-session contract for the explicit v2 surface, the frozen v0.2 session contract for the default v1 session, and the v0.1 protocol for the frozen legacy methods. Build and release operators should also read the release runbook.

Servo foundation

Servo is a prototype web browser engine written in the Rust language. It is currently developed on 64-bit macOS, 64-bit Linux, 64-bit Windows, 64-bit OpenHarmony, and Android.

Servo welcomes contribution from everyone. Check out:

Coordination of upstream Servo development happens:

Getting started

For more detailed build instructions, see the Servo Book under Getting the Code and Building Servo.

macOS

  • Download and install Xcode and brew.
  • Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • Restart your shell to make sure cargo is available
  • Install the other dependencies: ./mach bootstrap
  • Build servoshell: ./mach build

Linux

  • Install curl:
    • Arch: sudo pacman -S --needed curl
    • Debian, Ubuntu: sudo apt install curl
    • Fedora: sudo dnf install curl
    • Gentoo: sudo emerge net-misc/curl
  • Install uv: curl -LsSf https://astral.sh/uv/install.sh | sh
  • Install rustup: curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
  • Restart your shell to make sure cargo is available
  • Install the other dependencies: ./mach bootstrap
  • Build servoshell: ./mach build

Windows

  • Download uv, and rustup
    • Be sure to select Quick install via the Visual Studio Community installer
  • Ensure that winget is available. It should be preinstalled on Windows 10 1809+ and Windows 11, otherwise can be manually installed.
  • In the Visual Studio Installer, ensure the following components are installed:
    • Windows 10/11 SDK (anything >= 10.0.19041.0) (Microsoft.VisualStudio.Component.Windows{10, 11}SDK.{>=19041})
    • MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest) (Microsoft.VisualStudio.Component.VC.Tools.x86.x64)
    • C++ ATL for latest v143 build tools (x86 & x64) (Microsoft.VisualStudio.Component.VC.ATL)
  • Restart your shell to make sure cargo is available
  • Install the other dependencies: .\mach bootstrap
  • Build servoshell: .\mach build

Android

  • Ensure that the following environment variables are set:
    • ANDROID_SDK_ROOT
    • ANDROID_NDK_ROOT: $ANDROID_SDK_ROOT/ndk/28.2.13676358/ ANDROID_SDK_ROOT can be any directory (such as ~/android-sdk). All of the Android build dependencies will be installed there.
  • Install the latest version of the Android command-line tools to $ANDROID_SDK_ROOT/cmdline-tools/latest.
  • Run the following command to install the necessary components:
    sudo $ANDROID_SDK_ROOT/cmdline-tools/latest/bin/sdkmanager --install \
     "build-tools;36.0.0" \
     "emulator" \
     "ndk;28.2.13676358" \
     "platform-tools" \
     "platforms;android-37" \
     "system-images;android-37;google_apis;x86_64"
  • Follow the instructions above for the platform you are building on

OpenHarmony

  • Follow the instructions above for the platform you are building on to prepare the environment.
  • Depending on the target distribution (e.g. HarmonyOS NEXT vs pure OpenHarmony) the build configuration will differ slightly.
  • Ensure that the following environment variables are set
    • DE 6779 VECO_SDK_HOME (Required when targeting HarmonyOS NEXT)
    • OHOS_BASE_SDK_HOME (Required when targeting OpenHarmony)
    • OHOS_SDK_NATIVE (e.g. ${DEVECO_SDK_HOME}/default/openharmony/native or ${OHOS_BASE_SDK_HOME}/${API_VERSION}/native)
    • SERVO_OHOS_SIGNING_CONFIG: Path to json file containing a valid signing configuration for the demo app.
  • Review the detailed instructions at [Building for OpenHarmony].
  • The target distribution can be modified by passing --flavor=<default|harmonyos> to mach <build|package|install>.

About

Controlled Servo runtime for deterministic open-act-settle-inspect automation

Resources

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

0