Agent SDK Changelog

All notable changes to the Agent SDK are documented here.

0.7.x

v0.7.24 (2026-02-04)

Dependencies: cua-computer: 0.5.12, cua-som: 0.1.3

• Initial release or no path-specific changes found

v0.7.22 (2026-01-28)

Dependencies: cua-computer: 0.5.12, cua-som: 0.1.3

• Bump cua-agent to v0.7.22 by @github-actions[bot]

v0.7.21 (2026-01-26)

Dependencies: cua-computer: 0.5.11, cua-som: 0.1.3

• Bump cua-agent to v0.7.21 by @github-actions[bot]

v0.7.18 (2026-01-22)

Dependencies: cua-computer: 0.5.10, cua-som: 0.1.3

• Bump cua-agent to v0.7.18 by @github-actions[bot]
• fix(agent): accept 'computer_use' as valid function name for Fara model (#865) by @sarinali

v0.7.17 (2026-01-17)

Dependencies: cua-computer: 0.5.7, cua-som: 0.1.3

• Bump cua-agent to v0.7.17 by @github-actions[bot]

v0.7.16 (2026-01-17)

Dependencies: cua-computer: 0.5.7, cua-som: 0.1.3

• Bump cua-agent to v0.7.16 by @github-actions[bot]

v0.7.15 (2026-01-17)

Dependencies: cua-computer: 0.5.7, cua-som: 0.1.3

• Bump cua-agent to v0.7.15 by @github-actions[bot]

v0.7.14 (2026-01-17)

Dependencies: cua-computer: 0.5.6, cua-som: 0.1.3

• Bump cua-agent to v0.7.14 by @github-actions[bot]

v0.7.13 (2026-01-17)

Dependencies: cua-computer: 0.5.6, cua-som: 0.1.3

• Bump cua-agent to v0.7.13 by @github-actions[bot]
• Fix/gradio 6.3 compatibility (#810) by @Weichen Zhang
• fix(agent): create screenshot_dir when trajectory_dir option is specified (#813) by @Harsh Verma
• fix(agent): only yield partial response if not empty (#802) by @Harsh Verma
• fix tool mismatch in uitars agent loop (#640) by @zju-lx

v0.7.12 (2026-01-13)

Dependencies: cua-computer: 0.5.6, cua-som: 0.1.3

• Bump cua-agent to v0.7.12 by @github-actions[bot]
• pass browser tool (#774) by @Sarina Li
• feat(agent): add OpenTelemetry instrumentation callback (#662) by @r33drichards
• Fix Omniparser historical message conversion using per-screenshot mappings (#706) by @Fizza Mukhtar

v0.7.11 (2026-01-12)

Dependencies: cua-computer: 0.5.6, cua-som: 0.1.3

• Bump cua-agent to v0.7.11 by @github-actions[bot]

v0.7.10 (2026-01-12)

Dependencies: cua-computer: 0.5.6, cua-som: 0.1.3

• Bump cua-agent to v0.7.10 by @github-actions[bot]

v0.7.9 (2026-01-12)

Dependencies: cua-computer: 0.5.5, cua-som: 0.1.3

• Bump cua-agent to v0.7.9 by @github-actions[bot]

v0.7.8 (2026-01-12)

Dependencies: cua-computer: 0.5.4, cua-som: 0.1.3

• Bump cua-agent to v0.7.8 by @github-actions[bot]
• Bump cua-agent to v0.7.7 (#781) by @Francesco Bonacci
• Bump cua-agent to v0.7.7 (#780) by @Francesco Bonacci

v0.7.6 (2026-01-12)

Dependencies: cua-computer: 0.5.1, cua-som: 0.1.3

• Bump cua-agent to v0.7.6 by @github-actions[bot]

v0.7.5 (2026-01-12)

Dependencies: cua-computer: 0.5.1, cua-som: 0.1.3

• Bump cua-agent to v0.7.5 by @github-actions[bot]

v0.7.4 (2026-01-12)

Dependencies: cua-computer: 0.5.1, cua-som: 0.1.3

• Bump cua-agent to v0.7.4 by @github-actions[bot]
• refactor(docs): reorganize lume/cua docs and standardize READMEs (#752) by @Francesco Bonacci
• feat(lume,ci): add unattended VM setup and reorganize CI/CD workflows (#729) by @Francesco Bonacci
• Fix linting in cua-bench module (#727) by @ddupont
• Raise clear error when using Ollama models with ComputerAgent image inputs (#711) by @Fizza Mukhtar
• update dead links due to docs update by @Sarina Li
• add vm name to start/end by @Sarina Li

0.4.x

v0.4.53 (2025-11-19)

cua-agent is a general Computer-Use framework with liteLLM integration for running agentic workflows on macOS, Windows, and Linux sandboxes. It provides a unified interface for computer-use agents across multiple LLM providers with advanced callback system for extensibility.

• Jagjeevan's Fix + Merged Main for 4o Model Fix by @sarinali in https://github.com/trycua/cua/pull/522
• fix: Added GPT-4o compatibility for screenshot actions with text parameter by @JagjeevanAK in https://github.com/trycua/cua/pull/422
• Add test infrastructure with CI/CD #478 by @AceAtDev in https://github.com/trycua/cua/pull/491
• Fix/omniparser predict refactor by @sarinali in https://github.com/trycua/cua/pull/529
• Make VS Code Python interpreter path cross-platform by @skools-here in https://github.com/trycua/cua/pull/520
• Fix: sanitize shell in subprocess calls by @AdityaBavadekar in https://github.com/trycua/cua/pull/519
• [Agent] Add support for overriding api_base and api_url kwargs by @ddupont808 in https://github.com/trycua/cua/pull/504
• Update model list and schedule daily test for agent testing by @YeIIcw in https://github.com/trycua/cua/pull/540
• Add Claude Desktop Extension by @YeIIcw in https://github.com/trycua/cua/pull/521
• [AGENT] - New Model Gelato-30B-A3B added by @tamoghnokandar in https://github.com/trycua/cua/pull/558
• [AGENT] - New model UI-Ins added by @tamoghnokandar in https://github.com/trycua/cua/pull/549
• Add "cua/" LLM provider by @ddupont808 in https://github.com/trycua/cua/pull/506
• Add Local Desktop Mode for MCP Server with updated docs by @YeIIcw in https://github.com/trycua/cua/pull/493
• Fix: Enable custom function tools with Anthropic models by @LucaStngn in https://github.com/trycua/cua/pull/548
• Fix cua adapter, add UI-TARS-2 model by @ddupont808 in https://github.com/trycua/cua/pull/592
• Fix cua adapter for anthropic models by @ddupont808 in https://github.com/trycua/cua/pull/601
• Remove hud-python from cua-agent[all] extra by @f-trycua in https://github.com/trycua/cua/pull/603
• Add automatic CUA_API_KEY environment variable support by @f-trycua in https://github.com/trycua/cua/pull/604

New Contributors

• @AceAtDev made their first contribution in https://github.com/trycua/cua/pull/491
• @skools-here made their first contribution in https://github.com/trycua/cua/pull/520
• @tamoghnokandar made their first contribution in https://github.com/trycua/cua/pull/545
• @dinmukhamedm made their first contribution in https://github.com/trycua/cua/pull/404
• @LucaStngn made their first contribution in https://github.com/trycua/cua/pull/548

v0.4.35 (2025-10-22)

Dependencies: cua-computer: latest, cua-som: latest

• Standardize Python version 3.12 across all packages by @AdityaBavadekar in https://github.com/trycua/cua/pull/500
• Add support for all QwenVL models by @ddupont808 in https://github.com/trycua/cua/pull/501

v0.4.34 (2025-10-17)

Dependencies: cua-computer: latest, cua-som: latest

• Fix torch dependency in moondream3 loop by @ddupont808 in https://github.com/trycua/cua/pull/482

New Contributors

• @sarinali made their first contribution in https://github.com/trycua/cua/pull/477

v0.4.33 (2025-10-15)

Dependencies: cua-computer: latest, cua-som: latest

• Stream MCP responses instead of buffering by @YeIIcw in https://github.com/trycua/cua/pull/427
• Add support for Gemini CUA model by @ddupont808 in https://github.com/trycua/cua/pull/472
• Add support for Claude Haiku 4.5 by @ddupont808 in https://github.com/trycua/cua/pull/474
• Add bump2version configuration for all Python packages by @r33drichards in https://github.com/trycua/cua/pull/463

v0.4.32 (2025-09-25)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.31 (2025-09-13)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.30 (2025-09-12)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.29 (2025-09-12)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.28 (2025-09-12)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.27 (2025-09-10)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.26 (2025-09-10)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.25 (2025-09-05)

Dependencies: cua-computer: latest, cua-som: latest

• Change HUD dataset name from OSWorld-Verified-XLang to OSWorld-Verified by @jamesmurdza in https://github.com/trycua/cua/pull/392
• Fixed error when running agent with multimodal user inputs in the anthropic loop by @ddupont808 in https://github.com/trycua/cua/pull/394
• Reference documentation batch by @onel in https://github.com/trycua/cua/pull/390

v0.4.24 (2025-08-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.23 (2025-08-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.22 (2025-08-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.21 (2025-08-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.20 (2025-08-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.19 (2025-08-28)

Dependencies: cua-computer: latest, cua-som: latest

• Added screenshot_dir parameter
• Bugfix: Lazy loading of MLX by @ddupont808 in https://github.com/trycua/cua/pull/373

v0.4.18 (2025-08-28)

Dependencies: cua-computer: latest, cua-som: latest

• Fix example code and notebooks by @jamesmurdza in https://github.com/trycua/cua/pull/364
• Added a readme file to the notebooks folder by @onel in https://github.com/trycua/cua/pull/361
• Restrict root project to Python versions below 3.14 by @jamesmurdza in https://github.com/trycua/cua/pull/363
• Restored mlx/ adapter by @ddupont808 in https://github.com/trycua/cua/pull/366
• Upgrade HUD SDK to 0.4.12 by @ddupont808 in https://github.com/trycua/cua/pull/371
• Added callback to normalize common tool call hallucinations seen during evals

New Contributors

• @onel made their first contribution in https://github.com/trycua/cua/pull/361

v0.4.17 (2025-08-19)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.16 (2025-08-19)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.15 (2025-08-19)

Dependencies: cua-computer: latest, cua-som: latest

• Pin OpenAI version to work around BerriAI/litellm#13711 by @jamesmurdza in https://github.com/trycua/cua/pull/356
• Upgrade Claude 3.5 snapshot in web app, examples and docs by @jamesmurdza in https://github.com/trycua/cua/pull/359
• Update agent/computer SDKs to match changes in telemetry SDK by @jamesmurdza in https://github.com/trycua/cua/pull/355

v0.4.14 (2025-08-18)

Dependencies: cua-computer: latest, cua-som: latest

• Upgrade Agent SDK to require Python 3.12 by @jamesmurdza in https://github.com/trycua/cua/pull/342
• Fix UI-TARS predict_click always returning None by @ddupont808 in https://github.com/trycua/cua/pull/350

v0.4.13 (2025-08-14)

Dependencies: cua-computer: latest, cua-som: latest

• [Agent] Add HUD evals, OSWorld-verified docs, and support for custom computers by @ddupont808 in https://github.com/trycua/cua/pull/334

v0.4.12 (2025-08-12)

Dependencies: cua-computer: latest, cua-som: latest

• [Agent] Implement left_mouse_down, left_mouse_up, and tool errors by @ddupont808 in https://github.com/trycua/cua/pull/333
• [Agent] Add GLM-4.5V support by @ddupont808 in https://github.com/trycua/cua/pull/337

v0.4.11 (2025-08-07)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.10 (2025-08-06)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.9 (2025-08-06)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.8 (2025-08-05)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.7 (2025-08-05)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.6 (2025-08-04)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.5 (2025-07-29)

Dependencies: cua-computer: latest, cua-som: latest

v0.4.4 (2025-07-29)

Bugfixes caused by mouse_move having the wrong name

v0.4.3 (2025-07-29)

Bugfixes caused by mouse_move having the wrong name

v0.4.2 (2025-07-29)

• [Agent] Fix Anthropic unexpected tool_use_id by @ddupont808 in https://github.com/trycua/cua/pull/325

v0.4.1 (2025-07-28)

Updated to use latest cua-core

v0.4.0 (2025-07-28)

This update refactored the Agent SDK to make it easier to implement new features and support the release of new agent models/loops.

Changelog:

• Reworked agent loop, now all agent providers share a loop (Generate, Execute, Repeat), with the only difference between loops being the implementation of the Generate function
• Replaced LLM clients with LiteLLM, now all agent providers support any provider supported by LiteLLM
• Added 2 custom LiteLLM providers for local model inference on CUDA and MLX devices: huggingface-local/, mlx/
• Reworked callback system to have hooks at every step of the lifecycle
• Converted logging, trajectory saving, image retention into callbacks
• Added new callbacks - PII Anonymization (still a W.I.P) & budget management
• Anthropic providers - Added support for explicit prompt caching
• OpenAI providers - Added support for zero data retention
• Added Agent CLI for quick testing: python -m agent.cli <model name>

Breaking Changes

• Initialization:
  • ComputerAgent (v0.4.x) uses model as a string (e.g. "anthropic/claude-3-5-sonnet-20241022") instead of LLM and AgentLoop objects.
  • tools is a list (can include multiple computers and decorated functions).
  • callbacks are now first-class for extensibility (image retention, budget, trajectory, logging, etc).
• No explicit loop parameter:
  • Loop is inferred from the model string (e.g. anthropic/, openai/, omniparser+, ui-tars).
• No explicit computer parameter:
  • Computers are added to tools list.

Install

Before merge:
pip install --pre "cua-agent[all]==0.4.0b4"

After merge:
pip install "cua-agent[all]"

or install specific providers
pip install "cua-agent[openai]"        # OpenAI computer-use-preview support
pip install "cua-agent[anthropic]"     # Anthropic Claude support
pip install "cua-agent[omni]"          # Omniparser + any LLM support
pip install "cua-agent[uitars]"        # UI-TARS
pip install "cua-agent[uitars-mlx]"    # UI-TARS + MLX support
pip install "cua-agent[uitars-hf]"     # UI-TARS + Huggingface support
pip install "cua-agent[ui]"            # Gradio UI support

Supported Models

Anthropic Claude (Computer Use API)

model="anthropic/claude-3-5-sonnet-20241022"
model="anthropic/claude-3-5-sonnet-20240620"
model="anthropic/claude-opus-4-20250514"
model="anthropic/claude-sonnet-4-20250514"

OpenAI Computer Use Preview

model="openai/computer-use-preview"

UI-TARS (Local or Huggingface Inference)

model="huggingface-local/ByteDance-Seed/UI-TARS-1.5-7B"
model="ollama_chat/0000/ui-tars-1.5-7b"

Omniparser + Any LLM

model="omniparser+ollama_chat/mistral-small3.2"
model="omniparser+vertex_ai/gemini-pro"
model="omniparser+anthropic/claude-3-5-sonnet-20241022"
model="omniparser+openai/gpt-4o"

0.3.x

v0.3.2 (2025-07-15)

Dependencies: cua-computer: latest, cua-som: latest

v0.3.1 (2025-07-01)

Dependencies: cua-computer: latest, cua-som: latest

0.2.x

v0.2.15 (2025-06-25)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.14 (2025-06-24)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.13 (2025-06-24)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.12 (2025-06-20)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.11 (2025-06-18)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.10 (2025-06-10)

Dependencies: cua-computer: latest, cua-som: latest

• Fixed image retention bug by @ddupont808 in https://github.com/trycua/cua/pull/282
• Removed torch requirement from cua-agent/core and cua-agent/anthropic by @ddupont808 in https://github.com/trycua/cua/pull/285

v0.2.9 (2025-06-05)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.7 (2025-06-05)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.6 (2025-05-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.5 (2025-05-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.4 (2025-05-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.3 (2025-05-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.2 (2025-05-28)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.1 (2025-05-16)

Dependencies: cua-computer: latest, cua-som: latest

v0.2.0 (2025-05-14)

Dependencies: cua-computer: latest, cua-som: latest

0.1.x

v0.1.44 (2025-05-13)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.43 (2025-05-12)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.42 (2025-05-11)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.41 (2025-05-11)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.40 (2025-05-11)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.39 (2025-05-11)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.38 (2025-05-11)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.37 (2025-05-10)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.35 (2025-05-10)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.34 (2025-05-10)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.33 (2025-05-10)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.32 (2025-05-02)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.31 (2025-04-29)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.30 (2025-04-24)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.29 (2025-04-22)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.28 (2025-04-15)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.27 (2025-04-15)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.26 (2025-04-14)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.25 (2025-04-06)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.24 (2025-04-06)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.23 (2025-04-06)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.22 (2025-04-04)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.21 (2025-04-02)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.20 (2025-03-30)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.19 (2025-03-30)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.18 (2025-03-30)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.17 (2025-03-24)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.6 (2025-03-19)

Dependencies: cua-computer: latest, cua-som: latest

v0.1.5 (2025-03-17)

Dependencies: cua-computer: latest, cua-som: latest