@wirecat/whatsapp-cli 0.0.0-stage → 0.1.0

package/dist/paths.js

@@ -0,0 +1,7 @@
+import { join } from "node:path";
+import { resolvePaths } from "@wirecat/cli-base";
+import { WA } from "./app.js";
+export const pathsFor = (env = process.env) => resolvePaths({ appName: WA.appName, prefix: WA.envPrefix, env });
+/** The engine's device store: the linked device's keys, a credential as good as a password. One device per file. */
+export const privateStore = (profile, env = process.env) => join(pathsFor(env).state, "profiles", profile, "private.db");
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAc,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,EAAE,EAAE,MAAM,UAAU,CAAA;AAE7B,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAS,EAAE,CACtE,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAA;AAElE,oHAAoH;AACpH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAe,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAU,EAAE,CAC5F,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,YAAY,CAAC,CAAA"}

package/dist/program.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import { type Environment } from "./messenger.js";
+/** A revoked or missing login fails the same on every retry. */
+export declare const NO_RESTART_ON: number[];
+export declare const createProgram: () => Command;
+/** Never throws: every outcome is an exit code, and a failure is said once, on stderr. */
+export declare const run: (argv: string[], environment?: Environment) => Promise<number>;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,gBAAgB,CAAA;AAGlE,gEAAgE;AAChE,eAAO,MAAM,aAAa,UAAwC,CAAA;AAkElE,eAAO,MAAM,aAAa,QAAO,OAA6B,CAAA;AAE9D,0FAA0F;AAC1F,eAAO,MAAM,GAAG,SAAgB,MAAM,EAAE,gBAAe,WAAW,KAAQ,OAAO,CAAC,MAAM,CAcvF,CAAA"}

package/dist/program.js

