v1.10.2

jdx/misev1.10.2Jun 25, 2026by nicko-ai

AI Summary

A patch release for Agency Swarm focusing on local model routing, improved hosted tool compatibility, and safer remote file downloads.

Key Highlights

  • Added local Ollama and open-source model support via LiteLLM
  • Improved handling of OpenAI hosted tools on non-Responses backends
  • Safer remote file downloads by rejecting path separators in filenames
  • Split response-history coverage into focused helpers and tests

New Features

  • Local model routing support for Agent Swarm CLI
  • Safe function-compatible replacements for unsupported hosted tools
  • Compatibility preservation for projects using legacy flow-parser

Full Release Notes

Patch release for local and open-source model routing, hosted-tool compatibility on non-OpenAI routes, and safer remote file downloads.

This release is most relevant for FastAPI and Agent Swarm CLI users who route requests through LiteLLM, Ollama, OpenRouter, Chat Completions, or custom OpenAI-compatible gateways.

## What's Changed

### Provider routing and local models

- Add local Ollama and open-source model support through LiteLLM for Agent Swarm CLI request routing in https://github.com/VRSEN/agency-swarm/pull/688.
- Preserve explicit local LiteLLM base URLs, strip only the TUI bridge loopback URL for local model defaults, and avoid incomplete Ollama provider configuration in https://github.com/VRSEN/agency-swarm/pull/689.

### Hosted tools and OpenRouter compatibility

- Handle OpenAI hosted tools safely when a request routes an agency to OpenRouter, LiteLLM, Chat Completions, custom gateways, or other non-Responses backends in https://github.com/VRSEN/agency-swarm/pull/697.
- Replace unsupported hosted tools with same-name unavailable function stubs, preserve compatible same-name local `FunctionTool` replacements, and use the existing IPython-backed Agency Swarm replacement for `code_interpreter` when available in https://github.com/VRSEN/agency-swarm/pull/697.
- Route exact OpenRouter `base_url` overrides through the framework OpenRouter chat wrapper, and normalize OpenRouter `extra_body.reasoning` into typed model settings in https://github.com/VRSEN/agency-swarm/pull/697.

### Compatibility and file handling

- Keep compatibility for projects that still patch `parse_agent_flows` with the legacy two-value return shape, while preserving the current three-value communication-flow contract in https://github.com/VRSEN/agency-swarm/pull/706.
- Reject remote file URL names that contain path separators or Windows drive qualifiers before temporary download paths are created in https://github.com/VRSEN/agency-swarm/pull/705.

### Maintenance

- Split response-history coverage into focused helpers, samples, integration tests, and sanitizer unit tests in https://github.com/VRSEN/agency-swarm/pull/690.
- Update dependencies and lockfile entries for MCP, OpenAI, termcolor, datamodel-code-generator, Ruff, langchain-core, FastAPI, and ipykernel in https://github.com/VRSEN/agency-swarm/pull/692, https://github.com/VRSEN/agency-swarm/pull/693, https://github.com/VRSEN/agency-swarm/pull/694, https://github.com/VRSEN/agency-swarm/pull/695, https://github.com/VRSEN/agency-swarm/pull/696, https://github.com/VRSEN/agency-swarm/pull/699, https://github.com/VRSEN/agency-swarm/pull/700, https://github.com/VRSEN/agency-swarm/pull/701, https://github.com/VRSEN/agency-swarm/pull/702, and https://github.com/VRSEN/agency-swarm/pull/703.
- Bump package metadata to `1.10.2` in https://github.com/VRSEN/agency-swarm/pull/706.

## Compatibility Notes

- This is a patch release. No intentional breaking public API change is included.
- OpenAI Responses routes keep OpenAI hosted tools available. Non-Responses and non-OpenAI routes receive safe function-compatible replacements or unavailable stubs instead of sending unsupported hosted-tool payloads.
- The 1.10.1 flow-parser compatibility behavior is now kept on the main 1.10.x release line.

**Full Changelog**: https://github.com/VRSEN/agency-swarm/compare/v1.10.1...v1.10.2