Project Tendril v1.3.0

What's Changed

• chore(deps-dev): bump the development-dependencies group across 1 directory with 3 updates by @dependabot[bot] in #6
• chore(deps): bump the production-dependencies group across 1 directory with 2 updates by @dependabot[bot] in #5
• chore(deps): refresh remaining minor dependencies by @hermes-gadget in #23
• fix(config): validate runtime settings and sandbox readiness by @hermes-gadget in #30
• fix: harden runtime lifecycle boundaries by @hermes-gadget in #31
• feat(search): harden provider and research pipeline by @hermes-gadget in #33
• fix(browser): harden snapshot refs and bounds by @hermes-gadget in #32
• build: harden release and package verification by @hermes-gadget in #35
• Release v1.3.0: reliable agent web research by @gadgethd in #43

New Contributors

• @dependabot[bot] made their first contribution in #6
• @gadgethd made their first contribution in #43

Full Changelog: v1.2.0...v1.3.0

v1.2.0 — Agent-oriented browser improvements

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)

v1.1.0 — Fixed Search Providers + New Tools

What's New

Search Provider Fixes (Critical)

• DuckDuckGo: Switched to JSON API to avoid bot-check/CAPTCHA blocking
• Google: Added Custom Search JSON API support (set GOOGLE_SEARCH_API_KEY + GOOGLE_SEARCH_CX)
• SearXNG: Wired searxngUrl config through to MCP tools
• Circuit-breaker: Providers auto-skip after 3 consecutive failures (5min cooldown)

Search Infrastructure

• Search result caching (5min TTL LRU) — same query returns instantly
• Concurrent provider racing — first 2 providers race, fastest wins
• Provider health tracking with success/failure counts

New Tools

• browser_act: Added type (fill input) and select (dropdown) actions
• browser_session: Named persistent sessions with reconnect support
• browser_capture: Save screenshots to local files via savePath parameter

Security

• Path traversal fix: savePath validated against workspace roots (CodeQL)

Tests

• search.test.ts: 5/5 passing — all provider fixes verified

Project Tendril v1.0.0

Full Changelog: https://github.com/gadgethd/Project-Tendril/commits/v1.0.0