@wirecat/max-cli 0.0.0 → 0.42.0

package/install/windows.ps1

@@ -0,0 +1,160 @@
+param(
+    [ValidateSet('max')][string] $Tool = 'max',
+    [ValidateSet('all', 'codex', 'cursor', 'claude', 'gemini', 'none')][string] $Agent = 'all',
+    [string] $Prefix,
+    [string] $PackageSpec,
+    [string] $NodeDirectory,
+    [switch] $RepairOnly,
+    [switch] $Json
+)
+
+$ErrorActionPreference = 'Stop'
+if ($env:OS -ne 'Windows_NT') { throw 'This installer is for Windows.' }
+
+function Note([string] $Message) {
+    if ($Json) { [Console]::Error.WriteLine($Message) } else { Write-Host $Message }
+}
+
+function NormalPath([string] $Value) {
+    $expanded = [Environment]::ExpandEnvironmentVariables($Value.Trim().Trim('"'))
+    return $expanded.TrimEnd('\', '/').ToLowerInvariant()
+}
+
+function ContainsPath([string] $Value, [string] $Directory) {
+    $wanted = NormalPath $Directory
+    foreach ($entry in ($Value -split ';')) {
+        if ($entry.Trim() -and (NormalPath $entry) -eq $wanted) { return $true }
+    }
+    return $false
+}
+
+function AddUserPaths([string[]] $Directories) {
+    $key = [Microsoft.Win32.Registry]::CurrentUser.CreateSubKey('Environment')
+    try {
+        $old = [string] $key.GetValue('Path', '', [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+        $kind = [Microsoft.Win32.RegistryValueKind]::ExpandString
+        if ($key.GetValueNames() -contains 'Path') { $kind = $key.GetValueKind('Path') }
+        $machine = [Environment]::GetEnvironmentVariable('Path', 'Machine')
+        $updated = $old
+        $added = @()
+        foreach ($directory in $Directories) {
+            if (-not (ContainsPath "$machine;$updated" $directory)) {
+                $updated = if ($updated) { "$directory;$updated" } else { $directory }
+                $added += $directory
+            }
+            $remaining = ($env:Path -split ';') | Where-Object { (NormalPath $_) -ne (NormalPath $directory) }
+            $env:Path = "$directory;" + ($remaining -join ';')
+        }
+        if ($updated.Length -gt 32767) { throw 'User PATH is too long to add the CLI safely.' }
+        if ($updated -ne $old) { $key.SetValue('Path', $updated, $kind) }
+    } finally { $key.Dispose() }
+    if ($added.Count) {
+        if (-not ('WireCat.EnvironmentChange' -as [type])) {
+            Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+namespace WireCat {
+  public class EnvironmentChange {
+    [DllImport("user32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
+    public static extern IntPtr SendMessageTimeout(IntPtr window, uint message,
+      UIntPtr wParam, string lParam, uint flags, uint timeout, out UIntPtr result);
+  }
+}
+'@
+        }
+        $result = [UIntPtr]::Zero
+        $null = [WireCat.EnvironmentChange]::SendMessageTimeout([IntPtr] 0xffff, 0x1a,
+            [UIntPtr]::Zero, 'Environment', 2, 2000, [ref] $result)
+    }
+    return $added
+}
+
+function RemoveGeneratedPowerShellShim([string] $Directory) {
+    $script = Join-Path $Directory "$Tool.ps1"
+    if (Test-Path -LiteralPath $script) {
+        $content = (Get-Content -LiteralPath $script -Raw).Replace('\', '/')
+        if (-not $content.Contains("node_modules/@wirecat/$Tool-cli/dist/bin/$Tool.js")) {
+            throw "An unrelated $Tool.ps1 exists in the npm prefix; it was left untouched."
+        }
+        # npm's .cmd launcher works even when PowerShell refuses unsigned .ps1 scripts.
+        Remove-Item -LiteralPath $script
+    }
+}
+
+$node = (Get-Command node -CommandType Application -ErrorAction Stop | Select-Object -First 1).Source
+if (-not $NodeDirectory) { $NodeDirectory = Split-Path $node -Parent }
+if (-not $Prefix) {
+    $npm = (Get-Command npm.cmd -CommandType Application -ErrorAction Stop | Select-Object -First 1).Source
+    $Prefix = (& $npm prefix -g | Out-String).Trim()
+    if ($LASTEXITCODE -ne 0) { throw 'Could not determine the npm installation folder.' }
+}
+$Prefix = [IO.Path]::GetFullPath($Prefix)
+if ($Prefix.Contains(';') -or $NodeDirectory.Contains(';')) { throw 'Installation folders cannot contain a semicolon.' }
+
+if (-not $RepairOnly) {
+    $nodeVersion = (& $node --version | Out-String).Trim()
+    if ($LASTEXITCODE -ne 0 -or $nodeVersion -notmatch '^v(\d+)\.(\d+)\.') { throw 'Could not read the Node.js version.' }
+    $major = [int] $Matches[1]
+    $minor = [int] $Matches[2]
+    if (-not ($major -ge 24 -or ($major -eq 22 -and $minor -ge 16))) {
+        throw 'Node.js 22.16+ or 24+ is required. Install a supported Node.js release first.'
+    }
+    $npm = (Get-Command npm.cmd -CommandType Application -ErrorAction Stop | Select-Object -First 1).Source
+    $package = "@wirecat/$Tool-cli"
+    if (-not $PackageSpec) { $PackageSpec = $package }
+    Note "1/3 Installing $package..."
+    $savedPreference = $ErrorActionPreference
+    $savedAgent = $env:MAX_INSTALL_AGENT
+    try {
+        # PowerShell 5.1 turns redirected native warnings into errors; npm's exit code decides success.
+        $ErrorActionPreference = 'Continue'
+        $env:MAX_INSTALL_AGENT = $Agent
+        $log = & $npm install --global --prefix $Prefix "--allow-scripts=$package" --foreground-scripts $PackageSpec 2>&1
+        $installExit = $LASTEXITCODE
+    } finally {
+        $ErrorActionPreference = $savedPreference
+        $env:MAX_INSTALL_AGENT = $savedAgent
+    }
+    foreach ($line in $log) { Note ([string] $line) }
+    if ($installExit -ne 0) { throw 'npm installation failed; PATH was not changed.' }
+}
+
+$shim = Join-Path $Prefix "$Tool.cmd"
+if (-not (Test-Path -LiteralPath $shim)) { throw "The installation did not create $Tool.cmd." }
+$added = @(AddUserPaths @($NodeDirectory, $Prefix))
+RemoveGeneratedPowerShellShim $Prefix
+
+if ($RepairOnly) {
+    if ($Json) { @{ tool = $Tool; prefix = $Prefix; pathAdded = $added } | ConvertTo-Json -Compress }
+    exit 0
+}
+
+Note '2/3 PATH is ready in this terminal and saved for future terminals.'
+$version = (& $shim --version | Out-String).Trim()
+if ($LASTEXITCODE -ne 0) { throw 'The installed CLI could not start.' }
+$written = @()
+if ($Agent -ne 'none') {
+    Note "3/3 Installing agent instructions ($Agent)..."
+    $target = if ($Agent -eq 'all') { 'all' } elseif ($Agent -eq 'claude') { 'claude' } else { 'agents' }
+    $skillJson = & $shim skill install --for $target --json
+    if ($LASTEXITCODE -ne 0) { throw 'Agent skill installation failed.' }
+    $skill = ($skillJson -join "`n") | ConvertFrom-Json
+    $written = @($skill.written)
+    if (-not $written.Count) { throw 'Agent skill installation wrote no instructions.' }
+    foreach ($file in $written) {
+        if (-not (Test-Path -LiteralPath $file)) { throw 'An installed agent skill could not be found.' }
+    }
+}
+
+$resolved = Get-Command $Tool -CommandType Application -ErrorAction Stop | Select-Object -First 1
+if ([IO.Path]::GetFullPath($resolved.Source) -ne [IO.Path]::GetFullPath($shim)) {
+    throw "Another $Tool command shadows this installation on PATH."
+}
+$directVersion = (& $Tool --version | Out-String).Trim()
+if ($LASTEXITCODE -ne 0 -or $directVersion -ne $version) { throw "Bare $Tool did not start the installed version." }
+Note "$Tool $version is ready. Agent: read '$Tool skill show' before login; the skill is already installed."
+Note 'Account login is the next step; the owner enters codes or scans the QR locally.'
+if ($Json) {
+    @{ tool = $Tool; version = $version; prefix = $Prefix; pathAdded = $added;
+       agent = $Agent; written = $written; instructions = "$Tool skill show" } | ConvertTo-Json -Compress
+}

package/package.json

@@ -1,10 +1,127 @@
 {
   "name": "@wirecat/max-cli",
-  "version": "0.0.0",
-  "description": "Placeholder: releases of @wirecat/max-cli are published from CI",
+  "version": "0.42.0",
+  "description": "MAX Messenger bots through the official Bot API, and a personal MAX account, from the terminal — built for agents and scripts",
   "license": "MIT",
+  "author": "Viacheslav Ptsarev",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/WireCatLabs/max-cli.git"
+  },
+  "type": "module",
+  "engines": {
+    "node": "^22.16.0 || >=24"
+  },
+  "packageManager": "pnpm@11.20.0",
+  "bin": {
+    "max": "dist/bin/max.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "install",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --build",
+    "generate": "node --experimental-strip-types scripts/bot/generate.ts && pnpm build && node --experimental-strip-types scripts/generate.ts && node --experimental-strip-types scripts/commands.ts",
+    "bot:spec:sync": "node --experimental-strip-types scripts/bot/sync-spec.ts",
+    "bot:generate": "node --experimental-strip-types scripts/bot/generate.ts",
+    "bot:generate:check": "node --experimental-strip-types scripts/bot/generate.ts --check",
+    "typecheck": "tsc --build --force --emitDeclarationOnly && tsc -p tsconfig.test.json && tsc -p tsconfig.scripts.json",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:matrix": "vitest run >/dev/null && pnpm build >/dev/null && cli-dev test-matrix --program dist/program.js --untested scripts/test-matrix-untested.ts --name max --check",
+    "test:slow": "vitest run --reporter=json --outputFile=coverage/tests.json >/dev/null; cli-dev slow-tests",
+    "smoke:bun": "bun run scripts/smoke.ts",
+    "mcp:tools": "node --experimental-strip-types scripts/mcp-tools.ts",
+    "smoke:live": "pnpm build && node --experimental-strip-types scripts/smoke-live.ts",
+    "release:check": "pnpm build && node --experimental-strip-types scripts/release-check.ts",
+    "docs:check": "cli-dev docs-check --rules scripts/release/checks.ts --pages && cspell --no-progress --no-summary README.md 'docs/*.md' && rumdl check --config node_modules/@wirecat/cli-core/config/rumdl.toml README.md docs/*.md",
+    "parity:check": "pnpm build && node dist/bin/max.js commands --json | cli-messaging-parity max && node dist/bin/max.js commands --json | cli-messaging-parity max --pages README.md docs/*.md",
+    "version:check": "cli-dev version",
+    "version:sync": "cli-dev version --sync",
+    "seed:worktree": "node --experimental-strip-types scripts/seed-worktree.ts --force",
+    "probe:ids": "pnpm build && node --experimental-strip-types scripts/id-shape.ts",
+    "probe:download": "pnpm build && node --experimental-strip-types scripts/probe-download.ts",
+    "probe:upload": "pnpm build && node --experimental-strip-types scripts/probe-upload.ts",
+    "probe:reply": "pnpm build && node --experimental-strip-types scripts/probe-reply.ts",
+    "probe:scheduled": "pnpm build && node --experimental-strip-types scripts/probe-scheduled.ts",
+    "probe:delete": "pnpm build && node --experimental-strip-types scripts/probe-delete.ts",
+    "probe:edits": "pnpm build && node --experimental-strip-types scripts/probe-edits.ts",
+    "probe:attachments": "pnpm build && node --experimental-strip-types scripts/probe-attachments.ts",
+    "verify:live": "pnpm build && node --experimental-strip-types scripts/verify-commands.ts",
+    "prepare": "lefthook install || true",
+    "secrets:scan": "gitleaks git --no-banner --redact .",
+    "prepack": "rm -rf dist tsconfig.tsbuildinfo && pnpm build",
+    "probe:contacts": "pnpm build && node --experimental-strip-types scripts/probe-contacts.ts",
+    "probe:reactions": "pnpm build && node --experimental-strip-types scripts/probe-reactions.ts",
+    "probe:message-shapes": "pnpm build && node --experimental-strip-types scripts/probe-message-shapes.ts",
+    "probe:search": "pnpm build && node --experimental-strip-types scripts/probe-search.ts",
+    "probe:channel-posts": "pnpm build && node --experimental-strip-types scripts/probe-channel-posts.ts",
+    "probe:token": "pnpm build && node --experimental-strip-types scripts/probe-token.ts",
+    "probe:inbox": "pnpm build && node --experimental-strip-types scripts/probe-inbox.ts",
+    "probe:edit-pin-forward": "pnpm build && node --experimental-strip-types scripts/probe-edit-pin-forward.ts",
+    "probe:groups": "pnpm build && node --experimental-strip-types scripts/probe-groups.ts",
+    "probe:members": "pnpm build && node --experimental-strip-types scripts/probe-members.ts",
+    "probe:account": "pnpm build && node --experimental-strip-types scripts/probe-account.ts",
+    "probe:read-mark": "pnpm build && node --experimental-strip-types scripts/probe-read-mark.ts",
+    "probe:pre-release": "pnpm build && node --experimental-strip-types scripts/probe-pre-release.ts",
+    "probe:control": "pnpm build && node --experimental-strip-types scripts/probe-control.ts",
+    "probe:member-list": "pnpm build && node --experimental-strip-types scripts/probe-member-list.ts",
+    "probe:admin-rights": "pnpm build && node --experimental-strip-types scripts/probe-admin-rights.ts",
+    "probe:message-count": "pnpm build && node --experimental-strip-types scripts/probe-message-count.ts",
+    "probe:media-send": "pnpm build && node --experimental-strip-types scripts/probe-media-send.ts",
+    "probe:video": "pnpm build && node --experimental-strip-types scripts/probe-video.ts",
+    "probe:voice": "pnpm build && node --experimental-strip-types scripts/probe-voice.ts",
+    "probe:polls": "pnpm build && node --experimental-strip-types scripts/probe-polls.ts",
+    "probe:profile": "pnpm build && node --experimental-strip-types scripts/probe-profile.ts",
+    "probe:join-requests": "pnpm build && node --experimental-strip-types scripts/probe-join-requests.ts",
+    "probe:bot-link": "pnpm build && node --experimental-strip-types scripts/probe-bot-link.ts",
+    "probe:search-ops": "pnpm build && node --experimental-strip-types scripts/probe-search-ops.ts",
+    "probe:keyboard": "pnpm build && node --experimental-strip-types scripts/probe-keyboard.ts",
+    "probe:bot:me": "pnpm build && node --experimental-strip-types scripts/probe-bot-me.ts",
+    "postinstall": "node install/postinstall.mjs",
+    "check:agent-docs": "pnpm build && node --experimental-strip-types scripts/check-agent-docs.ts"
+  },
+  "dependencies": {
+    "@wirecat/cli-core": "0.18.1",
+    "@wirecat/cli-messaging": "0.215.0",
+    "@modelcontextprotocol/server": "2.1.0",
+    "@msgpack/msgpack": "3.1.3",
+    "@valibot/to-json-schema": "1.8.0",
+    "commander": "15.0.0",
+    "lossless-json": "4.3.1",
+    "ogg-opus-decoder": "1.7.5",
+    "qrcode-generator": "2.0.4",
+    "sherpa-onnx": "1.13.8",
+    "string-width": "8.3.0",
+    "valibot": "1.5.0",
+    "wrap-ansi": "10.0.2",
+    "ws": "8.21.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.14",
+    "@cspell/dict-en-gb": "^5.0.34",
+    "@cspell/dict-ru_ru": "^2.3.2",
+    "@modelcontextprotocol/client": "~2.2.0",
+    "@napi-rs/canvas": "1.0.10",
+    "@types/node": "^22.20.4",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^5.0.3",
+    "cspell": "^10.3.6",
+    "lefthook": "^2.1.8",
+    "rumdl": "^0.2.78",
+    "typescript": "^7.0.2",
+    "unpdf": "1.8.1",
+    "vitest": "^5.0.3",
+    "yaml": "^2.9.1"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }