v0.17.2

What's Changed

• fix/agent identity by @adi-wan-askui in #148
• fix: typing after start of controller by starting without overlay by default by @adi-wan-askui in #147

🐛 Bug Fixes & Improvements

• Controller: Fixed typing by disabling overlay by default ⟶ Focus not stolen by overlay (window) before typing
• Chat: Fixed agent identity configuration (asking agent Who are you?)

Full Changelog: v0.17.1...v0.17.2

v0.17.1

What's Changed

• add agent_os connect by @mlikasam-askui in #146

What's Changed

🐛 Bug Fixes & Improvements

• Android: Connect to ADB before using it ⟶ Fixes Android tool use

Full Changelog: v0.17.0...v0.17.1

v0.17.0

What's Changed

• feat: message truncation by @adi-wan-askui in #145

🚀 Features

• Message Truncation & Prompt Caching: Added intelligent message truncation and prompt caching capabilities (about 5 minutes) to optimize token usage and improve speed ⟶ Chat history is now automatically cached and truncated when approaching token limits so that you can have longer and faster conversations

🐛 Fixes

• Computer Tool (Regression): Fixed computer tool usage inconsistency between chat (MCP) and agent (ACT) implementations ⟶ Computer Agent should be able again to use press and release keyboard keys (including shortcuts)

🚨 Breaking Changes

• Truncation may change how agents (or assistants) respond to you
• Removed settings ActSettings.only_n_most_recent_images
  and ActSettings.image_truncation_threshold as we
  now use more sophisticated truncation and caching strategies (less configurable for now)

Full Changelog: v0.16.0...v0.17.0

v0.16.0

What's Changed

• Cl 1661 release 2025 09 rpa crud workflows by @danyalxahid-askui in #137
• fix android drag and drop by @mlikasam-askui in #143
• fix(chat)!: hold mcp client sessions by @adi-wan-askui in #140
• Refactor/replace hard coded agents with dynamic assistants by @adi-wan-askui in #142
• fix(tools): computer tool by @adi-wan-askui in #144

🚀 Features

• Dynamic Assistants: Replaced hard-coded agents with dynamic agents ("assistants") using hard-coded tools and tools from MCP servers for improved flexibility ⟶ Custom agent ("assistant") can be created through API
• Workflows API: CRUD operations for basic RPA workflow management
• Orchestrator Agent: Introduced orchestrator agent and fixed testing agent functionality

🐛 Bug Fixes

• Computer Tool: Fixed computer tool usage inconsistency between chat (MCP) and agent (ACT) implementations
• Android Drag & Drop: Resolved issues with Android drag and drop functionality
• MCP Session Management: MCP client session handling with persistent connections and lazy initialization ⟶ MCP sessions are now held indefinitely after initialization and scoped to a workspace

🚨 Breaking Changes

