Skip to main content

Migration (0.5.x to 0.6.x)

Key breaking changes from 0.5.x to 0.6.x:

Template routing API removals​

Removed APIs:

  • ChatTemplateEngine.registerHandler(...)
  • ChatTemplateEngine.unregisterHandler(...)
  • ChatTemplateEngine.clearCustomHandlers(...)
  • ChatTemplateEngine.registerTemplateOverride(...)
  • ChatTemplateEngine.unregisterTemplateOverride(...)
  • ChatTemplateEngine.clearTemplateOverrides(...)

Removed per-call routing fields:

  • render param: customHandlerId
  • parse param: handlerId

Error behavior changes​

Template render/parse no longer silently downgrades to content-only fallback when handler/parser execution fails. Failures now surface to callers.

Migration tasks​

  1. Remove all calls to removed template handler registration APIs.
  2. Remove legacy handler routing fields from request paths.
  3. Add explicit error handling where fallback behavior was previously expected.
  4. Re-test tool-calling and template-specific parsing paths.

Full migration details​

See canonical guide: