fix(cua-driver): forward-port Hyprland agent mode to v0.22

.github/CODEOWNERS

@@ -4,34 +4,34 @@
 /release-please-config.json @f-trycua
 
 # Core products and SDKs.
-/libs/cua-driver/ @f-trycua
+/libs/cua-driver/ @f-trycua @injaneity
 /libs/lume/ @f-trycua
 /libs/python/ @ddupont808
 /libs/cua-bench/ @ddupont808
 
 # Cua Driver documentation and driver-only release/CI automation.
-/docs/content/docs/reference/cua-driver/ @f-trycua
-/scripts/docs-generators/cua-driver.ts @f-trycua
-/.github/release-notes/cua-driver-rs.md @f-trycua
-/.github/scripts/sync_driver_release_docs.py @f-trycua
-/.github/scripts/verify_cua_driver_release_archives.py @f-trycua
-/.github/scripts/tests/test_cua_driver_release_wiring.py @f-trycua
-/.github/scripts/tests/test_sync_driver_release_docs.py @f-trycua
-/.github/scripts/tests/test_verify_cua_driver_release_archives.py @f-trycua
-/.github/workflows/cd-cua-driver-docs.yml @f-trycua
-/.github/workflows/cd-py-cua-driver.yml @f-trycua
-/.github/workflows/cd-rust-cua-driver.yml @f-trycua
-/.github/workflows/ci-cua-driver-contract-clients.yml @f-trycua
-/.github/workflows/ci-cua-driver-installer-compat.yml @f-trycua
-/.github/workflows/ci-distro-compat-cua-driver.yml @f-trycua
-/.github/workflows/ci-rust-format.yml @f-trycua
-/.github/workflows/ci-rust-linux.yml @f-trycua
-/.github/workflows/ci-rust-windows.yml @f-trycua
-/.github/workflows/clawhub-cua-driver.yml @f-trycua
-/.github/workflows/e2e-rust-linux-wayland.yml @f-trycua
-/.github/workflows/e2e-rust-linux.yml @f-trycua
-/.github/workflows/e2e-rust-standalone-browsers.yml @f-trycua
-/.github/workflows/e2e-rust-windows.yml @f-trycua
+/docs/content/docs/reference/cua-driver/ @f-trycua @injaneity
+/scripts/docs-generators/cua-driver.ts @f-trycua @injaneity
+/.github/release-notes/cua-driver-rs.md @f-trycua @injaneity
+/.github/scripts/sync_driver_release_docs.py @f-trycua @injaneity
+/.github/scripts/verify_cua_driver_release_archives.py @f-trycua @injaneity
+/.github/scripts/tests/test_cua_driver_release_wiring.py @f-trycua @injaneity
+/.github/scripts/tests/test_sync_driver_release_docs.py @f-trycua @injaneity
+/.github/scripts/tests/test_verify_cua_driver_release_archives.py @f-trycua @injaneity
+/.github/workflows/cd-cua-driver-docs.yml @f-trycua @injaneity
+/.github/workflows/cd-py-cua-driver.yml @f-trycua @injaneity
+/.github/workflows/cd-rust-cua-driver.yml @f-trycua @injaneity
+/.github/workflows/ci-cua-driver-contract-clients.yml @f-trycua @injaneity
+/.github/workflows/ci-cua-driver-installer-compat.yml @f-trycua @injaneity
+/.github/workflows/ci-distro-compat-cua-driver.yml @f-trycua @injaneity
+/.github/workflows/ci-rust-format.yml @f-trycua @injaneity
+/.github/workflows/ci-rust-linux.yml @f-trycua @injaneity
+/.github/workflows/ci-rust-windows.yml @f-trycua @injaneity
+/.github/workflows/clawhub-cua-driver.yml @f-trycua @injaneity
+/.github/workflows/e2e-rust-linux-wayland.yml @f-trycua @injaneity
+/.github/workflows/e2e-rust-linux.yml @f-trycua @injaneity
+/.github/workflows/e2e-rust-standalone-browsers.yml @f-trycua @injaneity
+/.github/workflows/e2e-rust-windows.yml @f-trycua @injaneity
 
 # Platform infrastructure.
 /libs/fleet/ @r33drichards

.github/release-attribution-config.json

@@ -27,6 +27,7 @@
     "klymenko@adobe.com": "pavelklymenko",
     "m.fuechtenkoetter@posteo.de": "ai-ag2026",
     "manfred@ubuntu26.04-vm": "ai-ag2026",
+    "marko.civonafets@gmail.com": "civonafets",
     "me@madhavajay.com": "madhavajay",
     "robert@trycua.com": "enchanted-koala",
     "rwendt1337@gmail.com": "r33drichards",

.github/release-state/cua-driver-rs-published-version

@@ -1 +1 @@
-0.19.3
+0.21.0

.github/scripts/github_release.py

@@ -149,10 +149,7 @@ def unique_release(api: GitHubApi, repository: str, tag: str) -> dict[str, Any]:
 
 
 def validate_registered_nightly_tag(tag: str) -> None:
-    # Driver publication runs after its exact nightly version has been staged
-    # into the checkout. Tag validation needs registry shape and namespaces,
-    # not the stable source-state invariant enforced by planning and builds.
-    registry = release_channels.load_registry(require_stable_state=False)
+    registry = release_channels.load_registry()
     matches = []
     for name, component in registry["components"].items():
         try:

.github/scripts/release_channels.py

@@ -9,8 +9,10 @@
 import os
 from pathlib import Path, PurePosixPath
 import re
+import shutil
 import subprocess
 import sys
+import tempfile
 from typing import Any, Mapping, Sequence
 
 import release_attribution
@@ -54,7 +56,6 @@ def load_registry(
     path: Path = DEFAULT_REGISTRY,
     *,
     root: Path = ROOT,
-    require_stable_state: bool = True,
 ) -> dict[str, Any]:
     registry = read_json(path)
     if registry.get("schemaVersion") != 1:
@@ -127,21 +128,18 @@ def load_registry(
             raise ChannelError(
                 f"component {name} stable prefix must match Release Please: {expected_prefix}"
             )
-        if require_stable_state:
-            authority = (
-                repository_path(root, component["versionAuthorityFile"])
-                .read_text(encoding="utf-8")
-                .strip()
+        authority = (
+            repository_path(root, component["versionAuthorityFile"])
+            .read_text(encoding="utf-8")
+            .strip()
+        )
+        if not SEMVER_RE.fullmatch(authority):
+            raise ChannelError(f"component {name} authority is not a stable version: {authority!r}")
+        if release_manifest.get(package_path) != authority:
+            raise ChannelError(
+                f"component {name} authority {authority} differs from Release Please manifest "
+                f"{release_manifest.get(package_path)!r}"
             )
-            if not SEMVER_RE.fullmatch(authority):
-                raise ChannelError(
-                    f"component {name} authority is not a stable version: {authority!r}"
-                )
-            if release_manifest.get(package_path) != authority:
-                raise ChannelError(
-                    f"component {name} authority {authority} differs from Release Please manifest "
-                    f"{release_manifest.get(package_path)!r}"
-                )
     return registry
 
 
@@ -150,13 +148,8 @@ def component_descriptor(
     path: Path = DEFAULT_REGISTRY,
     *,
     root: Path = ROOT,
-    require_stable_state: bool = True,
 ) -> dict[str, Any]:
-    registry = load_registry(
-        path,
-        root=root,
-        require_stable_state=require_stable_state,
-    )
+    registry = load_registry(path, root=root)
     try:
         return dict(registry["components"][name])
     except KeyError as error:
@@ -278,6 +271,39 @@ def replace_block(match: re.Match[str]) -> str:
     return len(seen)
 
 
+def _rewrite_version_site(
+    site: Mapping[str, Any],
+    path: Path,
+    old_version: str,
+    new_version: str,
+    *,
+    manifest_path: Path | None = None,
+) -> None:
+    kind = site["kind"]
+    if kind == "plain":
+        if path.read_text(encoding="utf-8").strip() != old_version:
+            raise ChannelError(f"plain version site {site['path']} differs from {old_version}")
+        path.write_text(f"{new_version}\n", encoding="utf-8")
+    elif kind == "regex":
+        original = path.read_text(encoding="utf-8")
+        replacement = str(site["replacement"]).replace("{version}", new_version)
+        rewritten, count = re.subn(str(site["pattern"]), replacement, original)
+        if count != int(site["expectedMatches"]):
+            raise ChannelError(
+                f"version site {site['path']} matched {count} times, "
+                f"expected {site['expectedMatches']}"
+            )
+        path.write_text(rewritten, encoding="utf-8")
+    elif kind == "cargo-workspace-lock":
+        if manifest_path is None:
+            raise ChannelError(
+                f"cargo lock version site {site['path']} requires its manifest in the staged tree"
+            )
+        _rewrite_cargo_lock(path, manifest_path, old_version, new_version)
+    else:
+        raise ChannelError(f"unsupported version site kind: {kind!r}")
+
+
 def apply_version(
     name: str,
     version: str,
@@ -293,30 +319,86 @@ def apply_version(
     changed: list[str] = []
     for site in component["buildVersionSites"]:
         path = repository_path(root, site["path"])
-        kind = site["kind"]
-        if kind == "plain":
-            if path.read_text(encoding="utf-8").strip() != old_version:
-                raise ChannelError(f"plain version site {site['path']} differs from {old_version}")
-            path.write_text(f"{version}\n", encoding="utf-8")
-        elif kind == "regex":
-            original = path.read_text(encoding="utf-8")
-            replacement = str(site["replacement"]).replace("{version}", version)
-            rewritten, count = re.subn(str(site["pattern"]), replacement, original)
-            if count != int(site["expectedMatches"]):
-                raise ChannelError(
-                    f"version site {site['path']} matched {count} times, "
-                    f"expected {site['expectedMatches']}"
-                )
-            path.write_text(rewritten, encoding="utf-8")
-        elif kind == "cargo-workspace-lock":
-            manifest = repository_path(root, site["manifestPath"])
-            _rewrite_cargo_lock(path, manifest, old_version, version)
-        else:
-            raise ChannelError(f"unsupported version site kind: {kind!r}")
+        manifest = (
+            repository_path(root, site["manifestPath"])
+            if site["kind"] == "cargo-workspace-lock"
+            else None
+        )
+        _rewrite_version_site(site, path, old_version, version, manifest_path=manifest)
         changed.append(str(site["path"]))
     return changed
 
 
+def stage_versioned_tree(
+    name: str,
+    version: str,
+    source: str,
+    destination: str,
+    *,
+    registry_path: Path = DEFAULT_REGISTRY,
+    root: Path = ROOT,
+) -> list[str]:
+    """Copy one source tree and rewrite only its declared version sites."""
+    nightly_version(version)
+    component = component_descriptor(name, registry_path, root=root)
+    authority = repository_path(root, component["versionAuthorityFile"])
+    old_version = authority.read_text(encoding="utf-8").strip()
+    stable_version(old_version)
+    source_path = repository_path(root, source)
+    destination_path = repository_path(root, destination)
+    if not source_path.is_dir():
+        raise ChannelError(f"versioned tree source is not a directory: {source}")
+    if destination_path.exists():
+        raise ChannelError(f"versioned tree destination already exists: {destination}")
+    if destination_path.resolve().is_relative_to(source_path.resolve()):
+        raise ChannelError("versioned tree destination cannot be inside its source")
+
+    source_pure = PurePosixPath(source)
+    selected: list[tuple[Mapping[str, Any], PurePosixPath]] = []
+    for site in component["buildVersionSites"]:
+        try:
+            relative = PurePosixPath(str(site["path"])).relative_to(source_pure)
+        except ValueError:
+            continue
+        selected.append((site, relative))
+    if not selected:
+        raise ChannelError(
+            f"versioned tree {source!r} contains no declared buildVersionSites for {name}"
+        )
+
+    destination_path.parent.mkdir(parents=True, exist_ok=True)
+    with tempfile.TemporaryDirectory(
+        dir=destination_path.parent,
+        prefix=f".{destination_path.name}.stage-",
+    ) as temporary:
+        staged = Path(temporary) / destination_path.name
+        shutil.copytree(source_path, staged)
+        changed: list[str] = []
+        for site, relative in selected:
+            manifest = None
+            if site["kind"] == "cargo-workspace-lock":
+                try:
+                    manifest_relative = PurePosixPath(str(site["manifestPath"])).relative_to(
+                        source_pure
+                    )
+                except ValueError as error:
+                    raise ChannelError(
+                        f"cargo lock version site {site['path']} cannot be staged without "
+                        f"manifest {site['manifestPath']}"
+                    ) from error
+                manifest = staged / manifest_relative
+            _rewrite_version_site(
+                site,
+                staged / relative,
+                old_version,
+                version,
+                manifest_path=manifest,
+            )
+            changed.append(str(PurePosixPath(destination) / relative))
+        staged.rename(destination_path)
+    return changed
+
+
 def _git(root: Path, *args: str) -> str:
     result = subprocess.run(["git", *args], cwd=root, check=False, text=True, capture_output=True)
     if result.returncode != 0:
@@ -407,12 +489,7 @@ def build_manifest(
     attribution_config_path: Path | None = None,
     github: release_attribution.GitHubClient | None = None,
 ) -> dict[str, Any]:
-    component = component_descriptor(
-        name,
-        registry_path,
-        root=root,
-        require_stable_state=False,
-    )
+    component = component_descriptor(name, registry_path, root=root)
     parsed = parse_tag(component, "nightly", tag)
     if parsed != version:
         raise ChannelError(f"tag version {parsed} differs from requested version {version}")
@@ -426,11 +503,7 @@ def build_manifest(
     if not base_sha:
         raise ChannelError(f"nightly attribution base has no commit: {previous_tag}")
     _git(root, "merge-base", "--is-ancestor", base_sha, source_sha)
-    registry = load_registry(
-        registry_path,
-        root=root,
-        require_stable_state=False,
-    )
+    registry = load_registry(registry_path, root=root)
     paths = sorted(
         {
             *(str(path) for path in component["changeDetectionPaths"]),
@@ -576,6 +649,12 @@ def parser() -> argparse.ArgumentParser:
     apply.add_argument("--component", required=True)
     apply.add_argument("--version", required=True)
 
+    stage = subparsers.add_parser("stage-versioned-tree")
+    stage.add_argument("--component", required=True)
+    stage.add_argument("--version", required=True)
+    stage.add_argument("--source", required=True)
+    stage.add_argument("--destination", required=True)
+
     plan = subparsers.add_parser("plan")
     plan.add_argument("--component", required=True)
     plan.add_argument("--source-sha", required=True)
@@ -627,6 +706,16 @@ def main(argv: Sequence[str] | None = None) -> int:
                 args.component, args.version, registry_path=args.registry, root=root
             ):
                 print(changed)
+        elif args.command == "stage-versioned-tree":
+            for changed in stage_versioned_tree(
+                args.component,
+                args.version,
+                args.source,
+                args.destination,
+                registry_path=args.registry,
+                root=root,
+            ):
+                print(changed)
         elif args.command == "plan":
             releases = read_json(args.releases)
             if not isinstance(releases, list):