@okxweb3/a2a-node 0.1.3 → 0.1.4-beta-520175e226-260702152522

package/dist/fix-windows-env.ps1

@@ -0,0 +1,339 @@
+# okx-a2a Windows environment fixer (Windows)
+#
+# Usage:
+#   .\fix-windows-env.ps1
+#
+# Behavior:
+#   - Diagnoses node/npm/okx-a2a resolution and prints every finding.
+#   - Rewrites the okx-a2a shims in %USERPROFILE%\.local\bin so they delegate
+#     to the npm global shim in %APPDATA%\npm (same templates as install.ps1).
+#   - Ensures %USERPROFILE%\.local\bin and %APPDATA%\npm are on the user PATH.
+#   - Does NOT install or uninstall any package and does not touch any data.
+#   - Idempotent: safe to run multiple times. Run it BEFORE installing the
+#     latest @okxweb3/a2a-node.
+#   - A full transcript is appended to %USERPROFILE%\.okx-a2a-fix-windows-env.log.
+
+$ErrorActionPreference = "Stop"
+
+if (-not $env:USERPROFILE) {
+    throw "USERPROFILE is required to fix the okx-a2a environment on Windows."
+}
+
+$LOG_PATH = Join-Path $env:USERPROFILE ".okx-a2a-fix-windows-env.log"
+$INSTALL_DIR = Join-Path $env:USERPROFILE ".local\bin"
+$NPM_GLOBAL_BIN = if ($env:APPDATA) { Join-Path $env:APPDATA "npm" } else { $null }
+
+$transcriptStarted = $false
+try {
+    Start-Transcript -Path $LOG_PATH -Append | Out-Null
+    $transcriptStarted = $true
+} catch {
+    Write-Host "[fix] WARNING: unable to start transcript at ${LOG_PATH}: $($_.Exception.Message)"
+}
+
+function Write-Fix {
+    param([string]$Message)
+
+    Write-Host "[fix] $Message"
+}
+
+function Resolve-ExternalCommand {
+    param([string[]]$Names)
+
+    foreach ($name in $Names) {
+        $command = Get-Command $name -ErrorAction SilentlyContinue
+        if ($command -and $command.Source) {
+            return $command.Source
+        }
+    }
+    return $null
+}
+
+function Get-LastNonEmptyLine {
+    param([object[]]$Lines)
+
+    $line = @($Lines) | Where-Object { "$_" -match '\S' } | Select-Object -Last 1
+    if ($null -eq $line) {
+        return $null
+    }
+    return "$line".Trim()
+}
+
+function Show-CommandSource {
+    param([string]$Name)
+
+    $command = Get-Command $Name -ErrorAction SilentlyContinue
+    if ($command -and $command.Source) {
+        Write-Fix "command ${Name}: $($command.Source)"
+    } elseif ($command) {
+        Write-Fix "command ${Name}: resolved as $($command.CommandType) without a file source"
+    } else {
+        Write-Fix "command ${Name}: not found"
+    }
+}
+
+function Get-GlobalPackageCliPath {
+    if (-not $NPM_CMD) {
+        Write-Fix "npm is not available; cannot locate the global @okxweb3/a2a-node CLI entry"
+        return $null
+    }
+
+    $npmRootOutput = $null
+    try {
+        $npmRootOutput = & $NPM_CMD root -g
+    } catch {
+        Write-Fix "npm root -g failed: $($_.Exception.Message)"
+        return $null
+    }
+    $npmRoot = Get-LastNonEmptyLine -Lines @($npmRootOutput)
+    if (-not $npmRoot) {
+        Write-Fix "unable to detect the npm global node_modules directory"
+        return $null
+    }
+
+    $cliPath = Join-Path (Join-Path (Join-Path $npmRoot "@okxweb3") "a2a-node") "dist\cli.js"
+    if (-not (Test-Path $cliPath)) {
+        Write-Fix "global @okxweb3/a2a-node CLI entry not found at $cliPath"
+        return $null
+    }
+    return $cliPath
+}
+
+function Test-LegacyCmdShimContent {
+    param([string]$Content)
+
+    if (-not $Content) {
+        return $false
+    }
+    # Historical shim formats either exported NODE_EXE= or embedded an absolute
+    # per-user path (which breaks for non-ASCII Windows usernames).
+    if ($Content -match "NODE_EXE=") {
+        return $true
+    }
+    if ($Content -match "[A-Za-z]:\\Users\\") {
+        return $true
+    }
+    return $false
+}
+
+function Compare-ShimContent {
+    param(
+        [string]$Existing,
+        [string]$Expected
+    )
+
+    if (-not $Existing) {
+        return $false
+    }
+    $normalizedExisting = ($Existing -replace "`r`n", "`n").Trim()
+    $normalizedExpected = ($Expected -replace "`r`n", "`n").Trim()
+    return $normalizedExisting -eq $normalizedExpected
+}
+
+function Add-DirectoryToUserPath {
+    param(
+        [string]$Directory,
+        [string]$Label
+    )
+
+    $userPath = [Environment]::GetEnvironmentVariable("Path", "User")
+    $entries = @()
+    if ($userPath) {
+        $entries = @($userPath -split ";" | Where-Object { $_ })
+    }
+    $directoryNormalized = $Directory.TrimEnd([char]'\')
+    $alreadyPresent = $entries | Where-Object { $_.TrimEnd([char]'\') -ieq $directoryNormalized } | Select-Object -First 1
+    if ($alreadyPresent) {
+        Write-Fix "$Label already on user PATH: $Directory"
+        $env:Path = "${Directory};${env:Path}"
+        return
+    }
+
+    $newPath = if ($userPath) { "${Directory};${userPath}" } else { $Directory }
+    [Environment]::SetEnvironmentVariable("Path", $newPath, "User")
+    $env:Path = "${Directory};${env:Path}"
+    Write-Fix "added $Label to user PATH: $Directory (restart the terminal to pick it up in other sessions)"
+}
+
+function Repair-LocalBinShims {
+    if (-not (Test-Path $INSTALL_DIR)) {
+        New-Item -ItemType Directory -Path $INSTALL_DIR -Force | Out-Null
+        Write-Fix "created $INSTALL_DIR"
+    }
+
+    $cmdPath = Join-Path $INSTALL_DIR "okx-a2a.cmd"
+    $ps1Path = Join-Path $INSTALL_DIR "okx-a2a.ps1"
+
+    # Keep this template byte-identical to Write-LocalBinShims in install.ps1.
+    # It delegates through %APPDATA%\npm so no absolute per-user path (e.g. a
+    # non-ASCII Windows username) is ever embedded into the shim.
+    $cmdContent = @"
+@ECHO off
+SETLOCAL
+IF NOT DEFINED APPDATA (
+  ECHO APPDATA is required to find the npm okx-a2a shim. >&2
+  EXIT /b 1
+)
+SET "OKX_A2A_NPM_CMD=%APPDATA%\npm\okx-a2a.cmd"
+IF NOT EXIST "%OKX_A2A_NPM_CMD%" (
+  ECHO okx-a2a npm shim not found at "%OKX_A2A_NPM_CMD%" >&2
+  EXIT /b 1
+)
+CALL "%OKX_A2A_NPM_CMD%" %*
+EXIT /b %ERRORLEVEL%
+"@
+
+    $existingCmd = $null
+    if (Test-Path $cmdPath) {
+        $existingCmd = Get-Content -Path $cmdPath -Raw -ErrorAction SilentlyContinue
+    }
+    if (Test-LegacyCmdShimContent -Content $existingCmd) {
+        Write-Fix "found legacy shim, rewriting $cmdPath"
+        Set-Content -Path $cmdPath -Value $cmdContent -Encoding ASCII
+        Write-Fix "rewrote cmd shim: $cmdPath"
+    } elseif (Compare-ShimContent -Existing $existingCmd -Expected $cmdContent) {
+        Write-Fix "cmd shim already up to date: $cmdPath"
+    } else {
+        Set-Content -Path $cmdPath -Value $cmdContent -Encoding ASCII
+        Write-Fix "rewrote cmd shim: $cmdPath"
+    }
+
+    if (-not $NODE_CMD) {
+        Write-Fix "node executable not found; skipped rewriting $ps1Path"
+        return
+    }
+    $cliPath = Get-GlobalPackageCliPath
+    if (-not $cliPath) {
+        Write-Fix "skipped rewriting $ps1Path (global CLI entry unavailable)"
+        return
+    }
+
+    # Keep this template byte-identical to Write-LocalBinShims in install.ps1.
+    $psContent = @"
+`$node = '$($NODE_CMD.Replace("'", "''"))'
+`$cli = '$($cliPath.Replace("'", "''"))'
+if (-not (Test-Path `$cli)) {
+    Write-Error "okx-a2a CLI entry not found at `$cli"
+    exit 1
+}
+& `$node `$cli @args
+exit `$LASTEXITCODE
+"@
+
+    $existingPs = $null
+    if (Test-Path $ps1Path) {
+        $existingPs = Get-Content -Path $ps1Path -Raw -ErrorAction SilentlyContinue
+    }
+    if (Compare-ShimContent -Existing $existingPs -Expected $psContent) {
+        Write-Fix "ps1 shim already up to date: $ps1Path"
+    } else {
+        Set-Content -Path $ps1Path -Value $psContent -Encoding UTF8
+        Write-Fix "rewrote ps1 shim: $ps1Path"
+    }
+}
+
+$exitCode = 0
+try {
+    Write-Fix "=== okx-a2a fix-windows-env started at $(Get-Date -Format o) ==="
+    Write-Fix "transcript: $LOG_PATH"
+    Write-Fix "PowerShell version: $($PSVersionTable.PSVersion)"
+    try {
+        Write-Fix "execution policy (effective): $(Get-ExecutionPolicy)"
+        Write-Fix "execution policy (CurrentUser): $(Get-ExecutionPolicy -Scope CurrentUser)"
+    } catch {
+        Write-Fix "unable to read execution policy: $($_.Exception.Message)"
+    }
+
+    # --- diagnostics ---
+    $NODE_CMD = Resolve-ExternalCommand -Names @("node.exe", "node")
+    if ($NODE_CMD) {
+        $nodeVersion = $null
+        try {
+            $nodeVersion = Get-LastNonEmptyLine -Lines @(& $NODE_CMD -v)
+        } catch {
+            Write-Fix "node -v failed: $($_.Exception.Message)"
+        }
+        Write-Fix "node: $NODE_CMD (version: $nodeVersion)"
+    } else {
+        Write-Fix "node: not found"
+    }
+
+    $NPM_CMD = Resolve-ExternalCommand -Names @("npm.cmd", "npm")
+    if ($NPM_CMD) {
+        $npmVersion = $null
+        try {
+            $npmVersion = Get-LastNonEmptyLine -Lines @(& $NPM_CMD -v)
+        } catch {
+            Write-Fix "npm -v failed: $($_.Exception.Message)"
+        }
+        Write-Fix "npm: $NPM_CMD (version: $npmVersion)"
+        try {
+            $npmPrefix = Get-LastNonEmptyLine -Lines @(& $NPM_CMD config get prefix)
+            Write-Fix "npm config get prefix: $npmPrefix"
+        } catch {
+            Write-Fix "npm config get prefix failed: $($_.Exception.Message)"
+        }
+        try {
+            $npmRoot = Get-LastNonEmptyLine -Lines @(& $NPM_CMD root -g)
+            Write-Fix "npm root -g: $npmRoot"
+        } catch {
+            Write-Fix "npm root -g failed: $($_.Exception.Message)"
+        }
+    } else {
+        Write-Fix "npm: not found"
+    }
+
+    if ($NPM_GLOBAL_BIN) {
+        if (Test-Path $NPM_GLOBAL_BIN) {
+            Write-Fix "APPDATA npm dir exists: $NPM_GLOBAL_BIN"
+        } else {
+            Write-Fix "APPDATA npm dir missing: $NPM_GLOBAL_BIN"
+        }
+    } else {
+        Write-Fix "APPDATA is not defined; cannot locate the npm global bin dir"
+    }
+
+    Show-CommandSource -Name "okx-a2a"
+    Show-CommandSource -Name "codex"
+    Show-CommandSource -Name "claude"
+
+    # --- repair: local bin shims ---
+    $npmShimPath = $null
+    if ($NPM_GLOBAL_BIN) {
+        $npmShimPath = Join-Path $NPM_GLOBAL_BIN "okx-a2a.cmd"
+    }
+    if ($npmShimPath -and (Test-Path $npmShimPath)) {
+        Write-Fix "npm global shim found: $npmShimPath"
+        Repair-LocalBinShims
+    } else {
+        Write-Fix "npm global okx-a2a shim not found (expected at $npmShimPath)"
+        Write-Fix "this script does not install packages; run 'npm install -g @okxweb3/a2a-node' or install.ps1 first, then re-run this script"
+    }
+
+    # --- repair: user PATH ---
+    Add-DirectoryToUserPath -Directory $INSTALL_DIR -Label "local bin"
+    if ($NPM_GLOBAL_BIN) {
+        Add-DirectoryToUserPath -Directory $NPM_GLOBAL_BIN -Label "npm global bin"
+    }
+
+    # --- verify ---
+    $resolved = Get-Command okx-a2a -ErrorAction SilentlyContinue
+    if ($resolved -and $resolved.Source) {
+        Write-Fix "okx-a2a now resolves to: $($resolved.Source)"
+    } else {
+        Write-Fix "okx-a2a is still not resolvable on PATH; see the messages above and the transcript at $LOG_PATH"
+        $exitCode = 1
+    }
+    Write-Fix "=== okx-a2a fix-windows-env finished (exit $exitCode) ==="
+} catch {
+    Write-Fix "ERROR: $($_.Exception.Message)"
+    $exitCode = 1
+} finally {
+    if ($transcriptStarted) {
+        try {
+            Stop-Transcript | Out-Null
+        } catch {}
+    }
+}
+
+exit $exitCode