Skip to content

v0.5.0 - 🐝 Auto Agents 🐝

Choose a tag to compare

@TimothyZhang7 TimothyZhang7 released this 16 Feb 03:34
· 1039 commits to main since this release
f7af5f9

Release Notes

Release Date: February 13, 2026
Tag: v0.5.0

Event-Driven Agents Are Here

v0.5.0 is our biggest architecture release yet. Hive agents can now react to the outside world -- webhooks, timers, and external events trigger agent execution alongside the interactive user session. This unlocks an entirely new class of agents: ones that don't just wait for you to talk to them, but autonomously respond to real-world events while you stay in control.


Highlights

Webhook & Timer Entry Points

Agents are no longer single-entry. A single agent graph can now declare multiple entry points with different trigger types -- each entering the graph at a different node.

# User-facing entry point (interactive)
EntryPointSpec(id="start", entry_node="intake", trigger_type="manual")

# External webhook triggers execution at a different node
EntryPointSpec(id="email-event", entry_node="fetch-emails",
               trigger_type="event",
               trigger_config={"event_types": ["webhook_received"]})

# Built-in scheduler -- no crontab needed
EntryPointSpec(id="email-timer", entry_node="fetch-emails",
               trigger_type="timer",
               trigger_config={"interval_minutes": 20})

Webhook server starts automatically when webhook_routes are configured. POST to http://localhost:8080/webhooks/gmail and your agent picks it up.

Timer triggers are built into the runtime -- AgentRuntime manages asyncio tasks internally. No external schedulers, no cron, no glue code.

Shared session state across entry points means the user sets up rules once via the interactive intake node, and every webhook/timer execution reuses those rules automatically.

TUI Event Source Dashboard

The TUI graph panel now displays active event sources below the agent graph:

Event Sources
  ⚡ Email Event Handler → fetch-emails
     127.0.0.1:8080/webhooks/gmail
  ⏱  Scheduled Inbox Check → fetch-emails
     every 20 min -- next in 14m 32s

tui_screenshot_20260215_194051

Timer countdowns update live. Webhook endpoints show the exact URL to POST to. No more guessing what's listening.

Gmail Inbox Guardian -- Reference Event-Driven Agent

A fully functional Gmail automation agent ships as both a template (examples/templates/gmail_inbox_guardian/) and a ready-to-run export (exports/gmail_inbox_guardian/). It demonstrates the complete event-driven pattern:

  • Intake node (client-facing, forever-alive): User defines free-text triage rules
  • Fetch-emails node: Retrieves unread emails via Gmail MCP tools
  • Classify-and-act node: Matches each email against rules, executes Gmail actions (star, trash, mark read, label, etc.)
  • Report node: Summarizes actions taken

Three entry points run concurrently: manual rule setup, webhook-triggered triage, and a 20-minute scheduled check. Conversation memory is continuous across all of them.


What's New

