@wirecat/whatsapp-cli 0.0.0-stage → 0.2.0

package/dist/bin/wa.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { enableCompileCache } from "node:module";
+import { catchCrashes } from "@wirecat/cli-base";
+import { ensureSqlite } from "@wirecat/cli-core/sqlite-runtime";
+import { WA } from "../app.js";
+// Compiling the module files is most of a start; later runs reuse what this one compiled.
+enableCompileCache();
+const stopCatching = catchCrashes({ cli: WA.command, interactive: process.stdout.isTTY === true });
+await ensureSqlite();
+stopCatching();
+// A static import would load the whole program, and its SQLite, before ensureSqlite could swap it.
+const { run } = await import("../program.js");
+process.exitCode = await run(process.argv.slice(2));
+//# sourceMappingURL=wa.js.map

package/dist/bin/wa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wa.js","sourceRoot":"","sources":["../../src/bin/wa.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AAC/D,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAE9B,0FAA0F;AAC1F,kBAAkB,EAAE,CAAA;AACpB,MAAM,YAAY,GAAG,YAAY,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC,CAAA;AAClG,MAAM,YAAY,EAAE,CAAA;AACpB,YAAY,EAAE,CAAA;AACd,mGAAmG;AACnG,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAA;AAC7C,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/commands/session.d.ts

@@ -0,0 +1,48 @@
+import { type MessengerContext } from "@wirecat/cli-core/cli";
+import { Command } from "commander";
+/**
+ * Shown once, before the code that links the device. It ignores `--quiet` the way the QR code does: it belongs to
+ * the prompt the person is answering, and after the link it is too late to read it.
+ */
+export declare const BAN_WARNING: string;
+/** The phone pushes its history right after linking, once; how long to keep receiving it. */
+export declare const HISTORY_WAIT: HistoryWait;
+/** `slowMs`: with nothing pushed by then, say once that the wait goes on, so the silence does not read as a hang. */
+export interface HistoryWait {
+    firstMs: number;
+    quietMs: number;
+    slowMs?: number;
+}
+export interface Received {
+    chats: number;
+    messages: number;
+    people: number;
+}
+export interface StartSessionOptions {
+    method: "qr" | "phone";
+    /** The command as typed, for the messages that name it. */
+    command?: string;
+    signal?: AbortSignal;
+    /** How far the questions and the QR code sit right, to line up under a setup step. */
+    indent?: number;
+    /**
+     * Ctrl+C, a cancel or --timeout ends the history wait alone, and the command answers with what was kept. A command
+     * with steps after the wait calls `endUntilStopped()` when it returns, so those steps get a deadline again.
+     */
+    stopEndsWait?: boolean;
+}
+export interface Session {
+    profile: string;
+    account: {
+        id: string;
+        name: string | null;
+    };
+    alreadyLinked: boolean;
+    /** Left out for a device linked before: nothing was pushed, so nothing was counted. */
+    received?: Received;
+}
+/** Links the profile's device unless it is linked already, then keeps the history the phone pushes once. */
+export declare const startSession: (command: Command, context: MessengerContext, { method, command: typed, signal, indent: pad, stopEndsWait }: StartSessionOptions) => Promise<Session>;
+export declare const AGENTS_LINK_BY_QR: string;
+export declare const sessionCommand: () => Command;
+//# sourceMappingURL=session.d.ts.map

package/dist/commands/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/commands/session.ts"],"names":[],"mappings":"AAIA,OAAO,EAML,KAAK,gBAAgB,EAOtB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAY,OAAO,EAAE,MAAM,WAAW,CAAA;AAI7C;;;GAGG;AACH,eAAO,MAAM,WAAW,QAKZ,CAAA;AAEZ,6FAA6F;AAC7F,eAAO,MAAM,YAAY,EAAE,WAAmE,CAAA;AAE9F,qHAAqH;AACrH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAmDD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAA;IACtB,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IAC5C,aAAa,EAAE,OAAO,CAAA;IACtB,uFAAuF;IACvF,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,4GAA4G;AAC5G,eAAO,MAAM,YAAY,YACd,OAAO,WACP,gBAAgB,iEACuE,mBAAmB,KAClH,OAAO,CAAC,OAAO,CA+EjB,CAAA;AA6BD,eAAO,MAAM,iBAAiB,QAKmE,CAAA;AAEjG,eAAO,MAAM,cAAc,eAiD1B,CAAA"}

package/dist/commands/session.js

@@ -0,0 +1,201 @@
+import { existsSync, rmSync } from "node:fs";
+import { CliError, indent, singleLine } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { atTerminal, loginQr, readSecret } from "@wirecat/cli-core";
+import { asFirstWord, commandWords, environmentOf, logsInOrOut, messengerContext, printItem, REMOTE_WRITE, refuseCommandName, rootOf, secretInputOf, } from "@wirecat/cli-core/cli";
+import { Argument, Command } from "commander";
+import { linkDevice, WHATSAPP } from "../messenger.js";
+import { privateStore } from "../paths.js";
+/**
+ * Shown once, before the code that links the device. It ignores `--quiet` the way the QR code does: it belongs to
+ * the prompt the person is answering, and after the link it is too late to read it.
+ */
+export const BAN_WARNING = [
+    "Before you link: wa is not an official WhatsApp app, and WhatsApp may ban an account that uses one.",
+    "It also bans accounts that send in bulk or write to people who do not know them.",
+    "wa writes only when a command asks, sends at most 30 messages an hour by default, and holds every",
+    "write when WhatsApp says to slow down or restricts the account. Never send in bulk or to strangers.",
+].join("\n");
+/** The phone pushes its history right after linking, once; how long to keep receiving it. */
+export const HISTORY_WAIT = { firstMs: 120_000, quietMs: 45_000, slowMs: 20_000 };
+/**
+ * Saves what the phone pushes until it goes quiet or `signal` aborts. Live messages that arrive meanwhile are saved
+ * too, through the same connection.
+ */
+const receiveHistory = async (adapter, wait, onSlow, signal) => {
+    const received = { chats: 0, messages: 0, people: 0 };
+    const stop = new AbortController();
+    const end = () => stop.abort();
+    let timer = setTimeout(end, wait.firstMs);
+    const slow = wait.slowMs === undefined ? undefined : setTimeout(onSlow, wait.slowMs);
+    signal?.addEventListener("abort", end, { once: true });
+    try {
+        await Promise.all([
+            adapter.feed?.((batch) => {
+                received.chats += batch.chats?.length ?? 0;
+                received.messages += batch.messages?.length ?? 0;
+                received.people += batch.people?.length ?? 0;
+                clearTimeout(slow);
+                clearTimeout(timer);
+                timer = setTimeout(end, wait.quietMs);
+            }, stop.signal),
+            adapter.watch?.(() => { }, stop.signal),
+        ]);
+    }
+    finally {
+        clearTimeout(slow);
+        clearTimeout(timer);
+        signal?.removeEventListener("abort", end);
+    }
+    return received;
+};
+const linkedText = (profile, account, got) => {
+    const word = asFirstWord(profile);
+    const name = account.name === null ? "you" : singleLine(account.name);
+    return [
+        got
+            ? `Linked as ${name} — profile ${profile}.`
+            : `Already linked as ${name} — profile ${profile}; nothing was asked. ` +
+                `\`wa ${word}session end\` first to link again.`,
+        ...(got ? [`History: ${got.chats} chats, ${got.messages} messages kept from the phone.`] : []),
+        `Next:    wa ${word}chats list · wa ${word}server install to keep receiving`,
+    ].join("\n");
+};
+/** Links the profile's device unless it is linked already, then keeps the history the phone pushes once. */
+export const startSession = async (command, context, { method, command: typed = "wa session start", signal, indent: pad = 0, stopEndsWait = false }) => {
+    const input = context.stdin;
+    const terminal = atTerminal(input);
+    const unanswerable = () => new CliError("validation_error", `${typed} asks questions — run it in a terminal`, {
+        reason: "input.required",
+    });
+    // A device that is linked already asks nothing, so only a profile without one is refused before the engine starts.
+    if (!terminal && method === "phone" && !existsSync(privateStore(context.profile, context.env)))
+        throw unanswerable();
+    const qr = loginQr({
+        diagnostic: context.streams.diagnostic,
+        note: context.renderer.note,
+        indent: pad,
+        terminal,
+        json: context.format !== "pretty",
+    });
+    const environment = environmentOf(command);
+    const linked = await linkDevice(command, context, {
+        method,
+        beforeLink: () => {
+            signal?.throwIfAborted();
+            if (!terminal && method === "phone")
+                throw unanswerable();
+            context.streams.diagnostic(indent(BAN_WARNING, pad));
+        },
+        phone: async () => {
+            if (!terminal)
+                throw new CliError("validation_error", `${typed} phone needs a terminal to ask for the number`, {
+                    reason: "input.required",
+                });
+            const number = await readSecret(`${" ".repeat(pad)}phone number, international format: `, {
+                ...secretInputOf(command),
+                echo: true,
+                ...(signal === undefined ? {} : { signal }),
+            });
+            // WhatsApp reads the leading digits as the country code, so a number typed without one pairs someone else's.
+            if (!number.trim().startsWith("+"))
+                throw new CliError("validation_error", "write the phone number with + and the country code, such as +34", {
+                    param: "phone",
+                    reason: "input.invalid",
+                });
+            return number;
+        },
+        onCode: ({ login, code }) => {
+            if (login === "pair") {
+                context.renderer.note(`pairing code: ${code}\n` +
+                    "On the phone: tap the WhatsApp notification, or Settings > Linked devices > Link a device >\n" +
+                    "Link with phone number instead, and type the code. It expires in about two minutes.");
+                return;
+            }
+            qr.show(code, "scan in WhatsApp → Settings → Linked devices → Link a device");
+        },
+    });
+    signal?.throwIfAborted();
+    const session = { profile: context.profile, account: linked.account, alreadyLinked: linked.alreadyLinked };
+    if (!linked.alreadyLinked) {
+        context.renderer.note("receiving history from the phone; keep WhatsApp open on it. Ctrl+C stops — `serve` picks up the rest.");
+        const stop = stopEndsWait ? environment.untilStopped?.() : environment.signal;
+        const ended = AbortSignal.any([signal, stop].filter((one) => one !== undefined));
+        session.received = await context.withMessenger((adapter) => receiveHistory(adapter, environment.historyWait ?? HISTORY_WAIT, () => context.renderer.note("still waiting for the phone's history — keep WhatsApp open on the phone; it can take a minute"), ended), { listen: true });
+    }
+    return session;
+};
+const end = async (command) => {
+    const context = messengerContext(command, WHATSAPP);
+    const store = privateStore(context.profile, context.env);
+    if (!existsSync(store)) {
+        printItem(context, { profile: context.profile, ended: false });
+        return;
+    }
+    let dropped = false;
+    try {
+        await context.withMessenger((adapter) => adapter.logout());
+    }
+    catch (error) {
+        if (error instanceof CliError && error.details.reason === "device.in-use")
+            throw new CliError("provider_unavailable", `${error.message} — stop it first (\`wa ${asFirstWord(context.profile)}server stop\` for serve, or Ctrl+C ` +
+                "where it runs), then end the session", { ...error.details, sent: false });
+        // The phone may have removed the device already; the keys here are then worth nothing, and still go.
+        if (!(error instanceof CliError && error.code === "authentication_error"))
+            throw error;
+        dropped = true;
+    }
+    for (const suffix of ["", "-wal", "-shm", ".lock"])
+        rmSync(`${store}${suffix}`, { force: true });
+    if (dropped)
+        context.renderer.note("WhatsApp had already dropped this device; deleted its keys here");
+    printItem(context, { profile: context.profile, ended: true });
+};
+export const AGENTS_LINK_BY_QR = "Agents: run `wa <profile> session start qr` in the background — it waits for the scan, and a shell tool\n" +
+    "shows nothing until it exits. Read its output and paste the QR text block into the chat as a code block,\n" +
+    "exactly as printed. WhatsApp renews the code after 60 seconds, then about every 20: paste each new block\n" +
+    'at once and say the old one expired. With --json each code is also a stderr line {"event":"qr","qr":{...}}.\n' +
+    "Linking is not offered over MCP; an agent with only MCP asks the person to run the command.\n";
+export const sessionCommand = () => {
+    // Linking waits for a person, and unlinking removes the owner's device: neither is an agent's call.
+    const session = annotate(new Command("session"), { mcp: false }).description("link this profile to WhatsApp as a device, or unlink it");
+    annotate(logsInOrOut(session.command("start")), {
+        effects: REMOTE_WRITE,
+        lifetime: "interactive",
+        examples: ["wa personal session start", "wa personal session start phone"],
+    })
+        .description("link by QR code (default) or a pairing code, then keep the pushed history")
+        .addArgument(new Argument("[method]", "how to link").choices(["qr", "phone"]).default("qr"))
+        .addHelpText("after", "\nFirst time? Use `wa personal setup` for linking, a check of five chats and an agent skill.\n" +
+        "\nqr: scan the code in WhatsApp > Settings > Linked devices > Link a device.\n" +
+        "phone: type your number here with + and the country code, then type the code WhatsApp shows here into\n" +
+        "the phone.\n" +
+        "\nRight after linking, the phone pushes your history once; this command keeps it in the local store\n" +
+        "until the phone goes quiet. Then run `wa <profile> server install` to keep receiving.\n" +
+        `\n${AGENTS_LINK_BY_QR}`)
+        .action(async function (method) {
+        const context = messengerContext(this, WHATSAPP);
+        refuseCommandName(context.profile, commandWords(rootOf(this)), "wa");
+        const session = await startSession(this, context, {
+            command: `wa ${asFirstWord(context.profile)}session start`,
+            method,
+            stopEndsWait: true,
+        });
+        if (context.format === "pretty")
+            context.streams.data(linkedText(context.profile, session.account, session.received));
+        else
+            printItem(context, {
+                profile: session.profile,
+                account: session.account,
+                already_linked: session.alreadyLinked,
+                ...(session.received ? { received: session.received } : {}),
+            });
+    });
+    annotate(logsInOrOut(session.command("end")), { effects: REMOTE_WRITE, examples: ["wa personal session end"] })
+        .description("unlink this device on WhatsApp's side and delete its keys here")
+        .action(async function () {
+        await end(this);
+    });
+    return session;
+};
+//# sourceMappingURL=session.js.map

