Release notes from python-sdk

v0.27.0

2026-03-18T09:55:29Z

v0.27.0

🎉 Overview

v0.27.0 adds a MultiDeviceAgent that can operate android and computer devices simultaneously, improves the SDK structure by introducing default tool lists for the ComputerAgent, and AndroidAgent, and fixes a bug with single-display handling on android.

✨ New Features

Execution Cost in Html Reports by @philipph-askui in #243
Otel tracing @philipph-askui in #249
max_steps parameter to stop the execution after a predefined number of steps by @philipph-askui in #244

🔧 Improvements

format execution time in html reports as hh:mm:ss by @philipph-askui in #247

🐛 Bug Fixes

Full Changelog: v0.26.1...v0.27.0

v0.26.1

2026-03-11T09:45:22Z

What's Changed

calls to the print_to_console_tool are now skipped during cached executions, to save time and tokens by @philipph-askui in #245

Full Changelog: v0.26.0...v0.26.1

v0.26.0

2026-03-10T12:07:47Z

v0.26.0

🎉 Overview

v0.26.0 adds a MultiDeviceAgent that can operate android and computer devices simultaneously, improves the SDK structure by introducing default tool lists for the ComputerAgent, and AndroidAgent, and fixes a bug with single-display handling on android.

✨ New Features

Add MultiDeviceAgent by @philipph-askui in #241

🔧 Improvements

Adds Default tool Lists for Agents by @philipph-askui in #242

🐛 Bug Fixes

refactor(android): single-display handling and SingleAndroidDisplay by @mlikasam-askui in #240

Full Changelog: v0.25.1...v0.26.0

v0.25.1

2026-03-05T15:53:45Z

What's Changed

the value of model_id for vlm_providers can now be set as env variable by @philipph-askui in #239

Full Changelog: v0.25.0...v0.25.1

v0.25.0

2026-03-05T13:03:21Z

v0.25.0

🎉 Overview

v0.25.0 is a major release that introduces the new conversation-based agent architecture with a pluggable speaker system, a complete overhaul of the caching system, and a new callback system for observing and extending agent behavior.

The agent's control loop has been redesigned around the speaker-conversation pattern, where different "speakers" generate messages while the Conversation class handles tool execution and state management. This enables modular execution strategies — the default AgentSpeaker handles LLM interactions, while the new CacheExecutor speaker replays cached trajectories.

🚨 Breaking Changes

Caching Settings Restructured

The CachingSettings model has been restructured with renamed strategies, nested settings objects, and new defaults.

Strategy renames:

Before	After
`"read"`	`"execute"`
`"write"`	`"record"`
`"both"`	`"auto"`
`"no"`	`None`

Settings structure:

# Before (0.24.x)
from askui.models.shared.settings import CachingSettings

CachingSettings(
    strategy="write",
    cache_dir=".cache",
    filename="login_flow.json",
    execute_cached_trajectory_tool_settings=CachedExecutionToolSettings(
        delay_time_between_action=0.5,
    ),
)

# After (0.25.0)
from askui.models.shared.settings import (
    CachingSettings,
    CacheWritingSettings,
    CacheExecutionSettings,
)

CachingSettings(
    strategy="record",
    cache_dir=".askui_cache",  # default changed
    writing_settings=CacheWritingSettings(
        filename="login_flow.json",
    ),
    execution_settings=CacheExecutionSettings(
        delay_time_between_actions=1.0,  # default changed from 0.5
    ),
)

Default changes:

cache_dir default: ".cache" → ".askui_cache"
delay_time_between_actions default: 0.5 → 1.0 seconds (to give UIs time to materialize)
visual_validation_threshold default: changed to 10

`act()` Parameter Renamed

The settings parameter on act() has been renamed to act_settings:

# Before
agent.act("Open settings", settings=ActSettings(...))

# After
agent.act("Open settings", act_settings=ActSettings(...))

`on_message` Callback Removed

