v1.2

🚀 Release Summary

This release delivers major improvements across routine execution, observability, data models, SDK structure, and OpenAI integration, with a strong focus on reliability, performance, and future agentic workflows.

---

✅ Resolved Issues

• Fixed placeholder interpolation tracking for improved error logging and observability (#58)
• Made pylint and pytest required (non-optional) dependencies (#54)
• Adopted OpenAI Responses API structured outputs (#51)
• Prevented Routine Discovery from generating unused parameters (#46)
• Cleaned up incorrect and inconsistent file path references

---

✨ New Features

• Chunking for large outputs to prevent CDP timeouts
• More efficient fetch storage, removing unnecessary CDP round-trips
• JS-level parameter interpolation logging to improve routine observability
• Window property monitoring (v1):
  • Tracks window properties on navigation and periodically
  • Logs value changes and removals with timestamps and URLs
  • Non-blocking to avoid disrupting browser sessions
• New routine operations:
  • JavaScript Evaluation Operation
  • Download Operation
  • UI Operations (foundation for UI-driven routines)
• UI data models:
  • UI elements
  • UI interactions
  • Improved interaction collection aligned with new models

---

🔧 Improvements & Refactors

• Refactored routine execution to operate cleanly at the routine/operation level
• Updated and unified routines, params, operations, and endpoint data models
• Refactored the CDP module
• Added new data utilities
• Improved routine integrity:
  • Automatic escaping of quotes when required
  • Fixed validation bugs (fully covered by unit tests)
• Updated OpenAI Responses API parsing
• Improved prompts and LM response data models
• Expanded network monitoring support (more file types, .txt as default response body)
• Migrated to GPT-5.1 for faster and more reliable execution
• Verified that Responses API provides sufficient context for extended runtimes

---

🧪 Developer Experience

• Updated and expanded unit test coverage
• SDK fully refactored to use new data models
• Added a new quickstart.py that uses the SDK directly, making SDK testing significantly easier

---

🛣️ Looking Ahead

Future PRs will focus on:

• Running and evaluating generated routines before completion (#57)
• Leveraging UI and window property data for reverse-engineering agents
• Adding more UI-driven routine operations
• Further improving placeholder interpolation diagnostics (#58 follow-ups)

v1.1.2

What's Changed

• Window props by @dimavrem22 in #47
• Fix unexpected Chrome session termination by @rayruizhiliao in #49

Full Changelog: v1.1.0...v1.1.2

v1.1.0

Changes in v1.1.0

🚀 Major Changes

PyPI Package Release

• Package is now available on PyPI: pip install web-hacker
• Restructured as a proper Python package with web_hacker/ namespace
• Added CLI entry points: web-hacker-monitor, web-hacker-discover, web-hacker-execute

New High-Level SDK Interface

• Added WebHacker class for simplified usage:

  from web_hacker import WebHacker
  hacker = WebHacker()
  with hacker.monitor_browser(output_dir="./captures"):
      pass
  routine = hacker.discover_routine(task="Search for flights", cdp_captures_dir="./captures")
  result = hacker.execute_routine(routine, parameters={"origin": "NYC", "destination": "LAX"})

✨ New Features

• Quickstart Script: Interactive Python script (quickstart.py) to automate the entire workflow
• Session Storage Interpolation: Support for {{sessionStorage:...}}, {{localStorage:...}}, {{cookie:...}}, and {{meta:...}} placeholders in fetch URLs
• Network Improvements: Added support for HTML responses, data cleaning, and retry loop for failed requests
• Human Interactions: Added support for executing GUI interactions

🔧 Improvements

• Improved task input experience in discovery workflow
• Better error handling and graceful exit
• Enhanced logging and messaging
• Updated documentation and README

🔄 Breaking Changes

Import Paths Changed:

Before

from src.config import Config
python scripts/browser_monitor.py

After

from web_hacker.config import Config
web-hacker-monitor

Note: Core functionality unchanged. Only import paths and package structure changed.

📦 Installation

pip install web-hacker

View on PyPI: https://pypi.org/project/web-hacker/1.1.0/

Initial public release

[1.0.0] - 2025-11-05

Added

• Initial public release of web-hacker
• Core reverse-engineering and web automation modules
• Example routines under /example_routines
• Basic tests and GitHub Actions setup
• Apache 2.0 License and CODEOWNERS configuration