@erica-s/ai-agent-notify 2.1.5

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@erica-s/ai-agent-notify",
+  "version": "2.1.5",
+  "description": "Windows Toast notifications for Claude Code and Codex",
+  "bin": {
+    "ai-agent-notify": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "scripts/",
+    "assets/",
+    ".published",
+    "postinstall.js"
+  ],
+  "scripts": {
+    "prepublishOnly": "node -e \"require('fs').writeFileSync('.published', JSON.stringify({version: require('./package.json').version, date: new Date().toISOString()}))\"",
+    "postpack": "node -e \"require('fs').rmSync('.published', {force:true})\"",
+    "postinstall": "node postinstall.js",
+    "test": "node test/test-cli.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "codex",
+    "notification",
+    "toast",
+    "windows",
+    "hooks"
+  ],
+  "author": "EricaLi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EricaLi123/ai-tools.git",
+    "directory": "packages/ai-agent-notify"
+  },
+  "engines": {
+    "node": ">=16"
+  }
+}

package/postinstall.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+if (process.platform !== "win32") {
+  process.exit(0);
+}
+
+const { execFileSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const tasks = [
+  {
+    kind: "powershell",
+    path: path.join(__dirname, "scripts", "register-protocol.ps1"),
+    warning: "ai-agent-notify: protocol registration skipped (non-fatal)",
+  },
+];
+
+for (const task of tasks) {
+  try {
+    if (task.kind === "powershell") {
+      execFileSync(
+        "powershell",
+        ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", task.path],
+        { stdio: "inherit" }
+      );
+      continue;
+    }
+
+    execFileSync("node", [task.path], { stdio: "inherit" });
+  } catch {
+    console.warn(task.warning);
+  }
+}
+
+try {
+  installCodexNotifyWrapper();
+} catch {
+  console.warn("ai-agent-notify: Codex wrapper install skipped (non-fatal)");
+}
+
+function installCodexNotifyWrapper() {
+  const localAppData = process.env.LOCALAPPDATA;
+  if (!localAppData) {
+    throw new Error("LOCALAPPDATA is not set");
+  }
+
+  const targetDir = path.join(localAppData, "ai-agent-notify");
+  const sourcePath = path.join(__dirname, "scripts", "codex-notify-wrapper.vbs");
+  const targetPath = path.join(targetDir, "codex-notify-wrapper.vbs");
+
+  fs.mkdirSync(targetDir, { recursive: true });
+  fs.copyFileSync(sourcePath, targetPath);
+}

package/scripts/activate-window.ps1

@@ -0,0 +1,26 @@
+# 激活窗口脚本 - 由 ai-agent-notify 协议处理器调用
+# 参数: 协议 URL，格式为 erica-s.ai-agent-notify.activate-window://<窗口句柄>
+
+$url = $args[0]
+$handleString = $url -replace '^[^:]+://', '' -replace '[/\\"]', ''
+$handleString = $handleString.Trim()
+if (-not $handleString) { exit 1 }
+try {
+    $handleInt = [long]$handleString
+    $hwnd = [IntPtr]$handleInt
+} catch { exit 1 }
+
+Add-Type -TypeDefinition @"
+using System;
+using System.Runtime.InteropServices;
+public class WinAPI {
+    [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);
+    [DllImport("user32.dll")] public static extern bool ShowWindow(IntPtr hWnd, int nCmdShow);
+    [DllImport("user32.dll")] public static extern bool IsWindow(IntPtr hWnd);
+    [DllImport("user32.dll")] public static extern bool IsIconic(IntPtr hWnd);
+}
+"@ -ErrorAction SilentlyContinue
+
+if (-not [WinAPI]::IsWindow($hwnd)) { exit 1 }
+if ([WinAPI]::IsIconic($hwnd)) { [WinAPI]::ShowWindow($hwnd, 9) | Out-Null }
+[WinAPI]::SetForegroundWindow($hwnd) | Out-Null

package/scripts/activate-window.vbs

@@ -0,0 +1,13 @@
+' VBScript wrapper to completely hide PowerShell window
+' When invoked via URL protocol, this script runs PowerShell without any window flash
+
+Dim shell, scriptPath, psCommand
+
+Set shell = CreateObject("WScript.Shell")
+
+' Get the directory where this script is located
+scriptPath = Replace(WScript.ScriptFullName, WScript.ScriptName, "")
+psCommand = "powershell.exe -NoProfile -WindowStyle Hidden -ExecutionPolicy Bypass -File """ & scriptPath & "activate-window.ps1"" """ & WScript.Arguments(0) & """"
+
+' Run with window style 0 = completely hidden
+shell.Run psCommand, 0, False

package/scripts/codex-notify-wrapper.vbs

@@ -0,0 +1,29 @@
+Option Explicit
+
+Dim shell
+Dim env
+Dim command
+Dim comspec
+Dim exitCode
+Dim payload
+
+If WScript.Arguments.Count < 1 Then
+    WScript.Quit 1
+End If
+
+payload = WScript.Arguments.Item(0)
+
+Set shell = CreateObject("WScript.Shell")
+Set env = shell.Environment("Process")
+comspec = shell.ExpandEnvironmentStrings("%ComSpec%")
+
+env("AI_AGENT_NOTIFY_PAYLOAD") = payload
+command = comspec & " /d /c ai-agent-notify.cmd"
+exitCode = shell.Run(command, 0, True)
+If exitCode = 9009 Then
+    command = comspec & " /d /c npx.cmd @erica-s/ai-agent-notify"
+    exitCode = shell.Run(command, 0, True)
+End If
+env("AI_AGENT_NOTIFY_PAYLOAD") = ""
+
+WScript.Quit exitCode

package/scripts/find-hwnd.ps1

@@ -0,0 +1,144 @@
+# 从指定 PID 向上遍历父进程链，输出第一个有窗口 handle 的进程的 hwnd。
+# 由 cli.js 在 spawn notify.ps1 之前调用，结果通过 TOAST_NOTIFY_HWND 环境变量传入。
+# -IncludeShellPid 启用时，输出格式为 hwnd|shellPid|isWindowsTerminal(1/0)
+param([int]$StartPid, [switch]$IncludeShellPid)
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+Add-Type -TypeDefinition @'
+using System;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+public class PH {
+    [DllImport("kernel32.dll", SetLastError=true)]
+    static extern IntPtr CreateToolhelp32Snapshot(uint f, uint p);
+    [DllImport("kernel32.dll")]
+    static extern bool Process32First(IntPtr h, ref PE e);
+    [DllImport("kernel32.dll")]
+    static extern bool Process32Next(IntPtr h, ref PE e);
+    [DllImport("kernel32.dll")]
+    static extern bool CloseHandle(IntPtr h);
+    [StructLayout(LayoutKind.Sequential, CharSet=CharSet.Auto)]
+    public struct PE {
+        public uint sz, u, pid; public IntPtr heap;
+        public uint mod, thr, ppid; public int pri; public uint fl;
+        [MarshalAs(UnmanagedType.ByValTStr, SizeConst=260)] public string exe;
+    }
+    public static Dictionary<int,int> Map() {
+        var m = new Dictionary<int,int>();
+        IntPtr s = CreateToolhelp32Snapshot(2, 0);
+        PE e = new PE(); e.sz = (uint)System.Runtime.InteropServices.Marshal.SizeOf(e);
+        if (Process32First(s, ref e)) do { m[(int)e.pid] = (int)e.ppid; } while (Process32Next(s, ref e));
+        CloseHandle(s);
+        return m;
+    }
+}
+'@ 2>$null
+
+$map = [PH]::Map()
+$cur = $StartPid
+$shellPid = 0
+$isWindowsTerminal = $false
+$shellNames = @('bash','powershell','pwsh','cmd','zsh','fish')
+$wtNames = @('WindowsTerminal','OpenConsole')
+
+[Console]::Error.WriteLine("find-hwnd: StartPid=$StartPid IncludeShellPid=$IncludeShellPid")
+for ($i = 0; $i -lt 50; $i++) {
+    try {
+        $p = Get-Process -Id $cur -ErrorAction Stop
+        $pName = $p.ProcessName
+        [Console]::Error.WriteLine("find-hwnd: depth=$i pid=$cur name=$pName hwnd=$($p.MainWindowHandle)")
+        # 记录最近的 shell 进程 PID。
+        # 不取“第一个 shell”，因为全局命令经常会经过短命的 cmd/volta 包装层；
+        # watcher 需要附着到离终端最近、仍然存活的交互 shell。
+        if ($IncludeShellPid -and $shellNames -contains $pName) {
+            $shellPid = $cur
+            [Console]::Error.WriteLine("find-hwnd: shellPid=$shellPid")
+        }
+        # 检测 Windows Terminal
+        if ($IncludeShellPid -and -not $isWindowsTerminal -and $wtNames -contains $pName) {
+            $isWindowsTerminal = $true
+            [Console]::Error.WriteLine("find-hwnd: isWindowsTerminal=true (detected $pName)")
+        }
+        if ($p.MainWindowHandle -ne 0) {
+            [Console]::Error.WriteLine("find-hwnd: found hwnd=$($p.MainWindowHandle)")
+            if ($IncludeShellPid) {
+                $wtFlag = if ($isWindowsTerminal) { '1' } else { '0' }
+                Write-Output "$($p.MainWindowHandle)|$shellPid|$wtFlag"
+            } else {
+                Write-Output $p.MainWindowHandle
+            }
+            exit
+        }
+    } catch {
+        [Console]::Error.WriteLine("find-hwnd: depth=$i pid=$cur dead")
+    }
+    if (-not $map.ContainsKey($cur) -or $map[$cur] -eq 0) {
+        [Console]::Error.WriteLine("find-hwnd: chain broken at pid=$cur")
+        break
+    }
+    $cur = $map[$cur]
+}
+# Fallback: VSCode/Cursor integrated terminal injects VSCODE_GIT_IPC_HANDLE,
+# a named pipe owned by the specific editor instance. Use GetNamedPipeServerProcessId
+# to get the exact owner PID without any process-name guessing.
+if ($env:VSCODE_GIT_IPC_HANDLE) {
+    [Console]::Error.WriteLine("find-hwnd: trying VSCODE_GIT_IPC_HANDLE=$($env:VSCODE_GIT_IPC_HANDLE)")
+    try {
+        Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+using Microsoft.Win32.SafeHandles;
+public class PipeHelper {
+    [DllImport("kernel32.dll", CharSet=CharSet.Auto, SetLastError=true)]
+    static extern SafeFileHandle CreateFile(
+        string lpFileName, uint dwDesiredAccess, uint dwShareMode,
+        IntPtr securityAttributes, uint dwCreationDisposition,
+        uint dwFlagsAndAttributes, IntPtr hTemplateFile);
+    [DllImport("kernel32.dll", SetLastError=true)]
+    static extern bool GetNamedPipeServerProcessId(SafeHandle hPipe, out uint ServerProcessId);
+    public static int GetServerPid(string pipeName) {
+        // GENERIC_READ|GENERIC_WRITE=0xC0000000, FILE_SHARE_READ|WRITE=3, OPEN_EXISTING=3
+        SafeFileHandle h = CreateFile(pipeName, 0xC0000000, 3, IntPtr.Zero, 3, 0, IntPtr.Zero);
+        if (h.IsInvalid) return -1;
+        try { uint pid = 0; return GetNamedPipeServerProcessId(h, out pid) ? (int)pid : -1; }
+        finally { h.Close(); }
+    }
+}
+'@ -ErrorAction Stop
+        $serverPid = [PipeHelper]::GetServerPid($env:VSCODE_GIT_IPC_HANDLE)
+        [Console]::Error.WriteLine("find-hwnd: pipe server pid=$serverPid")
+        if ($serverPid -gt 0) {
+            $cur = $serverPid
+            for ($i = 0; $i -lt 10; $i++) {
+                try {
+                    $p = Get-Process -Id $cur -ErrorAction Stop
+                    [Console]::Error.WriteLine("find-hwnd: pipe-chain depth=$i pid=$cur name=$($p.ProcessName) hwnd=$($p.MainWindowHandle)")
+                    if ($p.MainWindowHandle -ne 0) {
+                        [Console]::Error.WriteLine("find-hwnd: found via pipe hwnd=$($p.MainWindowHandle)")
+                        if ($IncludeShellPid) {
+                            $wtFlag = if ($isWindowsTerminal) { '1' } else { '0' }
+                            Write-Output "$($p.MainWindowHandle)|$shellPid|$wtFlag"
+                        } else {
+                            Write-Output $p.MainWindowHandle
+                        }
+                        exit
+                    }
+                } catch {
+                    [Console]::Error.WriteLine("find-hwnd: pipe-chain depth=$i pid=$cur dead")
+                }
+                if (-not $map.ContainsKey($cur) -or $map[$cur] -eq 0) { break }
+                $cur = $map[$cur]
+            }
+        }
+    } catch {
+        [Console]::Error.WriteLine("find-hwnd: pipe approach failed: $_")
+    }
+}
+[Console]::Error.WriteLine("find-hwnd: not found, returning 0")
+if ($IncludeShellPid) {
+    $wtFlag = if ($isWindowsTerminal) { '1' } else { '0' }
+    Write-Output "0|$shellPid|$wtFlag"
+} else {
+    Write-Output 0
+}

package/scripts/get-shell-pid.ps1

@@ -0,0 +1,69 @@
+param([int]$StartPid)
+
+$ErrorActionPreference = 'SilentlyContinue'
+
+Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+
+public class ConsoleProcList {
+    [DllImport("kernel32.dll", SetLastError=true)]
+    public static extern uint GetConsoleProcessList(uint[] processList, uint processCount);
+}
+'@ 2>$null
+
+$shellNames = @('bash', 'powershell', 'pwsh', 'cmd', 'zsh', 'fish')
+
+function Write-DebugLine($msg) {
+    [Console]::Error.WriteLine("get-shell-pid: $msg")
+}
+
+Write-DebugLine("StartPid=$StartPid")
+
+$size = 16
+$buffer = New-Object uint[] $size
+$count = [ConsoleProcList]::GetConsoleProcessList($buffer, $size)
+if ($count -gt $size) {
+    $size = [int]$count
+    $buffer = New-Object uint[] $size
+    $count = [ConsoleProcList]::GetConsoleProcessList($buffer, $size)
+}
+
+if ($count -le 0) {
+    Write-DebugLine("GetConsoleProcessList failed")
+    Write-Output 0
+    exit
+}
+
+$consolePids = @($buffer[0..($count - 1)] | Where-Object { $_ -gt 0 })
+Write-DebugLine("console pids=$($consolePids -join ',')")
+
+$candidates = foreach ($pid in $consolePids) {
+    if ($pid -eq $StartPid) { continue }
+    try {
+        $proc = Get-Process -Id $pid -ErrorAction Stop
+        Write-DebugLine("candidate pid=$pid name=$($proc.ProcessName) start=$($proc.StartTime.ToString('o'))")
+        if ($shellNames -contains $proc.ProcessName) {
+            [PSCustomObject]@{
+                Id = $proc.Id
+                Name = $proc.ProcessName
+                StartTime = $proc.StartTime
+            }
+        }
+    } catch {
+        Write-DebugLine("candidate pid=$pid dead")
+    }
+}
+
+$selected = $candidates |
+    Sort-Object StartTime, Id |
+    Select-Object -First 1
+
+if ($selected) {
+    Write-DebugLine("selected shell pid=$($selected.Id) name=$($selected.Name)")
+    Write-Output $selected.Id
+    exit
+}
+
+Write-DebugLine("no shell candidate found")
+Write-Output 0

package/scripts/notify.ps1

@@ -0,0 +1,193 @@
+# Notification Script — Native WinRT Toast (zero module dependencies)
+# Toast fires FIRST (fast), then window detection + flash (slower)
+#
+# All hook data (event, session_id, log file path, hwnd) is passed via environment
+# variables by cli.js, which reads stdin once before spawning this script.
+
+# log 路径由 cli.js 计算并传入
+$LogFile = $env:TOAST_NOTIFY_LOG_FILE
+function Write-Log($msg) {
+    $line = "[$(Get-Date -Format 'yyyy-MM-ddTHH:mm:ss.fff')] [ps1 pid=$PID] $msg"
+    [Console]::Error.WriteLine($line)
+    try { Add-Content -LiteralPath $LogFile -Value $line -Encoding UTF8 } catch {}
+}
+
+Write-Log "started"
+
+# isDev 由 cli.js 通过环境变量传入
+$isDev = $env:TOAST_NOTIFY_IS_DEV -ne "0"
+$source = if ($env:TOAST_NOTIFY_SOURCE) { $env:TOAST_NOTIFY_SOURCE } else { '' }
+
+# 1. 从 cli.js 传入的环境变量确定通知标题和内容
+$eventName = if ($env:TOAST_NOTIFY_EVENT) { $env:TOAST_NOTIFY_EVENT } else { '' }
+$baseTitle = if ($env:TOAST_NOTIFY_TITLE) { $env:TOAST_NOTIFY_TITLE } else { '' }
+$message = if ($env:TOAST_NOTIFY_MESSAGE) { $env:TOAST_NOTIFY_MESSAGE } else { '' }
+
+if (-not $baseTitle) {
+    switch ($eventName) {
+        'Stop' {
+            $baseTitle = 'Done'
+        }
+        'PermissionRequest' {
+            $baseTitle = 'Needs Approval'
+        }
+        default {
+            $baseTitle = 'Notification'
+        }
+    }
+}
+
+if (-not $message) {
+    switch ($eventName) {
+        'Stop' {
+            $message = 'Task finished'
+        }
+        'PermissionRequest' {
+            $message = 'Waiting for your approval'
+        }
+        default {
+            $message = 'Notification'
+        }
+    }
+}
+
+if ($source) {
+    $Title = "[$source] $baseTitle"
+} else {
+    $Title = $baseTitle
+}
+$Message = $message
+Write-Log "source=$source event=$eventName title=$Title message=$Message"
+
+# 2. 窗口检测
+$hwnd            = $null
+$terminalName    = 'Terminal'
+$terminalExePath = $null
+
+# 3a. 优先使用 cli.js 预先找好的 hwnd（通过 find-hwnd.ps1 在 Node 侧查父链得到）。
+# 这样可以绕过 MSYS2 断链问题：git bash 里 PowerShell 自身的父链走不到编辑器窗口，
+# 但 Node → cmd → Claude Code Node → Code.exe 这条链在 Node 侧是完整的。
+if ($env:TOAST_NOTIFY_HWND) {
+    $hwnd = [IntPtr][long]$env:TOAST_NOTIFY_HWND
+    try {
+        $proc = Get-Process -Id (Get-Process | Where-Object { $_.MainWindowHandle -eq $hwnd } | Select-Object -First 1 -ExpandProperty Id) -ErrorAction Stop
+        $terminalName    = if ($proc.Product) { $proc.Product } elseif ($proc.Description) { $proc.Description } else { $proc.ProcessName }
+        $terminalExePath = $proc.Path
+    } catch {}
+    Write-Log "hwnd from cli.js: $hwnd terminal=$terminalName exe=$terminalExePath"
+}
+
+Write-Log "hwnd=$hwnd terminal=$terminalName"
+
+# 合成通知图标：底层 exe 图标 + 上层静态符号 PNG
+# 缓存到 scripts/icons-cache/{hookName}-{exeSlug}.png，npm install 重建包目录时随之清空
+function Get-NotifyIcon($hookName, $exePath) {
+    $staticIcon = [System.IO.Path]::GetFullPath([System.IO.Path]::Combine($PSScriptRoot, "..", "assets", "icons", "$hookName.png"))
+    if (-not ($exePath -and (Test-Path $exePath))) { return $staticIcon }
+
+    $exeSlug  = [System.IO.Path]::GetFileNameWithoutExtension($exePath).ToLower()
+    $cacheDir = [System.IO.Path]::GetFullPath([System.IO.Path]::Combine($PSScriptRoot, "..", ".cache"))
+    $iconPath = [System.IO.Path]::Combine($cacheDir, "$hookName-$exeSlug.png")
+    if (-not (Test-Path $cacheDir)) { New-Item -ItemType Directory -Path $cacheDir | Out-Null }
+    if (Test-Path $iconPath) { return $iconPath }
+
+    try {
+        Add-Type -AssemblyName System.Drawing -ErrorAction Stop
+        $bmp = [System.Drawing.Bitmap]::new(48, 48)
+        $g   = [System.Drawing.Graphics]::FromImage($bmp)
+        $g.InterpolationMode = [System.Drawing.Drawing2D.InterpolationMode]::HighQualityBicubic
+        $g.Clear([System.Drawing.Color]::Transparent)
+
+        # 底层：exe 图标铺满画布
+        $appIcon = [System.Drawing.Icon]::ExtractAssociatedIcon($exePath)
+        if ($appIcon) {
+            $appBmp = $appIcon.ToBitmap()
+            $appIcon.Dispose()
+            $g.DrawImage($appBmp, [System.Drawing.Rectangle]::new(0, 0, 48, 48))
+            $appBmp.Dispose()
+        }
+
+        # 上层：叠加静态符号 PNG
+        $overlay = [System.Drawing.Bitmap]::new($staticIcon)
+        $g.DrawImage($overlay, [System.Drawing.Rectangle]::new(0, 0, 48, 48))
+        $overlay.Dispose()
+        $g.Dispose()
+
+        $bmp.Save($iconPath, [System.Drawing.Imaging.ImageFormat]::Png)
+        $bmp.Dispose()
+        Write-Log "icon cached: $iconPath"
+        return $iconPath
+    } catch {
+        Write-Log "icon generation failed: $_"
+        return $staticIcon
+    }
+}
+
+$hookName = switch ($eventName) {
+    'Stop'              { 'stop' }
+    'PermissionRequest' { 'permission' }
+    default             { 'info' }
+}
+$iconPath = Get-NotifyIcon $hookName $terminalExePath
+
+# 3. 构建 toast 通知内容
+# dev 版本在标题前添加 [DEV] 标记
+$devMarker = if ($isDev) { "[DEV] " } else { "" }
+$notificationTitle = "$devMarker$Title ($terminalName)"
+$escapedTitle = [System.Security.SecurityElement]::Escape($notificationTitle)
+$escapedMessage = [System.Security.SecurityElement]::Escape($Message)
+
+$actionsXml = ''
+if ($hwnd) {
+    $activateUrl = "erica-s.ai-agent-notify.activate-window://$hwnd"
+    $actionsXml = "<actions><action activationType=`"protocol`" arguments=`"$activateUrl`" content=`"Open`"/></actions>"
+}
+
+# 图标 XML（路径无效时为空字符串，保证降级安全）
+$iconXml = ''
+if ($iconPath -and (Test-Path $iconPath)) {
+    $uriPath = $iconPath.Replace('\', '/')
+    $escapedIconSrc = [System.Security.SecurityElement]::Escape("file:///$uriPath")
+    $iconXml = "<image placement=`"appLogoOverride`" src=`"$escapedIconSrc`"/>"
+}
+
+# 4. 发送 toast 通知
+try {
+    [Windows.UI.Notifications.ToastNotificationManager, Windows.UI.Notifications, ContentType = WindowsRuntime] | Out-Null
+    [Windows.Data.Xml.Dom.XmlDocument, Windows.Data.Xml.Dom, ContentType = WindowsRuntime] | Out-Null
+
+    $toastXml = @"
+<toast>
+  <visual>
+    <binding template="ToastGeneric">
+      $iconXml
+      <text>$escapedTitle</text>
+      <text>$escapedMessage</text>
+    </binding>
+  </visual>
+  $actionsXml
+</toast>
+"@
+
+    $xml = [Windows.Data.Xml.Dom.XmlDocument]::new()
+    $xml.LoadXml($toastXml)
+    $toast = [Windows.UI.Notifications.ToastNotification]::new($xml)
+    $appId = "{1AC14E77-02E7-4E5D-B744-2EB1AE5198B7}\WindowsPowerShell\v1.0\powershell.exe"
+    [Windows.UI.Notifications.ToastNotificationManager]::CreateToastNotifier($appId).Show($toast)
+    Write-Log "toast sent: $notificationTitle"
+} catch { Write-Log "toast failed: $_" }
+
+# 5. 任务栏闪烁
+if ($hwnd) {
+    try {
+        Add-Type -TypeDefinition 'using System; using System.Runtime.InteropServices; public class FlashW { [DllImport("user32.dll")] public static extern bool FlashWindowEx(ref FLASHWINFO p); [StructLayout(LayoutKind.Sequential)] public struct FLASHWINFO { public uint cbSize; public IntPtr hwnd; public uint dwFlags; public uint uCount; public uint dwTimeout; } }' -ErrorAction SilentlyContinue
+        $flash = New-Object FlashW+FLASHWINFO
+        $flash.cbSize = [System.Runtime.InteropServices.Marshal]::SizeOf($flash)
+        $flash.hwnd = $hwnd
+        $flash.dwFlags = 15
+        $flash.uCount = 0
+        $flash.dwTimeout = 0
+        [FlashW]::FlashWindowEx([ref]$flash) | Out-Null
+        Write-Log "flash sent"
+    } catch { Write-Log "flash failed: $_" }
+}

package/scripts/register-protocol.ps1

@@ -0,0 +1,18 @@
+# Register erica-s.ai-agent-notify.activate-window:// protocol handler
+# Uses VBScript wrapper to completely hide PowerShell window
+
+# Get the full path to activate-window.vbs
+$vbsPath = [System.IO.Path]::GetFullPath((Join-Path $PSScriptRoot "activate-window.vbs"))
+
+# Build the command string: wscript.exe runs VBScript which then invokes PowerShell
+# Using wscript (GUI-based) instead of cscript to avoid any console window
+$command = "wscript.exe `"$vbsPath`" `"%1`""
+
+# Write registry entries
+$regPath = "HKCU:\Software\Classes\erica-s.ai-agent-notify.activate-window"
+New-Item -Path "$regPath\shell\open\command" -Force | Out-Null
+Set-ItemProperty -Path $regPath -Name "(default)" -Value "URL:Claude Code Activate Window Protocol" -Force
+New-ItemProperty -Path $regPath -Name "URL Protocol" -Value "" -Force -ErrorAction SilentlyContinue | Out-Null
+Set-ItemProperty -Path "$regPath\shell\open\command" -Name "(default)" -Value $command -Force
+
+Write-Host "Protocol registered: erica-s.ai-agent-notify.activate-window"

package/scripts/start-hidden.vbs

@@ -0,0 +1,24 @@
+' Launch any command passed as argv with a hidden window.
+' Used when ai-agent-notify needs to start a background watcher without a visible console.
+
+Dim shell, command, index
+
+If WScript.Arguments.Count = 0 Then
+    WScript.Quit 1
+End If
+
+Set shell = CreateObject("WScript.Shell")
+command = ""
+
+For index = 0 To WScript.Arguments.Count - 1
+    If index > 0 Then
+        command = command & " "
+    End If
+    command = command & QuoteArg(WScript.Arguments(index))
+Next
+
+shell.Run command, 0, False
+
+Function QuoteArg(value)
+    QuoteArg = """" & Replace(value, """", """""") & """"
+End Function

package/scripts/start-tab-color-watcher.ps1

@@ -0,0 +1,41 @@
+param(
+    [Parameter(Mandatory)][int]$TargetPid,
+    [string]$HookEvent = '',
+    [long]$TerminalHwnd = 0,
+    [string]$WatcherPidFile = ''
+)
+
+$ErrorActionPreference = 'Stop'
+
+function Write-Log($msg) {
+    if (-not $env:TOAST_NOTIFY_LOG_FILE) { return }
+    $line = "[$(Get-Date -Format 'yyyy-MM-ddTHH:mm:ss.fffZ')] [watcher-launcher pid=$PID] $msg"
+    try { [System.IO.File]::AppendAllText($env:TOAST_NOTIFY_LOG_FILE, "$line`n") } catch {}
+}
+
+try {
+    $powershellExe = Join-Path $PSHOME 'powershell.exe'
+    $watcherScript = Join-Path $PSScriptRoot 'tab-color-watcher.ps1'
+    $argumentList = @(
+        '-NoProfile',
+        '-ExecutionPolicy', 'Bypass',
+        '-File', $watcherScript,
+        '-TargetPid', [string]$TargetPid
+    )
+    if (-not [string]::IsNullOrEmpty($HookEvent)) {
+        $argumentList += @('-HookEvent', $HookEvent)
+    }
+    if ($TerminalHwnd -gt 0) {
+        $argumentList += @('-TerminalHwnd', [string]$TerminalHwnd)
+    }
+
+    $proc = Start-Process -FilePath $powershellExe -ArgumentList $argumentList -NoNewWindow -PassThru
+    if (-not [string]::IsNullOrEmpty($WatcherPidFile)) {
+        [System.IO.File]::WriteAllText($WatcherPidFile, [string]$proc.Id)
+    }
+    Write-Log "started watcher pid=$($proc.Id) targetPid=$TargetPid hwnd=$TerminalHwnd noNewWindow=true"
+}
+catch {
+    Write-Log "launcher failed: $_"
+    throw
+}