Skip to content

v1.2.0 — Agent-oriented browser improvements

Choose a tag to compare

@hermes-gadget hermes-gadget released this 27 Aug 13:37
· 27 commits to main since this release
3630c24

What's New

Token Efficiency

  • Compact snapshot mode — reduces token usage by up to 90% via depth limiting, text inlining, and empty container drops while preserving all interactive elements
  • Snapshot diff mode — tracks page changes between snapshots with +/- line diffs and summary counts
  • Screenshot saveOnly mode — skip base64 return when only file output is needed

Agent Workflow Tools

  • Structured data extraction — parse JSON-LD, OpenGraph, microdata, prices, dates, and deduplicated authors from any page
  • Form filling helper — browser_act with action: fill_form for multi-field form completion
  • Download to workspace — browser_files with action: save to move downloads to accessible paths
  • Multi-tab context — browser_page with action: list_with_content for page summaries

Session Management

  • Activity logging — bounded ring buffer tracking all browser actions with timestamps
  • Session health checks — process liveness, memory usage, uptime, and page count
  • Cookie import/export — save and restore clearance cookies across sessions
  • Session export/import — full state snapshot (cookies, localStorage, URL, viewport)
  • Request interception — agent-controlled URL pattern blocking and header modification

Search & Research

  • Rate-limit awareness — per-provider tracking with structured retry info
  • Provider health monitoring — availability, latency, error counts
  • Crawl follow-up queries — iterative research with parent job linking
  • Research refinement — follow-up queries on existing research jobs

Bug Fixes

  • Wired compact/maxDepth/previousSnapshotId through session.snapshot() to createSnapshot()
  • Fixed assertPathWithinRoots to validate directory existence instead of requiring the destination file to exist

PRs Included

  • #14: Type definitions foundation
  • #15: Compact snapshot mode and diffs
  • #16: Structured data extraction
  • #17: Search rate-limiting and crawl follow-up
  • #18: Session management features
  • #19: MCP tool wiring
  • #21: Bug fixes for compact/diff params and savePath validation
  • #22: Version bump to 1.1.0 (re-tagged as 1.2.0)