v1.8.0

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 https://github.com/VRSEN/agency-swarm/pull/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 https://github.com/VRSEN/agency-swarm/pull/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 https://github.com/VRSEN/agency-swarm/pull/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 https://github.com/VRSEN/agency-swarm/pull/519 and https://github.com/VRSEN/agency-swarm/pull/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 https://github.com/VRSEN/agency-swarm/pull/523  
  - Function tool schemas are now available in metadata for richer UI/client generation.
- **Web search sources enabled by default** by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/530  
  - Enables source inclusion by default and adds shared source extraction utilities.
- **FastAPI server example polish** by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/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 https://github.com/VRSEN/agency-swarm/pull/525  
  - Persists protocol metadata consistently, rejects incompatible mixed history, and improves LiteLLM ↔ Responses replay behavior.
- **RunItem persistence refactor** by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/527  
  - Switches to typed `RunItem.raw_item` attribute access in stream persistence paths.
- **OpenAI Agents SDK upgrade** by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/535  
  - Bumps `openai-agents` to `0.9.3` and refreshes lock metadata.
- **Release-check unblock and LiteLLM test hardening** by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/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 https://github.com/VRSEN/agency-swarm/pull/533
- **AGENTS process-rule tightening (branch sync/review loop)** by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/534

**Full Changelog**: https://github.com/VRSEN/agency-swarm/compare/v1.7.0...v1.8.0