package/dist/commands/session.js.map

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

package/dist/commands/setup.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const setupCommand: () => Command;
+//# sourceMappingURL=setup.d.ts.map

package/dist/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/commands/setup.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAe3C,eAAO,MAAM,YAAY,eA2JnB,CAAA"}

package/dist/commands/setup.js

@@ -0,0 +1,140 @@
+import { accessSync, constants, existsSync, mkdirSync } from "node:fs";
+import { CliError, indent, renderPretty, singleLine } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { installSkill } from "@wirecat/cli-base/skill";
+import { AGENTS, agentFor, asFirstWord, commandWords, environmentOf, logsInOrOut, messengerContext, printItem, REMOTE_WRITE, refuseCommandName, rootOf, runtime, screenFor, secretInputOf, } from "@wirecat/cli-core/cli";
+import { levelFor } from "@wirecat/cli-core/sends";
+import { Command, Option } from "commander";
+import { WA } from "../app.js";
+import { SKILL, WHATSAPP } from "../messenger.js";
+import { pathsFor, privateStore } from "../paths.js";
+import { installer, PACKAGE } from "../update.js";
+import { startSession } from "./session.js";
+const STEPS = 5;
+const chatCount = (count) => `${count} ${count === 1 ? "chat" : "chats"}`;
+export const setupCommand = () => annotate(logsInOrOut(new Command("setup")), {
+    effects: REMOTE_WRITE,
+    lifetime: "interactive",
+    mcp: false,
+    examples: ["wa personal setup", "wa personal setup --agent codex", "wa personal setup --agent claude --json"],
+})
+    .description("set up WhatsApp and connect your agent")
+    .configureHelp({ showGlobalOptions: true })
+    .addHelpText("after", "\nExamples:\n" +
+    "  wa personal setup                Guided setup of profile personal in your local terminal\n" +
+    "  wa personal setup --agent codex  Install the skill for Codex\n" +
+    "  wa work setup --agent claude     Set up a separate work profile\n" +
+    "  wa personal setup --method phone Link with a pairing code instead of QR\n" +
+    "\nThe first word names the profile; every later command names it too.\n" +
+    "\nAllow about 5 minutes: the phone pushes your recent history once, right after linking.\n" +
+    "Scan the QR in WhatsApp: Settings > Linked devices > Link a device.\n" +
+    "Type your phone number only in the terminal.\n" +
+    "\nAgents: read `wa skill show` first. Without a terminal, setup prints the QR code as text:\n" +
+    "  wa personal setup --agent codex --json\n" +
+    "Run it in the background and paste each QR block into the chat, as for `session start qr`.\n" +
+    "Machine mode skips agent installation unless --agent is given.\n" +
+    "A device linked before is checked without linking again.\n" +
+    "\nSetup reads five chats from the local store. To keep receiving messages:\n" +
+    "  wa personal server install\n")
+    .addOption(new Option("--agent <agent>", "install the skill for this agent; asks at a terminal, otherwise none").choices(AGENTS))
+    .addOption(new Option("--method <method>", "how to log in when there is no session").choices(["qr", "phone"]).default("qr"))
+    .action(async function () {
+    const context = messengerContext(this, WHATSAPP);
+    refuseCommandName(context.profile, commandWords(rootOf(this)), "wa");
+    const options = this.opts();
+    if (context.settings.offline)
+        throw new CliError("validation_error", "wa setup verifies WhatsApp — remove --offline");
+    for (const permission of ["account.show", "chats.list"]) {
+        if (levelFor(context.settings.permissions, permission).level === "deny")
+            throw new CliError("permission_error", `profile ${context.profile} denies ${permission} — setup cannot verify it`, { permission });
+    }
+    const devicePath = privateStore(context.profile, context.env);
+    if (!existsSync(devicePath) && !context.stdin.isTTY && options.method === "phone")
+        throw new CliError("validation_error", "wa setup --method phone needs a terminal to ask for the number — run it locally, or link by QR", { reason: "input.required" });
+    const environment = environmentOf(this);
+    const { platform } = environment;
+    const prefix = `wa ${asFirstWord(context.profile)}`;
+    const command = installer(environmentOf(this).update) === "npx"
+        ? `npm${platform === "win32" ? ".cmd" : ""} exec --yes --package=${PACKAGE} -- ${prefix}`
+        : prefix;
+    // The command's own signal, not a phase's: Ctrl+C during the history wait ends the wait, not setup.
+    const signal = environment.commandSignal ?? new AbortController().signal;
+    const screen = screenFor(context, this.optsWithGlobals().quiet === true, STEPS);
+    const linkContext = { ...context, renderer: { ...context.renderer, note: screen.detail } };
+    screen.title(`WhatsApp setup — profile ${context.profile}. Allow about 5 minutes; the phone sends recent history once.`);
+    screen.step(1, "This computer");
+    const paths = pathsFor(context.env);
+    for (const path of [paths.config, paths.state, paths.cache]) {
+        mkdirSync(path, { recursive: true });
+        accessSync(path, constants.W_OK);
+    }
+    screen.detail("✓ local directories ready");
+    if (platform === "win32")
+        screen.detail("Windows: use wa.cmd or npm.cmd if PowerShell blocks scripts. Open a new terminal after installing Node.js.");
+    screen.step(2, "Link this device");
+    const session = await startSession(this, linkContext, {
+        signal,
+        method: options.method,
+        command: `${prefix}setup`,
+        indent: screen.indent,
+        stopEndsWait: true,
+    });
+    environment.endUntilStopped?.();
+    const reused = session.alreadyLinked;
+    const history = session.received;
+    screen.detail(history
+        ? `✓ linked; ${chatCount(history.chats)} and ${history.messages} messages kept from the phone`
+        : "✓ existing device, no new link");
+    screen.step(3, "Account");
+    const account = await context.withMessenger(async (adapter) => {
+        signal.throwIfAborted();
+        return adapter.me();
+    });
+    screen.detail(`✓ ${account.name === null ? "verified" : singleLine(account.name)}`);
+    screen.step(4, "A few chats");
+    // WhatsApp has no chat list to ask for: the store holds what the phone pushed and what serve received.
+    const chats = await context.withStore((store, key) => store.forAccount(key).chats.chats({ limit: 5, offset: 0 }));
+    screen.detail(`✓ ${chatCount(chats.items.length)} read from the local store`);
+    if (chats.items.length === 0)
+        screen.detail(`nothing kept yet — \`${command}server install\` starts receiving`);
+    screen.step(5, "Agent");
+    const agent = await agentFor(context, options.agent, screen.indent, { ...secretInputOf(this), signal });
+    screen.detail(agent === "none" ? "✓ no agent skill installed" : `✓ ${agent}`);
+    const targets = agent === "all" ? ["claude", "agents"] : [agent === "claude" ? "claude" : "agents"];
+    signal.throwIfAborted();
+    const written = agent === "none" ? [] : installSkill(WA, SKILL, { targets, env: context.env });
+    const next = {
+        instructions: `${command}skill show`,
+        inbox: `${command}inbox --limit 5`,
+        chats: `${command}chats list --limit 5`,
+        receive: `${command}server install`,
+        history_status: `${command}store status`,
+        ...(agent === "none" ? { skill: `${command}skill install`, mcp: `${command}mcp config` } : {}),
+    };
+    const answer = {
+        profile: context.profile,
+        runtime: runtime(),
+        paths,
+        device: { path: devicePath, reused },
+        account: { id: account.id, name: account.name },
+        ...(history ? { history } : {}),
+        chats: { checked: chats.items.length, has_more: chats.hasMore },
+        agent: { name: agent, written },
+        next,
+    };
+    if (context.format !== "pretty")
+        printItem(context, answer);
+    else {
+        const rows = {
+            "Try now": next.inbox,
+            "Keep receiving": `${next.receive}  (a background server saves new messages)`,
+            "Agent skill": agent === "none"
+                ? `skipped — install later: ${next.skill}`
+                : `installed for ${agent}; start a new agent session if it is not found`,
+            "For an agent": next.instructions,
+        };
+        context.streams.data(`\n✓ WhatsApp is ready — profile ${context.profile}, ${chatCount(chats.items.length)} checked\n\n` +
+            indent(renderPretty(rows, { color: context.color }), 2));
+    }
+});
+//# sourceMappingURL=setup.js.map