The on_message parameter on act() has been removed. Use the new ConversationCallback system instead (see New Features below).

# Before
agent.act("Open settings", on_message=my_callback)

# After — use ConversationCallback
from askui import ComputerAgent, ConversationCallback

class LoggingCallback(ConversationCallback):
    def on_step_end(self, conversation, step_index, result):
        for msg in result.messages_to_add:
            print(msg.model_dump_json())

with ComputerAgent(callbacks=[LoggingCallback()]) as agent:
    agent.act("Open settings")

`CustomAgent` Removed

The internal CustomAgent class has been removed as part of the architecture refactoring.

Default Model Updated to `claude-sonnet-4-6`

The default model for both AnthropicVlmProvider and AskUIVlmProvider has been changed to claude-sonnet-4-6 (previously claude-sonnet-4-5-20251101 / claude-sonnet-4-5-20250929).

`MessageSettings` Type Changes

MessageSettings fields now use provider-agnostic types instead of Anthropic-specific ones:

betas field removed — use provider_options={"betas": [...]} instead
thinking, tool_choice: now ThinkingConfigParam | None / ToolChoiceParam | None (instead of Anthropic Beta* types with Omit)
temperature: now float | None (instead of float | Omit)
New provider_options: dict[str, Any] | None field for provider-specific options

✨ New Features

Conversation-Based Architecture

The agent's control loop has been redesigned around the speaker-conversation pattern. The Conversation class orchestrates the flow, managing speaker switching, tool execution, message history, and truncation strategies. Speakers are pluggable message generators that produce responses without executing tools.

Speaker Handoff System

A new speaker handoff pattern enables dynamic switching between execution strategies. Speakers describe their capabilities in the system prompt, and the LLM can initiate handoffs via a switch_speaker tool. This replaces the hardcoded tool-result checks from previous versions.

Speaker abstract base class with can_handle(), handle_step(), and on_activate() hooks
Speakers registry for managing and looking up speakers
SwitchSpeakerTool automatically added when non-default speakers are registered
Speaker descriptions injected into system prompt for LLM-initiated handoffs

Callback System

A new PyTorch Lightning-style callback system provides hooks into the conversation lifecycle:

from askui import ComputerAgent, ConversationCallback

class TimingCallback(ConversationCallback):
    def on_conversation_start(self, conversation):
        self.start = time.time()
    def on_step_end(self, conversation, step_index, result):
        print(f"Step {step_index}: {result.status}")
    def on_conversation_end(self, conversation):
        print(f"Total: {time.time() - self.start:.2f}s")

with ComputerAgent(callbacks=[TimingCallback()]) as agent:
    agent.act("Open settings")

Available hooks: on_conversation_start, on_conversation_end, on_control_loop_start, on_control_loop_end, on_step_start, on_step_end, on_speaker_switch, on_tool_execution_start, on_tool_execution_end.

Caching V2: CacheManager and CacheExecutor

The caching system has been rebuilt from the ground up:

CacheManager replaces the old CacheWriter with support for cache metadata, validation, parameter handling, and recording
CacheExecutor speaker replays cached trajectories as a dedicated speaker, enabling the agent to verify results after playback and handle non-cacheable tools gracefully
Visual validation during cache replay using perceptual hashing (pHash/aHash) to detect UI state changes
Cache parameters — dynamic values in trajectories can be parameterized and substituted at replay time
Cache metadata — cache files now include metadata (validity, token usage, visual validation config)
Usage statistics for cached executions shown in HTML reports, including original token consumption from when the cache was recorded

CacheWritingSettings and CacheExecutionSettings

New dedicated settings classes for fine-grained control over cache recording and playback:

CacheWritingSettings: filename, parameter_identification_strategy, visual_verification_method, visual_validation_region_size
CacheExecutionSettings: delay_time_between_actions, skip_visual_validation, visual_validation_threshold

Conversation ID

Each conversation execution is now assigned a unique conversation_id (UUID), accessible via conversation.conversation_id.

🔧 Improvements

