v2.5.6

# Changelog

## New Features:

- **GitHub App Authentication for Knowledge Sources:** Adds support for authenticating with GitHub as a GitHub App (`app_id`, `installation_id`, `private_key`) in addition to personal access tokens, with thread-safe token caching and both sync/async variants.
- **File Upload:** Added `image/heic` and `image/heif` support to file upload endpoints.
- **Approvals:** Added approval status endpoint and admin-gated continue run enforcement.
- **Traces:** Added advanced filtering DSL support in Agent OS

## Improvements:

- **Google Tools**: Restructured Google tools into `agno.tools.google` sub-package (`from agno.tools.google import GmailTools`). Old import paths still work with a backwards compatibility.
- **Team Task Mode:**
    - Enhances `TeamMode.tasks` streaming to provide structured task data for frontend rendering in events like `TeamTaskCreated` and `TeamTaskUpdated`
    - Structured task data in `TaskStateUpdatedEvent`: Added `tasks: List[TaskData]` field containing full task details (id, title, description, status, assignee, dependencies, result) and completion_summary field

## Bug Fixes:

- **OpenAI Responses:**
    - Fixed vector store polling race condition where `file_search` silently returned empty results due to eventual consistency in OpenAI's `vector_stores.files.list`
    API.
    - Added `input_file` support to OpenAIResponses
- **Sentence Transformer Reranker:** Fixed VRAM memory leak in SentenceTransformerReranker caused by CrossEncoder being instantiated on every `_rerank()` call instead of being reused.
- **JSON Schema:** Extended support for `Literal` types in JSON schema generation

## What's Changed
* feat: extend Registry with agents/teams for UI workflow rehydration by @ysolanky in https://github.com/agno-agi/agno/pull/6278
* cookbook: add Gemini 3 progressive guide by @ysolanky in https://github.com/agno-agi/agno/pull/6730
* fix: add support for Literal types in JSON schema generation by @kausmeows in https://github.com/agno-agi/agno/pull/6723
* fix: updated links in README by @kyleaton in https://github.com/agno-agi/agno/pull/6749
* feat: add image/heic and image/heif support to file upload endpoints by @Br1an67 in https://github.com/agno-agi/agno/pull/6791
* feat: add input_file support to OpenAIResponses by @uzaxirr in https://github.com/agno-agi/agno/pull/6806
* [fix] properly release SentenceTransformerReranker models to prevent VRAM leak by @hztBUAA in https://github.com/agno-agi/agno/pull/6638
* feat: add advanced filtering dsl by @kausmeows in https://github.com/agno-agi/agno/pull/6671
* feat: restructure Google tools, add FileTools.search_content, add enable flags by @ashpreetbedi in https://github.com/agno-agi/agno/pull/6833
* feat: add GitHub App authentication support to GitHubConfig by @willemcdejongh in https://github.com/agno-agi/agno/pull/6831
* fix: use Coroutine return types for arun/acontinue_run overloads by @ysolanky in https://github.com/agno-agi/agno/pull/6836
* feat: add approval status endpoint and admin-gated continue run enforcement by @kausmeows in https://github.com/agno-agi/agno/pull/6598
* chore: update team tasks stream by @kausmeows in https://github.com/agno-agi/agno/pull/6718
* fix: return 503 instead of 404 for disabled AgentOS features by @ysolanky in https://github.com/agno-agi/agno/pull/6837
* chore: Release v2.5.6 by @kausmeows in https://github.com/agno-agi/agno/pull/6823

## New Contributors
* @Br1an67 made their first contribution in https://github.com/agno-agi/agno/pull/6791

**Full Changelog**: https://github.com/agno-agi/agno/compare/v2.5.5...v2.5.6