v1.8.0 — Present and Accounted For

This release improves first-message UX, cross-provider history compatibility, and metadata visibility while tightening LiteLLM release validation and upgrading the OpenAI Agents SDK. In short: better defaults, cleaner migration paths, and safer release behavior.

Breaking Changes

This release continues the v1.x cleanup and standardization work around guardrail/runtime APIs.

• Input guardrail runtime flag migration by @bonk1t in #532
  • Canonical runtime flag is raise_input_guardrail_error.
  • throw_input_guardrail_error remains as a deprecated alias.
  • return_input_guardrail_errors is removed and now fails fast with migration guidance.
• Handoff export clarification by @bonk1t in #532
  • Handoff now maps to Agency Swarm’s handoff tool export.
  • OpenAI Agents SDK handoff is exported as SDKHandoff.

Features

These additions improve out-of-the-box UX in both agent behavior and API metadata.

• Built-in PresentFiles tool by @ArtemShatokhin in #520
  • Moves files into the configured preview directory with overwrite/symlink safety and preview metadata output.
• Conversation starters + quick replies cache improvements by @bonk1t in #519 and #526
  • Adds quick_replies support for cached first-message replay.
  • Hardens cache fingerprinting (including shared instructions/streaming context) and cache skip rules for override/hook paths.
• Expose tool input schemas in metadata by @bonk1t in #523
  • Function tool schemas are now available in metadata for richer UI/client generation.
• Web search sources enabled by default by @bonk1t in #530
  • Enables source inclusion by default and adds shared source extraction utilities.
• FastAPI server example polish by @bonk1t in #529
  • Refreshes the server example to demonstrate clearer inter-agent routing and typed calculation tooling.

Improvements & Fixes

This release puts significant focus on history correctness across model backends and release-check stability.

• History protocol compatibility hardening by @bonk1t in #525
  • Persists protocol metadata consistently, rejects incompatible mixed history, and improves LiteLLM ↔ Responses replay behavior.
• RunItem persistence refactor by @bonk1t in #527
  • Switches to typed RunItem.raw_item attribute access in stream persistence paths.
• OpenAI Agents SDK upgrade by @bonk1t in #535
  • Bumps openai-agents to 0.9.3 and refreshes lock metadata.
• Release-check unblock and LiteLLM test hardening by @bonk1t in #536
  • Fixes LiteLLM integration test path/import issues and aligns test/CI validation for release gating.

Docs & Process

• Guardrails docs split + onboarding refresh by @bonk1t in #533
• AGENTS process-rule tightening (branch sync/review loop) by @bonk1t in #534

Full Changelog: v1.7.0...v1.8.0