v1.7.0

This release introduces conversation starters with caching and metadata support, stronger validation, and cleaner FastAPI/MCP behavior, plus a round of stability work in tests and docs.

## Breaking Changes
This release completes the v1.x transition by removing deprecated v0.x APIs. If you're still using old patterns, see the [Migration Guide](https://agency-swarm.ai/migration/guide).

* Removed deprecated Agency APIs (`agency_chart`, completions proxy, `message_files`), enforced strict Agent kwargs, and removed legacy reminder override behavior.
* `SendMessage` no longer accepts the `my_primary_instructions` field. Remove it from tool payloads to avoid schema errors.
* `get_agency_structure` is deprecated. Use `get_agency_graph` for nodes/edges and `get_metadata` when you need the full metadata bundle.
* `SendMessageHandoff` is deprecated and renamed to `Handoff`.

## Features
* feat: conversation starters cache and metadata by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/516: 
  * Exposes conversation starters in agency graph/FastAPI metadata, adds a cached starter-prompts system with fingerprinting and warmup for sync/streaming runs, removes deprecated completions paths, and refreshes related docs/tests.
* Add shared resource parameters to the agency class by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/502: 
  * You can now pass shared tools, tool folders, files folders, and MCP servers once, and have them applied to every agent (with shared vector store support and FastAPI wiring).
* Add local file path support to file urls by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/498: 
  * FastAPI now accepts local file paths in `file_urls` when `allowed_local_file_dirs` is set, with strict allowlisting, better error reporting, and updated AG-UI handling.
* Add dynamic client configuration override to fastapi endpoints by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/503: 
  * Each request can now override `base_url` and `api_key` (and LiteLLM provider keys) via `client_config`.

## Improvements
* Remove my_primary_instructions by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/499: Simplified `SendMessage` schema by removing the redundant `my_primary_instructions` field.
* chore: bump openai-agents to 0.6.4 by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/497: Upgraded `openai-agents` (and `openai`) and tightened runtime tool type checks so invalid hosted tool inputs are caught earlier.
* rename SendMessageHandoff to Handoff by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/507: Introduced `Handoff` as the preferred tool name, kept `SendMessageHandoff` as a deprecated alias, and refreshed docs/tests to match.
* fix: tighten tool validation errors by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/501: Agent tool validation now rejects invalid tool entries earlier (like uninitialized hosted tool classes or `FunctionTool` classes).
* Rename agency graph metadata APIs by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/517: Added `get_agency_graph` (nodes/edges only) and `get_metadata` (graph + metadata), plus updated visualization and docs.

## Fixes
* fix: pass uvicorn_config through run_mcp by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/510: `run_mcp` now forwards Uvicorn settings to FastMCP for HTTP/SSE servers, and MCP examples are more runnable out of the box.
* Fix tools_folder relative imports with stable namespace by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/513: Tools loaded from `tools_folder` now support relative imports reliably.

## Tests
* Stabilize tests: standardize models to GPT-5 mini + harden messaging/streaming tests by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/514: Updated test models and added more stable streaming, send_message, and vector-store assertions.

## Refactors & Chores
* cleanup: drop deprecated v0/v1 APIs and align docs/tests by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/512: Cleaned out deprecated surfaces and aligned docs/examples/tests to v1.x-only usage.

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