@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/cli/bot/registry.js

@@ -0,0 +1,97 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { resolvePaths, writeSecurely } from "@wirecat/cli-base";
+/** Everything this machine keeps about its bots: seen chats, recipients, the send journal. */
+export const botsDirectory = (app, env = process.env) => join(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).state, "bots");
+/** One bot's files. The names are what max-cli has always used: a moved path would lose a recipient list, and with it the limit. */
+export const botFiles = (app, profile, env = process.env) => {
+    const directory = botsDirectory(app, env);
+    return {
+        registry: join(directory, `${profile}.json`),
+        recipients: join(directory, "recipients", `${profile}.json`),
+        journal: join(directory, "sends", `${profile}.jsonl`),
+        updates: join(directory, "updates", `${profile}.json`),
+        presses: join(directory, "presses", `${profile}.json`),
+        checks: join(directory, "checks", `${profile}.json`),
+    };
+};
+/**
+ * The chats this bot has seen, because neither MAX's nor Telegram's Bot API has a call that lists them.
+ *
+ * State, not cache: the messenger cannot give it back, so clearing a cache must not take it. Titles
+ * are in it, hence 0600.
+ */
+export class ChatRegistry {
+    #path;
+    constructor(app, profile, env = process.env) {
+        this.#path = botFiles(app, profile, env).registry;
+    }
+    list() {
+        const { chats } = this.#read();
+        return Array.isArray(chats) ? chats : [];
+    }
+    /** The bot's own user id, once any command has learned it — the key its messages are stored under. */
+    botId() {
+        const { botId } = this.#read();
+        return typeof botId === "string" ? botId : undefined;
+    }
+    rememberBot(id) {
+        const file = this.#read();
+        if (file.botId !== id)
+            this.#write({ ...file, botId: id });
+    }
+    /** Makes this bot known to `bot list` before it has seen any chat. */
+    touch() {
+        if (!existsSync(this.#path))
+            writeSecurely(this.#path, `${JSON.stringify({ chats: [] }, null, 2)}\n`, 0o600);
+    }
+    /** Newer facts win; a chat seen only as an id keeps the title it had. */
+    observe(chats, now = new Date()) {
+        if (chats.length === 0)
+            return;
+        const byId = new Map(this.list().map((chat) => [chat.id, chat]));
+        const at = now.toISOString();
+        for (const chat of chats) {
+            const known = byId.get(chat.id);
+            const defined = Object.fromEntries(Object.entries(chat).filter(([, value]) => value !== undefined && value !== null));
+            byId.set(chat.id, {
+                title: null,
+                kind: "unknown",
+                unreadCount: null,
+                lastMessageAt: null,
+                participantsCount: null,
+                ...known,
+                ...defined,
+                id: chat.id,
+                firstSeenAt: known?.firstSeenAt ?? at,
+                lastSeenAt: at,
+            });
+        }
+        this.#write({ ...this.#read(), chats: [...byId.values()] });
+    }
+    #read() {
+        if (!existsSync(this.#path))
+            return {};
+        try {
+            const parsed = JSON.parse(readFileSync(this.#path, "utf8"));
+            return parsed && typeof parsed === "object" ? parsed : {};
+        }
+        catch {
+            return {};
+        }
+    }
+    #write(file) {
+        writeSecurely(this.#path, `${JSON.stringify(file, null, 2)}\n`, 0o600);
+    }
+}
+/** Every profile that has ever kept a registry — the bots this machine has used. */
+export const registryProfiles = (app, env = process.env) => {
+    const directory = botsDirectory(app, env);
+    if (!existsSync(directory))
+        return [];
+    return readdirSync(directory, { withFileTypes: true })
+        .filter((entry) => entry.isFile() && entry.name.endsWith(".json"))
+        .map((entry) => entry.name)
+        .map((name) => name.slice(0, -".json".length));
+};
+//# sourceMappingURL=registry.js.map

package/dist/cli/bot/registry.js.map

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

package/dist/cli/bot/setup.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import type { BotMessenger } from "./port.js";
+/** `bot commands`: the menu people see when they type `/`. */
+export declare const botMenuCommand: (bot: BotMessenger) => Command;
+/** `bot callbacks`: answers to the buttons people press under the bot's messages. */
+export declare const botCallbacksCommand: (bot: BotMessenger) => Command;
+/** `bot webhooks`: where the messenger pushes this bot's updates instead of being polled. */
+export declare const botWebhooksCommand: (bot: BotMessenger) => Command;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/bot/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/setup.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,OAAO,KAAK,EAAgB,YAAY,EAAE,MAAM,WAAW,CAAA;AAwB3D,8DAA8D;AAC9D,eAAO,MAAM,cAAc,QAAS,YAAY,KAAG,OAsClD,CAAA;AAED,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,QAAS,YAAY,KAAG,OA2CrD,CAAA;AAEH,6FAA6F;AAC7F,eAAO,MAAM,kBAAkB,QAAS,YAAY,KAAG,OA+DtD,CAAA"}

package/dist/cli/bot/setup.js

@@ -0,0 +1,155 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { guardedWrite } from "../../sends/guarded.js";
+import { newOperationId } from "../../sends/send-id.js";
+import { renderList } from "../paging.js";
+import { botContext, online } from "./context.js";
+import { botCan } from "./messages.js";
+import { botFiles } from "./registry.js";
+import { PressLog } from "./updates.js";
+const entryOf = (typed) => {
+    const split = typed.indexOf("=");
+    const name = (split === -1 ? typed : typed.slice(0, split)).replace(/^\//, "").trim();
+    if (!name)
+        throw new CliError("validation_error", `a command is name=description, not ${typed}`);
+    const description = split === -1 ? "" : typed.slice(split + 1).trim();
+    return { name, description: description || null };
+};
+const typesOf = (typed) => {
+    const types = typed
+        ?.split(",")
+        .map((one) => one.trim())
+        .filter(Boolean);
+    return types && types.length > 0 ? types : undefined;
+};
+/** A change to the bot itself, not to a chat: guarded and journaled with no chat. */
+const botWrite = (context, key, write) => guardedWrite(context.guard(), { operationId: newOperationId(), chatId: null, kind: "account", key }, write);
+/** `bot commands`: the menu people see when they type `/`. */
+export const botMenuCommand = (bot) => {
+    const command = new Command("commands").description("the bot's command menu — what people see after /");
+    command
+        .command("list")
+        .description("the commands in the menu now")
+        .action(async function () {
+        const context = online(botContext(this, bot), this);
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            renderList(context.renderer, context.format, await botCan(adapter, "menu", bot, "read its menu")());
+        });
+    });
+    const replace = async (command, entries, key) => {
+        const context = online(botContext(command, bot), command);
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            const set = botCan(adapter, "setMenu", bot, "change its menu");
+            await botWrite(context, key, () => set(entries));
+            renderList(context.renderer, context.format, entries);
+        });
+    };
+    annotate(command.command("set"), { mutates: true })
+        .description("replace the whole menu: each command as name=description, e.g. start=Begin")
+        .argument("<commands...>", "name=description, one per command")
+        .action(async function (typed) {
+        await replace(this, typed.map(entryOf), "bot.commands.set");
+    });
+    annotate(command.command("clear"), { mutates: true })
+        .description("empty the menu")
+        .action(async function () {
+        await replace(this, [], "bot.commands.clear");
+    });
+    return command;
+};
+/** `bot callbacks`: answers to the buttons people press under the bot's messages. */
+export const botCallbacksCommand = (bot) => new Command("callbacks").description("answers to the buttons people press under the bot's messages").addCommand(annotate(new Command("answer"), { mutates: true })
+    .description("answer a pressed button by its callback id: --notification shows the person a one-time note, " +
+    "--text replaces the message the button was on")
+    .argument("<callback>", "the callback id `bot watch` printed")
+    .option("--text <text>", "the message's new text")
+    .option("--notification <text>", "a note only the person who pressed sees")
+    .action(async function (callbackId) {
+    const context = online(botContext(this, bot), this);
+    const { text, notification } = this.opts();
+    if (text === undefined && notification === undefined) {
+        throw new CliError("validation_error", "an answer needs --text, --notification, or both");
+    }
+    const press = text === undefined
+        ? undefined
+        : new PressLog(botFiles(bot.app, context.profile, context.env).presses).find(callbackId);
+    await context.run(async (events) => {
+        const adapter = await context.authenticated({ events });
+        const answer = botCan(adapter, "answer", bot, "answer a button");
+        const operationId = newOperationId();
+        await guardedWrite(context.guard(), {
+            operationId,
+            chatId: press?.chatId ?? null,
+            kind: "message",
+            key: "bot.callbacks.answer",
+            ...(text === undefined ? {} : { length: text.length }),
+        }, () => answer(callbackId, {
+            ...(text === undefined ? {} : { text }),
+            ...(notification === undefined ? {} : { notification }),
+            ...(press ? { press } : {}),
+        }));
+        context.renderer.result({ operationId, callbackId, answered: true });
+    });
+}));
+/** `bot webhooks`: where the messenger pushes this bot's updates instead of being polled. */
+export const botWebhooksCommand = (bot) => {
+    const command = new Command("webhooks").description("where the messenger pushes this bot's updates — while one is set, `bot watch` gets nothing");
+    command
+        .command("list")
+        .description("the webhooks this bot has")
+        .action(async function () {
+        const context = online(botContext(this, bot), this);
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            renderList(context.renderer, context.format, await botCan(adapter, "webhooks", bot, "list its webhooks")());
+        });
+    });
+    const set = annotate(command.command("set"), { mutates: true })
+        .description("send this bot's updates to an HTTPS address; refused while another is set")
+        .argument("<url>", "the HTTPS address")
+        .option("--types <types>", "only these update types, comma-separated, in the messenger's words")
+        .option("--secret-stdin", "a secret the messenger sends back with each update — asked for, or read from a pipe");
+    if (bot.manyWebhooks)
+        set.option("--add", "keep the webhooks already set and add this one beside them");
+    set.action(async function (url) {
+        const context = online(botContext(this, bot), this);
+        const options = this.opts();
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            const list = botCan(adapter, "webhooks", bot, "list its webhooks");
+            const others = (await list()).filter((one) => one.url !== url);
+            if (others.length > 0 && !options.add) {
+                throw new CliError("confirmation_required", `this bot already sends its updates to ${others.map((one) => one.url).join(", ")} — ` +
+                    `remove it first with \`${context.words} webhooks delete <url>\`` +
+                    (bot.manyWebhooks ? ", or give --add to get every update at both" : ""));
+            }
+            const types = typesOf(options.types);
+            const setWebhook = botCan(adapter, "setWebhook", bot, "set a webhook");
+            // The secret is asked for only once the profile may set a webhook at all.
+            await botWrite(context, "bot.webhooks.set", async () => {
+                const secret = options.secretStdin ? (await context.readSecret("Webhook secret: ")).trim() : undefined;
+                if (options.secretStdin && !secret)
+                    throw new CliError("validation_error", "no secret given");
+                await setWebhook(url, { ...(types ? { types } : {}), ...(secret ? { secret } : {}) });
+            });
+            renderList(context.renderer, context.format, await list());
+        });
+    });
+    annotate(command.command("delete"), { mutates: true })
+        .description("stop sending updates to this address; with none left, `bot watch` works again")
+        .argument("<url>", "the address")
+        .action(async function (url) {
+        const context = online(botContext(this, bot), this);
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            const remove = botCan(adapter, "deleteWebhook", bot, "delete a webhook");
+            await botWrite(context, "bot.webhooks.delete", () => remove(url));
+            renderList(context.renderer, context.format, await botCan(adapter, "webhooks", bot, "list its webhooks")());
+        });
+    });
+    return command;
+};
+//# sourceMappingURL=setup.js.map

package/dist/cli/bot/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/bot/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAmB,UAAU,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAEvC,MAAM,OAAO,GAAG,CAAC,KAAa,EAAgB,EAAE;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAChC,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACrF,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,sCAAsC,KAAK,EAAE,CAAC,CAAA;IAChG,MAAM,WAAW,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACrE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,IAAI,IAAI,EAAE,CAAA;AACnD,CAAC,CAAA;AAED,MAAM,OAAO,GAAG,CAAC,KAAyB,EAAwB,EAAE;IAClE,MAAM,KAAK,GAAG,KAAK;QACjB,EAAE,KAAK,CAAC,GAAG,CAAC;SACX,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC,CAAA;IAClB,OAAO,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AACtD,CAAC,CAAA;AAED,qFAAqF;AACrF,MAAM,QAAQ,GAAG,CAAC,OAAmB,EAAE,GAAW,EAAE,KAA0B,EAAE,EAAE,CAChF,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,KAAK,CAAC,CAAA;AAE7G,8DAA8D;AAC9D,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAiB,EAAW,EAAE;IAC3D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,kDAAkD,CAAC,CAAA;IAEvG,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,8BAA8B,CAAC;SAC3C,MAAM,CAAC,KAAK;QACX,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;YACvD,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC,CAAA;QACrG,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEJ,MAAM,OAAO,GAAG,KAAK,EAAE,OAAgB,EAAE,OAAuB,EAAE,GAAW,EAAE,EAAE;QAC/E,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;QACzD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;YACvD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAA;YAC9D,MAAM,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;YAChD,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;IACJ,CAAC,CAAA;IAED,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAChD,WAAW,CAAC,4EAA4E,CAAC;SACzF,QAAQ,CAAC,eAAe,EAAE,mCAAmC,CAAC;SAC9D,MAAM,CAAC,KAAK,WAA0B,KAAe;QACpD,MAAM,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;IAEJ,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAClD,WAAW,CAAC,gBAAgB,CAAC;SAC7B,MAAM,CAAC,KAAK;QACX,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,oBAAoB,CAAC,CAAA;IAC/C,CAAC,CAAC,CAAA;IAEJ,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAiB,EAAW,EAAE,CAChE,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,8DAA8D,CAAC,CAAC,UAAU,CAC7G,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KAC/C,WAAW,CACV,+FAA+F;IAC7F,+CAA+C,CAClD;KACA,QAAQ,CAAC,YAAY,EAAE,qCAAqC,CAAC;KAC7D,MAAM,CAAC,eAAe,EAAE,wBAAwB,CAAC;KACjD,MAAM,CAAC,uBAAuB,EAAE,yCAAyC,CAAC;KAC1E,MAAM,CAAC,KAAK,WAA0B,UAAkB;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;IACnD,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,IAAI,EAA4C,CAAA;IACpF,IAAI,IAAI,KAAK,SAAS,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACrD,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,iDAAiD,CAAC,CAAA;IAC3F,CAAC;IACD,MAAM,KAAK,GACT,IAAI,KAAK,SAAS;QAChB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;IAC5F,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;QACvD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,iBAAiB,CAAC,CAAA;QAChE,MAAM,WAAW,GAAG,cAAc,EAAE,CAAA;QACpC,MAAM,YAAY,CAChB,OAAO,CAAC,KAAK,EAAE,EACf;YACE,WAAW;YACX,MAAM,EAAE,KAAK,EAAE,MAAM,IAAI,IAAI;YAC7B,IAAI,EAAE,SAAS;YACf,GAAG,EAAE,sBAAsB;YAC3B,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;SACvD,EACD,GAAG,EAAE,CACH,MAAM,CAAC,UAAU,EAAE;YACjB,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;YACvC,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;YACvD,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC,CACL,CAAA;QACD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;IACtE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CACL,CAAA;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAiB,EAAW,EAAE;IAC/D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,CACjD,4FAA4F,CAC7F,CAAA;IAED,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,2BAA2B,CAAC;SACxC,MAAM,CAAC,KAAK;QACX,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;YACvD,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,mBAAmB,CAAC,EAAE,CAAC,CAAA;QAC7G,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEJ,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SAC5D,WAAW,CAAC,2EAA2E,CAAC;SACxF,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;SACtC,MAAM,CAAC,iBAAiB,EAAE,oEAAoE,CAAC;SAC/F,MAAM,CAAC,gBAAgB,EAAE,qFAAqF,CAAC,CAAA;IAClH,IAAI,GAAG,CAAC,YAAY;QAAE,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,4DAA4D,CAAC,CAAA;IACvG,GAAG,CAAC,MAAM,CAAC,KAAK,WAA0B,GAAW;QACnD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAA4D,CAAA;QACrF,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;YACvD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAA;YAClE,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;YAC9D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;gBACtC,MAAM,IAAI,QAAQ,CAChB,uBAAuB,EACvB,yCAAyC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;oBACnF,0BAA0B,OAAO,CAAC,KAAK,0BAA0B;oBACjE,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1E,CAAA;YACH,CAAC;YACD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACpC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,eAAe,CAAC,CAAA;YACtE,0EAA0E;YAC1E,MAAM,QAAQ,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,IAAI,EAAE;gBACrD,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;gBACtG,IAAI,OAAO,CAAC,WAAW,IAAI,CAAC,MAAM;oBAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,iBAAiB,CAAC,CAAA;gBAC7F,MAAM,UAAU,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YACvF,CAAC,CAAC,CAAA;YACF,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;SACnD,WAAW,CAAC,+EAA+E,CAAC;SAC5F,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;SAChC,MAAM,CAAC,KAAK,WAA0B,GAAW;QAChD,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,CAAA;QACnD,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACjC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC,CAAA;YACvD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAA;YACxE,MAAM,QAAQ,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YACjE,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,mBAAmB,CAAC,EAAE,CAAC,CAAA;QAC7G,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEJ,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/dist/cli/bot/store.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+import type { BotMessenger } from "./port.js";
+/**
+ * `bot store fetch`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
+ * personal `messages sync` does. Mounted for a messenger whose Bot API pages back through a chat.
+ */
+export declare const botStoreCommand: (bot: BotMessenger, fetching: NonNullable<BotMessenger["fetching"]>) => Command;
+//# sourceMappingURL=store.d.ts.map

package/dist/cli/bot/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAS7C;;;GAGG;AACH,eAAO,MAAM,eAAe,QAAS,YAAY,YAAY,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,KAAG,OA4EpG,CAAA"}

package/dist/cli/bot/store.js

@@ -0,0 +1,87 @@
+import { CliError } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { fetchInto } from "../../services/archive.js";
+import { momentOf } from "../../services/moment.js";
+import { stopOnSignal } from "../messenger/patience.js";
+import { parseDuration } from "../settings.js";
+import { botContext, online } from "./context.js";
+import { botCan, botIdOf } from "./messages.js";
+const wholeNumber = (value) => {
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1)
+        throw new CliError("validation_error", `a whole number, 1 or more — got ${value}`);
+    return parsed;
+};
+/**
+ * `bot store fetch`: a chat's history into the bot's local copy, newest to oldest and resumable, as the
+ * personal `messages sync` does. Mounted for a messenger whose Bot API pages back through a chat.
+ */
+export const botStoreCommand = (bot, fetching) => {
+    const command = new Command("store").description("the bot's local copy on this machine");
+    const fetch = command
+        .command("fetch")
+        .description("fetch a chat's history into the bot's local copy, newest first; run it again to continue")
+        .argument("<chat>", "a chat id, or the title of a chat this bot has seen")
+        .option("--limit <n>", `at most this many messages in this run; ${fetching.maxPages * fetching.page} if not given`, wholeNumber)
+        .option("--page-size <n>", `how many messages one request asks for; ${fetching.page} if not given`, wholeNumber)
+        .option("--pause <duration>", "pause between pages, to stay under the messenger's limits", fetching.pause)
+        .option("--since-time <time>", "stop once it reaches messages older than this: ISO 8601, or 2h / 1d ago")
+        .option("--last <n>", "stop once the newest n messages are held", wholeNumber);
+    if (fetching.from)
+        fetch.option("--from <link>", fetching.from);
+    fetch.action(async function (chat) {
+        const options = this.opts();
+        if (options.sinceTime !== undefined && options.last !== undefined) {
+            throw new CliError("validation_error", "give --since-time or --last, not both: how far back the fetch goes");
+        }
+        const pauseMs = parseDuration(options.pause, "--pause");
+        const sinceMs = options.sinceTime === undefined ? undefined : momentOf(options.sinceTime, "--since-time");
+        const context = online(botContext(this, bot), this);
+        const ref = context.chatRef(chat);
+        const stop = stopOnSignal(this);
+        try {
+            await context.run(async (events) => {
+                const adapter = await context.authenticated({
+                    events,
+                    stop: stop.signal,
+                    history: { pauseMs, ...(options.from === undefined ? {} : { from: options.from }) },
+                });
+                try {
+                    const page = botCan(adapter, "historyBefore", bot, "read a chat back");
+                    const botId = await botIdOf(context, adapter);
+                    const account = context.copy.accountOf(botId);
+                    const result = await context.copy.read((store) => fetchInto({
+                        history: async (window) => {
+                            const read = await page(ref, window);
+                            await store.saveMessages(account, ref, read.items, { via: "history" });
+                            const senders = adapter.senders?.() ?? [];
+                            if (senders.length > 0)
+                                await store.savePeople(account, senders);
+                            return read;
+                        },
+                        store,
+                        account,
+                        fetching,
+                        limit: options.limit ?? fetching.maxPages * fetching.page,
+                        pageSize: options.pageSize ?? fetching.page,
+                        pauseMs,
+                        ...(sinceMs === undefined ? {} : { sinceMs }),
+                        ...(options.last === undefined ? {} : { last: options.last }),
+                        note: context.renderer.note,
+                        stop: stop.signal,
+                        onPage: () => { },
+                    }));
+                    context.renderer.result(result);
+                }
+                finally {
+                    await adapter.close();
+                }
+            });
+        }
+        finally {
+            stop.release();
+        }
+    });
+    return command;
+};
+//# sourceMappingURL=store.js.map