@@ -0,0 +1,114 @@
+import { appendFileSync } from "node:fs";
+import { exitCodeFor, processStreams } from "@wirecat/cli-base";
+import { accountCommand, attachmentsCommand, chatsCommand, commandsCommand, completeCommand, configCommand, contactsCommand, conversationsCommand, createProgram as create, doctorCommand, floodCommand, imagesCommand, inboxCommand, mcpCommand, mentionsCommand, messagesCommand, modelsCommand, pollsCommand, reactionsCommand, recipientsCommand, reviewCommand, run as runCli, runsCommand, searchCommand, searchesCommand, sendsCommand, serveCommand, serverCommand, skillCommand, statsCommand, storeCommand, tagsCommand, tasksCommand, watchCommand, } from "@wirecat/cli-core/cli";
+import { CONFIG, WA } from "./app.js";
+import { sessionCommand } from "./commands/session.js";
+import { setupCommand } from "./commands/setup.js";
+import { upgradeCommand } from "./commands/update.js";
+import { SKILL, WHATSAPP } from "./messenger.js";
+import { updateNotice } from "./update.js";
+/** A revoked or missing login fails the same on every retry. */
+export const NO_RESTART_ON = [exitCodeFor("authentication_error")];
+const definition = {
+    app: WA,
+    configuration: CONFIG,
+    configure: (program) => {
+        program.addHelpText("after", "\nGetting started after installation:\n" +
+            "  wa personal setup               Guided first run as profile personal; about 5 minutes\n" +
+            "  wa personal setup --agent codex Link and install your agent's skill\n" +
+            "  wa setup --help                 Linking choices, examples and Windows instructions\n" +
+            "Every account command names its profile first: `wa personal chats list`.\n" +
+            "\nFor agents:\n" +
+            "  wa skill show                   Read the bundled instructions before using WhatsApp\n" +
+            "  wa commands --json              Discover commands, arguments and flags\n");
+        program.commands
+            .find((command) => command.name() === "skill")
+            ?.addHelpText("after", "\nBefore the first link, an agent can read `wa skill show`; no device is needed.\n" +
+            "Run `wa personal setup --agent codex` for guided linking and skill installation.\n" +
+            "To install instructions separately: `wa skill install --for all`.\n");
+    },
+    commands: () => loggingArgv([
+        sessionCommand(),
+        setupCommand(),
+        accountCommand(WHATSAPP),
+        chatsCommand(WHATSAPP),
+        contactsCommand(WHATSAPP),
+        messagesCommand(WHATSAPP),
+        reactionsCommand(WHATSAPP),
+        pollsCommand(WHATSAPP),
+        modelsCommand(WHATSAPP),
+        inboxCommand(WHATSAPP),
+        reviewCommand(WHATSAPP),
+        watchCommand(WHATSAPP),
+        serveCommand(WHATSAPP),
+        serverCommand(WHATSAPP, { unit: { noRestartOn: NO_RESTART_ON } }),
+        storeCommand(WHATSAPP),
+        conversationsCommand(WHATSAPP),
+        attachmentsCommand(WHATSAPP),
+        tagsCommand(WHATSAPP),
+        mentionsCommand(WHATSAPP),
+        imagesCommand(WHATSAPP),
+        statsCommand(WHATSAPP),
+        tasksCommand(WHATSAPP),
+        searchCommand(WHATSAPP),
+        searchesCommand(WHATSAPP),
+        floodCommand(WHATSAPP),
+        recipientsCommand(WHATSAPP),
+        sendsCommand(WHATSAPP),
+        runsCommand(WA),
+        configCommand(WA, CONFIG),
+        doctorCommand(WHATSAPP),
+        commandsCommand(WA),
+        completeCommand(WHATSAPP, CONFIG),
+        upgradeCommand(),
+        mcpCommand(WHATSAPP),
+        skillCommand(WA, SKILL),
+    ]),
+};
+export const createProgram = () => create(definition);
+/** Never throws: every outcome is an exit code, and a failure is said once, on stderr. */
+export const run = async (argv, environment = {}) => {
+    const notice = updateNotice(argv, {
+        ...(environment.tty === undefined ? {} : { tty: environment.tty }),
+        ...(environment.update ? { environment: environment.update } : {}),
+        ...(environment.env ? { env: environment.env } : {}),
+    });
+    const code = await runCli(argv, definition, environment);
+    const line = await notice;
+    const argvLog = process.env.WA_TEST_ARGV_LOG;
+    // --version ends before any action, so the preAction hook never sees it.
+    if (argvLog && code === 0 && argv.some((word) => word === "--version" || word === "-V"))
+        appendFileSync(argvLog, `${JSON.stringify({ command: "", options: ["--version"] })}\n`);
+    if (line && code === 0)
+        (environment.streams ?? processStreams).diagnostic(line);
+    return code;
+};
+/**
+ * Under vitest only: which command a test drove and the option names it gave, never a value
+ * (`pnpm test:matrix`). The hook sits on each top-level command because the root program is built
+ * inside cli-core; commander runs an ancestor's preAction hook for every subcommand.
+ */
+function loggingArgv(commands) {
+    const file = process.env.WA_TEST_ARGV_LOG;
+    if (file)
+        for (const command of commands)
+            command.hook("preAction", (_self, action) => logParsed(file, action));
+    return commands;
+}
+const logParsed = (file, action) => {
+    const words = [];
+    const options = [];
+    for (let at = action; at; at = at.parent) {
+        if (at.parent)
+            words.unshift(at.name());
+        for (const option of at.options) {
+            const key = option.attributeName();
+            if (at.getOptionValueSource(key) !== "cli" || !option.long)
+                continue;
+            if (option.negate === (at.getOptionValue(key) === false))
+                options.push(option.long);
+        }
+    }
+    appendFileSync(file, `${JSON.stringify({ command: words.join(" "), options })}\n`);
+};
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"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"}

package/dist/reasons.d.ts

@@ -0,0 +1,4 @@
+import { type ErrorReason } from "@wirecat/cli-base/standards";
+/** Every reason wa raises beyond cli-core's, so an agent branches on it (WC-OUT-15). */
+export declare const REASONS: ErrorReason[];
+//# sourceMappingURL=reasons.d.ts.map

package/dist/reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../src/reasons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE7E,wFAAwF;AACxF,eAAO,MAAM,OAAO,EAAE,WAAW,EAahC,CAAA"}

package/dist/reasons.js

@@ -0,0 +1,13 @@
+import { defineReasons } from "@wirecat/cli-base/standards";
+/** Every reason wa raises beyond cli-core's, so an agent branches on it (WC-OUT-15). */
+export const REASONS = defineReasons([
+    ["device.in-use", "provider_unavailable", "another wa process holds this WhatsApp login"],
+    ["device.replaced", "provider_unavailable", "another connection took over this WhatsApp login"],
+    ["device.logged-out", "authentication_error", "WhatsApp logged this device out"],
+    ["client.outdated", "provider_unavailable", "WhatsApp no longer accepts this version of wa"],
+    ["account.banned", "permission_error", "WhatsApp has banned or restricted this account"],
+    ["account.rate-limited", "rate_limited", "WhatsApp asked this account to slow down"],
+    ["engine.stopped", "provider_unavailable", "the WhatsApp engine stopped unexpectedly"],
+    ["engine.stopped-mid-write", "outcome_unknown", "the WhatsApp engine stopped before WhatsApp confirmed a change"],
+].map(([reason, code, message]) => ({ reason, code, message, details: [] })));
+//# sourceMappingURL=reasons.js.map

package/dist/reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.js","sourceRoot":"","sources":["../src/reasons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAoB,MAAM,6BAA6B,CAAA;AAE7E,wFAAwF;AACxF,MAAM,CAAC,MAAM,OAAO,GAAkB,aAAa,CAE/C;IACE,CAAC,eAAe,EAAE,sBAAsB,EAAE,8CAA8C,CAAC;IACzF,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,kDAAkD,CAAC;IAC/F,CAAC,mBAAmB,EAAE,sBAAsB,EAAE,iCAAiC,CAAC;IAChF,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,+CAA+C,CAAC;IAC5F,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,gDAAgD,CAAC;IACxF,CAAC,sBAAsB,EAAE,cAAc,EAAE,0CAA0C,CAAC;IACpF,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,0CAA0C,CAAC;IACtF,CAAC,0BAA0B,EAAE,iBAAiB,EAAE,gEAAgE,CAAC;CAEpH,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAC7E,CAAA"}

package/dist/update.d.ts

@@ -0,0 +1,8 @@
+import { type UpdateEnvironment } from "@wirecat/cli-core/update";
+export type { UpdateEnvironment };
+export declare const PACKAGE = "@wirecat/whatsapp-cli";
+export declare const installer: ({ scriptPath }?: UpdateEnvironment) => import("@wirecat/cli-base/update").Installer, latest: (environment?: UpdateEnvironment) => Promise<string | undefined>, runUpdate: (argv: string[], environment?: UpdateEnvironment) => number, updateNotice: (argv: readonly string[], { tty, environment, env }?: import("@wirecat/cli-core/update").NoticeOptions) => Promise<string | undefined>;
+/** This install's own entry point — after an update, the new code at the same path. */
+export declare const waScript: () => string;
+export declare const restartServer: (profile: string, env: NodeJS.ProcessEnv, environment?: UpdateEnvironment) => number;
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAK5E,YAAY,EAAE,iBAAiB,EAAE,CAAA;AAEjC,eAAO,MAAM,OAAO,0BAA0B,CAAA;AAE9C,eAAO,MAAQ,SAAS,wFAAE,MAAM,oEAAE,SAAS,+DAAE,YAAY,wIAQvD,CAAA;AAEF,uFAAuF;AACvF,eAAO,MAAM,QAAQ,QAAO,MAAgE,CAAA;AAE5F,eAAO,MAAM,aAAa,YAAa,MAAM,OAAO,MAAM,CAAC,UAAU,gBAAe,iBAAiB,KAAQ,MAK5G,CAAA"}