Speaker Architecture Refinements

Speaker name and description are now validated member variables (non-empty enforced at init)
AgentSpeaker now returns "continue" status when tool calls are present (semantically accurate)
Speaker switch logic extracted into dedicated _switch_speaker_if_needed() method
_handle_result_status renamed to _handle_continue_conversation for clarity

Anthropic Messages API Refactoring

_sanitize_message_for_api refactored into from_message_param and from_content_block functions
ToolUseBlockParam.visual_representation (internal cache field) is now properly excluded when sending to the Anthropic API

Code Quality

Removed unnecessary try/except blocks in AgentSpeaker and CacheExecutor
Added isEnabledFor(logging.DEBUG) guard for costly model_dump() log calls
Tracing span names made consistent with function names
Usage tracking refactored to integrate via callback pattern
Default .askui_cache directory added to .gitignore

HTML Reporter

Truncation of long content (base64 image strings) to prevent report flooding
Cache execution statistics section with original token usage hints
Fixed crash for non-cached executions

🐛 Bug Fixes

Fixed bug where cached executions were reported as success when they failed
Fixed bug in visual validation during cached execution
Fixed duplicate clipping of coordinates in mouse move
Fixed agent occasionally providing coordinates as strings instead of integers
Fixed bug where AgentMessages did not show up in reports
Fixed agent response status not accurately reflecting tool-call state
Fixed telemetry error when AgentSettings could not be converted to dict

📚 Documentation

Updated docs/06_caching.md with new CachingSettings structure, renamed strategies, and corrected defaults
Updated docs/11_callbacks.md with new callback system documentation
Fixed outdated references across all docs:
- act() parameter settings → act_settings
- on_message callback removed from MCP example
- Typo AntrhopicImageQAProvider → AnthropicImageQAProvider
- vlm_provider=GoogleImageQAProvider → image_qa_provider=GoogleImageQAProvider
- Broken link to non-existent 11_file_support.md fixed
- _on_speaker_switch → on_speaker_switch in callback hooks table

📈 Statistics

73 files changed
5,136 additions
1,500 deletions

Dependencies

opentelemetry-sdk made a default dependency (previously optional)
OpenTelemetry instrumentors imported safely with fallback

Full Changelog: v0.24.1...v0.25.0

v0.24.1

2026-03-03T16:14:45Z

fixes a bug where AgentMessages did not show up in reports anymore](7514591)

Full Changelog: v0.24.0...v0.24.1

v0.24.0

2026-03-03T10:30:37Z

v0.24.0

🎉 Overview

v0.24.0 is a major architectural release that fundamentally refactors how custom models can be integrated into the AskUI SDK. The centerpiece is the new Bring-Your-Own-Model-Provider system: instead of configuring models via string identifiers and using a complicated ModelRouter abstraction, you can now simply plug typed provider instances directly into AgentSettings. Three clean interfaces, VlmProvider, ImageQAProvider, and DetectionProvider, make it straightforward to swap in your own model backends for acting, querying, and locating UI elements. Built-in providers for Anthropic and Google are included alongside the AskUI defaults.

🚨 Breaking Changes

Model Provider Overhaul: We removed the ModelRouter and ModelRegistry and replaced them with a new model_providers architecture. You can now bring your own model providers through three typed interfaces: VlmProvider (for act), ImageQAProvider (for get), and DetectionProvider (for locate). Built-in providers include AnthropicVlmProvider, GoogleImageQAProvider, AskUIVlmProvider, and more. Please see the new Bring Your Own Model Provider docs for detailed instructions.

