v1.7.2

lfnovo/open-notebookv1.7.2Feb 16, 2026by lfnovo

AI Summary

Major error handling improvements with error classification utility, global exception handlers, and user-friendly LLM error messages instead of generic errors.

Key Highlights

  • Error classification utility for LLM provider errors
  • Global exception handlers in FastAPI
  • Fixed LLM errors showing descriptive messages
  • Fixed SSE streaming error events
  • Various UI overflow fixes

New Features

  • Error classification utility mapping provider errors to user-friendly messages
  • Global exception handlers with proper HTTP status codes
  • getApiErrorMessage() frontend helper
  • ConfigurationError class for model provisioning
  • ValueError replaced with ConfigurationError

Full Release Notes

## Added
- Error classification utility that maps LLM provider errors to user-friendly messages (#506)
- Global exception handlers in FastAPI for all custom exception types with proper HTTP status codes
- `getApiErrorMessage()` frontend helper that falls back to backend messages when no i18n mapping exists

## Fixed
- LLM errors (invalid API key, wrong model, rate limits) now show descriptive messages instead of "An unexpected error occurred" (#590)
- SSE streaming error events in source chat and ask hooks were swallowed by inner JSON parse catch blocks
- Transformation execution errors were caught and re-wrapped as generic 500s instead of using proper status codes
- Fail fast when source content extraction returns empty instead of retrying (#589)
- Chat input and message overflow with long unbroken strings (#588)
- Word-wrap overflow in source cards, note editor, inline edit, note titles, and dialog content (#588)
- Translation proxy shadowing `name` keys (#588)
- OpenAI-compatible provider name handling via Esperanto update (#583)

## Changed
- `ValueError` replaced with `ConfigurationError` in model provisioning for proper error classification
- `ConfigurationError` added to command retry `stop_on` lists to avoid retrying permanent config failures

## Dependencies
- Bump esperanto to 2.19.3 (#583)
- Bump podcast-creator to 0.9.1