Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion packages/cua-driver/.vendored-from
Original file line number Diff line number Diff line change
@@ -1 +1 @@
cua-driver-rs-v0.6.8
cua-driver-rs-v0.7.0
28 changes: 15 additions & 13 deletions packages/cua-driver/.vendored-patches.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,20 @@
# Cherry-picked upstream PRs (not yet merged)
# Cherry-picked upstream PRs

This vendored copy is based on the tag in [`.vendored-from`](./.vendored-from)
(`cua-driver-rs-v0.6.8`), **plus** a small set of upstream trycua/cua pull
requests that were still _open_ when we needed their fixes (all four are still
open as of the 0.6.8 sync — confirmed by the sync applying with no collision on
their lines). They are applied as
ordinary commits on top of the base snapshot.
(`cua-driver-rs-v0.7.0`), **plus** a small set of upstream trycua/cua pull
requests applied as ordinary commits on top of the base snapshot.

| Upstream PR | Fix | Touches |
| Upstream PR | Fix | Status | Touches |
|---|---|---|---|
| [trycua/cua#2036](https://github.com/trycua/cua/pull/2036) | retry daemon socket writes on `EAGAIN`/`EWOULDBLOCK` instead of failing fatally | upstream-merged post-0.7.0 tag; re-injected here, remove when syncing to a ref that includes it | `cua-driver-core` (socket_io), `cua-driver` (serve.rs) |
| [trycua/cua#2021](https://github.com/trycua/cua/pull/2021) | `list_windows` includes empty-/null-title top-level windows; `resolve_uwp_host_window` for UWP apps | open (draft) | `platform-windows` |

## Retired patches (subsumed by 0.7.0)

| Upstream PR | Fix | Why retired |
|---|---|---|
| [trycua/cua#2035](https://github.com/trycua/cua/pull/2035) | `start_session` revives an idle-reaped session instead of erroring | `cua-driver-core` (session) |
| [trycua/cua#2036](https://github.com/trycua/cua/pull/2036) | retry daemon socket writes on `EAGAIN`/`EWOULDBLOCK` instead of failing fatally | `cua-driver-core` (socket_io) |
| [trycua/cua#2025](https://github.com/trycua/cua/pull/2025) | stop reporting a bare "Clicked" for X11 synthetic (`XSendEvent`) clicks that toolkits ignore | `platform-linux` |
| [trycua/cua#2021](https://github.com/trycua/cua/pull/2021) | `list_windows` includes empty-/null-title top-level windows | `platform-windows` |
| [trycua/cua#2025](https://github.com/trycua/cua/pull/2025) | X11 synthetic click false-success | Superseded by 0.7.0 honest-verification system |
| [trycua/cua#2035](https://github.com/trycua/cua/pull/2035) | `start_session` revive idle-reaped session | Superseded by 0.7.0 `revive_session`/loud-reject/`is_session_lifecycle_tool` |

## When you sync to a newer upstream ref

Expand All @@ -22,8 +24,8 @@ already in the upstream delta, so:

1. The hunks will collide with the cherry-picked commit (expect `.rej` on the
files above), and
2. Once reconciled, **remove the row from this table** — it's no longer a local
patch, it's part of the base.
2. Once reconciled, **remove the row from the active table** — it's no longer a
local patch, it's part of the base.

If `<new-ref>` is still *before* a PR merges, that row stays; the cherry-pick
keeps carrying the fix.
33 changes: 6 additions & 27 deletions packages/cua-driver/python/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,26 +4,15 @@ Python wrapper for [cua-driver](https://github.com/trycua/cua/tree/main/libs/cua

## Installation

```bash
pip install cua-driver
```
Install and usage docs live at https://cua.ai/docs/how-to-guides/driver/install
and https://cua.ai/docs/reference/cua-driver/mcp-tools.

## Usage

The package provides a `cua-driver` command that wraps the native Rust binary:

```bash
# Start MCP server over stdio
cua-driver mcp

# Check version
cua-driver --version

# View help
cua-driver --help
```
The package provides a `cua-driver` command that wraps the native Rust binary.
See the canonical tool reference at https://cua.ai/docs/reference/cua-driver/mcp-tools.

### Python API
## Python API

You can also use the Python API directly:

Expand All @@ -44,16 +33,6 @@ binary_path = get_binary_path()
- **Stdio passthrough**: Transparent piping for MCP protocol communication
- **Bundled binary**: No separate installation required - the Rust binary is included in the wheel

## What is cua-driver?

`cua-driver` is a cross-platform MCP server that provides 40+ tools for:
- Screen capture and window management
- Mouse and keyboard automation
- Accessibility tree interaction
- Application launching and control

It enables AI agents to interact with desktop applications through the Model Context Protocol.

## Platform Support

| Platform | Architecture | Status |
Expand All @@ -70,5 +49,5 @@ MIT License - see [LICENSE](https://github.com/trycua/cua/blob/main/LICENSE.md)
## Links

- [GitHub Repository](https://github.com/trycua/cua)
- [Documentation](https://github.com/trycua/cua/tree/main/libs/cua-driver)
- [Documentation](https://cua.ai/docs)
- [Issue Tracker](https://github.com/trycua/cua/issues)
2 changes: 1 addition & 1 deletion packages/cua-driver/rust/.bumpversion.cfg
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
[bumpversion]
current_version = 0.6.8
current_version = 0.7.0
commit = True
tag = True
tag_name = cua-driver-rs-v{new_version}
Expand Down
27 changes: 18 additions & 9 deletions packages/cua-driver/rust/Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

3 changes: 2 additions & 1 deletion packages/cua-driver/rust/Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
resolver = "2"
members = [
"crates/cua-driver",
"crates/cua-driver-testkit",
"crates/cua-driver-uia",
"crates/cua-driver-core",
"crates/platform-macos",
Expand All @@ -13,7 +14,7 @@ members = [
]

[workspace.package]
version = "0.6.8"
version = "0.7.0"
edition = "2021"
authors = ["trycua"]
license = "MIT"
Expand Down
Loading
Loading