package/dist/cli/bot/store.js.map

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

package/dist/cli/bot/token.d.ts

@@ -0,0 +1,31 @@
+import { type CredentialSource, type KeyringStore } from "@wirecat/cli-base";
+import { type AppIdentity } from "../app.js";
+export interface BotTokenStoreOptions {
+    app: AppIdentity;
+    profile: string;
+    env?: NodeJS.ProcessEnv;
+    keyring?: KeyringStore;
+    configDir?: string;
+}
+/**
+ * A bot token per profile, beside — never inside — the personal session: keyring account
+ * `bot:<profile>` under the app's own service, `<PREFIX>_BOT_TOKEN`, then a 0600 file.
+ */
+export declare class BotTokenStore {
+    #private;
+    readonly profile: string;
+    constructor({ app, profile, env, keyring, configDir }: BotTokenStoreOptions);
+    read(): {
+        token: string;
+        source: CredentialSource;
+    } | undefined;
+    write(token: string): CredentialSource;
+    readKeyring(): string | undefined;
+    readStored(): {
+        secret: string;
+        source: CredentialSource;
+    } | undefined;
+    writeKeyring(token: string): void;
+    remove(): CredentialSource[];
+}
+//# sourceMappingURL=token.d.ts.map

package/dist/cli/bot/token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EAErB,KAAK,YAAY,EAGlB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,WAAW,CAAA;AAErD,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,WAAW,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,YAAY,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,qBAAa,aAAa;;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAKxB,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,GAAiB,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,oBAAoB,EAqBxF;IAED,IAAI,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,GAAG,SAAS,CAG9D;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAErC;IAED,WAAW,IAAI,MAAM,GAAG,SAAS,CAGhC;IAED,UAAU,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,GAAG,SAAS,CAMrE;IAED,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAMhC;IAED,MAAM,IAAI,gBAAgB,EAAE,CAE3B;CACF"}

