v3.2.0

magnitudedev/magnitudev3.2.0Feb 9, 2026by kichanyurd

Upgrading?

AI Summary

A substantial SDK update introducing advanced filtering, lifecycle hooks, and data retrieval capabilities to improve agent interaction management.

Key Highlights

  • Labeling and filtering system for Guidelines and Journeys
  • Lifecycle hooks (on_match, on_message) for journeys
  • Streaming message output mode
  • Per-agent preamble configuration

New Features

  • Add labels to Guidelines, Journeys, JourneyNodes, and Sessions
  • Add automatic session label propagation from matched entities
  • Add track parameter to guidelines
  • Support multiple targets in prioritize_over() and depend_on() methods
  • Add field_dependencies to canned responses
  • Add attach_retriever() to Guideline, Journey, and JourneyState
  • Add on_match and on_message hooks to journeys
  • Add per-agent preamble configuration
  • 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
  • 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
  • Fix websocket warning upon startup
  • Fix agent intention proposer
  • Fix multiple customer guideline matchers not working
  • Fix bug with context variable access in SDK

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

Related Repositories