Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

7.8 KB
Raw Blame

Changelog

0.9.1 (2026-10-19)

Bug Fixes

  • post-launch CI follow-ups (#4405) (352507b)
  • lock the cua SDK checkout at 0.3.1 (#4593) (fcb386f)
  • python: cua-sandbox, cua-bench and the playground no longer depend on Fleet; remove cua-train (CUA-1834) (#5445) (7733289)
  • sandbox: report directory types in file listings (#5175) (1e53b1c)
  • sandbox: roll back partially opened tunnels (#5174) (ca6a0e2)
  • stop Cua Cloud (on="cloud") with a clear "Cua Cloud has ended" error (CUA-1854) (#5415) (5d78ec8)

0.9.0 (2026-10-01)

⚠ BREAKING CHANGES

  • sandbox: Sandbox.create runs locally unless local=False; the localhost module and the computer_server, http, local and websocket transports are removed.

Features

Behaviour changes

  • sandbox: sandboxes are local by default. Sandbox.create / Sandbox.ephemeral without on=/local= follow the user default (CUA_DEFAULT_ON, else cua config set default.on cloud, else local; the built-in local default shows a one-time notice, hidden by CUA_QUIET_DEFAULT=1). Pass on="cloud"/local=False (or cloud=CloudOptions(...), which implies the cloud) for the cloud. For compatibility, omitting both while passing a cloud-only argument (a Fleet pool, warm, max_pool_size, claim_ttl, claim_spec, api_key, ...) still runs in the cloud with a DeprecationWarning. local=True together with cloud=, or on= contradicting local=, raises InvalidArgument. Without cloud credentials, a cloud that came from the default says how to switch back (cua config set default.on local).
  • sandbox: Sandbox.create / ephemeral / sandbox() take on=, kind= (auto, container, vm) and runtime= as an engine name (local gvisor, runc, qemu, lume; cloud gvisor, kubevirt), validated by the cua SDK: a combination that does not exist raises InvalidPlacement (an InvalidArgument) listing the valid values. CUA_DEFAULT_KIND / CUA_DEFAULT_RUNTIME and default.kind / default.runtime fill unset values when they fit. A Runtime object keeps working as before. SandboxInfo gains kind and runtime; Sandbox.list(location="local"|"cloud") is the same filter as local=.
  • sandbox: Sandbox.suspend / resume / restart on a cloud sandbox raise Unsupported (a NotImplementedError): Fleet cannot suspend a single sandbox. They no longer scale a pool named after the sandbox. With local omitted, these and connect / get_info / delete pick the local sandbox of that name when one exists.
  • sandbox: Sandbox.list() lists local and cloud sandboxes by default (local=True / local=False filter; all= is deprecated), each row with location. The cloud part never fails it (silent without credentials, a warning after 5 s or on error) and reads the OS keychain only when the SDK's session marker says a session is stored (for sessions from before this release, run cua auth status once). Sandbox.resume(name) of a running cloud sandbox reconnects.
  • sandbox: SandboxInfo.location says where a sandbox runs.
  • sandbox: Image.from_registry(ref) is literal: ubuntu:24.04 is Docker Hub's image, never the canonical Linux alias.

0.8.0 (2026-09-15)

Features

  • sandbox: OSWorld disks on Fleet via agent_type="osworld" + "Run OSWorld on Fleet" guide (#3686) (db8ba21)

Bug Fixes

  • sandbox: keep Image file sizes JSON-safe (#3839) (1d6e81e)

0.7.0 (2026-09-11)

Features

0.6.0 (2026-09-10)

⚠ BREAKING CHANGES

  • cua-driver: ClickInput now requires target, position, and delivery_mode; click returns ActionResult directly and raises typed tool errors for refusals.

Features

  • cua-driver: expose typed native-window SDK flow (#3683) (75b04aa)
  • sandbox: connect typed Driver through explicit MCP carrier (#3693) (dc3d35c)

Bug Fixes

  • sandbox: align optional Driver dependency with 0.26.0 (#3699) (2b748f6)
  • sandbox: drain MCP responses before cancellation teardown (#3696) (07e36a3)

0.5.0 (2026-09-09)

Features

  • cua-driver: integrate typed Driver access with Fleet Sandbox (#3654) (c9c29dc)
  • cua-sandbox: add signed service URLs (#3508) (8ab33c7)
  • sandbox: add an optional compatible Driver SDK extra (#3678) (80f2dee)
  • sandbox: define the Image API contract (#3327) (a525001)

Bug Fixes

  • cua-sandbox: honor Fleet request timeouts (#3381) (a925ffa)
  • sandbox: manage package releases with Release Please (#3675) (f880ac4)

Changelog

Release Please maintains entries for releases after the migration from sandbox-v0.4.3. Earlier releases remain available in the repository's GitHub release history.