@mseep/clawdcursor 1.5.5

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@mseep/clawdcursor",
+  "version": "1.5.5",
+  "mcpName": "io.github.AmrDab/clawdcursor",
+  "description": "Local MCP server that gives any AI agent safe cross-OS desktop control \u2014 the fallback execution layer for when APIs, CLIs, and direct integrations aren't available. Works with any tool-calling model (Claude, GPT, Gemini, Llama) on Windows, macOS, and Linux. Open source (MIT).",
+  "homepage": "https://clawdcursor.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AmrDab/clawdcursor.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AmrDab/clawdcursor/issues"
+  },
+  "author": "Amr Dabbas",
+  "keywords": [
+    "agent",
+    "ai-agent",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "desktop-automation",
+    "computer-use",
+    "gui-automation",
+    "accessibility",
+    "claude",
+    "gpt",
+    "openai",
+    "anthropic",
+    "skill",
+    "cli",
+    "mseep"
+  ],
+  "bin": {
+    "clawdcursor": "dist/surface/cli.js"
+  },
+  "files": [
+    "dist/",
+    "scripts/verify-install.js",
+    "scripts/postinstall-native.js",
+    "scripts/sync-version.ts",
+    "scripts/*.ps1",
+    "scripts/mac/",
+    "scripts/linux/",
+    "native/build.sh",
+    "native/Package.swift",
+    "native/Sources/",
+    "native/entitlements.plist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "SKILL.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/verify-install.js || node -e \"process.exit(0)\" && node scripts/postinstall-native.js || node -e \"process.exit(0)\"",
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "prepare": "npm run clean && tsc && node dist/postbuild.js",
+    "prebuild": "npm run clean",
+    "build": "tsc && node dist/postbuild.js",
+    "setup": "node scripts/verify-install.js && npm run build && node -e \"if(process.platform==='darwin'){const{execSync}=require('child_process');try{execSync('chmod +x native/build.sh && native/build.sh',{stdio:'inherit'})}catch(e){console.error('\\n\u274c Native build failed. Run manually: cd native && ./build.sh');process.exit(1)}}\" && npm link --force",
+    "postbuild:msg": "handled by postbuild.js",
+    "dev": "tsx watch src/surface/cli.ts",
+    "start": "node dist/surface/cli.js agent",
+    "stop": "node dist/surface/cli.js stop",
+    "doctor": "node dist/surface/cli.js doctor",
+    "lint": "eslint src/",
+    "test": "vitest",
+    "test:ci": "vitest run",
+    "test:mcp-schema-snapshot": "tsx scripts/build-mcp-schema.ts",
+    "test:mcp-schema-snapshot:update": "tsx scripts/build-mcp-schema.ts --write",
+    "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc --noEmit -p tsconfig.tests.json",
+    "sync-version": "tsx scripts/sync-version.ts",
+    "version": "tsx scripts/sync-version.ts && git add SKILL.md docs/index.html docs/install.sh docs/install.ps1",
+    "test:coverage": "vitest run --coverage",
+    "perf:smoke": "tsx scripts/perf-smoke.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@nut-tree-fork/nut-js": "^4.2.0",
+    "commander": "^15.0.0",
+    "croner": "^10.0.1",
+    "dotenv": "^17.4.2",
+    "express": "^5.2.1",
+    "picocolors": "^1.1.1",
+    "playwright": "^1.60.0",
+    "sharp": "^0.34.5",
+    "ws": "^8.21.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.9.2",
+    "@types/supertest": "^7.2.0",
+    "@types/ws": "^8.5.0",
+    "@typescript-eslint/eslint-plugin": "^8.60.1",
+    "@typescript-eslint/parser": "^8.60.1",
+    "@vitest/coverage-v8": "^4.1.8",
+    "eslint": "^10.4.1",
+    "supertest": "^7.2.2",
+    "tsx": "^4.22.4",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.8"
+  },
+  "overrides": {
+    "ip-address": "10.1.1",
+    "brace-expansion": "5.0.6"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "license": "MIT",
+  "publisher": "mseep"
+}

package/scripts/banner.ps1