package/dist/update.js

@@ -0,0 +1,26 @@
+import { spawnSync } from "node:child_process";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { appUpdate } from "@wirecat/cli-core/update";
+import { resolveSettings } from "./app.js";
+import { pathsFor } from "./paths.js";
+import { VERSION } from "./version.js";
+export const PACKAGE = "@wirecat/whatsapp-cli";
+export const { installer, latest, runUpdate, updateNotice } = appUpdate({
+    packageName: PACKAGE,
+    command: "wa",
+    version: VERSION,
+    entry: import.meta.url,
+    statePath: (env) => join(pathsFor(env).state, "update-check.json"),
+    enabled: (env) => resolveSettings({}, { env, needsProfile: false }).updateCheck,
+    offVariables: ["WA_NO_UPDATE_CHECK"],
+});
+/** This install's own entry point — after an update, the new code at the same path. */
+export const waScript = () => fileURLToPath(new URL("./bin/wa.js", import.meta.url));
+export const restartServer = (profile, env, environment = {}) => {
+    const argv = [waScript(), profile, "server", "restart"];
+    return environment.spawn
+        ? environment.spawn([process.execPath, ...argv])
+        : (spawnSync(process.execPath, argv, { env, shell: false, stdio: ["ignore", 2, 2] }).status ?? 1);
+};
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,SAAS,EAA0B,MAAM,0BAA0B,CAAA;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAItC,MAAM,CAAC,MAAM,OAAO,GAAG,uBAAuB,CAAA;AAE9C,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,SAAS,CAAC;IACtE,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,OAAO;IAChB,KAAK,EAAE,OAAO,IAAI,CAAC,GAAG;IACtB,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,mBAAmB,CAAC;IAClE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW;IAC/E,YAAY,EAAE,CAAC,oBAAoB,CAAC;CACrC,CAAC,CAAA;AAEF,uFAAuF;AACvF,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAW,EAAE,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAE5F,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,GAAsB,EAAE,WAAW,GAAsB,EAAE,EAAU,EAAE;IACpH,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;IACvD,OAAO,WAAW,CAAC,KAAK;QACtB,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAA;AACrG,CAAC,CAAA"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAA"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA"}

package/install/postinstall.mjs

@@ -0,0 +1,3 @@
+if (process.env.npm_config_global === "true") {
+  await import("../dist/install/postinstall.js").then(({ completeGlobalInstall }) => completeGlobalInstall())
+}

package/install/windows.ps1

