v3.2.0

sipeed/picoclawv3.2.0Feb 9, 2026by kichanyurd

AI Summary

Introduces extensive features for categorization, lifecycle hooks, data retrieval, and streaming, alongside fixes for agent behavior and websocket warnings.

Key Highlights

  • Add labels for categorization and filtering
  • Add automatic session label propagation
  • Add on_match and on_message hooks for journeys
  • Add per-agent preamble configuration
  • Add streaming message output mode

New Features

  • Labels for Guidelines, Journeys, JourneyNodes, and Sessions
  • Automatic session label propagation from matched entities
  • track parameter for guidelines
  • Multiple targets in prioritize_over and depend_on methods
  • field_dependencies for canned responses
  • attach_retriever for conditional data retrieval
  • on_match and on_message hooks for journeys
  • Per-agent preamble configuration
  • Streaming message output mode
  • Custom journey node ID specification

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