v1.2.0

VRSEN/agency-swarmv1.2.0Oct 14, 2025by nicko-ai

AI Summary

Introduces FastAPI capability metadata, state isolation per agency, and hardens vector-store sync resilience.

Key Highlights

Per-agent capability metadata (tools, reasoning) served via FastAPI
Runtime and pending guard isolation per agency
Vector-store sync hardening with cleanup, timestamp reconciliation, and ID parsing
Handoff reminder customization moved to Agent.handoff_reminder

New Features

FastAPI support for DRY_RUN env variable to serve metadata without initialization
Handoff reminder system moved to Agent.handoff_reminder
Vector-store file cleanup and timestamp reconciliation for sync jobs
MCP shutdown handling hardening

Full Release Notes

## Features
- FastAPI integration: provide per-agent capability metadata (tools, reasoning, hosted tools) by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/397
- FastAPI integration: support `DRY_RUN` env variable so agent metadata can be served without initialization / API keys by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/398
- handoffs (backwards-compatible): move reminder customization onto `Agent.handoff_reminder`, add a dedicated `examples/handoffs.py`, and update communication-flow docs by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/388 and by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/399

## Improvements & Fixes
- fix: isolate agent runtime state per agency by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/396  
- fix: isolate send_message pending guard per thread manager by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/394  
- fixes: add vector-store file cleanup, timestamp reconciliation, and resilient ID parsing so stale artifacts and OpenAI ID mismatches no longer break sync jobs by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/393 and @bonk1t in https://github.com/VRSEN/agency-swarm/pull/395  
- fix: harden mcp shutdown handling by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/401

## Dependencies
- deps: upgrade the OpenAI Agents SDK from 0.2.9 to 0.3.3 (plus pinned transitive updates) to include streaming fixes and other improvements by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/369

## Docs
- docs: rename "open-source models" to "third-party models", fix GitHub references by @bonk1t in https://github.com/VRSEN/agency-swarm/pull/391  
- docs/examples: expand hybrid communication flow guidance and align tutorials with the new handoff reminder APIs by @ArtemShatokhin in https://github.com/VRSEN/agency-swarm/pull/388  


Full Changelog: https://github.com/VRSEN/agency-swarm/compare/v1.1.0...v1.2.0