Migration: Replace model/models constructor parameters with the new settings: AgentSettings parameter:
```
# Before
agent = VisionAgent(model="claude-sonnet-4-20250514")

# After
from askui import ComputerAgent, AgentSettings
from askui.model_providers import AnthropicVlmProvider

agent = ComputerAgent(settings=AgentSettings(
    vlm_provider=AnthropicVlmProvider(model_id="claude-sonnet-4-20250514"),
))
```
VisionAgent renamed to ComputerAgent: The main agent class is now ComputerAgent. VisionAgent still works but emits a DeprecationWarning. Similarly, AndroidVisionAgent is now AndroidAgent.
click()/mouse_move() model parameter replaced: The model parameter on click(), mouse_move(), and locate() has been replaced by locate_settings: LocateSettings for controlling resolution and other locate options.
betas parameter removed from MessageSettings: The Anthropic-specific betas parameter was replaced with a generic provider_options: dict[str, Any] field. To pass betas, use provider_options={"betas": [...]}.
Chat API removed: The Chat API (src/askui/chat/) has been removed from the package along with its dependencies (sqlalchemy, alembic, fastapi, uvicorn, apscheduler, etc.).
pynput AgentOs backend removed: The PynputAgentOs implementation and the askui[pynput] optional dependency group have been removed. Use the default AskUiControllerClient (gRPC) backend instead.
UITars model removed: The UITars model integration (src/askui/models/ui_tars_ep/) has been removed.
OpenAI integration removed: The OpenAI-compatible model provider (src/askui/models/openai/) has been removed. Use the new provider interfaces for custom model integrations.
ModelComposition and ModelDefinition removed: These classes have been replaced by the new provider system.

✨ New Features

AgentSettings for centralized configuration: A new AgentSettings class provides a clean, typed configuration surface for agents with three provider slots: vlm_provider, image_qa_provider, and detection_provider — each with sensible AskUI defaults.
Bring-Your-Own-Model-Provider: Three abstract provider interfaces (VlmProvider, ImageQAProvider, DetectionProvider) allow users to plug in their own models. Built-in implementations:
- AskUIVlmProvider, AskUIImageQAProvider, AskUIDetectionProvider (defaults)
- AnthropicVlmProvider, AnthropicImageQAProvider (direct Anthropic API)
- GoogleImageQAProvider (direct Google Gemini API)
mouse_movement accepts a duration parameter to control mouse movement speed (in milliseconds, default: 500ms) by @philipph-askui in #233
Time and wait tools added to universal tool store by @mlikasam-askui in #234:
- GetCurrentTimeTool — returns current date/time for time-aware agent decisions
- WaitTool — pauses execution for a specified duration
- WaitWithProgressTool — wait with a visual progress bar
- WaitUntilConditionTool — polls a condition with configurable interval and timeout
LocateSettings and GetSettings exposed in public API: Users can now control per-call locate/get behavior including resolution, max_tokens, temperature, and system_prompt.
FallbackLocateModel and FallbackGetModel: New utility classes that try multiple models in sequence until one succeeds, replacing the old ModelComposition pattern.
get and locate tools in act loop: The LLM can now use get and locate as tools during act() calls (only when an AgentOs is available).

🐛 Bug Fixes

Fixed agent crash without AgentOs: get and locate tools are now only added to the act loop when agent_os is set. Agents used without an AgentOs (e.g., pure LLM pipelines) no longer crash on act(). by @philipph-askui in #237
Fixed OpenTelemetry import errors: opentelemetry-sdk is now a default dependency. Instrumentor imports (FastAPIInstrumentor, HTTPXClientInstrumentor, etc.) are safely guarded with try/except so installing without [otel] extras no longer causes import failures. by @philipph-askui in #238
Fixed typechecking issue in not_given.py — added @final decorator to resolve mypy ambiguity.
Fixed Display default value for name parameter in AgentOS (was raising an error when executing from cache).

📚 Documentation

Complete restructuring of docs (00_overview.md through 10_extracting_data.md)
Removed outdated docs for chat API, MCP, and direct tool use
New Bring Your Own Model Provider guide
Updated reporting docs to distinguish between execution reports and test reports
Updated README to reflect new ComputerAgent class name, corrected Python version requirement (>=3.10, <3.14), and fixed broken links

Dependencies

