@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/cli/bot/messages.js

@@ -0,0 +1,263 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { validateFormattedText } from "../../domain/formatting.js";
+import { renderMessages } from "../../render/messages.js";
+import { guardedWrite } from "../../sends/guarded.js";
+import { newOperationId } from "../../sends/send-id.js";
+import { readAttachments } from "../../sends/upload.js";
+import { environmentOf } from "../context.js";
+import { readAll } from "../messenger/stdin.js";
+import { listed, positiveCount } from "../paging.js";
+import { botContext } from "./context.js";
+/** The adapter's `method`, or a refusal naming what this messenger's bot cannot do. */
+export const botCan = (adapter, method, bot, what) => {
+    const found = adapter[method];
+    if (typeof found !== "function") {
+        throw new CliError("validation_error", `a ${bot.name ?? "messenger"} bot cannot ${what}`);
+    }
+    return found.bind(adapter);
+};
+/** The bot's own id — the key its local copy is kept under — remembered after the first time it is asked. */
+export const botIdOf = async (context, adapter) => {
+    const known = context.registry.botId();
+    if (known)
+        return known;
+    const { id } = await adapter.me();
+    context.registry.rememberBot(id);
+    return id;
+};
+const show = (context, bot, messages, one = false) => {
+    if (context.format === "pretty") {
+        context.streams.data(renderMessages(messages, {
+            color: context.color,
+            verbosity: context.settings.detail,
+            senderColors: context.settings.senderColors,
+            profile: context.profile,
+            provider: bot.provider,
+            locale: bot.app.locale,
+        }));
+    }
+    else if (context.format === "jsonl")
+        context.renderer.stream(messages);
+    else
+        context.renderer.result(one ? messages[0] : listed(messages));
+};
+/** Says what fills the copy, rather than printing an empty list. */
+const nothingKept = (context) => new CliError("not_found", `this bot has kept nothing on this machine yet — run \`${context.words} messages list <chat>\` once without --offline`);
+const marks = (md, html) => {
+    if (md && html)
+        throw new CliError("validation_error", "--md and --html mark up the text two ways; use one");
+};
+/** Wrote somewhere real — a numeric chat — so the bot has seen that chat. */
+const seen = (context, message) => {
+    if (/^-?\d+$/.test(message.chatId))
+        context.registry.observe([{ id: message.chatId }]);
+};
+const sendCommand = (bot) => annotate(new Command("send"), { mutates: true })
+    .description("send a message as the bot; without [text], the text is read from stdin")
+    .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+    .argument("[text]", "the message")
+    .option("--reply-to <message>", "answer this message, by its id in the same chat")
+    .option("--silent", "deliver without a notification")
+    .option("--md", "read this messenger's Markdown; see its formatting guide for supported syntax")
+    .option("--html", "the text is HTML: <b>, <i>, <a href>, <code>")
+    .option("--file <file>", "attach a file; the text becomes its caption")
+    .option("--photo <file>", "attach a .jpg, .png or .webp as a photo; the text becomes its caption")
+    .option("--as-file", "send the --file as a file to download, a video included")
+    .option("--voice <file>", "send an Ogg Opus file as a voice message, alone, with no text")
+    .option("--allow-any-file", "send a file even from credential folders or this CLI's own folders")
+    .action(async function (chat, text) {
+    const context = botContext(this, bot);
+    const options = this.opts();
+    marks(options.md, options.html);
+    const ref = context.chatRef(chat);
+    const attachments = await readAttachments({
+        ...(options.photo === undefined ? {} : { photo: options.photo }),
+        ...(options.file === undefined ? {} : { file: options.file }),
+        ...(options.voice === undefined ? {} : { voice: options.voice }),
+        ...(text === undefined ? {} : { text }),
+        asFile: options.asFile === true,
+    }, { app: bot.app, env: context.env, anyFile: options.allowAnyFile === true });
+    const body = text ?? (attachments.length > 0 ? "" : await readAll(environmentOf(this).stdin ?? process.stdin));
+    if (body.trim() === "" && attachments.length === 0) {
+        throw new CliError("validation_error", "nothing to send — give the text or pipe it in");
+    }
+    const replyTo = options.replyTo?.trim();
+    await context.run(async (events) => {
+        const adapter = await context.authenticated({ events });
+        const send = botCan(adapter, "send", bot, "send messages");
+        const { text: plain, spans } = options.md
+            ? validateFormattedText(await botCan(adapter, "formatMarkdown", bot, "format Markdown")(body))
+            : { text: body, spans: [] };
+        if (plain.trim() === "" && !attachments.length)
+            throw new CliError("validation_error", "nothing to send after formatting");
+        const operationId = newOperationId();
+        const message = await guardedWrite(context.guard(), {
+            operationId,
+            chatId: ref,
+            kind: "message",
+            key: "bot.messages.send",
+            length: plain.length,
+            ...(replyTo ? { replyTo } : {}),
+        }, () => send(ref, plain, {
+            ...(replyTo ? { replyTo } : {}),
+            ...(options.silent ? { silent: true } : {}),
+            ...(spans.length > 0 ? { formatting: spans } : {}),
+            ...(options.html ? { html: true } : {}),
+            ...(attachments.length > 0 ? { attachments } : {}),
+        }), (sent) => ({ messageId: sent.id }));
+        seen(context, message);
+        if (message.senderId)
+            context.registry.rememberBot(message.senderId);
+        const botId = message.senderId ?? (await botIdOf(context, adapter));
+        await context.copy.keep(botId, [message], "send", context.renderer.warn, adapter.senders?.());
+        context.renderer.result({ operationId, message });
+    });
+});
+const listCommand = (bot) => new Command("list")
+    .description(`the latest messages in a chat; where ${bot.name ?? "the messenger"} gives a bot no history, and with --offline, ` +
+    "the ones this bot has seen on this machine")
+    .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+    .option("--limit <n>", "how many, the newest", positiveCount("--limit"))
+    .action(async function (chat) {
+    const context = botContext(this, bot);
+    const ref = context.chatRef(chat);
+    const limit = this.opts().limit ?? context.settings.limit;
+    await context.run(async (events) => {
+        const fromCopy = async (botId) => {
+            const page = await context.copy.read((store) => store.messages(context.copy.accountOf(botId), ref, { limit }));
+            return page.items;
+        };
+        if (context.settings.offline) {
+            const botId = context.registry.botId();
+            if (!botId)
+                throw nothingKept(context);
+            show(context, bot, await fromCopy(botId));
+            return;
+        }
+        const adapter = await context.authenticated({ events });
+        const botId = await botIdOf(context, adapter);
+        if (!adapter.history) {
+            context.renderer.note(`${bot.name ?? "the messenger"} gives a bot no history: these are the messages it kept`);
+            show(context, bot, await fromCopy(botId));
+            return;
+        }
+        const messages = await adapter.history(ref, { limit });
+        await context.copy.keep(botId, messages, "history", context.renderer.warn, adapter.senders?.());
+        if (/^-?\d+$/.test(ref))
+            context.registry.observe([{ id: ref }]);
+        show(context, bot, messages);
+    });
+});
+const showCommand = (bot) => new Command("show")
+    .description("one message by its id in a chat")
+    .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+    .argument("<message>", "message id")
+    .action(async function (chat, messageId) {
+    const context = botContext(this, bot);
+    const ref = context.chatRef(chat);
+    await context.run(async (events) => {
+        const fromCopy = async (botId) => {
+            const kept = await context.copy.read((store) => store.message(context.copy.accountOf(botId), messageId, { chatId: ref }));
+            if (!kept)
+                throw new CliError("not_found", `message ${messageId} is not in this bot's local copy`);
+            return kept;
+        };
+        if (context.settings.offline) {
+            const botId = context.registry.botId();
+            if (!botId)
+                throw nothingKept(context);
+            show(context, bot, [await fromCopy(botId)], true);
+            return;
+        }
+        const adapter = await context.authenticated({ events });
+        const botId = await botIdOf(context, adapter);
+        if (!adapter.message) {
+            show(context, bot, [await fromCopy(botId)], true);
+            return;
+        }
+        const found = await adapter.message(ref, messageId);
+        await context.copy.keep(botId, [found], "history", context.renderer.warn, adapter.senders?.());
+        show(context, bot, [found], true);
+    });
+});
+const editCommand = (bot) => annotate(new Command("edit"), { mutates: true })
+    .description("replace the text of a message the bot sent")
+    .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+    .argument("<message>", "message id")
+    .argument("<text>", "the new text")
+    .option("--md", "read this messenger's Markdown; see its formatting guide for supported syntax")
+    .option("--html", "the text is HTML: <b>, <i>, <a href>, <code>")
+    .action(async function (chat, messageId, text) {
+    const context = botContext(this, bot);
+    const options = this.opts();
+    marks(options.md, options.html);
+    const ref = context.chatRef(chat);
+    await context.run(async (events) => {
+        const adapter = await context.authenticated({ events });
+        const edit = botCan(adapter, "edit", bot, "edit messages");
+        const { text: plain, spans } = options.md
+            ? validateFormattedText(await botCan(adapter, "formatMarkdown", bot, "format Markdown")(text))
+            : { text, spans: [] };
+        if (plain.trim() === "")
+            throw new CliError("validation_error", "no new text after formatting");
+        const operationId = newOperationId();
+        const message = await guardedWrite(context.guard(), { operationId, chatId: ref, kind: "edit", key: "bot.messages.edit", messageId, length: plain.length }, () => edit(ref, messageId, plain, {
+            ...(spans.length > 0 ? { formatting: spans } : {}),
+            ...(options.html ? { html: true } : {}),
+        }));
+        await context.copy.keep(await botIdOf(context, adapter), [message], "send", context.renderer.warn, adapter.senders?.());
+        context.renderer.result({ operationId, message });
+    });
+});
+const deleteCommand = (bot) => annotate(new Command("delete"), { mutates: true })
+    .description("delete messages in a chat the bot can delete in; it cannot be undone")
+    .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+    .argument("<messages...>", "message ids")
+    .option("--allow-dangerous", "delete without asking")
+    .action(async function (chat, messageIds) {
+    const context = botContext(this, bot);
+    const ref = context.chatRef(chat);
+    await context.run(async (events) => {
+        const adapter = await context.authenticated({ events });
+        const remove = botCan(adapter, "delete", bot, "delete messages");
+        const operationId = newOperationId();
+        await guardedWrite(context.guard(), { operationId, chatId: ref, kind: "delete", key: "bot.messages.delete", count: messageIds.length }, () => remove(ref, messageIds));
+        await context.copy.forget(await botIdOf(context, adapter), ref, messageIds, context.renderer.warn);
+        context.renderer.result({ operationId, deleted: messageIds });
+    });
+});
+const pinCommand = (bot, pin) => {
+    const command = annotate(new Command(pin ? "pin" : "unpin"), { mutates: true })
+        .description(pin ? "pin a message in a chat; quietly unless --notify" : "unpin a message in a chat")
+        .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+        .argument("<message>", "message id");
+    if (pin)
+        command.option("--notify", "tell the chat's members");
+    return command.action(async function (chat, messageId) {
+        const context = botContext(this, bot);
+        const ref = context.chatRef(chat);
+        const notify = this.opts().notify === true;
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            const operationId = newOperationId();
+            const key = pin ? "bot.messages.pin" : "bot.messages.unpin";
+            await guardedWrite(context.guard(), { operationId, chatId: ref, kind: "pin", key, messageId }, () => pin
+                ? botCan(adapter, "pin", bot, "pin messages")(ref, messageId, { notify })
+                : botCan(adapter, "unpin", bot, "unpin messages")(ref, messageId));
+            context.renderer.result({ operationId, chatId: ref, messageId, pinned: pin });
+        });
+    });
+};
+/** `bot messages`: the bot's own messages, under the names the personal account uses. */
+export const botMessagesCommand = (bot) => new Command("messages")
+    .description("the messages in the chats this bot is in")
+    .addCommand(sendCommand(bot))
+    .addCommand(listCommand(bot))
+    .addCommand(showCommand(bot))
+    .addCommand(editCommand(bot))
+    .addCommand(deleteCommand(bot))
+    .addCommand(pinCommand(bot, true))
+    .addCommand(pinCommand(bot, false));
+//# sourceMappingURL=messages.js.map

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

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

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