@@ -0,0 +1,112 @@
+# banner.ps1 — "ClawdCursor — desktop control in progress" indicator.
+#
+# A small, always-on-top, borderless pill at the top-center of the primary
+# screen with a blinking red "recording" dot. Shown by the daemon while an
+# agent is actively driving the desktop, so a human at the machine ALWAYS
+# knows automation is live (transparency requirement — same spirit as the
+# labeled agent browser window).
+#
+# Interaction contract with the parent (src/core/banner.ts):
+#   - Parent spawns:  powershell -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File banner.ps1
+#   - DOUBLE-CLICK anywhere on the banner → prints "BANNER_STOP" on stdout and
+#     exits; the parent reacts by running the `clawdcursor stop` flow
+#     (abort in-flight task + graceful daemon shutdown).
+#   - Parent kills this process to hide the banner.
+#
+# CRITICAL: the window must NEVER steal focus — it appears WHILE the agent is
+# typing/clicking, and an activating window would redirect those keystrokes
+# (the exact focus-theft bug class fixed in v1.5.1). WS_EX_NOACTIVATE +
+# ShowWithoutActivation make it a zero-focus overlay; clicks still reach it.
+
+$ErrorActionPreference = 'Stop'
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+Add-Type -ReferencedAssemblies System.Windows.Forms, System.Drawing -TypeDefinition @'
+using System;
+using System.Windows.Forms;
+
+public class NoActivateBannerForm : Form {
+    // Never take focus when shown…
+    protected override bool ShowWithoutActivation { get { return true; } }
+    // …or when clicked. WS_EX_NOACTIVATE (0x08000000) + WS_EX_TOPMOST (0x8).
+    protected override CreateParams CreateParams {
+        get {
+            CreateParams p = base.CreateParams;
+            p.ExStyle |= 0x08000000; // WS_EX_NOACTIVATE
+            p.ExStyle |= 0x00000008; // WS_EX_TOPMOST
+            return p;
+        }
+    }
+}
+'@
+
+$form = New-Object NoActivateBannerForm
+$form.FormBorderStyle = 'None'
+$form.ShowInTaskbar   = $false
+$form.TopMost         = $true
+$form.StartPosition   = 'Manual'
+$form.BackColor       = [System.Drawing.Color]::FromArgb(18, 18, 26)
+$form.Size            = New-Object System.Drawing.Size(430, 40)
+
+# Top-center of the primary screen, 8px below the edge.
+$screen = [System.Windows.Forms.Screen]::PrimaryScreen.WorkingArea
+$form.Location = New-Object System.Drawing.Point(
+    [int]($screen.X + ($screen.Width - $form.Width) / 2), [int]($screen.Y + 8))
+
+# Rounded pill region.
+$gp = New-Object System.Drawing.Drawing2D.GraphicsPath
+$r = 18; $w = $form.Width; $h = $form.Height
+$gp.AddArc(0, 0, $r*2, $r*2, 180, 90)
+$gp.AddArc($w - $r*2, 0, $r*2, $r*2, 270, 90)
+$gp.AddArc($w - $r*2, $h - $r*2, $r*2, $r*2, 0, 90)
+$gp.AddArc(0, $h - $r*2, $r*2, $r*2, 90, 90)
+$gp.CloseFigure()
+$form.Region = New-Object System.Drawing.Region($gp)
+
+$dot = New-Object System.Windows.Forms.Label
+$dot.Text      = [char]0x25CF  # ●
+$dot.Font      = New-Object System.Drawing.Font('Segoe UI', 14, [System.Drawing.FontStyle]::Bold)
+$dot.ForeColor = [System.Drawing.Color]::FromArgb(255, 59, 48)
+$dot.BackColor = [System.Drawing.Color]::Transparent
+$dot.AutoSize  = $true
+$dot.Location  = New-Object System.Drawing.Point(14, 5)
+
+$text = New-Object System.Windows.Forms.Label
+$text.Text      = 'ClawdCursor '  # brand
+$text.Font      = New-Object System.Drawing.Font('Segoe UI Semibold', 10)
+$text.ForeColor = [System.Drawing.Color]::White
+$text.BackColor = [System.Drawing.Color]::Transparent
+$text.AutoSize  = $true
+$text.Location  = New-Object System.Drawing.Point(40, 10)
+
+$sub = New-Object System.Windows.Forms.Label
+$sub.Text      = 'desktop control in progress  -  double-click to stop'
+$sub.Font      = New-Object System.Drawing.Font('Segoe UI', 9)
+$sub.ForeColor = [System.Drawing.Color]::FromArgb(170, 170, 185)
+$sub.BackColor = [System.Drawing.Color]::Transparent
+$sub.AutoSize  = $true
+$sub.Location  = New-Object System.Drawing.Point(133, 11)
+
+$form.Controls.AddRange(@($dot, $text, $sub))
+
+# Recording blink — bright/dim every 600ms.
+$timer = New-Object System.Windows.Forms.Timer
+$timer.Interval = 600
+$bright = $true
+$timer.Add_Tick({
+    $script:bright = -not $script:bright
+    if ($script:bright) { $dot.ForeColor = [System.Drawing.Color]::FromArgb(255, 59, 48) }
+    else                { $dot.ForeColor = [System.Drawing.Color]::FromArgb(110, 25, 20) }
+})
+$timer.Start()
+
+$stopHandler = {
+    [Console]::Out.WriteLine('BANNER_STOP')
+    [Console]::Out.Flush()
+    $form.Close()
+}
+$form.Add_MouseDoubleClick($stopHandler)
+foreach ($c in @($dot, $text, $sub)) { $c.Add_MouseDoubleClick($stopHandler) }
+
+[System.Windows.Forms.Application]::Run($form)