Removed: openai, fastapi, uvicorn, sqlalchemy, alembic, apscheduler, pynput, mss, structlog, asgi-correlation-id, starlette-context, anyio, bson, aiofiles

Added to core: opentelemetry-sdk>=1.38.0 (promoted from optional chat extras)

Optional extras changed:

askui[chat] — removed
askui[pynput] — removed
askui[otel] — now contains only the instrumentor packages (the base SDK is always available)
askui[all] — now includes android, bedrock, tracing, vertex, web

📝 Full Changelog: v0.23.1...v0.24.0

v0.23.1

2026-02-12T12:32:15Z

Release Notes - v0.23.1

🎉 Overview

This release adds the new LoadImageTool, improves Tool Store tools with flexible paths and encodings, introduces unique instance identifiers for tools, renames the project to AskUI Python SDK, and includes refactoring and documentation fixes. With 44 files changed, 353 additions, and 271 deletions, this is a focused update building on the v0.23.0 foundation.

✨ New Features

LoadImageTool

New universal tool for loading images from the filesystem:

Location: askui.tools.store.universal.LoadImageTool
Loads images from a configurable base directory for analysis, comparison, or visual inspection
Supports common formats (PNG, JPEG etc.)
Use cases: analyzing screenshots, comparing visual elements, verifying image content, providing visual context during execution

Use with agent.act() or via act_tools on the agent constructor.

Unique Tool Instance Identifiers

Tools now get unique instance identifiers so that multiple instances of the same tool (e.g. different base_dir) can be used together without name collisions. Tool names are derived from base name, optional tags, and a unique ID, and are sanitized and truncated to 64 characters for model compatibility.

🔧 Improvements

Tool Store – File Tools Flexibility

ListFilesTool, ReadFromFileTool, WriteToFileTool: base_dir now accepts str | Path (previously str only). Paths are normalized to absolute for consistent descriptions and behavior.
ReadFromFileTool: New optional encodings parameter (default: ["utf-8", "latin-1"]) to try multiple encodings when reading text files. Improves handling of files that are not UTF-8.
WriteToFileTool: Base directory is no longer created in __init__; creation happens on write, aligning behavior with other file tools.

AskUI Controller Refactoring

Stub checks in AskUiControllerClient are centralized in a _get_stub() helper, removing repeated assert blocks and clarifying error messages (e.g. "Call connect() first").

Documentation and Branding

Project and docs renamed from "AskUI Vision Agent" to AskUI Python SDK (README, docs, and HTML report title).
Fixed Custom Models link in README to point to docs/using-models.md#using-custom-models instead of docs/custom-models.md.
Doc and README references updated for consistency.

🐛 Bug Fixes

Fixed stub initialization error message in AskUI controller ("Connect" → "connect()").
Improved file reading robustness via configurable encodings in ReadFromFileTool (avoids UnicodeDecodeError for non-UTF-8 files when an alternative encoding is suitable).

📚 Documentation

README and docs updated for AskUI Python SDK naming and correct Custom Models link.
LoadImageTool documented with examples in its docstring and exported from askui.tools.store.universal.

📊 Statistics

44 files changed
353 lines added
271 lines removed
Net change: +82 lines

🚀 New Tools

Using LoadImageTool

from askui import VisionAgent
from askui.tools.store.universal import LoadImageTool

with VisionAgent(act_tools=[LoadImageTool(base_dir="./images")]) as agent:
    agent.act("Describe the logo image called './images/logo.png'")

Or per-act:

with VisionAgent() as agent:
    agent.act(
        "Describe the logo image called './images/logo.png'",
        tools=[LoadImageTool(base_dir="./images")]
    )

📝 Full Changelog

For a complete list of changes, see the git log.

Upgrade: pip install --upgrade askui

Documentation: docs.askui.com

v0.23.0

2026-01-22T10:26:29Z

Release Notes - v0.23.0

🎉 Overview

This release introduces a major overhaul of the prompting system, a new Tool Store for extending agent capabilities, automatic AgentOS injection, and numerous improvements and bug fixes. With 106 files changed, 5,972 additions, and 1,767 deletions, this is one of the most significant updates to the Vision Agent.

✨ New Features

Advanced Prompting System

A completely redesigned prompting paradigm with a structured 5-fold (plus optional 6th) system prompt architecture:

System Capabilities: Defines what the agent can do and how it should behave
Device Information: Provides platform-specific context (desktop, mobile, web)
UI Information: Custom information about your specific UI (strongly recommended)
Report Format: Specifies how to format execution results
Cache Use: New optional prompt part that specifies when and how the agent should use cache files
Additional Rules: Optional special handling for edge cases or known issues

The new system provides better structure, flexibility, and control over agent behavior. A comprehensive prompting guide has been added to help you create effective custom prompts.

Breaking Change: System prompts passed as strings will now show a deprecation warning. Use ActSystemPrompt instead.

Tool Store

Introducing a new Tool Store that provides optional, extensible tools organized by category:

Universal Tools (askui.tools.store.universal): Work with any agent type
- ListFilesTool: List files in a directory
- ReadFromFileTool: Read content from files
- WriteToFileTool: Write content to files
- PrintToConsoleTool: Print messages to console during execution
Computer Tools (askui.tools.store.computer): Require ComputerAgentOs
- ComputerSaveScreenshotTool: Save screenshots during execution
- Experimental window management tools:
  - AddWindowAsVirtualDisplayTool
  - ListProcessWindowsTool
  - ListProcessTool
  - SetProcessInFocusTool
  - SetWindowInFocusTool
Android Tools (askui.tools.store.android): Require AndroidAgentOs
- AndroidSaveScreenshotTool: Save screenshots from Android devices

Tools can be passed to agent.act() or to the agent constructor as act_tools for persistent availability.

AgentOS Auto-Injection

Tools that require AgentOS (like computer or Android tools) now automatically receive the appropriate AgentOS instance. This simplifies tool usage and eliminates the need for manual AgentOS management in most cases.

Computer Tools Refactoring

Computer tools have been completely refactored and reorganized:

Tools are now properly modularized in askui.tools.computer
Removed deprecated AskUiComputerBaseTool
Improved separation of concerns and better code organization
New tools added:
- GetSystemInfoTool: Retrieve system information
- GetActiveProcessTool: Get information about the active process
- ConnectTool and DisconnectTool: Manage computer connections in chat

Enhanced AgentOS Capabilities

Updated AgentOS JSON schema with expanded capabilities
New system information retrieval methods
Improved window management capabilities
Better error handling for gRPC invalid argument errors

SSL Verification Control

Added the ability to disable SSL verification for the user identification API via the ASKUI_HTTP_SSL_VERIFICATION environment variable. This is useful for development environments with self-signed certificates.

Note: SSL verification is enabled by default for security.

🔧 Improvements

Chat API Enhancements

Added computer connect/disconnect tools for chat interface
Improved chat history management
Enhanced MCP server integration for computer operations

Agent Improvements

Cleaned up agent and agent_base code
Fixed typechecking bugs
Improved reporter encoding handling
Added more reporter messages for better observability
Enhanced overlay support during e2e controller tests

Prompting Improvements

Refined how system prompts are provided
Introduced cache_use prompt part for better cache control
Improved prompt structure and organization
Better handling of prompt parts

Tool System Improvements

Better tool organization and categorization
Improved tool initialization and lifecycle management
Enhanced tool tagging system
Better support for tools with AgentOS requirements

🐛 Bug Fixes

Fixed act prompts issues
Fixed reporter encoding problems
Fixed tool initialization bugs
Fixed typechecking issues in agent
Fixed linter issues across the codebase
Fixed typos in documentation and code

📚 Documentation

Added comprehensive System Prompts documentation
Updated README with Tool Store examples
Improved code examples and usage patterns

🔄 Code Quality

Extensive code cleanup and refactoring
Improved type hints and type safety
Better code organization and structure
Enhanced test coverage

