v1.4.0

VRSEN/agency-swarmv1.4.0Nov 12, 2025by nicko-ai

AI Summary

Feature release introducing built-in tools (IPythonInterpreter, PersistentShellTool, LoadFileAttachment) and major terminal demo UX improvements.

Key Highlights

  • New `import-tool` CLI command to list/copy built-ins into a project
  • Added IPythonInterpreter, PersistentShellTool, and LoadFileAttachment
  • Terminal demo now has keyboard-navigable dropdowns and autocomplete
  • Added Widget Integration documentation

New Features

  • Built-in tools (IPythonInterpreter, PersistentShellTool, LoadFileAttachment)
  • CLI import-tool command
  • Terminal demo UX improvements

Full Release Notes

## 🚀 Features

### Built-in Tools & CLI Import
Introduces built-in tools — **IPythonInterpreter**, **PersistentShellTool**, and **LoadFileAttachment** — along with a new `import-tool` CLI command.  
Includes improvements to file handling, agent template generation, and documentation/navigation for built-ins.

- Add built-in tools and CLI import command ([#442](https://github.com/VRSEN/agency-swarm/pull/442)) by @ArtemShatokhin  
  - CLI: `import-tool` command to list/copy built-ins into a project
  - Docs: new [Built-in Tools](https://agency-swarm.ai/core-framework/tools/built-in-tools) page with cross-links

### Terminal Demo Improvements
Major UX upgrade for the terminal demo (Agency.terminal_demo()) with interactive dropdowns and autocomplete.

- Terminal demo improvements ([#432](https://github.com/VRSEN/agency-swarm/pull/432)) by @ArtemShatokhin  
  - Added keyboard-navigable dropdown for `/` commands and `@agent` mentions  
  - Improved agent parsing, error handling, and handoff logic  
  - Added autocomplete, new key bindings (Tab, Esc, Enter), and refined styling  
  - Updated integration tests for all new behaviors

---

## 🛠 Fixes and Improvements
- Improve IPython tool isolation ([#448](https://github.com/VRSEN/agency-swarm/pull/448)) by @ArtemShatokhin  
- Add working directory as a separate IPython tool input ([#452](https://github.com/VRSEN/agency-swarm/pull/452)) by @ArtemShatokhin  
- Additional improvements: improve agent file handling by skipping subfolders, detecting empty directories, and optimizing vector store creation.

---

## 📘 Docs
- Added [**Widget Integration** documentation](https://agency-swarm.ai/platform/integrations/widget) ([#427](https://github.com/VRSEN/agency-swarm/pull/427)) by @MykhailoShchuka  

---

## 🧑‍💻 New Contributors
- @MykhailoShchuka made their first contribution in [#427](https://github.com/VRSEN/agency-swarm/pull/427)

---

**Full Changelog:** [v1.3.1 → v1.4.0](https://github.com/VRSEN/agency-swarm/compare/v1.3.1...v1.4.0)