package/scripts/coord-accuracy.ps1

@@ -0,0 +1,140 @@
+# Direct-drive coordinate accuracy test against the running daemon.
+# No `clawdcursor agent` loop, no LLM in the path - just MCP tool calls.
+#
+# What it proves:
+#  1. read_screen reports element bounds at logical coords.
+#  2. mouse_click on those coords lands on the element (focus shifts to it).
+#  3. invoke_element clicks the right thing without coord math at all.
+#  4. The values returned by find_element + the get_screen_size scale factor
+#     agree end-to-end across DPI.
+
+param([int]$Port = 3847)
+
+$token = (Get-Content "$env:USERPROFILE\.clawdcursor\token" -Raw).Trim()
+$base  = "http://127.0.0.1:$Port/mcp"
+$hdrs  = @{
+  "Authorization" = "Bearer $token"
+  "Accept"        = "application/json, text/event-stream"
+}
+
+function Call-Tool {
+  param([string]$Name, [hashtable]$Arguments = @{})
+  $body = (@{ jsonrpc="2.0"; id=1; method="tools/call"; params=@{ name=$Name; arguments=$Arguments } } | ConvertTo-Json -Depth 10 -Compress)
+  try {
+    $r = Invoke-WebRequest -Uri $base -Method POST -Headers $hdrs -ContentType "application/json" -Body $body -UseBasicParsing -TimeoutSec 15
+    if ($r.Content -match '(?s)data:\s*(\{.*\})') {
+      return ($matches[1] | ConvertFrom-Json)
+    }
+    return ($r.Content | ConvertFrom-Json)
+  } catch { return @{ error = @{ message = $_.Exception.Message } } }
+}
+
+function Tool-Text {
+  param($r)
+  if ($r.error)        { return "ERROR: $($r.error.message)" }
+  if ($r.result.content) { return ($r.result.content | ForEach-Object { $_.text }) -join "`n" }
+  return ($r | ConvertTo-Json -Depth 5 -Compress)
+}
+
+Write-Host ""
+Write-Host "============================================"
+Write-Host " Coordinate accuracy test"
+Write-Host "============================================"
+
+# A) Screen / scale baseline
+$ssR = Call-Tool "get_screen_size"
+$ss  = Tool-Text $ssR
+Write-Host ""
+Write-Host "[A] get_screen_size:"
+Write-Host "    $ss"
+
+# B) Open Notepad fresh (clean Win32, no ApplicationFrameHost UWP wrapper)
+$null = Call-Tool "open_app" @{ name = "Notepad" }
+Start-Sleep -Seconds 2
+$null = Call-Tool "focus_window" @{ title = "Notepad" }
+Start-Sleep -Milliseconds 500
+
+# C) Read the a11y tree, find the Text editor element bounds
+$treeR = Call-Tool "read_screen"
+$tree  = Tool-Text $treeR
+Write-Host ""
+Write-Host "[B] Notepad a11y bounds (look for [Edit] / Text editor lines):"
+$tree -split "`n" | Where-Object { $_ -match "Text editor|Edit|Document" } | Select-Object -First 5 | ForEach-Object { Write-Host "    $_" }
+
+# Extract the Edit bounds. Format example:
+#   [Edit] "Text editor" id:... @122,200 1200x600
+$editLine = ($tree -split "`n") | Where-Object { $_ -match "@\d+,\d+\s+\d+x\d+.*Text editor|Text editor.*@\d+,\d+" } | Select-Object -First 1
+if (-not $editLine) {
+  $editLine = ($tree -split "`n") | Where-Object { $_ -match "\[Edit\]" } | Select-Object -First 1
+}
+Write-Host ""
+Write-Host "[C] Picked editor line:"
+Write-Host "    $editLine"
+
+if ($editLine -match "@(\d+),(\d+)\s+(\d+)x(\d+)") {
+  $ex = [int]$matches[1]; $ey = [int]$matches[2]
+  $ew = [int]$matches[3]; $eh = [int]$matches[4]
+  $cx = $ex + [int]($ew / 2)
+  $cy = $ey + [int]($eh / 2)
+  Write-Host ""
+  Write-Host "[D] Edit center calc: ($cx, $cy)   bounds @($ex,$ey) ${ew}x${eh}"
+
+  # D1) Click via raw coords - verify focus moves to the Edit
+  $null = Call-Tool "mouse_click" @{ x = $cx; y = $cy }
+  Start-Sleep -Milliseconds 400
+  $focusR = Call-Tool "get_focused_element"
+  $focus  = Tool-Text $focusR
+  Write-Host ""
+  Write-Host "[E] After mouse_click($cx,$cy) - focused element:"
+  Write-Host "    $focus"
+  $isEditFocused = ($focus -match "Edit|Text editor|Document|RichEdit")
+  if ($isEditFocused) {
+    Write-Host "    PASS  raw coordinate click landed in the editor" -ForegroundColor Green
+  } else {
+    Write-Host "    FAIL  raw coordinate click did NOT focus the editor" -ForegroundColor Red
+  }
+
+  # D2) Now type a marker - if focus is right, it appears in the doc
+  $marker = "COORD_TEST_$([int](Get-Random -Maximum 99999))"
+  $null = Call-Tool "type_text" @{ text = $marker }
+  Start-Sleep -Milliseconds 400
+  $tree2 = Tool-Text (Call-Tool "read_screen")
+  $contained = ($tree2 -match [regex]::Escape($marker))
+  Write-Host ""
+  Write-Host "[F] type_text('$marker') -> tree contains marker: $contained"
+  if ($contained) {
+    Write-Host "    PASS  raw click + type was end-to-end correct" -ForegroundColor Green
+  } else {
+    Write-Host "    FAIL  marker not found in tree" -ForegroundColor Red
+  }
+} else {
+  Write-Host "    Could not parse bounds from editor line - skipping coord test" -ForegroundColor Yellow
+}
+
+# E) Title bar buttons: Minimize sits at a known position on every Win32 window.
+#    Use it to test edge-of-window coord accuracy without actually minimizing.
+$minLine = ($tree -split "`n") | Where-Object { $_ -match "\[Button\] `"Minimize" } | Select-Object -First 1
+if ($minLine -match "@(\d+),(\d+)\s+(\d+)x(\d+)") {
+  $mx = [int]$matches[1] + [int]([int]$matches[3] / 2)
+  $my = [int]$matches[2] + [int]([int]$matches[4] / 2)
+  Write-Host ""
+  Write-Host "[G] Minimize button center: ($mx, $my) - HOVER ONLY (no click)"
+  # Hover, then read the focused window - if hover landed there, the tooltip
+  # area would update but the focused element should not (hover != click).
+  $null = Call-Tool "mouse_hover" @{ x = $mx; y = $my }
+  Start-Sleep -Milliseconds 250
+  Write-Host "    (hover dispatched; visible verification is the tooltip you may see)"
+}
+
+Write-Host ""
+Write-Host "============================================"
+Write-Host " Limitations probed:"
+Write-Host "============================================"
+Write-Host "  - DPI scaling: get_screen_size already prints the scaleFactor."
+Write-Host "  - UWP offset (Calculator): the wrapped ApplicationFrameHost"
+Write-Host "    case is tested separately - this run focuses on plain Win32."
+Write-Host "  - Multi-monitor: not exercised here. read_screen reports virtual"
+Write-Host "    desktop coords; off-primary-monitor accuracy needs a multi-mon"
+Write-Host "    box to validate."
+Write-Host "  - Negative coords (left-of-primary monitor): same as above."
+Write-Host ""

package/scripts/coord-uwp.ps1

@@ -0,0 +1,80 @@
+param([int]$Port = 3847)
+
+$token = (Get-Content "$env:USERPROFILE\.clawdcursor\token" -Raw).Trim()
+$base  = "http://127.0.0.1:$Port/mcp"
+$hdrs  = @{
+  "Authorization" = "Bearer $token"
+  "Accept"        = "application/json, text/event-stream"
+}
+
+function Call-Tool {
+  param([string]$Name, [hashtable]$Arguments = @{})
+  $body = (@{ jsonrpc="2.0"; id=1; method="tools/call"; params=@{ name=$Name; arguments=$Arguments } } | ConvertTo-Json -Depth 10 -Compress)
+  try {
+    $r = Invoke-WebRequest -Uri $base -Method POST -Headers $hdrs -ContentType "application/json" -Body $body -UseBasicParsing -TimeoutSec 15
+    if ($r.Content -match '(?s)data:\s*(\{.*\})') { return ($matches[1] | ConvertFrom-Json) }
+    return ($r.Content | ConvertFrom-Json)
+  } catch { return @{ error = @{ message = $_.Exception.Message } } }
+}
+
+function Tool-Text {
+  param($r)
+  if ($r.error) { return "ERROR: $($r.error.message)" }
+  if ($r.result.content) { return ($r.result.content | ForEach-Object { $_.text }) -join "`n" }
+  return ($r | ConvertTo-Json -Depth 5 -Compress)
+}
+
+Write-Host ""
+Write-Host "============================================"
+Write-Host " UWP (Calculator + ApplicationFrameHost)"
+Write-Host " Raw coordinate click test - no invoke_element shortcut"
+Write-Host "============================================"
+
+$null = Call-Tool "open_app" @{ name = "Calculator" }
+Start-Sleep -Seconds 2
+$null = Call-Tool "focus_window" @{ title = "Calculator" }
+Start-Sleep -Milliseconds 500
+
+# Clear the display first via invoke (known good)
+$null = Call-Tool "invoke_element" @{ name = "Clear" }
+Start-Sleep -Milliseconds 250
+
+$tree = Tool-Text (Call-Tool "read_screen")
+
+# Parse coords for Two, Plus, Three, Equals
+$want = @("Two","Plus","Three","Equals")
+$coords = @{}
+foreach ($n in $want) {
+  # Lines look like:  [Button] "Two" id:num2Button @171,489 77x51
+  $line = ($tree -split "`n") | Where-Object { $_ -match "\[Button\]\s+`"$n`"" } | Select-Object -First 1
+  if ($line -match "@(\d+),(\d+)\s+(\d+)x(\d+)") {
+    $bx = [int]$matches[1]; $by = [int]$matches[2]
+    $bw = [int]$matches[3]; $bh = [int]$matches[4]
+    $coords[$n] = @{ x = $bx + [int]($bw/2); y = $by + [int]($bh/2); raw = "$bx,$by ${bw}x$bh" }
+    Write-Host "[parse] $n bounds: $($coords[$n].raw)  -> center ($($coords[$n].x),$($coords[$n].y))"
+  } else {
+    Write-Host "[parse] $n NOT FOUND in tree" -ForegroundColor Red
+  }
+}
+
+Write-Host ""
+Write-Host "[click] Driving 2 + 3 = via mouse_click only (no invoke_element):"
+foreach ($n in $want) {
+  if ($coords.ContainsKey($n)) {
+    $r = Call-Tool "mouse_click" @{ x = $coords[$n].x; y = $coords[$n].y }
+    Write-Host "  mouse_click $n @ ($($coords[$n].x),$($coords[$n].y)) -> $(Tool-Text $r)"
+    Start-Sleep -Milliseconds 200
+  }
+}
+
+Start-Sleep -Milliseconds 400
+$treeAfter = Tool-Text (Call-Tool "read_screen")
+if ($treeAfter -match "Display is (\d+)") {
+  Write-Host ""
+  Write-Host ">>> Display shows: $($matches[1])"
+  if ($matches[1] -eq "5") {
+    Write-Host "    PASS  UWP raw-coord click chain produced correct result" -ForegroundColor Green
+  } else {
+    Write-Host "    FAIL  UWP raw-coord click chain produced WRONG result" -ForegroundColor Red
+  }
+}

package/scripts/edge-glow.ps1

@@ -0,0 +1,180 @@
+# edge-glow.ps1 — "task in progress" screen-edge glow.
+#
+# A full-screen, CLICK-THROUGH, never-activating overlay that draws a soft glow
+# on all four screen edges and pulses it dim<->bright while clawdcursor is
+# driving the desktop. Spawned/killed by src/core/banner.ts in lockstep with the
+# control-banner pill (pin() on task start, unpin()/idle to hide) — it runs
+# ALONGSIDE the pill, which keeps the double-click-to-stop affordance.
+#
+# Why a per-pixel-alpha layered window (UpdateLayeredWindow) and not a plain
+# WinForms paint + TransparencyKey: a color key can only knock out ONE exact
+# color, so a soft inward fade can't be made click-through cleanly. Per-pixel
+# alpha gives a real soft glow AND a fully click-through interior in one shot.
+#
+# Extended window styles (mirrors banner.ps1's zero-focus contract, plus
+# click-through — critical: it is up WHILE the agent types/clicks):
+#   WS_EX_LAYERED      0x00080000  per-pixel alpha compositing
+#   WS_EX_TRANSPARENT  0x00000020  click-through (input falls to the app below)
+#   WS_EX_NOACTIVATE   0x08000000  never steals focus (agent keeps typing)
+#   WS_EX_TOOLWINDOW   0x00000080  no taskbar / alt-tab entry
+#   WS_EX_TOPMOST      0x00000008  stays above normal windows
+#
+# Defaults are production: amber, persistent (runs until the parent kills it).
+# For a manual DEMO, pass -DurationSec so it self-closes, e.g.:
+#   powershell -NoProfile -ExecutionPolicy Bypass -File edge-glow.ps1 -DurationSec 12
+#
+# Windows-only today, same as the banner. macOS/Linux overlays are a follow-up.
+
+param(
+    [string]$Color       = '#f59e0b',  # glow color (amber — "in progress")
+    [int]   $Thickness   = 80,         # px depth the glow fades in from each edge
+    [int]   $PeriodMs    = 1600,       # full dim->bright->dim cycle
+    [int]   $MinAlpha    = 60,         # dim floor (0-255); lower = dims more
+    [int]   $PeakAlpha   = 200,        # per-pixel alpha at the very edge (0-255)
+    [int]   $DurationSec = 0           # 0 = run until killed; >0 = self-close (demo)
+)
+
+$ErrorActionPreference = 'Stop'
+Add-Type -AssemblyName System.Windows.Forms
+Add-Type -AssemblyName System.Drawing
+
+Add-Type -ReferencedAssemblies System.Windows.Forms, System.Drawing -TypeDefinition @'
+using System;
+using System.Drawing;
+using System.Runtime.InteropServices;
+using System.Windows.Forms;
+
+public class GlowOverlay : Form {
+    protected override bool ShowWithoutActivation { get { return true; } }
+    protected override CreateParams CreateParams {
+        get {
+            CreateParams cp = base.CreateParams;
+            cp.ExStyle |= 0x00080000; // WS_EX_LAYERED
+            cp.ExStyle |= 0x00000020; // WS_EX_TRANSPARENT (click-through)
+            cp.ExStyle |= 0x08000000; // WS_EX_NOACTIVATE
+            cp.ExStyle |= 0x00000080; // WS_EX_TOOLWINDOW
+            cp.ExStyle |= 0x00000008; // WS_EX_TOPMOST
+            return cp;
+        }
+    }
+
+    [DllImport("user32.dll")] static extern IntPtr GetDC(IntPtr hWnd);
+    [DllImport("user32.dll")] static extern int ReleaseDC(IntPtr hWnd, IntPtr hDC);
+    [DllImport("gdi32.dll")]  static extern IntPtr CreateCompatibleDC(IntPtr hDC);
+    [DllImport("gdi32.dll")]  static extern bool DeleteDC(IntPtr hdc);
+    [DllImport("gdi32.dll")]  static extern IntPtr SelectObject(IntPtr hdc, IntPtr h);
+    [DllImport("gdi32.dll")]  static extern bool DeleteObject(IntPtr ho);
+    [DllImport("user32.dll")] static extern bool UpdateLayeredWindow(
+        IntPtr hwnd, IntPtr hdcDst, ref POINT pptDst, ref SIZE psize,
+        IntPtr hdcSrc, ref POINT pptSrc, int crKey, ref BLENDFUNCTION pblend, int dwFlags);
+
+    [StructLayout(LayoutKind.Sequential)] public struct POINT { public int X, Y; public POINT(int x,int y){X=x;Y=y;} }
+    [StructLayout(LayoutKind.Sequential)] public struct SIZE  { public int cx, cy; public SIZE(int x,int y){cx=x;cy=y;} }
+    [StructLayout(LayoutKind.Sequential, Pack=1)] public struct BLENDFUNCTION {
+        public byte BlendOp, BlendFlags, SourceConstantAlpha, AlphaFormat;
+    }
+
+    IntPtr screenDc, memDc, hBitmap, oldBitmap;
+    Bitmap bmp;
+
+    public void SetBitmap(Bitmap b) {
+        bmp = b;
+        screenDc  = GetDC(IntPtr.Zero);
+        memDc     = CreateCompatibleDC(screenDc);
+        hBitmap   = b.GetHbitmap(Color.FromArgb(0)); // ARGB DIB for ULW
+        oldBitmap = SelectObject(memDc, hBitmap);
+    }
+
+    // Re-push the same bitmap with a new global alpha → smooth pulse.
+    public void Push(byte alpha) {
+        if (bmp == null) return;
+        SIZE size = new SIZE(bmp.Width, bmp.Height);
+        POINT src = new POINT(0, 0);
+        POINT dst = new POINT(this.Left, this.Top);
+        BLENDFUNCTION blend = new BLENDFUNCTION();
+        blend.BlendOp = 0;              // AC_SRC_OVER
+        blend.BlendFlags = 0;
+        blend.SourceConstantAlpha = alpha;
+        blend.AlphaFormat = 1;          // AC_SRC_ALPHA
+        UpdateLayeredWindow(this.Handle, screenDc, ref dst, ref size, memDc, ref src, 0, ref blend, 2); // ULW_ALPHA
+    }
+
+    public void Cleanup() {
+        if (memDc    != IntPtr.Zero) SelectObject(memDc, oldBitmap);
+        if (hBitmap  != IntPtr.Zero) { DeleteObject(hBitmap); hBitmap = IntPtr.Zero; }
+        if (memDc    != IntPtr.Zero) { DeleteDC(memDc); memDc = IntPtr.Zero; }
+        if (screenDc != IntPtr.Zero) { ReleaseDC(IntPtr.Zero, screenDc); screenDc = IntPtr.Zero; }
+    }
+}
+'@
+
+# ── Parse color ──
+$hex = $Color.TrimStart('#')
+$cr  = [Convert]::ToInt32($hex.Substring(0,2),16)
+$cg  = [Convert]::ToInt32($hex.Substring(2,2),16)
+$cb  = [Convert]::ToInt32($hex.Substring(4,2),16)
+
+# ── Cover the primary screen ──
+$scr = [System.Windows.Forms.Screen]::PrimaryScreen.Bounds
+$W   = $scr.Width
+$H   = $scr.Height
+$T   = [Math]::Min($Thickness, [Math]::Min([int]($W/2), [int]($H/2)))
+
+# ── Render the edge glow into an ARGB bitmap once ──
+$bmp = New-Object System.Drawing.Bitmap($W, $H, [System.Drawing.Imaging.PixelFormat]::Format32bppArgb)
+$g   = [System.Drawing.Graphics]::FromImage($bmp)
+$g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
+$g.Clear([System.Drawing.Color]::FromArgb(0,0,0,0))
+
+$edge = [System.Drawing.Color]::FromArgb($PeakAlpha, $cr, $cg, $cb)
+$fade = [System.Drawing.Color]::FromArgb(0,           $cr, $cg, $cb)
+$P    = [System.Drawing.Point]
+function New-Band($p1, $p2, $colorAt1, $colorAt2, $rect) {
+    $br = New-Object System.Drawing.Drawing2D.LinearGradientBrush($p1, $p2, $colorAt1, $colorAt2)
+    $br.WrapMode = [System.Drawing.Drawing2D.WrapMode]::TileFlipXY
+    $g.FillRectangle($br, $rect)
+    $br.Dispose()
+}
+# Corners deliberately overlap (additive glow pooling).
+New-Band (New-Object $P 0,0)        (New-Object $P 0,$T)        $edge $fade (New-Object Drawing.Rectangle 0,0,$W,$T)          # top
+New-Band (New-Object $P 0,($H-$T))  (New-Object $P 0,$H)        $fade $edge (New-Object Drawing.Rectangle 0,($H-$T),$W,$T)    # bottom
+New-Band (New-Object $P 0,0)        (New-Object $P $T,0)        $edge $fade (New-Object Drawing.Rectangle 0,0,$T,$H)          # left
+New-Band (New-Object $P ($W-$T),0)  (New-Object $P $W,0)        $fade $edge (New-Object Drawing.Rectangle ($W-$T),0,$T,$H)    # right
+$g.Dispose()
+
+# ── Build the overlay window ──
+$form = New-Object GlowOverlay
+$form.FormBorderStyle = 'None'
+$form.ShowInTaskbar   = $false
+$form.TopMost         = $true
+$form.StartPosition   = 'Manual'
+$form.Bounds          = $scr
+
+$startTicks = [Environment]::TickCount
+
+$form.Add_Shown({
+    $form.SetBitmap($bmp)
+    $form.Push([byte]$MinAlpha)
+})
+
+# Pulse: cosine ease between MinAlpha and 255 (smooth dim<->bright).
+$pulse = New-Object System.Windows.Forms.Timer
+$pulse.Interval = 30
+$pulse.Add_Tick({
+    $elapsed = [Environment]::TickCount - $startTicks
+    if ($DurationSec -gt 0 -and $elapsed -ge ($DurationSec * 1000)) {
+        $pulse.Stop()
+        $form.Cleanup()
+        $form.Close()
+        return
+    }
+    $phase = ($elapsed % $PeriodMs) / [double]$PeriodMs
+    $wave  = (1 - [Math]::Cos($phase * 2 * [Math]::PI)) / 2     # 0->1->0
+    $alpha = [int]($MinAlpha + ($wave * (255 - $MinAlpha)))
+    if ($alpha -lt 0) { $alpha = 0 } elseif ($alpha -gt 255) { $alpha = 255 }
+    $form.Push([byte]$alpha)
+})
+$pulse.Start()
+
+[System.Windows.Forms.Application]::Run($form)
+$bmp.Dispose()