@@ -0,0 +1,10 @@
+import { Command } from "commander";
+import type { BotMessenger } from "./port.js";
+/** `bot chats rules show|set|unset`: kept on this machine, the chat named the bot's way. */
+export declare const botRulesCommand: (bot: BotMessenger) => Command;
+/**
+ * `bot chats moderate`: the personal `chats moderate`, done by the bot. Typing it is the consent for
+ * what the rules name. A removal bans unless `--no-ban`.
+ */
+export declare const botModerateCommand: (bot: BotMessenger) => Command;
+//# sourceMappingURL=moderation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/moderation.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAYnC,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,WAAW,CAAA;AAkBzD,4FAA4F;AAC5F,eAAO,MAAM,eAAe,QAAS,YAAY,KAAG,OAqCnD,CAAA;AA2FD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,QAAS,YAAY,KAAG,OAgEjD,CAAA"}

package/dist/cli/bot/moderation.js

@@ -0,0 +1,187 @@
+import { existsSync, readFileSync } from "node:fs";
+import { CliError, writeSecurely } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { CHECK_READS, describe, MAX_ACTIONS } from "../../moderation/check.js";
+import { defaultRules, ModerationRules, moderationPathFor, RULE_KEYS } from "../../moderation/rules.js";
+import { moderateWith } from "../../moderation/run.js";
+import { guardedWrite } from "../../sends/guarded.js";
+import { newOperationId } from "../../sends/send-id.js";
+import { momentOf } from "../../services/moment.js";
+import { environmentOf } from "../context.js";
+import { answerOf } from "../messenger/ask.js";
+import { botContext, online } from "./context.js";
+import { botCan, botIdOf } from "./messages.js";
+import { botFiles } from "./registry.js";
+const CHAT = "a group's id, or the title of a group this bot has seen";
+/** The personal profile of the same name keeps its rules in this file too: one group's rules, whoever acts on them. */
+const rulesOf = (context, bot) => new ModerationRules(moderationPathFor(bot.app, context.profile, context.env));
+const titleOf = (context, chatId) => context.registry.list().find((one) => one.id === chatId)?.title ?? null;
+const shown = (context, chatId, rules) => {
+    const saved = rules.read(chatId);
+    const title = titleOf(context, chatId);
+    return { chatId, title, file: rules.path, saved: saved !== undefined, rules: saved ?? defaultRules(title) };
+};
+/** `bot chats rules show|set|unset`: kept on this machine, the chat named the bot's way. */
+export const botRulesCommand = (bot) => {
+    const command = new Command("rules").description("a chat's moderation rules for this bot, kept on this machine");
+    command
+        .command("show")
+        .description("the chat's rules; the defaults, marked not saved, if it has none yet")
+        .argument("<chat>", CHAT)
+        .action(function (chat) {
+        const context = botContext(this, bot);
+        context.renderer.result(shown(context, context.chatRef(chat), rulesOf(context, bot)));
+    });
+    annotate(command.command("set"), { mutates: true, local: true })
+        .description(`change one rule — ${RULE_KEYS.join(", ")}`)
+        .argument("<chat>", CHAT)
+        .argument("<key>", "the rule")
+        .argument("<value>", "its new value")
+        .action(function (chat, key, value) {
+        const context = botContext(this, bot);
+        if (key.startsWith("newAccount.")) {
+            throw new CliError("validation_error", "a bot is not told how old an account is, so newAccount cannot work");
+        }
+        const chatId = context.chatRef(chat);
+        const rules = rulesOf(context, bot);
+        rules.set(chatId, titleOf(context, chatId), key, value);
+        context.renderer.result(shown(context, chatId, rules));
+    });
+    annotate(command.command("unset"), { mutates: true, local: true })
+        .description("put one rule back to its default")
+        .argument("<chat>", CHAT)
+        .argument("<key>", "the rule")
+        .action(function (chat, key) {
+        const context = botContext(this, bot);
+        const chatId = context.chatRef(chat);
+        const rules = rulesOf(context, bot);
+        rules.unset(chatId, titleOf(context, chatId), key);
+        context.renderer.result(shown(context, chatId, rules));
+    });
+    return command;
+};
+/** Beside the bot's other state, one file per bot: max-cli's `bots/checks/<profile>.json`. */
+const savedPoint = (path) => {
+    const all = () => existsSync(path)
+        ? (JSON.parse(readFileSync(path, "utf8")).points ?? {})
+        : {};
+    return {
+        read: (chatId) => all()[chatId],
+        write: (chatId, at) => writeSecurely(path, `${JSON.stringify({ points: { ...all(), [chatId]: at } })}\n`, 0o600),
+    };
+};
+const gatherer = (command, context, bot, adapter, botId, chatId) => async (since) => {
+    const notes = [];
+    const read = adapter.historySince
+        ? await adapter.historySince(chatId, since, CHECK_READS)
+        : await context.copy.read(async (store) => {
+            const page = await store.messages(context.copy.accountOf(botId), chatId, {
+                limit: CHECK_READS,
+                since: new Date(since).toISOString(),
+            });
+            return { messages: page.items, more: page.hasMore };
+        });
+    if (!adapter.historySince) {
+        notes.push(`${bot.name ?? "the messenger"} gives a bot no history: judged from what \`${context.words} watch\` kept`);
+    }
+    const messages = [...read.messages].sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
+    const admins = adapter.admins ? await adapter.admins(chatId) : null;
+    if (admins === null)
+        notes.push("the group's admins are not known, so only the bot's own messages are exempt");
+    const joined = bot.joinsSince?.(command, context.profile, chatId, since);
+    if (!bot.joinsSince)
+        notes.push("this messenger's bot keeps no joins, so only messages are judged");
+    else if (joined === undefined)
+        notes.push(`no joins kept for this bot — run \`${context.words} watch\` to have them judged`);
+    return {
+        messages,
+        joined: joined ?? [],
+        answerers: new Set((admins ?? []).map((admin) => admin.id)),
+        service: new Set(),
+        until: messages.at(-1)?.timestamp ?? null,
+        more: read.more,
+        notes,
+    };
+};
+/** Each action through the bot's guard under `bot.chats.moderate`: typing the command was the consent. */
+const moderatorOf = (context, bot, adapter, botId, ban) => ({
+    deleteMessage: async (chatId, messageId) => {
+        const remove = botCan(adapter, "delete", bot, "delete messages");
+        await guardedWrite(context.guard(), { operationId: newOperationId(), chatId, kind: "delete", count: 1, key: "bot.chats.moderate" }, () => remove(chatId, [messageId]));
+        await context.copy.forget(botId, chatId, [messageId], context.renderer.warn);
+    },
+    removePerson: async (chatId, personId) => {
+        const remove = botCan(adapter, "removeMember", bot, "remove people from a group");
+        await guardedWrite(context.guard(), {
+            operationId: newOperationId(),
+            chatId,
+            kind: "chat",
+            action: "members.remove",
+            people: 1,
+            key: "bot.chats.moderate",
+        }, () => remove(chatId, personId, { block: ban }));
+    },
+});
+const yes = (answer) => /^\s*y(es)?\s*$/i.test(answer);
+/**
+ * `bot chats moderate`: the personal `chats moderate`, done by the bot. Typing it is the consent for
+ * what the rules name. A removal bans unless `--no-ban`.
+ */
+export const botModerateCommand = (bot) => annotate(new Command("moderate"), { mutates: true })
+    .description("judge a group's new messages and joins by its rules, and act as they allow — as the bot")
+    .argument("<chat>", CHAT)
+    .option("--since-time <time>", "judge what came after this ISO 8601 time, or 2h / 1d ago; the saved point stays")
+    .option("--dry-run", "judge and plan; do nothing")
+    .option("--allow-dangerous", "yes to every action whose level in the group's rules is ask")
+    .option("--no-ban", "remove without banning; by default a removed person cannot come back by the link")
+    .option("--max-actions <n>", `at most this many actions in one run; ${MAX_ACTIONS} if not given`)
+    .action(async function (chat) {
+    const context = online(botContext(this, bot), this);
+    const options = this.opts();
+    const maxActions = options.maxActions === undefined ? MAX_ACTIONS : Number(options.maxActions);
+    if (!Number.isInteger(maxActions) || maxActions < 0) {
+        throw new CliError("validation_error", `--max-actions takes a whole number — got ${String(options.maxActions)}`);
+    }
+    const chatId = context.chatRef(chat);
+    // An in-process caller's answer counts under --json too: it is not a terminal that could wait for ever.
+    const given = environmentOf(this).answer;
+    const ask = async (question) => (given ? await given(question) : await answerOf(this, question));
+    await context.run(async (events) => {
+        const adapter = await context.authenticated({ events });
+        const botId = await botIdOf(context, adapter);
+        const { rows, notes } = await moderateWith({
+            chatId,
+            title: titleOf(context, chatId),
+            rules: rulesOf(context, bot),
+            point: savedPoint(botFiles(bot.app, context.profile, context.env).checks),
+            gather: gatherer(this, context, bot, adapter, botId, chatId),
+            moderator: moderatorOf(context, bot, adapter, botId, options.ban),
+            command: bot.app.command,
+            commandFor: (group, finding) => finding.action === "delete"
+                ? `${context.words} messages delete ${group} ${finding.messageId} --allow-dangerous`
+                : `${context.words} chats members remove ${group} ${finding.personId}`,
+            ...(options.sinceTime === undefined ? {} : { since: momentOf(options.sinceTime, "--since-time") }),
+            dryRun: options.dryRun === true,
+            allowDangerous: options.allowDangerous === true,
+            maxActions,
+            confirm: async (finding) => {
+                const answer = await ask(`${describe(finding)}? [y/N] `);
+                return answer === null ? undefined : yes(answer);
+            },
+        });
+        context.renderer.result(context.format === "pretty"
+            ? rows.map((row) => ({
+                what: row.kind,
+                who: row.personName ?? row.personId,
+                rule: row.rule,
+                action: row.action,
+                outcome: row.outcome,
+                ...(row.reason ? { why: row.reason } : {}),
+            }))
+            : { chatId, rows });
+        for (const note of notes)
+            context.renderer.note(note);
+    });
+});
+//# sourceMappingURL=moderation.js.map

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

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

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

