v3.2.0

OpenBB-finance/OpenBBv3.2.0Feb 9, 2026by kichanyurd

AI Summary

This release introduces enhanced categorization and session management features for OpenBB's agent framework, including automatic label propagation, conditional data retrieval hooks, and per-agent configuration options. It also improves the SDK's dependency handling and adds streaming output capabilities.

Key Highlights

  • Added labels for Guidelines, Journeys, and Sessions to enable better categorization
  • Introduced automatic session label propagation from matched entities
  • Added lifecycle hooks (on_match, on_message) and conditional data retrieval via attach_retriever()
  • Support for multiple targets in prioritize_over() and depend_on() methods
  • Added streaming message output mode and per-agent preamble configuration

New Features

  • Labels for categorization and filtering
  • Automatic session label propagation
  • Track parameter for guidelines
  • Multiple targets in dependency methods
  • Field dependencies for canned responses
  • Conditional data retrieval (attach_retriever)
  • Lifecycle callbacks (on_match, on_message)
  • Per-agent preamble configuration
  • Streaming message output
  • Custom journey node ID support
  • Matched states in completion events

Full Release Notes

## [3.2.0] - 2026-02-09

### Added

- Add labels to Guidelines, Journeys, JourneyNodes, and Sessions for categorization and filtering
- Add automatic session label propagation from matched entities (guidelines, observations, journeys)
- Add `track` parameter to guidelines to control "previously applied" tracking
- Support multiple targets in `prioritize_over()` and `depend_on()` methods
- Add `field_dependencies` to canned responses for explicit field availability requirements
- Add `attach_retriever()` to Guideline, Journey, and JourneyState for conditional data retrieval
- Add `on_match` and `on_message` hooks to journeys for lifecycle callbacks
- Add per-agent preamble configuration (custom examples and instructions)
- Add separate default greeting responses for first agent message in fluid mode
- Add streaming message output mode
- Allow specifying custom journey node ID
- Add matched guidelines/journey states to completion ready event

### Changed

- Make condition optional for SDK guidelines
- Tweak default preamble examples
- Soften log levels for relational guideline resolver
- Add activated/skipped logs to custom guideline matcher batches

### Fixed

- Fix websocket warning upon startup
- Fix agent intention proposer (guidelines were getting rewritten incorrectly)
- Fix multiple customer guideline matchers not working
- Fix bug with context variable access in SDK