package/dist/commands/setup.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,2 @@
+export declare const upgradeCommand: () => import("commander").Command;
+//# sourceMappingURL=update.d.ts.map

package/dist/commands/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,cAAc,mCAexB,CAAA"}

package/dist/commands/update.js

@@ -0,0 +1,17 @@
+import { annotate } from "@wirecat/cli-base/commands";
+import { environmentOf, outputFor, restartServers, upgradeCommand as sharedUpgradeCommand } from "@wirecat/cli-core/cli";
+import { WA } from "../app.js";
+import { installer, latest, PACKAGE, runUpdate, waScript } from "../update.js";
+export const upgradeCommand = () => annotate(sharedUpgradeCommand(WA, PACKAGE, (command) => {
+    const context = environmentOf(command);
+    const environment = context.update ?? {};
+    const env = context.env ?? process.env;
+    return {
+        ...outputFor(command),
+        installer: () => installer(environment),
+        latest: () => latest(environment),
+        install: (argv) => runUpdate(argv, environment),
+        afterUpdate: () => restartServers(WA, waScript(), env, environment.spawn),
+    };
+}), { examples: ["wa upgrade --check", "wa upgrade"] });
+//# sourceMappingURL=update.js.map

package/dist/commands/update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,IAAI,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACxH,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CACjC,QAAQ,CACN,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;IAC5C,MAAM,OAAO,GAAG,aAAa,CAAc,OAAO,CAAC,CAAA;IACnD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAA;IACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAA;IACtC,OAAO;QACL,GAAG,SAAS,CAAC,OAAO,CAAC;QACrB,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;QACvC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC;QACjC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC;QAC/C,WAAW,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC;KAC1E,CAAA;AACH,CAAC,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC,EAAE,CACnD,CAAA"}

