fix(cua-driver-rs): rename agent-cursor overlay namespace TropeCUA → Cua - #1656
Merged
Merged
Conversation
The transparent agent-cursor overlay window registers a Win32 class + title under the namespace `TropeCUA.AgentCursorOverlay` — a leaked codename from an early C# reference implementation that nobody outside the original team would recognise. Renaming to `Cua.AgentCursorOverlay`: - Matches the install-path convention introduced in PR #1644 (`%LOCALAPPDATA%\Programs\Cua\cua-driver\`). - Matches PascalCase Windows-class-name convention. - Gives users a recognisable `Cua.*` namespace when they see the window in EnumWindows / Spy++ / Task Manager — instead of "what's a TropeCUA?". - Cross-platform consistency: Linux overlay's X11 WM_NAME mirrors the same string, so the rename applies to both platforms. ## Surfaced During the cuademo dogfood (running `EnumWindows` against the daemon's pid as part of #1645 hidden-window verification) — saw `TropeCUA.AgentCursorOverlay.default` listed as a visible top-level window owned by cua-driver. The window is intentional (it's the transparent click-through cursor visualization) but the name was confusing. User asked for a namespace that reflects the trycua org. ## Files touched - `crates/platform-windows/src/overlay.rs` — registered class + title - `crates/platform-linux/src/overlay.rs` — X11 WM_NAME - `crates/platform-windows/examples/overlay_dump.rs` — `FindWindowW` class match (matches the registered class so the example still resolves the overlay HWND after this rename) ## Compat The class + title strings aren't part of any public API — they're window-identification metadata visible via EnumWindows. External tools hard-coding the `TropeCUA.*` string would break (we don't know of any). The agent-cursor MCP tools (`set_agent_cursor_enabled`, etc.) reference the overlay by `cursor_id`, not by class/title — unaffected. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
Contributor
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
Contributor
|
Caution Review failedThe pull request is closed. ℹ️ Recent review info⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (3)
📝 WalkthroughWalkthroughThe overlay window identifier namespace is renamed from ChangesOverlay Window Namespace Update
Estimated code review effort🎯 1 (Trivial) | ⏱️ ~5 minutes
✨ Finishing Touches📝 Generate docstrings
🧪 Generate unit tests (beta)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
This was referenced May 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
The transparent agent-cursor overlay window registers under the namespace `TropeCUA.AgentCursorOverlay` — a leaked codename from an early C# reference impl. Renaming to `Cua.AgentCursorOverlay`:
Surfaced
During cuademo dogfood — `EnumWindows` against the daemon's pid listed `TropeCUA.AgentCursorOverlay.default` as a visible top-level window. The window is intentional (transparent click-through cursor visualization) but the name confused the user.
Files touched
Compat
Class + title strings are window-metadata, not public API. No known external tools depend on the `TropeCUA.*` string. Agent-cursor MCP tools reference the overlay by `cursor_id`, not class/title — unaffected.
🤖 Generated with Claude Code
Summary by CodeRabbit