Skip to content

v0.4.2 🐝

Choose a tag to compare

View all tags
@github-actions github-actions released this 09 Feb 04:51
· 1258 commits to main since this release
v0.4.2
9ecd498

Release Date: February 8, 2026
Tag: v0.4.2

🎉 Resumable Sessions - Never Lose Progress Again

This release introduces comprehensive resumable session functionality, allowing agents to pause and resume execution without losing progress. Whether interrupted by errors, rate limits, or simply needing to step away, your work is now automatically preserved.

✨ What's New

🎯 Core Feature: Resumable Sessions

Never lose progress again. Agents now automatically save state and can resume execution after any interruption - credential errors, rate limits, or simply closing the terminal.

🚀 New Commands

TUI Commands:

  • /resume - Resume the most recent paused/failed session automatically
  • /resume <session_id> - Resume a specific session by ID
  • /sessions - List all sessions for the current agent with status
  • /pause - Immediately pause execution with full state capture (alternative to Ctrl+Z)

CLI Flags:

  • --resume-session - Auto-resume latest session when starting agent
  • --checkpoint <checkpoint_id> - Resume from specific checkpoint (advanced)

⌨️ Keyboard Shortcuts

  • Ctrl+Z - Instantly pause execution (now actually works!)
    • Previously: Just showed a notification without pausing
    • Now: Immediately cancels task and saves full state

💾 Automatic State Saving

State is automatically saved when:

  • You press Ctrl+Z or use /pause
  • You quit the TUI (close terminal or Ctrl+C)
  • A node fails with an error
  • Agent hits rate limits or missing credentials
  • Execution completes (for iterative workflows)

What gets saved:

  • Complete memory snapshot with all collected data
  • Full conversation history for interactive nodes
  • Execution path (which nodes were executed)
  • Current node position (exact point where paused)
  • Node visit counts (for feedback loop handling)

📂 Unified Session Storage

  • All sessions stored at: ~/.hive/agents/{agent_name}/sessions/
  • Each session has its own directory with state.json
  • Session status tracked: active, paused, completed, failed, cancelled
  • Automatic selection of most recent resumable session

🔧 Changes & Improvements

Behavior Changes

  • Pause is now immediate - Uses task cancellation instead of waiting for node boundaries
  • TUI quit behavior - Now pauses and saves state (previously cancelled without saving)
  • Timeout increased - Session cleanup timeout raised from 0.5s to 5s for reliable state saving

Architecture Updates

  • Deprecated pause nodes in favor of client-facing EventLoopNodes
  • Replaced request_pause() with immediate task cancellation pattern
  • Enhanced ExecutionResult with session_state["memory"] at all exit points

🐛 Bug Fixes

  • Memory persistence - ExecutionResult.session_state["memory"] now properly populated at all exit points (Ctrl+Z, failure, exception)
  • Resume node selection - Fixed resume starting at intake node instead of paused_at node
  • Visit count handling - Fixed double-counting on resume (paused node count now properly adjusted)
  • Session selection - Fixed selection of oldest instead of latest session
  • Quit state save - Fixed failures due to insufficient timeout
  • Ctrl+Z implementation - Implemented actual pause logic (was only showing notification)
  • Empty memory on resume - Fixed memory restoration by ensuring session_state["memory"] is populated

⚠️ Known Limitations

  • Interactive debugging - Checkpoint recovery (/recover) exists but lacks user-friendly inspection UI
  • Hot reloading - Code changes don't reflect in resumed sessions (must complete old execution first)
  • Graph structure changes - Resuming after heavy modifications (renamed/deleted nodes, changed edges) has undefined behavior
  • Version compatibility - No mechanism to detect mismatches between session schema and agent structure

📚 Documentation

See RESUMABLE_SESSIONS_PR.md for detailed operational guide.

🙏 Contributors

This release was made possible by community contributions from:

Contributions (v0.4.0 → v0.4.2)

  • @Acid-OP (Gaurav Kapur) - Fixed node outputs not being written to memory before edge evaluation (#3599, #3694)
  • @hamzanajam7 - Documentation improvements (Contributing link, project structure fixes)
  • @kramitnke5 (Amit Kumar) - Apollo.io contact and company data enrichment integration (#3167)
  • @subhayanmukherjee78 (Subhayan Mukherjee) - Clarified test generation responsibility in hive skill documentation
  • @RichardTang-Aden (Richard Tang) - Documentation improvements (README updates, video addition, quickstart.sh messages, uv run migration)

Special thanks to all community members who provided feedback, testing, and bug reports during development.

🔗 Links

What's Next?

We're working on:

  • Interactive debugging UI for checkpoint inspection
  • Hot reloading support for code changes
  • Graph version compatibility checking
  • MCP tools for session management

Stay tuned for v0.5.0! 🚀

Assets 2
Loading