Skip to content

0.1.8 - 2026-05-28

Choose a tag to compare

@github-actions github-actions released this 28 May 20:18

Release Notes

Added

  • click on a non-navigating element (an in-page handler that mutates
    the DOM or calls history.pushState) now returns the post-click
    text, tree, and content_hash, so an agent can see what changed.
    The <a href> navigation path (which already returned the
    destination's fields) is unchanged.
  • run gains --no-verify-input to skip the input-integrity check
    introduced below.

Changed

  • The heso command installed by pip install heso is now the native
    Rust binary itself (shipped via the wheel's *.data/scripts/
    directory) instead of a Python console-script that booted the
    interpreter before exec'ing the binary. import heso and
    python -m heso are unchanged.
  • read no longer fetches external <script src=...> by default; pass
    --js-fetch to opt in (matching read --help and eval-dom). Inline
    scripts are unaffected.
  • run now verifies the input plat's integrity before replaying and
    refuses on a plat_hash mismatch (exit 1, {ok: false, error: {code: "plat_integrity_mismatch", ...}}); a missing or malformed plat_hash
    exits 2. --no-verify-input restores the prior replay-anything
    behavior. This is a contract change — run previously replayed any
    input and exited 0. See ADR 0024.

Fixed

  • heso read now accepts --js-fetch. The flag was advertised in
    read --help but rejected by the argument parser.
  • read output is internally consistent after JavaScript runs: tree,
    title, description, and metadata are derived from the post-JS
    DOM, matching text and actions. Previously tree reflected the
    pre-JS HTML while text reflected the post-JS mutated DOM.
  • read's cookies field now includes cookies set by page JavaScript
    via document.cookie, merged with the network Set-Cookie headers.
    batch and serve keep their per-response cookie snapshot.

Install heso-cli 0.1.8

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/blank3rs/heso/releases/download/v0.1.8/heso-cli-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/blank3rs/heso/releases/download/v0.1.8/heso-cli-installer.ps1 | iex"

Download heso-cli 0.1.8

File Platform Checksum
heso-cli-aarch64-apple-darwin.tar.gz Apple Silicon macOS checksum
heso-cli-x86_64-apple-darwin.tar.gz Intel macOS checksum
heso-cli-x86_64-pc-windows-msvc.zip x64 Windows checksum
heso-cli-aarch64-unknown-linux-gnu.tar.gz ARM64 Linux checksum
heso-cli-x86_64-unknown-linux-gnu.tar.gz x64 Linux checksum