v3.2.0

mickael-kerjean/filestashv3.2.0Feb 9, 2026by kichanyurd

AI Summary

This release introduces advanced lifecycle management for journeys and guidelines, featuring automatic label propagation, new hooks, and streaming output, while fixing critical agent logic and websocket issues.

Key Highlights

  • Automatic session label propagation from matched entities
  • New `on_match` and `on_message` hooks for journey lifecycle callbacks
  • Streaming message output mode
  • Support for multiple targets in `prioritize_over()` and `depend_on()` methods
  • Fixes for agent intention proposer and multiple customer guideline matchers

New Features

  • Labels for Guidelines, Journeys, JourneyNodes, and Sessions
  • Automatic session label propagation
  • `track` parameter for guidelines to control tracking
  • Multiple targets in dependency methods
  • `field_dependencies` for canned responses
  • `attach_retriever()` for conditional data retrieval
  • `on_match` and `on_message` hooks
  • Per-agent preamble configuration
  • Separate default greeting responses for fluid mode
  • Streaming message output mode
  • Custom journey node ID specification
  • Matched guidelines/journey 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