📊 Statistics

106 files changed
5,972 lines added
1,767 lines removed
Net change: +4,205 lines

⚠️ Breaking Changes

System Prompt Format: System prompts should now use ActSystemPrompt instead of plain strings. Passing strings will show a deprecation warning.
Computer Tools: The AskUiComputerBaseTool has been removed. Use tools from askui.tools.computer or askui.tools.store.computer instead.
Tool Organization: Computer tools have been reorganized. If you were using tools directly from askui.tools.computer, check the new structure.

🚀 Migration Guide

Using the Tool Store

from askui import VisionAgent
from askui.tools.store.universal import PrintToConsoleTool, WriteToFileTool
from askui.tools.store.computer import ComputerSaveScreenshotTool

with VisionAgent(act_tools=[
    PrintToConsoleTool(),
    WriteToFileTool(base_dir="./output"),
    ComputerSaveScreenshotTool(base_dir="./screenshots")
]) as agent:
    agent.act("Take a screenshot and save it")

📝 Full Changelog

For a complete list of changes, see the git log.

Upgrade: pip install --upgrade askui

Documentation: docs.askui.com

v0.22.12

2026-01-07T10:13:13Z

What's Changed

feat: add SBOM generation and release workflow by @mlikasam-askui in #214
Add SBOM generator by @mlikasam-askui in #215
ci: ensure SBOM generation runs after PyPI publish by @mlikasam-askui in #216
refactor: remove functools.cache decorator from create_api_client fun… by @danyalxahid-askui in #218
Cl 1935 scheduling workflows which run on a specific time by @danyalxahid-askui in #217

🚀 New Features

Background Scheduler for Executing Run
Create SBOM

🐛 Bug Fixes

Unauthorized issues with long Running instances

Full Changelog: v0.22.11...v0.22.12

Release notes from python-sdk

v0.27.0

v0.27.0

🎉 Overview

✨ New Features

🔧 Improvements

🐛 Bug Fixes

v0.26.1

What's Changed

v0.26.0

v0.26.0

🎉 Overview

✨ New Features

🔧 Improvements

🐛 Bug Fixes

v0.25.1

What's Changed

v0.25.0

v0.25.0

🎉 Overview

🚨 Breaking Changes

Caching Settings Restructured

act() Parameter Renamed

on_message Callback Removed

CustomAgent Removed

Default Model Updated to claude-sonnet-4-6

MessageSettings Type Changes

✨ New Features

Conversation-Based Architecture

Speaker Handoff System

Callback System

Caching V2: CacheManager and CacheExecutor

CacheWritingSettings and CacheExecutionSettings

Conversation ID

🔧 Improvements

Speaker Architecture Refinements

Anthropic Messages API Refactoring

Code Quality

HTML Reporter

🐛 Bug Fixes

📚 Documentation

📈 Statistics

Dependencies

v0.24.1

v0.24.0

v0.24.0

🎉 Overview

🚨 Breaking Changes

✨ New Features

🐛 Bug Fixes

📚 Documentation

Dependencies

v0.23.1

Release Notes - v0.23.1

🎉 Overview

✨ New Features

LoadImageTool

Unique Tool Instance Identifiers

🔧 Improvements

Tool Store – File Tools Flexibility

AskUI Controller Refactoring

Documentation and Branding

🐛 Bug Fixes

📚 Documentation

📊 Statistics

🚀 New Tools

Using LoadImageTool

📝 Full Changelog

v0.23.0

Release Notes - v0.23.0

🎉 Overview

✨ New Features

Advanced Prompting System

Tool Store

AgentOS Auto-Injection

Computer Tools Refactoring

Enhanced AgentOS Capabilities

SSL Verification Control

🔧 Improvements

Chat API Enhancements

`act()` Parameter Renamed

`on_message` Callback Removed

`CustomAgent` Removed

Default Model Updated to `claude-sonnet-4-6`

`MessageSettings` Type Changes