package/dist/cli/bot/token.js

@@ -0,0 +1,65 @@
+import { CliError, Credentials, pathsAreOverridden, resolvePaths, } from "@wirecat/cli-base";
+import { envName } from "../app.js";
+/**
+ * A bot token per profile, beside — never inside — the personal session: keyring account
+ * `bot:<profile>` under the app's own service, `<PREFIX>_BOT_TOKEN`, then a 0600 file.
+ */
+export class BotTokenStore {
+    profile;
+    #account;
+    #credentials;
+    #keyringCredentials;
+    constructor({ app, profile, env = process.env, keyring, configDir }) {
+        const where = { appName: app.appName, prefix: app.envPrefix, env };
+        this.profile = profile;
+        this.#account = `bot:${profile}`;
+        this.#credentials = new Credentials({
+            configDir: configDir ?? resolvePaths(where).config,
+            service: app.appName,
+            envVar: envName(app, "BOT_TOKEN"),
+            isolated: pathsAreOverridden(where),
+            ...(keyring ? { keyring } : {}),
+            env,
+            warn: (message) => process.stderr.write(`${message}\n`),
+        });
+        this.#keyringCredentials = new Credentials({
+            configDir: configDir ?? resolvePaths(where).config,
+            service: app.appName,
+            isolated: pathsAreOverridden(where),
+            storage: "keyring",
+            ...(keyring ? { keyring } : {}),
+            env,
+        });
+    }
+    read() {
+        const stored = this.#credentials.read(this.#account);
+        return stored ? { token: stored.secret, source: stored.source } : undefined;
+    }
+    write(token) {
+        return this.#credentials.write(this.#account, token);
+    }
+    readKeyring() {
+        const stored = this.readStored();
+        return stored?.source === "keyring" ? stored.secret : undefined;
+    }
+    readStored() {
+        try {
+            return this.#keyringCredentials.read(this.#account);
+        }
+        catch {
+            throw new CliError("configuration_error", "the OS keyring is unavailable for the destination bot profile");
+        }
+    }
+    writeKeyring(token) {
+        try {
+            this.#keyringCredentials.write(this.#account, token);
+        }
+        catch {
+            throw new CliError("configuration_error", "the returned bot credential could not be stored in the OS keyring");
+        }
+    }
+    remove() {
+        return this.#credentials.remove(this.#account);
+    }
+}
+//# sourceMappingURL=token.js.map

