@wirecat/whatsapp-cli 0.0.0-stage → 0.1.0

package/dist/commands/session.js

@@ -0,0 +1,202 @@
+import { chmodSync, existsSync, rmSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { CliError, indent, singleLine } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { qrPng, readSecret, terminalQr } from "@wirecat/cli-core";
+import { asFirstWord, commandWords, environmentOf, inputPolicy, messengerContext, REMOTE_WRITE, refuseCommandName, rootOf, } from "@wirecat/cli-core/cli";
+import { Argument, Command } from "commander";
+import { linkDevice, WHATSAPP } from "../messenger.js";
+import { privateStore } from "../paths.js";
+import { printItem } from "./answer.js";
+/** 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 };
+/**
+ * Saves what the phone pushes until it goes quiet, Ctrl+C, or the caller's signal. Live messages that arrive
+ * meanwhile are saved too, through the same connection.
+ */
+const receiveHistory = async (adapter, wait, signal) => {
+    const received = { chats: 0, messages: 0, people: 0 };
+    const stop = new AbortController();
+    const end = () => stop.abort();
+    let timer = setTimeout(end, wait.firstMs);
+    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(timer);
+                timer = setTimeout(end, wait.quietMs);
+            }, stop.signal),
+            adapter.watch?.(() => { }, stop.signal),
+        ]);
+    }
+    finally {
+        clearTimeout(timer);
+        signal?.removeEventListener("abort", end);
+    }
+    return received;
+};
+// Linking and unlinking change the account without passing cli-core's send guard, so the lock is checked here.
+const refuseUnderReadOnly = (context) => {
+    const lock = context.settings.readOnlyLock;
+    if (lock)
+        throw new CliError("permission_error", `this process is read-only (${lock}) — it cannot link or unlink the device`);
+};
+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, qrFile, command: typed = "wa session start", signal, indent: pad = 0, track }) => {
+    const input = context.stdin;
+    const terminal = input.isTTY === true && !inputPolicy(input).noInput;
+    if (qrFile !== undefined && method !== "qr")
+        throw new CliError("validation_error", "--qr-file is for a QR login", { param: "--qr-file" });
+    const unanswerable = () => new CliError("validation_error", `${typed} shows a code to scan or type — run it in a terminal, or pass --qr-file`, {
+        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 && qrFile === undefined && !existsSync(privateStore(context.profile, context.env)))
+        throw unanswerable();
+    const qrPath = qrFile === undefined ? undefined : resolve(qrFile);
+    const environment = environmentOf(command);
+    // A cut command never reaches its own finally in time; the image links the account while it is valid.
+    if (qrPath)
+        environment.trackCloseable?.({ close: async () => rmSync(qrPath, { force: true }) });
+    try {
+        const linked = await linkDevice(command, context, {
+            method,
+            ...(track ? { track } : {}),
+            beforeLink: () => {
+                signal?.throwIfAborted();
+                refuseUnderReadOnly(context);
+                if (!terminal && qrFile === undefined)
+                    throw unanswerable();
+            },
+            phone: async () => {
+                if (!terminal)
+                    throw new CliError("validation_error", `${typed} phone needs a terminal to ask for the number`, {
+                        reason: "input.required",
+                    });
+                return readSecret(`${" ".repeat(pad)}phone number, international format: `, {
+                    input,
+                    echo: true,
+                    ...(signal === undefined ? {} : { signal }),
+                });
+            },
+            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;
+                }
+                context.renderer.note("scan in WhatsApp → Settings → Linked devices → Link a device");
+                if (!qrPath) {
+                    context.streams.diagnostic(`\n${indent(terminalQr(code).text, pad + 2)}`);
+                    return;
+                }
+                writeFileSync(qrPath, qrPng(code), { mode: 0o600 });
+                chmodSync(qrPath, 0o600);
+                context.renderer.note(`the QR code is in ${qrPath} — it is replaced when WhatsApp renews it`);
+            },
+        });
+        if (qrPath)
+            rmSync(qrPath, { force: true });
+        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 = AbortSignal.any([signal, environment.signal].filter((one) => one !== undefined));
+            session.received = await context.withMessenger((adapter) => {
+                track?.(adapter);
+                return receiveHistory(adapter, environment.historyWait ?? HISTORY_WAIT, stop);
+            }, { listen: true });
+        }
+        return session;
+    }
+    finally {
+        // The image links the account for as long as it is valid; it does not outlive the login.
+        if (qrPath)
+            rmSync(qrPath, { force: true });
+    }
+};
+const end = async (command) => {
+    const context = messengerContext(command, WHATSAPP);
+    refuseUnderReadOnly(context);
+    // Run by serve for us, the logout would end serve's own connection and the keys would go from under it.
+    if (environmentOf(command).relayed)
+        throw new CliError("provider_unavailable", `serve holds this WhatsApp login — stop it first (\`wa ${asFirstWord(context.profile)}server stop\`, or Ctrl+C ` +
+            "where it runs), then end the session", { reason: "device.in-use", sent: false });
+    const store = privateStore(context.profile, context.env);
+    if (!existsSync(store)) {
+        printItem(context, { profile: context.profile, ended: false });
+        return;
+    }
+    try {
+        await context.withMessenger((adapter) => adapter.logout());
+    }
+    catch (error) {
+        // 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;
+        context.renderer.note("WhatsApp no longer knew this device; removing the keys here");
+    }
+    for (const suffix of ["", "-wal", "-shm", ".lock"])
+        rmSync(`${store}${suffix}`, { force: true });
+    printItem(context, { profile: context.profile, ended: true });
+};
+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(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"))
+        .option("--qr-file <png>", "write the QR code to this PNG instead of drawing it, for an agent to pass on")
+        .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, then type the code WhatsApp shows here into 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" +
+        "Agents: --qr-file writes the QR as a PNG (mode 600) and removes it after the login.\n")
+        .action(async function (method) {
+        const context = messengerContext(this, WHATSAPP);
+        refuseCommandName(context.profile, commandWords(rootOf(this)), "wa");
+        const { qrFile } = this.opts();
+        const session = await startSession(this, context, {
+            command: `wa ${asFirstWord(context.profile)}session start`,
+            method,
+            ...(qrFile === undefined ? {} : { qrFile }),
+        });
+        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(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":"AAoBA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AA+D3C,eAAO,MAAM,YAAY,eA2KnB,CAAA"}

package/dist/commands/setup.js

@@ -0,0 +1,192 @@
+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 { readSecret } from "@wirecat/cli-core";
+import { asFirstWord, commandWords, environmentOf, inputPolicy, messengerContext, REMOTE_WRITE, refuseCommandName, rootOf, runtime, withDeadline, } 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 { printItem } from "./answer.js";
+import { startSession } from "./session.js";
+const AGENTS = ["none", "codex", "cursor", "claude", "gemini", "all"];
+const STEPS = 5;
+const chatCount = (count) => `${count} ${count === 1 ? "chat" : "chats"}`;
+const DETAIL = 6;
+/**
+ * A person sees each step as a heading with its details indented under it. `--quiet` hides both, as it
+ * hides notes; a machine mode keeps the plain notes it always had, since stderr there is a log.
+ */
+const screenFor = (context, quiet) => {
+    const person = context.format === "pretty";
+    const say = (text) => {
+        if (!quiet)
+            context.streams.diagnostic(text);
+    };
+    return {
+        step: (index, title) => person ? say(`\n[${index}/${STEPS}] ${title}`) : context.renderer.note(`${index}/${STEPS} — ${title}`),
+        detail: (text) => (person ? say(indent(text, DETAIL)) : context.renderer.note(text)),
+        title: (text) => (person ? say(text) : context.renderer.note(text)),
+        indent: person ? DETAIL : 0,
+    };
+};
+const agentFor = async (context, given, pad, signal) => {
+    if (given)
+        return given;
+    if (context.format !== "pretty" || !context.stdin.isTTY || inputPolicy(context.stdin).noInput)
+        return "none";
+    const answer = (await readSecret(`${" ".repeat(pad)}Agent [codex/cursor/claude/gemini/all/none] (none): `, {
+        input: context.stdin,
+        echo: true,
+        ...(signal === undefined ? {} : { signal }),
+    }))
+        .trim()
+        .toLowerCase() || "none";
+    const agent = AGENTS.find((known) => known === answer);
+    if (agent === undefined)
+        throw new CliError("validation_error", `unknown agent — choose ${AGENTS.join(", ")} with --agent`);
+    return agent;
+};
+export const setupCommand = () => annotate(new Command("setup"), {
+    effects: REMOTE_WRITE,
+    lifetime: "interactive",
+    mcp: false,
+    examples: ["wa personal setup", "wa personal setup --agent codex", "wa personal setup --qr-file login.png --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, an agent can use:\n" +
+    "  wa personal setup --qr-file login.png --agent codex --json\n" +
+    "and pass the image on to be scanned. The QR image is removed when linking ends.\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"))
+    .option("--qr-file <png>", "write a temporary QR image for an agent to pass on; works without a terminal")
+    .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");
+    if (options.qrFile && options.method !== "qr")
+        throw new CliError("validation_error", "--qr-file is for a QR login", { param: "--qr-file" });
+    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.qrFile)
+        throw new CliError("validation_error", "wa setup needs a terminal to link a device — run it locally, or pass --qr-file for an agent", { reason: "input.required" });
+    const prefix = `wa ${asFirstWord(context.profile)}`;
+    const command = installer(environmentOf(this).update) === "npx"
+        ? `npm${process.platform === "win32" ? ".cmd" : ""} exec --yes --package=${PACKAGE} -- ${prefix}`
+        : prefix;
+    const cancellation = new AbortController();
+    const closeables = [
+        {
+            close: async () => {
+                cancellation.abort();
+            },
+        },
+    ];
+    const track = (closeable) => {
+        closeables.push(closeable);
+    };
+    const screen = screenFor(context, this.optsWithGlobals().quiet === true);
+    const linkContext = { ...context, renderer: { ...context.renderer, note: screen.detail } };
+    const answer = await withDeadline(context.settings.commandTimeoutMs, closeables, async () => {
+        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 (process.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, existsSync(devicePath) ? "Link" : "Link: scan the QR code or type the pairing code");
+        const session = await startSession(this, linkContext, {
+            signal: cancellation.signal,
+            method: options.method,
+            ...(options.qrFile === undefined ? {} : { qrFile: options.qrFile }),
+            command: `${prefix}setup`,
+            indent: screen.indent,
+            track,
+        });
+        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) => {
+            track(adapter);
+            cancellation.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, cancellation.signal);
+        screen.detail(agent === "none" ? "✓ no agent skill installed" : `✓ ${agent}`);
+        const targets = agent === "all" ? ["claude", "agents"] : [agent === "claude" ? "claude" : "agents"];
+        cancellation.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` } : {}),
+        };
+        return {
+            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,
+        };
+    });
+    const { agent, next, chats } = answer;
+    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.name === "none"
+                ? `skipped — install later: ${next.skill}`
+                : `installed for ${agent.name}; 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.checked)} 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":"AAYA,eAAO,MAAM,cAAc,mCAexB,CAAA"}

package/dist/commands/update.js

@@ -0,0 +1,36 @@
+import { annotate } from "@wirecat/cli-base/commands";
+import { environmentOf, outputFor, servingProfiles, upgradeCommand as sharedUpgradeCommand, usableProfileName, } from "@wirecat/cli-core/cli";
+import { WA } from "../app.js";
+import { installer, latest, PACKAGE, restartServer, runUpdate } 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(env, environment),
+    };
+}), { examples: ["wa upgrade --check", "wa upgrade"] });
+/**
+ * A running serve keeps the code it started with; the update replaced the files under it. Each is
+ * restarted by the new wa — `server restart` refuses a serve started by hand, which is then named.
+ */
+const restartServers = (env, environment) => {
+    const restarted = [];
+    const left = [];
+    for (const profile of servingProfiles(WA, env)) {
+        try {
+            usableProfileName(profile);
+        }
+        catch {
+            continue;
+        }
+        const code = restartServer(profile, env, environment);
+        (code === 0 ? restarted : left).push(profile);
+    }
+    return { restarted, left };
+};
+//# 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,EACL,aAAa,EACb,SAAS,EACT,eAAe,EACf,cAAc,IAAI,oBAAoB,EACtC,iBAAiB,GAClB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAA;AAE9B,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,SAAS,EAA0B,MAAM,cAAc,CAAA;AAE3G,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,GAAG,EAAE,WAAW,CAAC;KACpD,CAAA;AACH,CAAC,CAAC,EACF,EAAE,QAAQ,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC,EAAE,CACnD,CAAA;AAEH;;;GAGG;AACH,MAAM,cAAc,GAAG,CAAC,GAAsB,EAAE,WAA8B,EAAE,EAAE;IAChF,MAAM,SAAS,GAAa,EAAE,CAAA;IAC9B,MAAM,IAAI,GAAa,EAAE,CAAA;IACzB,KAAK,MAAM,OAAO,IAAI,eAAe,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,iBAAiB,CAAC,OAAO,CAAC,CAAA;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,SAAQ;QACV,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,CAAC,CACpD;QAAA,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAChD,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAA;AAC5B,CAAC,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"}