@@ -0,0 +1,161 @@
+param(
+    [ValidateSet('wa')][string] $Tool = 'wa',
+    [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/whatsapp-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/whatsapp-cli"
+    if (-not $PackageSpec) { $PackageSpec = $package }
+    Note "1/3 Installing $package..."
+    $savedPreference = $ErrorActionPreference
+    $agentVariable = $Tool.ToUpperInvariant() + '_INSTALL_AGENT'
+    $savedAgent = [Environment]::GetEnvironmentVariable($agentVariable, 'Process')
+    try {
+        # PowerShell 5.1 turns redirected native warnings into errors; npm's exit code decides success.
+        $ErrorActionPreference = 'Continue'
+        [Environment]::SetEnvironmentVariable($agentVariable, $Agent, 'Process')
+        $log = & $npm install --global --prefix $Prefix "--allow-scripts=$package" --foreground-scripts $PackageSpec 2>&1
+        $installExit = $LASTEXITCODE
+    } finally {
+        $ErrorActionPreference = $savedPreference
+        [Environment]::SetEnvironmentVariable($agentVariable, $savedAgent, 'Process')
+    }
+    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,6 +1,91 @@
 {
   "name": "@wirecat/whatsapp-cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "A personal WhatsApp account from the terminal, as a linked device — built for agents and scripts",
+  "license": "Apache-2.0",
+  "author": "Viacheslav Ptsarev",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WireCatLabs/whatsapp-cli.git"
+  },
+  "type": "module",
+  "engines": {
+    "node": "^22.16.0 || >=24"
+  },
+  "packageManager": "pnpm@11.20.0",
+  "bin": {
+    "wa": "dist/bin/wa.js"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "install",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc --build --force",
+    "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 wa --check",
+    "test:slow": "vitest run --reporter=json --outputFile=coverage/tests.json >/dev/null; cli-dev slow-tests",
+    "engine:test": "cd engine && unformatted=$(\"$(go env GOROOT)/bin/gofmt\" -l .) && { test -z \"$unformatted\" || { echo \"not gofmt-formatted: $unformatted\" >&2; exit 1; }; } && go vet ./... && go test ./...",
+    "generate": "pnpm build && node --experimental-strip-types scripts/commands.ts",
+    "smoke:bun": "bun run scripts/smoke.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 config/wirecat/rumdl.toml README.md docs/*.md",
+    "parity:check": "pnpm build && node dist/bin/wa.js commands --json | cli-core-parity wa && node dist/bin/wa.js commands --json | cli-core-parity wa --pages README.md docs/*.md",
+    "version:check": "cli-dev version && node scripts/engine-packages.mjs check",
+    "version:sync": "cli-dev version --sync && node scripts/engine-packages.mjs sync",
+    "prepare": "lefthook install || true",
+    "secrets:scan": "gitleaks git --no-banner --redact .",
+    "prepack": "rm -rf dist tsconfig.tsbuildinfo && pnpm build",
+    "postinstall": "node install/postinstall.mjs",
+    "check:agent-docs": "pnpm build && node --experimental-strip-types scripts/check-agent-docs.ts",
+    "standards:check": "node config/wirecat/check.mjs",
+    "docs:lint": "markdownlint-cli2",
+    "docs:spell": "cspell lint --config cspell.json --no-progress README.md",
+    "ci:quick": "pnpm typecheck && pnpm build && pnpm lint:commands",
+    "contracts:check": "cli-contract contracts/plan.json",
+    "security:no-leak": "cli-testing security no-leak . contracts/no-leak.json",
+    "lint:commands": "cli-dev lint --cli dist/bin/wa.js",
+    "engine:build": "cd engine && go build -trimpath -ldflags=\"-s -w\" -o bin/wa-engine ./cmd/wa-engine",
+    "engine:packages": "node scripts/engine-packages.mjs build"
+  },
+  "dependencies": {
+    "@wirecat/cli-base": "0.43.1",
+    "@wirecat/cli-core": "0.326.0",
+    "commander": "15.0.0",
+    "valibot": "1.5.0"
+  },
+  "optionalDependencies": {
+    "@wirecat/whatsapp-engine-darwin-arm64": "0.1.0",
+    "@wirecat/whatsapp-engine-darwin-x64": "0.1.0",
+    "@wirecat/whatsapp-engine-linux-arm64": "0.1.0",
+    "@wirecat/whatsapp-engine-linux-x64": "0.1.0",
+    "@wirecat/whatsapp-engine-win32-arm64": "0.1.0",
+    "@wirecat/whatsapp-engine-win32-x64": "0.1.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "@cspell/dict-en-gb": "5.0.34",
+    "@cspell/dict-es-es": "3.0.9",
+    "@cspell/dict-ru_ru": "2.3.3",
+    "@types/node": "^22.20.4",
+    "@vitest/coverage-v8": "^5.0.3",
+    "@wirecat/cli-testing": "0.5.2",
+    "cspell": "10.3.6",
+    "lefthook": "2.1.16",
+    "markdownlint-cli2": "0.23.3",
+    "rumdl": "^0.2.79",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}