@@ -0,0 +1,14 @@
+import { Command } from "commander";
+import type { BotMessenger } from "./port.js";
+/** What a read may reach beyond this bot: `--all-bots`, or `--bots` naming some (max-cli, 2026-09-29). */
+export interface Across {
+    allBots?: boolean;
+    bots?: string[];
+}
+/** `bot contacts show`: one person this bot has seen write, from the local copy. */
+export declare const botContactsCommand: (bot: BotMessenger) => Command;
+/** `bot search messages`: the messages this bot's local copy holds. */
+export declare const botSearchCommand: (bot: BotMessenger) => Command;
+/** `bot messages between`, over the local copy, added to the shared `messages` group. */
+export declare const addBotCopyReads: (messages: Command, bot: BotMessenger) => void;
+//# sourceMappingURL=people.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"people.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/people.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAWnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAM7C,0GAA0G;AAC1G,MAAM,WAAW,MAAM;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB;AA0ID,oFAAoF;AACpF,eAAO,MAAM,kBAAkB,QAAS,YAAY,KAAG,OA6CtD,CAAA;AA0BD,uEAAuE;AACvE,eAAO,MAAM,gBAAgB,QAAS,YAAY,KAAG,OAoCpD,CAAA;AAED,yFAAyF;AACzF,eAAO,MAAM,eAAe,aAAc,OAAO,OAAO,YAAY,KAAG,IAuCtE,CAAA"}