package/dist/cli/bot/token.js.map

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

package/dist/cli/bot/updates.d.ts

@@ -0,0 +1,23 @@
+import type { BotPress } from "./port.js";
+/**
+ * Where the bot's next poll starts. State, not cache: a poll with it confirms everything before it
+ * to the messenger for every reader of this bot, so losing it prints a batch twice and never loses
+ * one. `{ "marker": … }`, the shape max-cli has always written.
+ */
+export declare class UpdatesCursor {
+    #private;
+    constructor(path: string);
+    read(): string | undefined;
+    write(marker: string): void;
+}
+/** The buttons `bot watch` saw pressed, so `bot callbacks answer --text` can find the message later. */
+export declare class PressLog {
+    #private;
+    constructor(path: string);
+    find(callbackId: string): BotPress | undefined;
+    /** The same press twice is kept once: a batch the copy refused comes again. */
+    add(presses: readonly (BotPress & {
+        callbackId: string;
+    })[], now?: Date): void;
+}
+//# sourceMappingURL=updates.d.ts.map

package/dist/cli/bot/updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updates.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/updates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEzC;;;;GAIG;AACH,qBAAa,aAAa;;IAGxB,YAAY,IAAI,EAAE,MAAM,EAEvB;IAED,IAAI,IAAI,MAAM,GAAG,SAAS,CAQzB;IAED,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1B;CACF;AAUD,wGAAwG;AACxG,qBAAa,QAAQ;;IAGnB,YAAY,IAAI,EAAE,MAAM,EAEvB;IAYD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAG7C;IAED,+EAA+E;IAC/E,GAAG,CAAC,OAAO,EAAE,SAAS,CAAC,QAAQ,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,EAAE,GAAG,OAAa,GAAG,IAAI,CASnF;CACF"}