package/dist/diagnose.d.ts

@@ -0,0 +1,77 @@
+import { type UpdateEnvironment } from "./update.js";
+/** Whether the engine binary is there to start — never started here. */
+export declare const engineState: (env: NodeJS.ProcessEnv, update?: UpdateEnvironment) => {
+    path: string;
+    found: boolean;
+    hint?: undefined;
+} | {
+    path: string;
+    found: boolean;
+    hint: string;
+};
+/** The device keys' file modes, from `stat` alone: the keys are a credential and are never opened here. */
+export declare const deviceModes: (storePath: string, platform?: NodeJS.Platform) => {
+    checked: boolean;
+    reason: string;
+    ok?: undefined;
+    problems?: undefined;
+} | {
+    reason?: undefined;
+    checked: boolean;
+    ok: boolean;
+    problems: {
+        path: string;
+        mode: string;
+        want: string;
+        fix: string;
+    }[];
+};
+/**
+ * Who last held the device's lock, from the name the engine writes into it. The engine never clears that name, so
+ * the holder counts as running only while a process with its pid is.
+ */
+export declare const lockState: (lockPath: string) => {
+    path: string;
+    holder: string | null;
+    pid: number | null;
+    running: boolean;
+};
+/** `doctor`'s WhatsApp block: the engine, the device keys and the lock, read from disk without starting anything. */
+export declare const diagnoseWhatsApp: (profile: string, env: NodeJS.ProcessEnv, update?: UpdateEnvironment) => {
+    engine: {
+        path: string;
+        found: boolean;
+        hint?: undefined;
+    } | {
+        path: string;
+        found: boolean;
+        hint: string;
+    };
+    device: {
+        path: string;
+        exists: boolean;
+        files: {
+            checked: boolean;
+            reason: string;
+            ok?: undefined;
+            problems?: undefined;
+        } | {
+            reason?: undefined;
+            checked: boolean;
+            ok: boolean;
+            problems: {
+                path: string;
+                mode: string;
+                want: string;
+                fix: string;
+            }[];
+        };
+    };
+    lock: {
+        path: string;
+        holder: string | null;
+        pid: number | null;
+        running: boolean;
+    };
+};
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../src/diagnose.ts"],"names":[],"mappings":"AAIA,OAAO,EAAa,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAI/D,wEAAwE;AACxE,eAAO,MAAM,WAAW,QAAS,MAAM,CAAC,UAAU,WAAU,iBAAiB;;;;;;;;CAY5E,CAAA;AAED,2GAA2G;AAC3G,eAAO,MAAM,WAAW,cAAe,MAAM,aAAY,MAAM,CAAC,QAAQ;;;;;;;;;;;;;;;CAoBvE,CAAA;AAWD;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAc,MAAM;;;;;CAazC,CAAA;AAED,qHAAqH;AACrH,eAAO,MAAM,gBAAgB,YAAa,MAAM,OAAO,MAAM,CAAC,UAAU,WAAW,iBAAiB;IAGhG,MAAM;;;;;;;;;IACN,MAAM;QAAI,IAAI;QAAS,MAAM;QAAqB,KAAK;;;;;;;;;;;;;;;;;IACvD,IAAI;;;;;;CAEP,CAAA"}