Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[3.0.5] - 2026-03-30

Added notification preferences SDK methods:
- update_notifications(...) / update_notifications_async(...) -> POST /v1/me/notifications
- supports partial updates for email_notifications_enabled, tool_error_notifications_enabled, run_failure_notifications_enabled
Added tests for notification preferences client methods (sync + async payload validation and endpoint mapping).
Updated README.md and examples/README.md for latest backend plan matrix:
- tools registry now available on all plans with limits 1 / 20 / 100 / 1000
- governance entitlements and kill switch availability aligned with backend
- documented free hard-limit vs paid soft-limit usage behavior

Added run debug SDK methods:
- post_event(...) / post_event_async(...) -> POST /v1/events
- get_run_timeline(...) / get_run_timeline_async(...) -> GET /v1/runs/{run_id}
Added high-level wrappers ai_run(...) / ai_run_async(...) on OnceOnly.
Added run_id support in AI high-level calls (ai.run*, ai.run_tool*, ai.run_and_wait*):
- key mode -> auto-injected into metadata.run_id
- tool mode -> auto-injected into args.run_id
Extended events(...) / events_async(...) with optional offset.
Added run-debug example: examples/ai/run_debug_timeline.py.
Added failure-debug SDK example: examples/ai/run_debug_failure.py.

Updated repository links after migration to GitHub org OnceOnly-Tech/onceonly-python.
Updated package metadata repository URL used by PyPI project links.

Documentation updates (README links and references).
Minor client compatibility improvements (base_url normalization, clearer 403 feature gating).