package/dist/cli/bot/updates.js

@@ -0,0 +1,61 @@
+import { existsSync, readFileSync } from "node:fs";
+import { writeSecurely } from "@wirecat/cli-base";
+/**
+ * Where the bot's next poll starts. State, not cache: a poll with it confirms everything before it
+ * to the messenger for every reader of this bot, so losing it prints a batch twice and never loses
+ * one. `{ "marker": … }`, the shape max-cli has always written.
+ */
+export class UpdatesCursor {
+    #path;
+    constructor(path) {
+        this.#path = path;
+    }
+    read() {
+        if (!existsSync(this.#path))
+            return undefined;
+        try {
+            const { marker } = JSON.parse(readFileSync(this.#path, "utf8"));
+            return typeof marker === "string" ? marker : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    write(marker) {
+        writeSecurely(this.#path, `${JSON.stringify({ marker })}\n`, 0o600);
+    }
+}
+const KEPT_PRESSES = 500;
+const PRESS_LIFETIME_MS = 24 * 60 * 60 * 1000;
+/** The buttons `bot watch` saw pressed, so `bot callbacks answer --text` can find the message later. */
+export class PressLog {
+    #path;
+    constructor(path) {
+        this.#path = path;
+    }
+    #read() {
+        if (!existsSync(this.#path))
+            return [];
+        try {
+            const { presses } = JSON.parse(readFileSync(this.#path, "utf8"));
+            return Array.isArray(presses) ? presses : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    find(callbackId) {
+        const found = this.#read().find((press) => press.callbackId === callbackId);
+        return found ? { chatId: found.chatId, messageId: found.messageId } : undefined;
+    }
+    /** The same press twice is kept once: a batch the copy refused comes again. */
+    add(presses, now = new Date()) {
+        if (presses.length === 0)
+            return;
+        const fresh = this.#read().filter((press) => now.getTime() - Date.parse(press.at) < PRESS_LIFETIME_MS &&
+            !presses.some((one) => one.callbackId === press.callbackId));
+        const added = presses.map((press) => ({ ...press, at: now.toISOString() }));
+        writeSecurely(this.#path, `${JSON.stringify({ presses: [...fresh, ...added].slice(-KEPT_PRESSES) })}\n`, 0o600);
+    }
+}
+//# sourceMappingURL=updates.js.map

package/dist/cli/bot/updates.js.map

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

package/dist/cli/bot/watch.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+import type { BotMessenger } from "./port.js";
+/**
+ * `bot watch`: what happens in the bot's chats, as it arrives, until Ctrl-C or `--timeout` — both a
+ * normal end. Each batch is kept before it is printed, and the cursor moves only after that: an end
+ * at any moment never loses a batch. An update the messenger names by id is recorded and skipped when it
+ * comes again after being handled; one without an id may print twice. A read: it changes nothing anyone sees.
+ */
+export declare const botWatchCommand: (bot: BotMessenger) => Command;
+//# sourceMappingURL=watch.d.ts.map

package/dist/cli/bot/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/watch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAMnC,OAAO,KAAK,EAAY,YAAY,EAAa,MAAM,WAAW,CAAA;AAwFlE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,YAAY,KAAG,OA4H9C,CAAA"}