Architecture & Runtime

  • Multi-entry-point AgentRuntime -- Register webhook, timer, event, and manual entry points on a single graph. Each gets its own ExecutionStream with configurable concurrency and isolation. (#4918)
  • Timer trigger type -- trigger_type="timer" with interval_minutes config. Runtime manages scheduling internally with next-fire tracking. (#4720)
  • Webhook server -- Auto-starts an HTTP server for configured routes. Receives POST payloads and routes them to the correct entry point. (#4720)
  • Fresh shared-session cursor clearing -- Webhook/timer executions reuse the primary session but get a fresh OutputAccumulator, preventing stale outputs from causing node skips. (#4918)
  • Async LLM methods -- acomplete(), acomplete_with_tools(), _acompletion_with_rate_limit_retry() added to LiteLLMProvider. Uses litellm.acompletion and asyncio.sleep -- no more blocking the event loop. (#4920)
  • Phased compaction & event bus integration -- Conversation compaction now respects phase boundaries. Event bus emits lifecycle events for all node transitions. (#4647)

Robustness & Error Handling

  • Transient error retry -- Stream errors from APIConnectionError, InternalServerError, ServiceUnavailableError, and connection resets are now retried with exponential backoff instead of crashing the agent. (#4722)
  • Loop detection -- Detects repeated empty responses (3+ consecutive) and breaks out instead of spinning forever.
  • Recoverable stream errors -- StreamErrorEvent now carries a recoverable flag so the EventLoopNode can decide whether to retry or fail.
  • Storage path validation -- Runtime validates and creates storage paths on init instead of crashing later. (#4466)

TUI Improvements

  • Two-panel layout -- Graph overview on the left, chat on the right. Cleaner, more focused. (#4610)
  • Event source display -- Webhooks show endpoint URLs, timers show interval and live countdown.
  • Live timer countdown -- Graph panel refreshes every second to show next in Xm XXs for scheduled triggers.

New Tool Integrations

New MCP tool integrations from the community:

Tool Description Contributor
Google Calendar Create, list, update calendar events @Antiarin
Cal.com Open-source scheduling infrastructure @Amdev-5
BigQuery SQL querying and data analysis @emmanuel Nwanguma
Excel Read/write .xlsx/.xlsm files @amit Kumar
Google Maps Platform 6 MCP tools (geocode, directions, places, etc.) @amit Kumar
Telegram Bot Send messages, manage chats @siddharth Varshney
NewsData + Finlight Market intelligence and news aggregation @amit Kumar
GCP Vision API Image analysis and OCR @T.Trinath Reddy
Gmail List, get, trash, modify labels on emails Core team
Time Current date/time retrieval @Antiarin
Security Scanner 6 passive scanning tools (SSL/TLS, HTTP headers, DNS, ports, tech stack, subdomains) + risk scorer Core team

Example Agents

Four new ready-to-use template agents ship with this release in examples/templates/:

  • Gmail Inbox Guardian -- Event-driven email triage with webhooks, timers, and user-defined rules. The user defines free-text rules ("star emails from my boss", "trash marketing newsletters"), and the agent autonomously processes incoming emails via webhook triggers or a 20-minute scheduled check. Demonstrates multi-entry-point architecture, shared session state, and continuous conversation memory. Full template + ready-to-run export. (#4925)

  • Inbox Management -- Linear email management pipeline. User provides natural language rules, agent fetches inbox emails in configurable batches (up to 100), classifies each against the rules, executes Gmail actions (trash, archive, star, label, mark read/unread), and produces a summary report grouped by action type. 4-node pipeline: intake → fetch-emails → classify-and-act → report. (#4610)

  • Job Hunter -- Resume-driven job search and outreach agent. Analyzes your resume to identify strongest role fits, searches the web for 10 matching job listings, lets you interactively select which to pursue, then generates tailored resume customization notes and cold outreach emails for each selected position -- all saved to disk. 4-node pipeline with 3 client-facing interactive nodes: intake → job-search → job-review → customize. (#4759)

  • Passive Vulnerability Assessment -- OSINT-based website security scanner. Accepts a target domain and runs 6 passive scanning tools (SSL/TLS, HTTP headers, DNS security, port scanning, tech stack detection, subdomain enumeration), produces letter-grade risk scores (A-F) per category with a weighted overall grade, presents findings at an interactive checkpoint where the user can request deeper scanning or generate the report, and delivers a self-contained HTML risk dashboard with color-coded grades, detailed findings, and developer-focused remediation steps. 5-node pipeline with feedback loop: intake → passive-recon → risk-scoring → findings-review ↔ passive-recon → final-report ↻ intake. (#4922)

tui_screenshot_20260215_192338


Bug Fixes

  • Fix call_from_thread errors in TUI when events fire from executor threads
  • Fix stale memory filtering -- webhook executions no longer inherit outdated nullable outputs
  • Fix conversation history persistence causing fetch-emails to be skipped on subsequent triggers
  • Fix default batch size (50 → 10) to prevent context overflow on large inboxes
  • Fix unicode bullet rendering on Windows (#4525)
  • Fix uv local storage path resolution
  • Remove unused send_budget_alert_email tool, require explicit provider param

Documentation


Breaking Changes

None. All changes are backwards-compatible. Agents without event sources continue to work exactly as before.


Windows

  • Windows Defender exclusions for 40% faster uv sync (@e-cesar9)
  • Improved failure messaging with success rate display (@e-cesar9)
  • Path validation for Defender exclusions (@e-cesar9)
  • Unicode bullet replacement with ASCII dashes (@richard Tang)

Community Contributors

A huge thank you to everyone who contributed to this release:

  • Amit Kumar (@Amdev-5) -- Cal.com, Excel, Google Maps, NewsData + Finlight integrations
  • Pravin Mishra (@mishrapravin114) -- critical framework issues that slows down runtime execution
  • Aaryann Chandola (@Antiarin)-- Google Calendar integration, Time tool
  • Emmanuel Nwanguma (@Emart29) -- BigQuery integration, storage path validation fix
  • @siddharth Varshney -- Telegram Bot integration
  • @T.Trinath Reddy (@Trinath052004) -- GCP Vision API integration
  • @e-cesar9 -- Windows Defender performance, security fixes, and UX improvements
  • @LukeM94 -- Documentation fixes
  • @zhanglinqian -- Documentation fixes
  • @Hima-de -- Documentation fixes
  • @jaathavan18 -- Documentation fixes

Upgrading

git pull origin main
uv sync

No migration steps required. Existing agents work without changes.

To try the new event-driven capabilities:

# Run the Gmail Inbox Guardian with TUI
hive tui
# Select "Gmail Inbox Guardian" from the agent list

# Or run directly
PYTHONPATH=core:exports uv run python -m gmail_inbox_guardian tui

What's Next

  • Multiple OAuth credentials from the same platform -- for long-running agents with multiple identities
  • Cost Visibility -- for detailed runtime log of llm costs
  • Agent-to-agent communication -- one agent's output triggers another agent's entry point
  • Persistent webhook subscriptions -- survive agent restarts without re-registering