v1.7.0 — Cache Me If You Can

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.

• 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 #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 #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 #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 #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 #499: Simplified SendMessage schema by removing the redundant my_primary_instructions field.
• chore: bump openai-agents to 0.6.4 by @bonk1t in #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 #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 #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 #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 #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 #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 #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 #512: Cleaned out deprecated surfaces and aligned docs/examples/tests to v1.x-only usage.

Full Changelog: v1.6.0...v1.7.0