Starstruk Logo MarkStarstruk

v2.5.8

agno-agi/agnov2.5.8Mar 6, 2026by kausmeows

AI Summary

This release introduces human-readable IDs for Agents and Teams, supports container deployment via environment variables, and adds GitlabTools and GmailTools. It fixes media handling, OpenAI responses, and loop iteration bugs.

Key Highlights

  • Human-readable IDs for Agents and Teams
  • Support for AGENT_OS_HOST and AGENT_OS_PORT environment variables
  • New GitlabTools with read-focused integrations
  • Extended GmailTools with service account auth
  • Loop iterations now forward output from previous iterations

New Features

  • Human-readable IDs
  • GitlabTools
  • GmailTools extensions
  • forward_iteration_output flag for Loop

Full Release Notes

# Changelog

## New Features

- **Human-Readable IDs**: Agents and teams now use human-readable identifiers (e.g., `brave-falcon-7x3k`) instead of `UUIDs`, making debugging and monitoring more intuitive.
- **AgentOS**: `serve()` now supports `AGENT_OS_HOST` and `AGENT_OS_PORT` environment variables as fallbacks, simplifying container deployments.
- **GitlabTools:** Added `GitlabTools` with read-focused GitLab integrations, async support, and cleaner tool configuration.
- **GmailTools:** Extended `GmailTools` with new tools and service account auth.

## Bug Fixes

- **Media in Run Output**: Generated media (images, audio) is now always included in run output, regardless of the `store_media` setting and is rather scrubbed before storing in DB
- **OpenAIResponses**: Fixed handling of mixed `external_execution` and regular tools when using OpenAI Responses API.
- **MySQL**: Added `json_serializer` to MySQL engine creation for proper JSON handling.
- **PostgreSQL**: Removed `session_type` filter from `get_session` to prevent session data loss when session types change.
- **Workflow:** Fixed a bug where `Loop` iterations always received the original input instead of the previous iteration's output. Added a flag `forward_iteration_output` to opt-in to this behaviour.

## What's Changed
* feat: Docker-style human-readable IDs for agents and teams by @ysolanky in https://github.com/agno-agi/agno/pull/6869
* feat: add AGENT_OS_HOST/AGENT_OS_PORT env var fallbacks to serve() by @Mustafa-Esoofally in https://github.com/agno-agi/agno/pull/6857
* fix: remove session_type filter from PostgreSQL get_session to prevent session data loss by @kausmeows in https://github.com/agno-agi/agno/pull/6873
* fix: add json_serializer to MySQL engine creation by @willemcdejongh in https://github.com/agno-agi/agno/pull/6848
* [fix] handle mixed external_execution and regular tools for OpenAI by @hztBUAA in https://github.com/agno-agi/agno/pull/6630
* fix: include generated media in run output regardless of store_media setting by @Br1an67 in https://github.com/agno-agi/agno/pull/6793
* cookbook: add x402scan MCP tools example by @SamOpenClaw in https://github.com/agno-agi/agno/pull/6555
* feat: add GitlabTools with tests and cookbook example by @SalimELMARDI in https://github.com/agno-agi/agno/pull/6721
* feat: extend GmailTools with new tools, service account auth, and agentic cookbooks by @Mustafa-Esoofally in https://github.com/agno-agi/agno/pull/6765
* fix: loop iterations to forward output from previous iteration by @kausmeows in https://github.com/agno-agi/agno/pull/6868
* fix: resolve duplicate operationId warnings in disabled feature router by @kausmeows in https://github.com/agno-agi/agno/pull/6887
* chore: Release v2.5.8 by @kausmeows in https://github.com/agno-agi/agno/pull/6886

## New Contributors
* @SamOpenClaw made their first contribution in https://github.com/agno-agi/agno/pull/6555
* @SalimELMARDI made their first contribution in https://github.com/agno-agi/agno/pull/6721

**Full Changelog**: https://github.com/agno-agi/agno/compare/v2.5.7...v2.5.8