• Node.js: Usage of new chat requires now Node.js + npm (npx) to be installed as we use Playwrights official MCP under the hood (see https://nodejs.org/en/download/)
• Chat API: Existing (global) agents ("assistants") are deleted

Full Changelog: v0.15.1...v0.16.0

v0.15.1

What's Changed

• docs: add comprehensive file format support documentation for AskUI V… by @danyalxahid-askui in #136
• feat: switch from hard-coded agent to generic agent built from Assistant - VisionAgent (Computer Agent) by @adi-wan-askui in #135
• feat(runner, inference_api): integrate ModelName for dynamic model … by @danyalxahid-askui in #138
• fix(chat): set env from headers (ASKUI_WORKSPACE, AUTHORIZATION) by @adi-wan-askui in #139

🚀 Features

• File Support: Added Detailed Docs for using different types of Files
• MCP Chat Api Support: Chat api exported as an MCP

🐛 Bug Fixes

• Chat Default model: Fixed issue where chat run was not using askui hostel model
• Chat dependency on env variables: Fixed chat dependency on env variables to be defined

Full Changelog: v0.15.0...v0.15.1

v0.15.0

What's Changed

• fix(chat): run expiring after 10 minutes by @adi-wan-askui in #134
• fix(chat): deleting empty threads by @adi-wan-askui in #133
• refactor: extract system prompts for reuse in chat by @adi-wan-askui in #132
• feat(chat)!: differentiate default and custom (workspace scoped) assistants and mcp configs by @adi-wan-askui in #131

🚀 Features

• Chat API Enhancement: Differentiate between default and custom (workspace scoped) assistants and MCP configurations
• System Prompts: Extracted system prompts for better reusability in chat functionality

🐛 Bug Fixes

• Chat: Fixed issue where chat runs were expiring after 10 minutes
• Thread Management: Fixed deletion of empty threads in chat

🚨 Breaking Changes

• MCP Configurations: Existing MCP configs won't be accessible anymore through API but only through the file system
• Workspace ID: Workspace ID expected to be a UUID4 - resources saved with non-UUID4 askui-workspace header won't be accessible anymore through API but only through the file system (AskUI Hub already uses this format so if you never used the API directly, there is nothing to do)
• Custom Agents: Existing custom agents can only be modified/deleted through file system but not API

Full Changelog: v0.14.2...v0.15.0

v0.14.2

What's Changed

• feat: use a custom agent by @adi-wan-askui in #125
• feat(chat): add support for documents (pdf, excel, word) in chat by @danyalxahid-askui in #126

🚀 Features

• Custom Agents: CRUD operations for custom agents with configurable system prompts and tools (need to be provided via MCP)
• Document Support in Chat: Enhanced chat functionality with support for PDF, Excel, and Word documents

🐛 Bug Fixes

• Chat: Messages incorrectly ordered before sent to LLM leading to all kinds of errors, e.g., tool result block not finding tool call block ("Each tool_result block must have a corresponding tool_use block in the previous message.")

Full Changelog: v0.14.1...v0.14.2

v0.14.1

What's Changed

• Support devices with empty display name by @mlikasam-askui in #129

Full Changelog: v0.14.0...v0.14.1

v0.14.0

What's Changed

• Add controller args support by @mlikasam-askui in #127
• chore: remove unused askui hub/workspaces api client by @adi-wan-askui in #128

🚀 Features

• Controller Arguments Support: Enhanced controller functionality with configurable arguments support, providing better flexibility and control over AskUI Controller, e.g., showing/hiding overlay

🚨 Breaking Changes

• AskUI Hub/Workspaces API Removal: Completely removed the unused AskUI Hub and Workspaces API client (~25k lines of code) that led to problems with long paths on Windows
  • Removed AskUIHub class and all workspace-related APIs
  • Removed hub property from AgentToolbox class in src/askui/tools/toolbox.py:33
  • Removed all AskUI workspaces exceptions from src/askui/tools/askui/exceptions.py

Full Changelog: v0.13.0...v0.14.0

v0.13.0

What's Changed

• feat(excel): add support for Excel file processing in VisionAgent by @danyalxahid-askui in #121
• feat: mcp tool support by @adi-wan-askui in #122
• Fix/persistence in chat api by @adi-wan-askui in #123
• feat/create thread and run endpoint by @adi-wan-askui in #124

🚀 Features

• Office Document Support: Excel and Word: Pass .xlsx, .xls, .docx, .doc files to <Agent>.get() as string (path) or pathlib.Path
• MCP (Model Context Protocol) Tool Support:
  • Pass fastmcp.Client to ToolCollection and ToolCollection to <Agent>.act() to use MCP tools
  • Use MCP config endpoints of Chat API to configure MCP servers to be used by agents within chat (for now, no filtering of servers or tools, unavailable servers are ignored)
• Chat:
  • Start agent run / conversation with single create_thread_and_run endpoint to create a thread (conversation) and execute an agent to continue the thread (conversation)
  • Add Files API for managing files referenced from within chat messages
  • Scope resources to workspaces instead of sharing them across all workspaces (with exception of assistants/agents)

🐛 Bug Fixes

• Chat
  • Consistent encoding of files used for storage of resources (UTF-8)
  • Resource ID generation and ordering of resources when listing them

Other

• Unified input source types: Replaced various type definitions (Img, Excel, Pdf) with standardized InputSource type
• Improved documentation: Extracted documentation from README to dedicated /docs folder
• Chat message storage optimization: Changed from single JSONL file to individual files for better scalability
• Async/await: Switch to async/await under the hood and for creating a run for supporting async-first fastmcp framework and improving performance
• New documentation: Added detailed guides for MCP, extracting data, chat API, and more

🚨 Breaking Changes

• ActModel.act(): The tools parameter is now a ToolCollection instead of a list of Tool
• Chat: You are going to loose all your chats when upgrading to this version as we changed how we store them

Full Changelog: v0.12.1...v0.13.0