@xrkseek/harness 0.6.21 → 0.7.0-rc.1

package/node_modules/@xrkseek/exec-computer-use/dist/windows-uia.js

@@ -16,33 +16,33 @@ export const DEFAULT_POWERSHELL_TIMEOUT_MS = 25_000;
  * mangles every CJK `Name` when decoded as UTF-8. The prelude pins both streams
  * to UTF-8 so the JSON payload survives round-trip.
  */
-const PS_PRELUDE = `
-$ErrorActionPreference = 'Stop'
-try { [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 } catch {}
-try { [Console]::ErrorEncoding = [System.Text.Encoding]::UTF8 } catch {}
-Add-Type -AssemblyName UIAutomationClient
-Add-Type -AssemblyName UIAutomationTypes
-function XrkSafeInt {
-  param([double]$Value)
-  if ([double]::IsNaN($Value) -or [double]::IsInfinity($Value)) { return $null }
-  if ($Value -lt [int]::MinValue -or $Value -gt [int]::MaxValue) { return $null }
-  return [int][Math]::Round($Value, [System.MidpointRounding]::AwayFromZero)
-}
-function XrkTopWindows {
-  $cond = New-Object System.Windows.Automation.PropertyCondition(
-    [System.Windows.Automation.AutomationElement]::ControlTypeProperty,
-    [System.Windows.Automation.ControlType]::Window)
-  return [System.Windows.Automation.AutomationElement]::RootElement.FindAll(
-    [System.Windows.Automation.TreeScope]::Children, $cond)
-}
-function XrkProcName([int]$targetPid) {
-  try { return (Get-Process -Id $targetPid -ErrorAction SilentlyContinue).ProcessName } catch { return '' }
-}
-function XrkMatch([string]$hay, [string]$needle) {
-  if ([string]::IsNullOrWhiteSpace($needle)) { return $true }
-  if ([string]::IsNullOrEmpty($hay)) { return $false }
-  return ($hay.IndexOf($needle, [System.StringComparison]::OrdinalIgnoreCase) -ge 0)
-}
+const PS_PRELUDE = `
+$ErrorActionPreference = 'Stop'
+try { [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 } catch {}
+try { [Console]::ErrorEncoding = [System.Text.Encoding]::UTF8 } catch {}
+Add-Type -AssemblyName UIAutomationClient
+Add-Type -AssemblyName UIAutomationTypes
+function XrkSafeInt {
+  param([double]$Value)
+  if ([double]::IsNaN($Value) -or [double]::IsInfinity($Value)) { return $null }
+  if ($Value -lt [int]::MinValue -or $Value -gt [int]::MaxValue) { return $null }
+  return [int][Math]::Round($Value, [System.MidpointRounding]::AwayFromZero)
+}
+function XrkTopWindows {
+  $cond = New-Object System.Windows.Automation.PropertyCondition(
+    [System.Windows.Automation.AutomationElement]::ControlTypeProperty,
+    [System.Windows.Automation.ControlType]::Window)
+  return [System.Windows.Automation.AutomationElement]::RootElement.FindAll(
+    [System.Windows.Automation.TreeScope]::Children, $cond)
+}
+function XrkProcName([int]$targetPid) {
+  try { return (Get-Process -Id $targetPid -ErrorAction SilentlyContinue).ProcessName } catch { return '' }
+}
+function XrkMatch([string]$hay, [string]$needle) {
+  if ([string]::IsNullOrWhiteSpace($needle)) { return $true }
+  if ([string]::IsNullOrEmpty($hay)) { return $false }
+  return ($hay.IndexOf($needle, [System.StringComparison]::OrdinalIgnoreCase) -ge 0)
+}
 `;
 /**
  * `powershell.exe` is resolvable only when the parent process inherited the
@@ -133,270 +133,270 @@ export function captureScript(options = {}) {
     const keepOffscreen = options.includeOffscreen ? "$true" : "$false";
     const includeShot = options.includeScreenshot ? "$true" : "$false";
     const annotateSom = options.annotateSom ? "$true" : "$false";
-    return `${PS_PRELUDE}
-$appFilter = ${appLit}
-$max = ${max}
-$keepOffscreen = ${keepOffscreen}
-$includeScreenshot = ${includeShot}
-$annotateSom = ${annotateSom}
-$maxDepth = 60
-# Cross-process UIA calls are expensive; bound the walk so a giant browser tree
-# cannot outrun the PowerShell timeout.
-$visitCap = [Math]::Max(300, $max * 12 + 200)
-$walker = [System.Windows.Automation.TreeWalker]::ControlViewWalker
-
-$focusedWin = $null
-try {
-  $fe = [System.Windows.Automation.AutomationElement]::FocusedElement
-  $cur = $fe
-  while ($cur -and $cur.Current.ControlType -ne [System.Windows.Automation.ControlType]::Window) {
-    $p = $walker.GetParent($cur)
-    if (-not $p) { break }
-    $cur = $p
-  }
-  if ($cur) { $focusedWin = $cur }
-} catch {}
-
-$all = XrkTopWindows
-$win = $null
-$byProc = $null
-$byTitle = $null
-$candidates = New-Object System.Collections.Generic.List[string]
-foreach ($w in $all) {
-  $t = ''
-  try { $t = $w.Current.Name } catch {}
-  $pn = XrkProcName $w.Current.ProcessId
-  $cn = ''
-  try { $cn = $w.Current.ClassName } catch {}
-  if (-not [string]::IsNullOrWhiteSpace($t)) { $candidates.Add($t + ' [' + $pn + ']') }
-  if ($appFilter -eq '') {
-    if (-not $win -and $focusedWin -and $w.Current.NativeWindowHandle -eq $focusedWin.Current.NativeWindowHandle) {
-      $win = $w
-    } elseif (-not $win -and -not [string]::IsNullOrWhiteSpace($t)) {
-      $win = $w
-    }
-    continue
-  }
-  # A process/class hit beats a title that merely mentions the app (a browser tab
-  # titled "...QQ..." must not shadow the real QQ window).
-  if (-not $byProc -and ((XrkMatch $pn $appFilter) -or (XrkMatch $cn $appFilter))) { $byProc = $w }
-  if (-not $byTitle -and (XrkMatch $t $appFilter)) { $byTitle = $w }
-}
-if ($appFilter -ne '' -and -not $win) {
-  if ($focusedWin) {
-    $ft = ''
-    try { $ft = $focusedWin.Current.Name } catch {}
-    $fpn = XrkProcName $focusedWin.Current.ProcessId
-    if ((XrkMatch $fpn $appFilter) -or (XrkMatch $ft $appFilter)) { $win = $focusedWin }
-  }
-  if (-not $win) { $win = $byProc }
-  if (-not $win) { $win = $byTitle }
-}
-if (-not $win) {
-  @{ error = 'app-not-found'; app = ''; windowTitle = ''; elements = @(); candidates = $candidates } | ConvertTo-Json -Depth 6 -Compress
-  return
-}
-
-$title = ''
-try { $title = $win.Current.Name } catch {}
-$targetPid = $win.Current.ProcessId
-$appLabel = XrkProcName $targetPid
-if ([string]::IsNullOrWhiteSpace($appLabel)) { $appLabel = $title }
-
-$elements = New-Object System.Collections.Generic.List[object]
-$seen = New-Object System.Collections.Generic.HashSet[string]
-$queue = New-Object System.Collections.Generic.Queue[object]
-$queue.Enqueue(@{ el = $win; d = 0 })
-$idx = 0
-$visited = 0
-$dropped = 0
-$exhausted = $true
-while ($queue.Count -gt 0 -and $idx -lt $max -and $visited -lt $visitCap) {
-  $item = $queue.Dequeue()
-  $el = $item.el
-  $depth = $item.d
-  $visited++
-  $rid = ''
-  try { $rid = ($el.GetRuntimeId() -join ',') } catch {}
-  if ($rid -ne '' -and -not $seen.Add($rid)) { continue }
-  $ct = ''
-  try { $ct = $el.Current.ControlType.ProgrammaticName } catch {}
-  $name = ''
-  try { $name = $el.Current.Name } catch {}
-  # Always expand (bounded by depth): gating expansion on $depth -gt 0 meant the
-  # root window never yielded children and every capture came back empty.
-  if ($depth -lt $maxDepth) {
-    try {
-      $child = $walker.GetFirstChild($el)
-      $guard = 0
-      while ($child -and $guard -lt 500 -and ($visited + $guard) -lt $visitCap) {
-        $queue.Enqueue(@{ el = $child; d = ($depth + 1) })
-        $guard++
-        $child = $walker.GetNextSibling($child)
-      }
-    } catch { $dropped++ }
-  }
-  try {
-    if ($el.Current.ProcessId -ne $targetPid) { continue }
-    $role = ($ct -replace '^ControlType\\.','')
-    if ($depth -eq 0) { continue }
-    if (($role -eq 'Window' -or $role -eq 'Pane') -and [string]::IsNullOrWhiteSpace($name)) { continue }
-    $r = $el.Current.BoundingRectangle
-    $x = XrkSafeInt $r.X
-    $y = XrkSafeInt $r.Y
-    $wd = XrkSafeInt $r.Width
-    $ht = XrkSafeInt $r.Height
-    $offscreen = ($null -eq $x -or $null -eq $y -or $null -eq $wd -or $null -eq $ht -or $wd -le 0 -or $ht -le 0)
-    if ($offscreen -and -not $keepOffscreen) { continue }
-    if ([string]::IsNullOrWhiteSpace($name) -and [string]::IsNullOrWhiteSpace($role)) { continue }
-    $idx++
-    $display = $name
-    if ([string]::IsNullOrWhiteSpace($display)) { $display = $ct }
-    $elements.Add([pscustomobject]@{
-      index = $idx
-      role = $role
-      name = $display
-      x = $x; y = $y; width = $wd; height = $ht
-      runtimeId = $rid
-    })
-  } catch { $dropped++ }
-}
-if ($queue.Count -gt 0 -and $visited -ge $visitCap) { $exhausted = $false }
-
-$screenshotBase64 = ''
-$screenshotError = ''
-if ($includeScreenshot) {
-  try {
-    Add-Type -AssemblyName System.Drawing
-    $br = $win.Current.BoundingRectangle
-    $sx = XrkSafeInt $br.X
-    $sy = XrkSafeInt $br.Y
-    $sw = XrkSafeInt $br.Width
-    $sh = XrkSafeInt $br.Height
-    if ($null -eq $sx -or $null -eq $sy -or $null -eq $sw -or $null -eq $sh -or $sw -le 0 -or $sh -le 0) {
-      $screenshotError = 'window has no on-screen bounds for screenshot'
-    } else {
-      $maxW = 1280; $maxH = 720
-      $scale = [Math]::Min(1.0, [Math]::Min(($maxW / [double]$sw), ($maxH / [double]$sh)))
-      $dw = [Math]::Max(1, [int][Math]::Round($sw * $scale))
-      $dh = [Math]::Max(1, [int][Math]::Round($sh * $scale))
-      $src = New-Object System.Drawing.Bitmap $sw, $sh
-      $gs = [System.Drawing.Graphics]::FromImage($src)
-      $gs.CopyFromScreen($sx, $sy, 0, 0, (New-Object System.Drawing.Size($sw, $sh)))
-      $gs.Dispose()
-      $bmp = $src
-      if ($scale -lt 1.0) {
-        $bmp = New-Object System.Drawing.Bitmap $dw, $dh
-        $g = [System.Drawing.Graphics]::FromImage($bmp)
-        $g.DrawImage($src, 0, 0, $dw, $dh)
-        $g.Dispose()
-        $src.Dispose()
-      }
-      if ($annotateSom) {
-        $g2 = [System.Drawing.Graphics]::FromImage($bmp)
-        $font = New-Object System.Drawing.Font 'Consolas', 10, ([System.Drawing.FontStyle]::Bold)
-        $fill = New-Object System.Drawing.SolidBrush ([System.Drawing.Color]::FromArgb(220, 255, 220, 0))
-        $ink = New-Object System.Drawing.SolidBrush ([System.Drawing.Color]::Black)
-        foreach ($e in $elements) {
-          if ($null -eq $e.x -or $null -eq $e.y) { continue }
-          $lx = [int][Math]::Round(($e.x - $sx) * $scale)
-          $ly = [int][Math]::Round(($e.y - $sy) * $scale)
-          if ($lx -lt 0 -or $ly -lt 0 -or $lx -gt $dw -or $ly -gt $dh) { continue }
-          $label = [string]$e.index
-          $g2.FillRectangle($fill, $lx, $ly, 18, 14)
-          $g2.DrawString($label, $font, $ink, $lx, $ly)
-        }
-        $g2.Dispose(); $font.Dispose(); $fill.Dispose(); $ink.Dispose()
-      }
-      $ms = New-Object System.IO.MemoryStream
-      $bmp.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png)
-      $screenshotBase64 = [Convert]::ToBase64String($ms.ToArray())
-      $ms.Dispose(); $bmp.Dispose()
-    }
-  } catch {
-    $screenshotError = $_.Exception.Message
-  }
-}
-
-@{
-  app = $appLabel
-  windowTitle = $title
-  elements = $elements
-  visited = $visited
-  dropped = $dropped
-  exhausted = $exhausted
-  screenshotBase64 = $screenshotBase64
-  screenshotError = $screenshotError
-} | ConvertTo-Json -Depth 6 -Compress
+    return `${PS_PRELUDE}
+$appFilter = ${appLit}
+$max = ${max}
+$keepOffscreen = ${keepOffscreen}
+$includeScreenshot = ${includeShot}
+$annotateSom = ${annotateSom}
+$maxDepth = 60
+# Cross-process UIA calls are expensive; bound the walk so a giant browser tree
+# cannot outrun the PowerShell timeout.
+$visitCap = [Math]::Max(300, $max * 12 + 200)
+$walker = [System.Windows.Automation.TreeWalker]::ControlViewWalker
+
+$focusedWin = $null
+try {
+  $fe = [System.Windows.Automation.AutomationElement]::FocusedElement
+  $cur = $fe
+  while ($cur -and $cur.Current.ControlType -ne [System.Windows.Automation.ControlType]::Window) {
+    $p = $walker.GetParent($cur)
+    if (-not $p) { break }
+    $cur = $p
+  }
+  if ($cur) { $focusedWin = $cur }
+} catch {}
+
+$all = XrkTopWindows
+$win = $null
+$byProc = $null
+$byTitle = $null
+$candidates = New-Object System.Collections.Generic.List[string]
+foreach ($w in $all) {
+  $t = ''
+  try { $t = $w.Current.Name } catch {}
+  $pn = XrkProcName $w.Current.ProcessId
+  $cn = ''
+  try { $cn = $w.Current.ClassName } catch {}
+  if (-not [string]::IsNullOrWhiteSpace($t)) { $candidates.Add($t + ' [' + $pn + ']') }
+  if ($appFilter -eq '') {
+    if (-not $win -and $focusedWin -and $w.Current.NativeWindowHandle -eq $focusedWin.Current.NativeWindowHandle) {
+      $win = $w
+    } elseif (-not $win -and -not [string]::IsNullOrWhiteSpace($t)) {
+      $win = $w
+    }
+    continue
+  }
+  # A process/class hit beats a title that merely mentions the app (a browser tab
+  # titled "...QQ..." must not shadow the real QQ window).
+  if (-not $byProc -and ((XrkMatch $pn $appFilter) -or (XrkMatch $cn $appFilter))) { $byProc = $w }
+  if (-not $byTitle -and (XrkMatch $t $appFilter)) { $byTitle = $w }
+}
+if ($appFilter -ne '' -and -not $win) {
+  if ($focusedWin) {
+    $ft = ''
+    try { $ft = $focusedWin.Current.Name } catch {}
+    $fpn = XrkProcName $focusedWin.Current.ProcessId
+    if ((XrkMatch $fpn $appFilter) -or (XrkMatch $ft $appFilter)) { $win = $focusedWin }
+  }
+  if (-not $win) { $win = $byProc }
+  if (-not $win) { $win = $byTitle }
+}
+if (-not $win) {
+  @{ error = 'app-not-found'; app = ''; windowTitle = ''; elements = @(); candidates = $candidates } | ConvertTo-Json -Depth 6 -Compress
+  return
+}
+
+$title = ''
+try { $title = $win.Current.Name } catch {}
+$targetPid = $win.Current.ProcessId
+$appLabel = XrkProcName $targetPid
+if ([string]::IsNullOrWhiteSpace($appLabel)) { $appLabel = $title }
+
+$elements = New-Object System.Collections.Generic.List[object]
+$seen = New-Object System.Collections.Generic.HashSet[string]
+$queue = New-Object System.Collections.Generic.Queue[object]
+$queue.Enqueue(@{ el = $win; d = 0 })
+$idx = 0
+$visited = 0
+$dropped = 0
+$exhausted = $true
+while ($queue.Count -gt 0 -and $idx -lt $max -and $visited -lt $visitCap) {
+  $item = $queue.Dequeue()
+  $el = $item.el
+  $depth = $item.d
+  $visited++
+  $rid = ''
+  try { $rid = ($el.GetRuntimeId() -join ',') } catch {}
+  if ($rid -ne '' -and -not $seen.Add($rid)) { continue }
+  $ct = ''
+  try { $ct = $el.Current.ControlType.ProgrammaticName } catch {}
+  $name = ''
+  try { $name = $el.Current.Name } catch {}
+  # Always expand (bounded by depth): gating expansion on $depth -gt 0 meant the
+  # root window never yielded children and every capture came back empty.
+  if ($depth -lt $maxDepth) {
+    try {
+      $child = $walker.GetFirstChild($el)
+      $guard = 0
+      while ($child -and $guard -lt 500 -and ($visited + $guard) -lt $visitCap) {
+        $queue.Enqueue(@{ el = $child; d = ($depth + 1) })
+        $guard++
+        $child = $walker.GetNextSibling($child)
+      }
+    } catch { $dropped++ }
+  }
+  try {
+    if ($el.Current.ProcessId -ne $targetPid) { continue }
+    $role = ($ct -replace '^ControlType\\.','')
+    if ($depth -eq 0) { continue }
+    if (($role -eq 'Window' -or $role -eq 'Pane') -and [string]::IsNullOrWhiteSpace($name)) { continue }
+    $r = $el.Current.BoundingRectangle
+    $x = XrkSafeInt $r.X
+    $y = XrkSafeInt $r.Y
+    $wd = XrkSafeInt $r.Width
+    $ht = XrkSafeInt $r.Height
+    $offscreen = ($null -eq $x -or $null -eq $y -or $null -eq $wd -or $null -eq $ht -or $wd -le 0 -or $ht -le 0)
+    if ($offscreen -and -not $keepOffscreen) { continue }
+    if ([string]::IsNullOrWhiteSpace($name) -and [string]::IsNullOrWhiteSpace($role)) { continue }
+    $idx++
+    $display = $name
+    if ([string]::IsNullOrWhiteSpace($display)) { $display = $ct }
+    $elements.Add([pscustomobject]@{
+      index = $idx
+      role = $role
+      name = $display
+      x = $x; y = $y; width = $wd; height = $ht
+      runtimeId = $rid
+    })
+  } catch { $dropped++ }
+}
+if ($queue.Count -gt 0 -and $visited -ge $visitCap) { $exhausted = $false }
+
+$screenshotBase64 = ''
+$screenshotError = ''
+if ($includeScreenshot) {
+  try {
+    Add-Type -AssemblyName System.Drawing
+    $br = $win.Current.BoundingRectangle
+    $sx = XrkSafeInt $br.X
+    $sy = XrkSafeInt $br.Y
+    $sw = XrkSafeInt $br.Width
+    $sh = XrkSafeInt $br.Height
+    if ($null -eq $sx -or $null -eq $sy -or $null -eq $sw -or $null -eq $sh -or $sw -le 0 -or $sh -le 0) {
+      $screenshotError = 'window has no on-screen bounds for screenshot'
+    } else {
+      $maxW = 1280; $maxH = 720
+      $scale = [Math]::Min(1.0, [Math]::Min(($maxW / [double]$sw), ($maxH / [double]$sh)))
+      $dw = [Math]::Max(1, [int][Math]::Round($sw * $scale))
+      $dh = [Math]::Max(1, [int][Math]::Round($sh * $scale))
+      $src = New-Object System.Drawing.Bitmap $sw, $sh
+      $gs = [System.Drawing.Graphics]::FromImage($src)
+      $gs.CopyFromScreen($sx, $sy, 0, 0, (New-Object System.Drawing.Size($sw, $sh)))
+      $gs.Dispose()
+      $bmp = $src
+      if ($scale -lt 1.0) {
+        $bmp = New-Object System.Drawing.Bitmap $dw, $dh
+        $g = [System.Drawing.Graphics]::FromImage($bmp)
+        $g.DrawImage($src, 0, 0, $dw, $dh)
+        $g.Dispose()
+        $src.Dispose()
+      }
+      if ($annotateSom) {
+        $g2 = [System.Drawing.Graphics]::FromImage($bmp)
+        $font = New-Object System.Drawing.Font 'Consolas', 10, ([System.Drawing.FontStyle]::Bold)
+        $fill = New-Object System.Drawing.SolidBrush ([System.Drawing.Color]::FromArgb(220, 255, 220, 0))
+        $ink = New-Object System.Drawing.SolidBrush ([System.Drawing.Color]::Black)
+        foreach ($e in $elements) {
+          if ($null -eq $e.x -or $null -eq $e.y) { continue }
+          $lx = [int][Math]::Round(($e.x - $sx) * $scale)
+          $ly = [int][Math]::Round(($e.y - $sy) * $scale)
+          if ($lx -lt 0 -or $ly -lt 0 -or $lx -gt $dw -or $ly -gt $dh) { continue }
+          $label = [string]$e.index
+          $g2.FillRectangle($fill, $lx, $ly, 18, 14)
+          $g2.DrawString($label, $font, $ink, $lx, $ly)
+        }
+        $g2.Dispose(); $font.Dispose(); $fill.Dispose(); $ink.Dispose()
+      }
+      $ms = New-Object System.IO.MemoryStream
+      $bmp.Save($ms, [System.Drawing.Imaging.ImageFormat]::Png)
+      $screenshotBase64 = [Convert]::ToBase64String($ms.ToArray())
+      $ms.Dispose(); $bmp.Dispose()
+    }
+  } catch {
+    $screenshotError = $_.Exception.Message
+  }
+}
+
+@{
+  app = $appLabel
+  windowTitle = $title
+  elements = $elements
+  visited = $visited
+  dropped = $dropped
+  exhausted = $exhausted
+  screenshotBase64 = $screenshotBase64
+  screenshotError = $screenshotError
+} | ConvertTo-Json -Depth 6 -Compress
 `.trim();
 }
 /** Re-resolve an element by runtime id; Invoke → Select → focus + mouse click. */
 function clickScript(runtimeId) {
     const idLit = psStr(runtimeId);
-    return `${PS_PRELUDE}
-$ids = @((${idLit}) -split ',' | ForEach-Object { [int]$_ })
-$el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
-if (-not $el) { throw 'element not found (window changed? capture again)' }
-$inv = $null
-if ($el.TryGetCurrentPattern([System.Windows.Automation.InvokePattern]::Pattern, [ref]$inv)) {
-  $inv.Invoke()
-  'clicked-invoke'
-  return
-}
-$sel = $null
-if ($el.TryGetCurrentPattern([System.Windows.Automation.SelectionItemPattern]::Pattern, [ref]$sel)) {
-  $sel.Select()
-  'clicked-select'
-  return
-}
-$box = $el.Current.BoundingRectangle
-if ($null -eq (XrkSafeInt $box.X) -or $null -eq (XrkSafeInt $box.Y)) {
-  throw 'element is not invokable via UIA and has no on-screen bounds to click'
-}
-Add-Type -AssemblyName System.Windows.Forms
-Add-Type -AssemblyName System.Drawing
-Add-Type @"
-using System;
-using System.Runtime.InteropServices;
-public static class XrkClick {
-  [DllImport("user32.dll")] public static extern bool SetCursorPos(int x, int y);
-  [DllImport("user32.dll")] public static extern void mouse_event(uint f, uint dx, uint dy, int data, UIntPtr extra);
-  public const uint LEFTDOWN = 0x0002;
-  public const uint LEFTUP = 0x0004;
-}
-"@
-try { $el.SetFocus() } catch {}
-Start-Sleep -Milliseconds 40
-$r = $el.Current.BoundingRectangle
-$x = XrkSafeInt ($r.X + $r.Width / 2)
-$y = XrkSafeInt ($r.Y + $r.Height / 2)
-[void][XrkClick]::SetCursorPos($x, $y)
-[void][XrkClick]::mouse_event([XrkClick]::LEFTDOWN, 0, 0, 0, [UIntPtr]::Zero)
-Start-Sleep -Milliseconds 30
-[void][XrkClick]::mouse_event([XrkClick]::LEFTUP, 0, 0, 0, [UIntPtr]::Zero)
-'clicked-point'
+    return `${PS_PRELUDE}
+$ids = @((${idLit}) -split ',' | ForEach-Object { [int]$_ })
+$el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
+if (-not $el) { throw 'element not found (window changed? capture again)' }
+$inv = $null
+if ($el.TryGetCurrentPattern([System.Windows.Automation.InvokePattern]::Pattern, [ref]$inv)) {
+  $inv.Invoke()
+  'clicked-invoke'
+  return
+}
+$sel = $null
+if ($el.TryGetCurrentPattern([System.Windows.Automation.SelectionItemPattern]::Pattern, [ref]$sel)) {
+  $sel.Select()
+  'clicked-select'
+  return
+}
+$box = $el.Current.BoundingRectangle
+if ($null -eq (XrkSafeInt $box.X) -or $null -eq (XrkSafeInt $box.Y)) {
+  throw 'element is not invokable via UIA and has no on-screen bounds to click'
+}
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+public static class XrkClick {
+  [DllImport("user32.dll")] public static extern bool SetCursorPos(int x, int y);
+  [DllImport("user32.dll")] public static extern void mouse_event(uint f, uint dx, uint dy, int data, UIntPtr extra);
+  public const uint LEFTDOWN = 0x0002;
+  public const uint LEFTUP = 0x0004;
+}
+"@
+try { $el.SetFocus() } catch {}
+Start-Sleep -Milliseconds 40
+$r = $el.Current.BoundingRectangle
+$x = XrkSafeInt ($r.X + $r.Width / 2)
+$y = XrkSafeInt ($r.Y + $r.Height / 2)
+[void][XrkClick]::SetCursorPos($x, $y)
+[void][XrkClick]::mouse_event([XrkClick]::LEFTDOWN, 0, 0, 0, [UIntPtr]::Zero)
+Start-Sleep -Milliseconds 30
+[void][XrkClick]::mouse_event([XrkClick]::LEFTUP, 0, 0, 0, [UIntPtr]::Zero)
+'clicked-point'
 `.trim();
 }
 /** Absolute screen-pixel click (Codex vision path when no AX element). */
 function clickCoordinateScript(x, y) {
-    return `${PS_PRELUDE}
-Add-Type @"
-using System;
-using System.Runtime.InteropServices;
-public static class XrkClickAt {
-  [DllImport("user32.dll")] public static extern bool SetCursorPos(int x, int y);
-  [DllImport("user32.dll")] public static extern void mouse_event(uint f, uint dx, uint dy, int data, UIntPtr extra);
-  public const uint LEFTDOWN = 0x0002;
-  public const uint LEFTUP = 0x0004;
-}
-"@
-$x = ${Math.trunc(x)}
-$y = ${Math.trunc(y)}
-[void][XrkClickAt]::SetCursorPos($x, $y)
-[void][XrkClickAt]::mouse_event([XrkClickAt]::LEFTDOWN, 0, 0, 0, [UIntPtr]::Zero)
-Start-Sleep -Milliseconds 30
-[void][XrkClickAt]::mouse_event([XrkClickAt]::LEFTUP, 0, 0, 0, [UIntPtr]::Zero)
-"clicked-coordinate:$x,$y"
+    return `${PS_PRELUDE}
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+public static class XrkClickAt {
+  [DllImport("user32.dll")] public static extern bool SetCursorPos(int x, int y);
+  [DllImport("user32.dll")] public static extern void mouse_event(uint f, uint dx, uint dy, int data, UIntPtr extra);
+  public const uint LEFTDOWN = 0x0002;
+  public const uint LEFTUP = 0x0004;
+}
+"@
+$x = ${Math.trunc(x)}
+$y = ${Math.trunc(y)}
+[void][XrkClickAt]::SetCursorPos($x, $y)
+[void][XrkClickAt]::mouse_event([XrkClickAt]::LEFTDOWN, 0, 0, 0, [UIntPtr]::Zero)
+Start-Sleep -Milliseconds 30
+[void][XrkClickAt]::mouse_event([XrkClickAt]::LEFTUP, 0, 0, 0, [UIntPtr]::Zero)
+"clicked-coordinate:$x,$y"
 `.trim();
 }
 /**
@@ -408,124 +408,124 @@ function typeScript(runtimeId, text) {
     const idLit = psStr(runtimeId);
     const textLit = psStr(text);
     const keysLit = psStr(escapeSendKeys(text));
-    return `${PS_PRELUDE}
-Add-Type -AssemblyName System.Windows.Forms
-$text = ${textLit}
-$escaped = ${keysLit}
-$ids = @((${idLit}) -split ',' | ForEach-Object { [int]$_ })
-$el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
-if (-not $el) { throw 'element not found (window changed? capture again)' }
-$val = $null
-if ($el.TryGetCurrentPattern([System.Windows.Automation.ValuePattern]::Pattern, [ref]$val)) {
-  try {
-    if (-not $val.Current.IsReadOnly) {
-      $val.SetValue($text)
-      'typed-value'
-      return
-    }
-  } catch {}
-}
-try { $el.SetFocus() } catch {}
-Start-Sleep -Milliseconds 40
-$pasted = $false
-$old = $null
-$clipReadable = $false
-try { $old = Get-Clipboard -ErrorAction Stop; $clipReadable = $true } catch {
-  try { $old = Get-Clipboard -Raw -ErrorAction Stop; $clipReadable = $true } catch {}
-}
-try {
-  Set-Clipboard -Value $text
-  [System.Windows.Forms.SendKeys]::SendWait('^v')
-  Start-Sleep -Milliseconds 30
-  $pasted = $true
-} catch {}
-if ($pasted -and $clipReadable) {
-  try {
-    if ($null -ne $old) { Set-Clipboard -Value ($old -join [Environment]::NewLine) } else { Set-Clipboard -Value '' }
-  } catch {}
-}
-if ($pasted) { 'typed-paste' } else {
-  [System.Windows.Forms.SendKeys]::SendWait($escaped)
-  'typed-sendkeys'
-}
+    return `${PS_PRELUDE}
+Add-Type -AssemblyName System.Windows.Forms
+$text = ${textLit}
+$escaped = ${keysLit}
+$ids = @((${idLit}) -split ',' | ForEach-Object { [int]$_ })
+$el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
+if (-not $el) { throw 'element not found (window changed? capture again)' }
+$val = $null
+if ($el.TryGetCurrentPattern([System.Windows.Automation.ValuePattern]::Pattern, [ref]$val)) {
+  try {
+    if (-not $val.Current.IsReadOnly) {
+      $val.SetValue($text)
+      'typed-value'
+      return
+    }
+  } catch {}
+}
+try { $el.SetFocus() } catch {}
+Start-Sleep -Milliseconds 40
+$pasted = $false
+$old = $null
+$clipReadable = $false
+try { $old = Get-Clipboard -ErrorAction Stop; $clipReadable = $true } catch {
+  try { $old = Get-Clipboard -Raw -ErrorAction Stop; $clipReadable = $true } catch {}
+}
+try {
+  Set-Clipboard -Value $text
+  [System.Windows.Forms.SendKeys]::SendWait('^v')
+  Start-Sleep -Milliseconds 30
+  $pasted = $true
+} catch {}
+if ($pasted -and $clipReadable) {
+  try {
+    if ($null -ne $old) { Set-Clipboard -Value ($old -join [Environment]::NewLine) } else { Set-Clipboard -Value '' }
+  } catch {}
+}
+if ($pasted) { 'typed-paste' } else {
+  [System.Windows.Forms.SendKeys]::SendWait($escaped)
+  'typed-sendkeys'
+}
 `.trim();
 }
 function keyScript(keysSendWait, runtimeId) {
     const keysLit = psStr(keysSendWait);
     const focusBlock = runtimeId
-        ? `
-$ids = @((${psStr(runtimeId)}) -split ',' | ForEach-Object { [int]$_ })
-$el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
-if (-not $el) { throw 'element not found (window changed? capture again)' }
-try { $el.SetFocus() } catch {}
-Start-Sleep -Milliseconds 40
+        ? `
+$ids = @((${psStr(runtimeId)}) -split ',' | ForEach-Object { [int]$_ })
+$el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
+if (-not $el) { throw 'element not found (window changed? capture again)' }
+try { $el.SetFocus() } catch {}
+Start-Sleep -Milliseconds 40
 `
         : "";
-    return `${PS_PRELUDE}${focusBlock}Add-Type -AssemblyName System.Windows.Forms
-[System.Windows.Forms.SendKeys]::SendWait(${keysLit})
-'keyed'
+    return `${PS_PRELUDE}${focusBlock}Add-Type -AssemblyName System.Windows.Forms
+[System.Windows.Forms.SendKeys]::SendWait(${keysLit})
+'keyed'
 `.trim();
 }
 function scrollScript(options) {
     const amount = Math.max(1, Math.min(50, Math.floor(options.amount)));
     const dir = options.direction;
     const idLit = options.runtimeId ? psStr(options.runtimeId) : "''";
-    return `${PS_PRELUDE}
-Add-Type -AssemblyName System.Windows.Forms
-Add-Type -AssemblyName System.Drawing
-$dir = ${psStr(dir)}
-$amount = ${amount}
-$runtimeId = ${idLit}
-$el = $null
-if ($runtimeId -ne '') {
-  $ids = @(($runtimeId) -split ',' | ForEach-Object { [int]$_ })
-  $el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
-  if (-not $el) { throw 'element not found (window changed? capture again)' }
-}
-if ($el) {
-  $scroll = $null
-  if ($el.TryGetCurrentPattern([System.Windows.Automation.ScrollPattern]::Pattern, [ref]$scroll)) {
-    $horiz = [System.Windows.Automation.ScrollAmount]::NoAmount
-    $vert = [System.Windows.Automation.ScrollAmount]::NoAmount
-    $large = [System.Windows.Automation.ScrollAmount]::LargeIncrement
-    $largeNeg = [System.Windows.Automation.ScrollAmount]::LargeDecrement
-    $small = [System.Windows.Automation.ScrollAmount]::SmallIncrement
-    $smallNeg = [System.Windows.Automation.ScrollAmount]::SmallDecrement
-    for ($i = 0; $i -lt $amount; $i++) {
-      if ($dir -eq 'down') { $vert = $large }
-      elseif ($dir -eq 'up') { $vert = $largeNeg }
-      elseif ($dir -eq 'right') { $horiz = $small }
-      elseif ($dir -eq 'left') { $horiz = $smallNeg }
-      $scroll.Scroll($horiz, $vert)
-    }
-    'scrolled-pattern'
-    return
-  }
-  try { $el.SetFocus() } catch {}
-  Start-Sleep -Milliseconds 40
-  $r = $el.Current.BoundingRectangle
-  $x = XrkSafeInt ($r.X + $r.Width / 2)
-  $y = XrkSafeInt ($r.Y + $r.Height / 2)
-  if ($null -ne $x -and $null -ne $y) {
-    [System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point($x, $y)
-  }
-}
-Add-Type @"
-using System;
-using System.Runtime.InteropServices;
-public static class XrkMouseWheel {
-  [DllImport("user32.dll")]
-  public static extern void mouse_event(uint dwFlags, uint dx, uint dy, int dwData, UIntPtr dwExtraInfo);
-  public const uint MOUSEEVENTF_WHEEL = 0x0800;
-  public const uint MOUSEEVENTF_HWHEEL = 0x01000;
-}
-"@
-$delta = 120 * $amount
-if ($dir -eq 'down' -or $dir -eq 'right') { $delta = -$delta }
-$flags = [XrkMouseWheel]::MOUSEEVENTF_WHEEL
-if ($dir -eq 'left' -or $dir -eq 'right') { $flags = [XrkMouseWheel]::MOUSEEVENTF_HWHEEL }
-[XrkMouseWheel]::mouse_event($flags, 0, 0, $delta, [UIntPtr]::Zero)
-'scrolled-wheel'
+    return `${PS_PRELUDE}
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+$dir = ${psStr(dir)}
+$amount = ${amount}
+$runtimeId = ${idLit}
+$el = $null
+if ($runtimeId -ne '') {
+  $ids = @(($runtimeId) -split ',' | ForEach-Object { [int]$_ })
+  $el = [System.Windows.Automation.AutomationElement]::AutomationElementFromRuntimeId($ids)
+  if (-not $el) { throw 'element not found (window changed? capture again)' }
+}
+if ($el) {
+  $scroll = $null
+  if ($el.TryGetCurrentPattern([System.Windows.Automation.ScrollPattern]::Pattern, [ref]$scroll)) {
+    $horiz = [System.Windows.Automation.ScrollAmount]::NoAmount
+    $vert = [System.Windows.Automation.ScrollAmount]::NoAmount
+    $large = [System.Windows.Automation.ScrollAmount]::LargeIncrement
+    $largeNeg = [System.Windows.Automation.ScrollAmount]::LargeDecrement
+    $small = [System.Windows.Automation.ScrollAmount]::SmallIncrement
+    $smallNeg = [System.Windows.Automation.ScrollAmount]::SmallDecrement
+    for ($i = 0; $i -lt $amount; $i++) {
+      if ($dir -eq 'down') { $vert = $large }
+      elseif ($dir -eq 'up') { $vert = $largeNeg }
+      elseif ($dir -eq 'right') { $horiz = $small }
+      elseif ($dir -eq 'left') { $horiz = $smallNeg }
+      $scroll.Scroll($horiz, $vert)
+    }
+    'scrolled-pattern'
+    return
+  }
+  try { $el.SetFocus() } catch {}
+  Start-Sleep -Milliseconds 40
+  $r = $el.Current.BoundingRectangle
+  $x = XrkSafeInt ($r.X + $r.Width / 2)
+  $y = XrkSafeInt ($r.Y + $r.Height / 2)
+  if ($null -ne $x -and $null -ne $y) {
+    [System.Windows.Forms.Cursor]::Position = New-Object System.Drawing.Point($x, $y)
+  }
+}
+Add-Type @"
+using System;
+using System.Runtime.InteropServices;
+public static class XrkMouseWheel {
+  [DllImport("user32.dll")]
+  public static extern void mouse_event(uint dwFlags, uint dx, uint dy, int dwData, UIntPtr dwExtraInfo);
+  public const uint MOUSEEVENTF_WHEEL = 0x0800;
+  public const uint MOUSEEVENTF_HWHEEL = 0x01000;
+}
+"@
+$delta = 120 * $amount
+if ($dir -eq 'down' -or $dir -eq 'right') { $delta = -$delta }
+$flags = [XrkMouseWheel]::MOUSEEVENTF_WHEEL
+if ($dir -eq 'left' -or $dir -eq 'right') { $flags = [XrkMouseWheel]::MOUSEEVENTF_HWHEEL }
+[XrkMouseWheel]::mouse_event($flags, 0, 0, $delta, [UIntPtr]::Zero)
+'scrolled-wheel'
 `.trim();
 }
 /**
@@ -535,21 +535,21 @@ if ($dir -eq 'left' -or $dir -eq 'right') { $flags = [XrkMouseWheel]::MOUSEEVENT
  * "Argument types do not match".
  */
 function listWindowsScript() {
-    return `${PS_PRELUDE}
-$root = [System.Windows.Automation.AutomationElement]::RootElement
-$cond = New-Object System.Windows.Automation.PropertyCondition(
-  [System.Windows.Automation.AutomationElement]::ControlTypeProperty,
-  [System.Windows.Automation.ControlType]::Window)
-$wins = $root.FindAll([System.Windows.Automation.TreeScope]::Children, $cond)
-$list = New-Object System.Collections.Generic.List[object]
-foreach ($w in $wins) {
-  $n = ''
-  try { $n = $w.Current.Name } catch {}
-  $proc = XrkProcName $w.Current.ProcessId
-  if ([string]::IsNullOrWhiteSpace($n) -and [string]::IsNullOrWhiteSpace($proc)) { continue }
-  $list.Add([pscustomobject]@{ title = $n; pid = $w.Current.ProcessId; app = $proc })
-}
-@{ windows = $list } | ConvertTo-Json -Depth 5 -Compress
+    return `${PS_PRELUDE}
+$root = [System.Windows.Automation.AutomationElement]::RootElement
+$cond = New-Object System.Windows.Automation.PropertyCondition(
+  [System.Windows.Automation.AutomationElement]::ControlTypeProperty,
+  [System.Windows.Automation.ControlType]::Window)
+$wins = $root.FindAll([System.Windows.Automation.TreeScope]::Children, $cond)
+$list = New-Object System.Collections.Generic.List[object]
+foreach ($w in $wins) {
+  $n = ''
+  try { $n = $w.Current.Name } catch {}
+  $proc = XrkProcName $w.Current.ProcessId
+  if ([string]::IsNullOrWhiteSpace($n) -and [string]::IsNullOrWhiteSpace($proc)) { continue }
+  $list.Add([pscustomobject]@{ title = $n; pid = $w.Current.ProcessId; app = $proc })
+}
+@{ windows = $list } | ConvertTo-Json -Depth 5 -Compress
 `.trim();
 }
 function finite(...values) {