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.

docs: correct trope-cua attribution for cursor motion (#4760)

Francesco Bonacci60ae9a63ec82
diff --git a/libs/cua-driver/rust/THIRD_PARTY_NOTICES.md b/libs/cua-driver/rust/THIRD_PARTY_NOTICES.md
index 63ec229db5..297cd37053 100644
--- a/libs/cua-driver/rust/THIRD_PARTY_NOTICES.md
+++ b/libs/cua-driver/rust/THIRD_PARTY_NOTICES.md
@@ -4,11 +4,18 @@ Parts of the Cua Driver Rust workspace are derived from these MIT-licensed
projects. Each project's copyright notice is below, followed by the MIT
License text they share.
-| Project | Copyright | Used in | What |
-| --------------------------------------------------------------- | ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| [trope-cua](https://github.com/voctory/trope-cua) | Copyright (c) 2026 Victor Vannara | `crates/cursor-overlay/src/motion.rs`, `crates/cursor-overlay/src/bezier.rs`; `crates/platform-windows` (`src/overlay.rs`, `src/input/`, `src/tools/impl_.rs`) | Agent-cursor motion and timing configuration and Bezier segment math; Windows cursor overlay, background input and layered pixel-click dispatch |
-| [Interface-Agent](https://github.com/francedot/Interface-Agent) | Copyright (c) 2024 Francesco Bonacci | `crates/platform-windows` (`src/uia/`, `src/win32/`, `src/tools/impl_.rs`) | Windows UI Automation tree walk, app and window enumeration, InvokePattern click and ValuePattern set-value |
-| [yabai](https://github.com/koekeishiya/yabai) | Copyright (c) 2019 Åsmund Vikane | `crates/platform-macos/src/input/skylight.rs` (`activate_without_raise`) | The focus-without-raise SkyLight event-record sequence |
+trope-cua's cursor motion is itself a port of Cua Driver's Swift cursor
+implementation (`CursorMotionPath.swift`, `Bezier.swift` and the Dubins glide in
+`AgentCursorRenderer.swift`, April 2026; MIT, Copyright (c) 2025 Cua AI, Inc.).
+In `cursor-overlay`, the motion knobs, their defaults, the arc formula and the
+Dubins glide originate in that Swift code; trope-cua is credited below only for
+the items listed.
+
+| Project | Copyright | Used in | What |
+| --------------------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [trope-cua](https://github.com/voctory/trope-cua) | Copyright (c) 2026 Victor Vannara | `crates/platform-windows` (`src/overlay.rs`, `src/input/`, `src/tools/impl_.rs`); `crates/cursor-overlay/src/motion.rs`, `crates/cursor-overlay/src/bezier.rs` (specific items only) | Windows cursor overlay, background input and layered pixel-click dispatch; in `cursor-overlay`, the `press_duration_ms` knob, the 80 ms dwell default, the former 20 s idle default, the `with_overrides` method shape and the cached 32-point arc-length helper |
+| [Interface-Agent](https://github.com/francedot/Interface-Agent) | Copyright (c) 2024 Francesco Bonacci | `crates/platform-windows` (`src/uia/`, `src/win32/`, `src/tools/impl_.rs`) | Windows UI Automation tree walk, app and window enumeration, InvokePattern click and ValuePattern set-value |
+| [yabai](https://github.com/koekeishiya/yabai) | Copyright (c) 2019 Åsmund Vikane | `crates/platform-macos/src/input/skylight.rs` (`activate_without_raise`) | The focus-without-raise SkyLight event-record sequence |
## MIT License
diff --git a/libs/cua-driver/rust/crates/cursor-overlay/src/bezier.rs b/libs/cua-driver/rust/crates/cursor-overlay/src/bezier.rs
index ddf87d390d..ef456c3284 100644
--- a/libs/cua-driver/rust/crates/cursor-overlay/src/bezier.rs
+++ b/libs/cua-driver/rust/crates/cursor-overlay/src/bezier.rs
@@ -1,5 +1,12 @@
-//! Cubic Bezier math, ported from `Bezier.swift` and `CursorMotionSegment`.
-//! Derived from trope-cua (MIT); see THIRD_PARTY_NOTICES.md.
+//! Cubic Bezier math.
+//!
+//! Lineage:
+//! - The cubic point and tangent math and `build_motion_bezier` (the arc
+//! formula) originate in Cua Driver's Swift `Bezier.swift` and
+//! `CursorMotionPath.swift` (April 2026, #1359).
+//! - The cached arc length (32-point integration) and `sample_at_distance`
+//! follow trope-cua's C# `CursorMotionSegment` (MIT); see
+//! THIRD_PARTY_NOTICES.md.
//!
//! `B(t) = (1-t)³P₀ + 3(1-t)²tP₁ + 3(1-t)t²P₂ + t³P₃`
diff --git a/libs/cua-driver/rust/crates/cursor-overlay/src/lib.rs b/libs/cua-driver/rust/crates/cursor-overlay/src/lib.rs
index 0faaa8ceca..46177c8534 100644
--- a/libs/cua-driver/rust/crates/cursor-overlay/src/lib.rs
+++ b/libs/cua-driver/rust/crates/cursor-overlay/src/lib.rs
@@ -3,7 +3,9 @@
//! Platform renderers (macOS, Windows, Linux) depend on this crate for:
//! - `CursorConfig` — theme, accessibility, visibility, and motion settings
//! - `MotionConfig` — glide duration, spring, dwell, idle-hide timings
-//! - `CubicBezier` — Bezier path math (ported 1:1 from C#)
+//! - `CubicBezier` — Bezier path math (from Cua Driver's Swift `Bezier.swift` /
+//! `CursorMotionPath.swift`; arc-length helper after trope-cua, see
+//! THIRD_PARTY_NOTICES.md)
//! - `trajectory` — the motion styles, timing and effect geometry, which live
//! in the `cua-cursor-motion` crate (shared with the `@trycua/cursor-motion` web package)
//! - `OverlayCommand` — messages sent from MCP tools to the overlay thread
diff --git a/libs/cua-driver/rust/crates/cursor-overlay/src/motion.rs b/libs/cua-driver/rust/crates/cursor-overlay/src/motion.rs
index ae667b051d..29069c8e31 100644
--- a/libs/cua-driver/rust/crates/cursor-overlay/src/motion.rs
+++ b/libs/cua-driver/rust/crates/cursor-overlay/src/motion.rs
@@ -1,5 +1,15 @@
//! Motion / timing configuration.
-//! Derived from trope-cua (MIT); see THIRD_PARTY_NOTICES.md.
+//!
+//! Lineage:
+//! - The arc knobs (`start_handle`, `end_handle`, `arc_size`, `arc_flow`,
+//! `spring`), their defaults and clamp ranges, and the glide speed constants
+//! originate in Cua Driver's Swift `CursorMotionPath.swift` (April 2026,
+//! #1359). The Dubins glide they feed is from Cua Driver's Swift
+//! `AgentCursorRenderer.swift` (#1360).
+//! - The `press_duration_ms` knob, the 80 ms `dwell_after_click_ms` default
+//! and the `with_overrides` method shape follow trope-cua's C#
+//! `AgentCursorMotion.cs` (MIT); see THIRD_PARTY_NOTICES.md.
+//! - The motion styles, timing modes and effects are Cua's own.
use serde::{Deserialize, Serialize};
use serde_json::Value;