From 849c17752db9fd76d3c393d99dae8b992d1e805a Mon Sep 17 00:00:00 2001
From: teknium1 <127238744+teknium1@users.noreply.github.com>
Date: Sat, 18 Jul 2026 12:29:35 -0700
Subject: [PATCH] fix(skills/tldraw-offline): correct the computer-use delivery
 note
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The skill claimed Chromium/Electron 'reject synthetic clicks' so computer-use
can't drive the canvas. The Cua team disproved this on the exact v1.11.0
AppImage (Linux/X11): background delivery returns background_unavailable, but
that's the first rung, not a wall — cua-driver returns escalation:'foreground'
and its X11 XTest path (x11_xtest_fg) with delivery_mode:'foreground' clicks
through, dismissing the consent dialog and landing canvas clicks.

Corrected the note to say: climb to foreground on background_unavailable, don't
conclude Electron is unclickable. Ref: NousResearch/hermes-agent#67052.
---
 optional-skills/creative/tldraw-offline/SKILL.md | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/optional-skills/creative/tldraw-offline/SKILL.md b/optional-skills/creative/tldraw-offline/SKILL.md
index a721d2376cf5..1c03cf729ee0 100644
--- a/optional-skills/creative/tldraw-offline/SKILL.md
+++ b/optional-skills/creative/tldraw-offline/SKILL.md
@@ -137,11 +137,16 @@ that standard the counter is verified: dispatched clicks stepped it
   logs `inotify_add_watch ... No space left on device`, `script-status` shows
   `state: "not-watching"` / `hasEntry: false`, and the script never executes.
   This is a host limit, not a script bug — a normal desktop is unaffected.
-- **Real background GUI clicks (computer-use style) do NOT reach the canvas.**
-  Chromium/Electron reject synthetic pointer input to an unfocused/occluded
-  renderer, so `computer_use` no-focus automation can't click buttons. This is
-  irrelevant to the actual product path (agents use `/exec`, not clicks) — but
-  don't try to "verify" a script by having a background agent click the GUI.
+- **Driving the canvas with computer-use needs FOREGROUND delivery, not
+  background.** cua-driver's default `background` delivery returns
+  `background_unavailable` against Electron's occluded renderer — but that is the
+  first rung, not a wall. cua-driver returns an `escalation: "foreground"` hint;
+  set `delivery_mode: "foreground"` (pair with `bring_to_front`) and its X11 XTest
+  path (`x11_xtest_fg`) clicks land — this dismisses the "Run Script" consent
+  dialog and clicks the canvas. Verified by the Cua team on this exact v1.11.0
+  AppImage (Linux/X11). Do NOT conclude "Electron rejects synthetic clicks" and
+  give up in background mode — climb to foreground. (The real product path is
+  still `/exec`, not clicks; this note is for computer-use-driven testing.)
 
 The pattern: