@leemour/max-cli 0.12.0 → 0.14.0

package/dist/commands/bot-reads.js

@@ -0,0 +1,103 @@
+import { CliError } from "@leemour/cli-core";
+import { annotate } from "@leemour/cli-core/commands";
+import { pickChat, renderMessages } from "@leemour/cli-messaging";
+import { Command } from "commander";
+import { botOperations } from "../bot/client.js";
+import { botContext } from "./bot-context.js";
+import { guardedCall, sendCommands } from "./bot-sends.js";
+const CHAT_ID = /^-?\d+$/;
+/** An id as it is, or a title this bot has already seen — never a guess (ARCHITECTURE §9). */
+export const chatIdOf = (reference, registry) => {
+    if (CHAT_ID.test(reference))
+        return reference;
+    if (reference.startsWith("user:")) {
+        throw new CliError("validation_error", "a direct chat is read by its chat id; `user:<id>` is only for sending");
+    }
+    return pickChat(reference, registry.list()).id;
+};
+const operation = (id) => {
+    const found = botOperations.find((candidate) => candidate.id === id);
+    if (!found)
+        throw new CliError("configuration_error", `the generated manifest has no operation ${id}`);
+    return found;
+};
+export const messagesCommand = () => {
+    const command = new Command("messages").description("messages in the chats this bot is in");
+    command
+        .command("list <chat>")
+        .option("--limit <n>", "how many, up to 100", (value) => Number.parseInt(value, 10))
+        .description("the latest messages in a chat (--limit, up to 100) — its id, or the title of a chat this bot has seen")
+        .action(async function (chat) {
+        const context = botContext(this);
+        const limit = context.settings.limit;
+        if (limit > 100)
+            throw new CliError("validation_error", "a bot reads at most 100 messages at a time — --limit 100");
+        const client = context.authenticated();
+        const chatId = chatIdOf(chat, context.registry);
+        const self = (await client.me()).user_id;
+        const messages = await client.messages(chatId, limit, self);
+        context.registry.observe([{ id: chatId }]);
+        show(context, messages);
+    });
+    command
+        .command("get <message>")
+        .description("one message by its id (mid.…)")
+        .action(async function (message) {
+        const context = botContext(this);
+        const client = context.authenticated();
+        const self = (await client.me()).user_id;
+        show(context, [await client.message(message, self)]);
+    });
+    sendCommands(command);
+    return command;
+};
+const show = (context, messages) => {
+    if (context.format !== "pretty") {
+        context.renderer.result(messages);
+        return;
+    }
+    context.streams.data(renderMessages(messages, {
+        verbosity: context.settings.detail,
+        color: context.color,
+        profile: context.settings.profile,
+        provider: "max-bot",
+    }));
+};
+export const chatsCommand = () => {
+    const command = new Command("chats").description("the chats this bot is in — MAX gives a bot no list of them, so `list` shows the ones it has seen");
+    command
+        .command("list")
+        .description("chats this bot has seen on this machine — not a complete list from MAX")
+        .action(function () {
+        const { renderer, registry } = botContext(this);
+        renderer.result(registry.list());
+    });
+    command
+        .command("get <chat>")
+        .description("one chat from MAX, and remember it")
+        .action(async function (chat) {
+        const { renderer, registry, authenticated } = botContext(this);
+        const found = await authenticated().chat(chatIdOf(chat, registry));
+        registry.observe([found]);
+        renderer.result(found);
+    });
+    const write = (name, operationId, description, body) => annotate(command.command(name), { mutates: true })
+        .description(description)
+        .action(async function (chat, argument) {
+        const context = botContext(this);
+        const { renderer, registry } = context;
+        const chatId = chatIdOf(chat, registry);
+        const answer = await guardedCall(context, operation(operationId), {
+            path: { chatId },
+            ...(body ? { body: body(argument) } : {}),
+        });
+        registry.observe([{ id: chatId }]);
+        renderer.result(answer ?? { success: true });
+    });
+    write("pin <chat> <message>", "pinMessage", "pin a message in a chat", (message) => JSON.stringify({ message_id: message, notify: false }));
+    write("unpin <chat>", "unpinMessage", "unpin whatever is pinned in a chat");
+    write("leave <chat>", "leaveChat", "the bot leaves the chat; only an admin can bring it back");
+    write("action <chat> <action>", "sendAction", "show an action to the chat: typing_on, sending_photo, sending_video, sending_audio, sending_file, mark_seen", (action) => JSON.stringify({ action }));
+    return command;
+};
+//# sourceMappingURL=bot-reads.js.map

package/dist/commands/bot-reads.js.map

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

package/dist/commands/bot-sends.d.ts

@@ -0,0 +1,12 @@
+import type { ManifestOperation } from "@leemour/cli-core/codegen";
+import { Command } from "commander";
+import { type CallInput } from "../bot/transport.js";
+import { botContext } from "./bot-context.js";
+type Context = ReturnType<typeof botContext>;
+/** Every bot write, from any command: readOnly and allow, then the recipient list and the journal. */
+export declare const guardedCall: (context: Context, target: ManifestOperation, input: CallInput) => Promise<unknown>;
+export declare const sendCommands: (messages: Command) => void;
+export declare const recipientsCommand: () => Command;
+export declare const sendsCommand: () => Command;
+export {};
+//# sourceMappingURL=bot-sends.d.ts.map

package/dist/commands/bot-sends.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-sends.d.ts","sourceRoot":"","sources":["../../src/commands/bot-sends.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAIlE,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAK3C,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,qBAAqB,CAAA;AAE/D,OAAO,EAAiB,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE5D,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;AA6G5C,sGAAsG;AACtG,eAAO,MAAM,WAAW,YAAmB,OAAO,UAAU,iBAAiB,SAAS,SAAS,KAAG,OAAO,CAAC,OAAO,CAQhH,CAAA;AAED,eAAO,MAAM,YAAY,aAAc,OAAO,KAAG,IAqFhD,CAAA;AAED,eAAO,MAAM,iBAAiB,QAAO,OAoCpC,CAAA;AAED,eAAO,MAAM,YAAY,QAAO,OAQ3B,CAAA"}

package/dist/commands/bot-sends.js

@@ -0,0 +1,225 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError } from "@leemour/cli-core";
+import { annotate } from "@leemour/cli-core/commands";
+import { pickChat } from "@leemour/cli-messaging";
+import { newSendId, RecipientList, SendJournal, sendGuard } from "@leemour/cli-messaging/sends";
+import { Command, Option } from "commander";
+import { botOperations } from "../bot/client.js";
+import { checkBody } from "../bot/input.js";
+import { BOT_JOURNAL_KINDS } from "../bot/permissions.js";
+import { botsDirectory } from "../bot/registry.js";
+import { plainJson } from "../bot/transport.js";
+import { asFirstWord } from "../profile.js";
+import { assertAllowed, botContext } from "./bot-context.js";
+const operation = (id) => {
+    const found = botOperations.find((candidate) => candidate.id === id);
+    if (!found)
+        throw new CliError("configuration_error", `the generated manifest has no operation ${id}`);
+    return found;
+};
+/** How the owner types this bot, so every refusal names the command that fixes it. */
+const botWords = (profile) => `${asFirstWord(profile)}bot`;
+const files = (profile) => ({
+    journal: join(botsDirectory(), "sends", `${profile}.jsonl`),
+    recipients: join(botsDirectory(), "recipients", `${profile}.json`),
+});
+const recipientsOf = (context) => new RecipientList(files(context.settings.profile).recipients, `max ${botWords(context.settings.profile)}`);
+/**
+ * cli-messaging's guard with the bot's own recipient list and journal. `readOnly` and `allow` are
+ * checked before it, with the bot's permission names; a bot has no hourly limit (owner, `NEED-305`).
+ */
+const guardOf = (context) => sendGuard({
+    profile: botWords(context.settings.profile),
+    command: "max",
+    readOnly: false,
+    readOnlyFrom: "default",
+    sendsPerHour: Number.POSITIVE_INFINITY,
+    journal: new SendJournal(files(context.settings.profile).journal),
+    recipients: recipientsOf(context),
+    warn: (message) => context.streams.diagnostic(message),
+});
+const DIGITS = /^-?\d+$/;
+const targetOf = (reference, context) => {
+    if (DIGITS.test(reference))
+        return { key: reference, query: { chat_id: reference } };
+    const user = /^user:(\d+)$/.exec(reference);
+    if (user?.[1])
+        return { key: reference, query: { user_id: user[1] } };
+    const id = pickChat(reference, context.registry.list()).id;
+    return { key: id, query: { chat_id: id } };
+};
+const textOf = (text) => (text === "-" ? readFileSync(0, "utf8").replace(/\n$/, "") : text);
+/** Runs one write through the guard and the journal, on every outcome. */
+const guarded = async (context, request, body, length) => {
+    const guard = guardOf(context);
+    const sendId = newSendId();
+    const base = { chatId: request.chatId, kind: request.kind, sendId, ...(length === undefined ? {} : { length }) };
+    try {
+        guard.check(request);
+    }
+    catch (error) {
+        const code = error.code;
+        guard.record({ ...base, outcome: "refused", ...(code ? { errorCode: code } : {}) });
+        throw error;
+    }
+    try {
+        const { result, messageId } = await body(sendId);
+        guard.record({
+            ...base,
+            outcome: "sent",
+            ...(messageId ? { messageId } : {}),
+            ...(request.count ? { count: request.count } : {}),
+        });
+        return result;
+    }
+    catch (error) {
+        const code = error.code;
+        guard.record({
+            ...base,
+            outcome: code === "outcome_unknown" ? "outcome_unknown" : "failed",
+            ...(code ? { errorCode: code } : {}),
+        });
+        throw error;
+    }
+};
+const chatOfMessage = async (context, messageId) => {
+    const message = await context.authenticated().message(messageId);
+    return message.chatId;
+};
+/**
+ * Which chat a write reaches, from its own parameters — the recipient list must hold for
+ * `max bot api` as much as for `messages send`, or the raw command is the way around it.
+ */
+const chatOfCall = async (context, input) => {
+    const chat = input.path?.chatId ?? input.query?.chat_id;
+    if (typeof chat === "string")
+        return chat;
+    const user = input.query?.user_id;
+    if (typeof user === "string")
+        return `user:${user}`;
+    const message = input.path?.messageId ?? input.query?.message_id;
+    if (typeof message === "string")
+        return chatOfMessage(context, message);
+    return null;
+};
+/** Every bot write, from any command: readOnly and allow, then the recipient list and the journal. */
+export const guardedCall = async (context, target, input) => {
+    const client = context.authenticated();
+    if (target.effect === "read")
+        return client.call(target, input);
+    assertAllowed(target, context.settings);
+    const kind = BOT_JOURNAL_KINDS[target.id];
+    if (!kind)
+        return client.call(target, input);
+    const chatId = await chatOfCall(context, input);
+    return guarded(context, { chatId, kind }, async () => ({ result: await client.call(target, input) }));
+};
+export const sendCommands = (messages) => {
+    annotate(messages.command("send"), { mutates: true })
+        .description("send a message as the bot — to a chat id, `user:<id>`, or the title of a chat it has seen; - reads stdin")
+        .argument("<chat>")
+        .argument("<text>")
+        .addOption(new Option("--format <format>", "how the text is marked up").choices(["markdown", "html"]))
+        .option("--reply-to <message>", "answer this message")
+        .option("--silent", "no notification for the people in the chat")
+        .action(async function (chat, text) {
+        const context = botContext(this);
+        const options = this.opts();
+        const send = operation("sendMessage");
+        assertAllowed(send, context.settings);
+        const target = targetOf(chat, context);
+        const content = textOf(text);
+        const body = checkBody(send, JSON.stringify({
+            text: content,
+            ...(options.format ? { format: options.format } : {}),
+            ...(options.silent ? { notify: false } : {}),
+            ...(options.replyTo ? { link: { type: "reply", mid: options.replyTo } } : {}),
+        }));
+        const client = context.authenticated();
+        const sent = await guarded(context, { chatId: target.key, kind: "message" }, async () => {
+            const answer = (await client.call(send, { query: target.query, ...(body ? { body } : {}) }));
+            const message = answer?.message ? client.decodeMessage(answer.message) : undefined;
+            return { result: message ?? plainJson(answer), ...(message ? { messageId: message.id } : {}) };
+        }, content.length);
+        const recipientChat = sent.chatId;
+        if (recipientChat && DIGITS.test(recipientChat))
+            context.registry.observe([{ id: recipientChat }]);
+        context.renderer.result(sent);
+    });
+    annotate(messages.command("edit"), { mutates: true })
+        .description("replace the text of a message the bot sent; - reads stdin")
+        .argument("<message>")
+        .argument("<text>")
+        .addOption(new Option("--format <format>", "how the text is marked up").choices(["markdown", "html"]))
+        .action(async function (messageId, text) {
+        const context = botContext(this);
+        const edit = operation("editMessage");
+        assertAllowed(edit, context.settings);
+        const content = textOf(text);
+        const format = this.opts().format;
+        const body = checkBody(edit, JSON.stringify({ text: content, ...(format ? { format } : {}) }));
+        const chatId = await chatOfMessage(context, messageId);
+        const answer = await guarded(context, { chatId, kind: "edit" }, async () => ({
+            result: plainJson(await context.authenticated().call(edit, { query: { message_id: messageId }, ...(body ? { body } : {}) })),
+            messageId,
+        }), content.length);
+        context.renderer.result(answer ?? { success: true });
+    });
+    annotate(messages.command("delete"), { mutates: true })
+        .description("delete a message in a chat the bot can delete in")
+        .argument("<message>")
+        .action(async function (messageId) {
+        const context = botContext(this);
+        const remove = operation("deleteMessage");
+        assertAllowed(remove, context.settings);
+        const chatId = await chatOfMessage(context, messageId);
+        const answer = await guarded(context, { chatId, kind: "delete", count: 1 }, async () => ({
+            result: plainJson(await context.authenticated().call(remove, { query: { message_id: messageId } })),
+            messageId,
+        }));
+        context.renderer.result(answer ?? { success: true });
+    });
+};
+export const recipientsCommand = () => {
+    const command = new Command("recipients").description("the chats this bot may write to; with no list, every chat — `off` removes the list");
+    command
+        .command("list")
+        .description("the chats on the list, or nothing when there is no list")
+        .action(function () {
+        const context = botContext(this);
+        context.renderer.result(recipientsOf(context).read() ?? []);
+    });
+    command
+        .command("add <chat>")
+        .description("allow a chat: its id, `user:<id>`, or the title of a chat this bot has seen")
+        .action(function (chat) {
+        const context = botContext(this);
+        const target = targetOf(chat, context);
+        const title = context.registry.list().find((seen) => seen.id === target.key)?.title ?? null;
+        recipientsOf(context).add({ id: target.key, title, addedAt: new Date().toISOString() });
+        context.renderer.result(recipientsOf(context).read() ?? []);
+    });
+    command
+        .command("remove <chat>")
+        .description("take a chat off the list")
+        .action(function (chat) {
+        const context = botContext(this);
+        context.renderer.result({ removed: recipientsOf(context).remove(chat) ?? null });
+    });
+    command
+        .command("off")
+        .description("remove the list: the bot may write to any chat again")
+        .action(function () {
+        const context = botContext(this);
+        context.renderer.result({ removed: recipientsOf(context).off() });
+    });
+    return command;
+};
+export const sendsCommand = () => new Command("sends")
+    .description("what this bot sent, edited and deleted from this machine — ids and outcomes, never text")
+    .addCommand(new Command("list").action(function () {
+    const context = botContext(this);
+    context.renderer.result(new SendJournal(files(context.settings.profile).journal).entries());
+}));
+//# sourceMappingURL=bot-sends.js.map

package/dist/commands/bot-sends.js.map

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

package/dist/commands/bot.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot.d.ts","sourceRoot":"","sources":["../../src/commands/bot.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAiD3C,eAAO,MAAM,UAAU,QAAO,OAwG7B,CAAA"}

package/dist/commands/bot.js

@@ -0,0 +1,145 @@
+import { CliError } from "@leemour/cli-core";
+import { annotate } from "@leemour/cli-core/commands";
+import { Command, Option } from "commander";
+import { BotTokenStore } from "../bot/auth.js";
+import { botOperations } from "../bot/client.js";
+import { checkBody, checkParameter, flagOf, optionKey, readBody } from "../bot/input.js";
+import { registryProfiles } from "../bot/registry.js";
+import { plainJson } from "../bot/transport.js";
+import { configuredProfiles } from "../config.js";
+import { assertAllowed, botContext } from "./bot-context.js";
+import { chatsCommand, messagesCommand } from "./bot-reads.js";
+import { guardedCall, recipientsCommand, sendsCommand } from "./bot-sends.js";
+import { environmentOf } from "./context.js";
+const apiCommand = (operation) => {
+    const binding = operation.binding.kind === "http" ? `${operation.binding.method} ${operation.binding.path}` : operation.id;
+    const command = new Command(operation.command).description(`${operation.summary ?? operation.id} — ${operation.effect} (${binding})`);
+    for (const parameter of operation.parameters) {
+        const option = new Option(`--${flagOf(parameter.name)} <value>`, parameter.description?.split("\n")[0] ?? parameter.name);
+        command.addOption(parameter.required ? option.makeOptionMandatory() : option);
+    }
+    if (operation.request) {
+        command.option("--body <json>", "the request body as JSON; - reads it from stdin");
+        command.option("--body-file <path>", "the request body from a JSON file; - is stdin");
+    }
+    annotate(command, { origin: "generated", operationId: operation.id, mutates: operation.effect !== "read" });
+    return command.action(async function () {
+        const options = this.opts();
+        const input = { path: {}, query: {} };
+        for (const parameter of operation.parameters) {
+            const raw = options[optionKey(parameter.name)];
+            if (raw === undefined)
+                continue;
+            const problem = checkParameter(parameter.name, parameter.schema, raw);
+            if (problem)
+                throw new CliError("validation_error", problem);
+            if (parameter.in === "path")
+                input.path[parameter.name] = raw;
+            else if (parameter.in === "query")
+                input.query[parameter.name] = raw;
+        }
+        const context = botContext(this);
+        if (operation.effect !== "read")
+            assertAllowed(operation, context.settings);
+        const body = checkBody(operation, readBody(options));
+        const call = body === undefined ? input : { ...input, body };
+        context.renderer.result(plainJson(await guardedCall(context, operation, call)));
+    });
+};
+export const botCommand = () => {
+    const command = new Command("bot").description("a MAX bot, through the official Bot API and a bot token — not your personal account");
+    const auth = new Command("auth").description("the bot token this profile uses");
+    auth
+        .command("set")
+        .description("check a bot token with MAX, then keep it — typed at a hidden prompt or piped on stdin")
+        .action(async function () {
+        const { store, client, ask, renderer, settings, streams } = botContext(this);
+        const token = (await ask("Bot token: ", { secret: true })).trim();
+        if (!token)
+            throw new CliError("validation_error", "no token given");
+        const bot = await client(token).me();
+        const source = store.write(token);
+        botContext(this).registry.touch();
+        if (process.env.MAX_BOT_TOKEN) {
+            streams.diagnostic("MAX_BOT_TOKEN is set, and it wins over the token just kept until it is unset");
+        }
+        renderer.result({
+            profile: settings.profile,
+            stored: source,
+            bot: bot.first_name,
+            id: bot.user_id,
+            username: bot.username,
+        });
+    });
+    auth
+        .command("show")
+        .description("where this profile's bot token comes from, and which bot it is")
+        .action(async function () {
+        const { store, authenticated, renderer, settings } = botContext(this);
+        const source = store.read()?.source;
+        const bot = await authenticated().me();
+        renderer.result({
+            profile: settings.profile,
+            source,
+            bot: bot.first_name,
+            id: bot.user_id,
+            username: bot.username,
+        });
+    });
+    auth
+        .command("remove")
+        .description("forget this profile's bot token")
+        .action(function () {
+        const { store, renderer, settings } = botContext(this);
+        renderer.result({ profile: settings.profile, removed: store.remove() });
+    });
+    command.addCommand(auth);
+    command
+        .command("me")
+        .description("the bot this profile's token belongs to: name, id, description, commands")
+        .action(async function () {
+        const { authenticated, renderer } = botContext(this);
+        renderer.result(await authenticated().me());
+    });
+    command
+        .command("list")
+        .description("every name on this machine that has a bot token; --check asks MAX which bot each is")
+        .option("--check", "ask MAX who each bot is")
+        .action(async function () {
+        const { renderer, streams } = botContext(this);
+        const check = this.opts().check === true;
+        const environment = environmentOf(this);
+        const names = [...new Set(["default", ...configuredProfiles(), ...registryProfiles()])].sort();
+        if (process.env.MAX_BOT_TOKEN)
+            streams.diagnostic("MAX_BOT_TOKEN is set, so every name uses that one token");
+        const rows = [];
+        for (const name of names) {
+            const store = environment.botStore?.(name) ?? new BotTokenStore({ profile: name });
+            const stored = store.read();
+            if (!stored)
+                continue;
+            const row = { name, token: stored.source };
+            if (check) {
+                try {
+                    const bot = await botContext(this).client(stored.token).me();
+                    Object.assign(row, { bot: bot.username ?? bot.first_name, id: bot.user_id });
+                }
+                catch (error) {
+                    row.problem = error.code ?? "failed";
+                }
+            }
+            rows.push(row);
+        }
+        renderer.result(rows);
+    });
+    command.addCommand(messagesCommand());
+    command.addCommand(chatsCommand());
+    command.addCommand(recipientsCommand());
+    command.addCommand(sendsCommand());
+    const api = new Command("api").description("every operation of the official Bot API, generated from its schema — docs/dev/bot-api-coverage.md");
+    for (const operation of botOperations)
+        api.addCommand(apiCommand(operation));
+    command.addCommand(api);
+    return command;
+};
+//# sourceMappingURL=bot.js.map

package/dist/commands/bot.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"chats.d.ts","sourceRoot":"","sources":["../../src/commands/chats.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAQnC,eAAO,MAAM,YAAY,QAAO,OA4L/B,CAAA"}
+{"version":3,"file":"chats.d.ts","sourceRoot":"","sources":["../../src/commands/chats.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAWnC,eAAO,MAAM,YAAY,QAAO,OA8P/B,CAAA"}

package/dist/commands/chats.js

@@ -6,6 +6,8 @@ import { ADMIN_RIGHTS } from "../client.js";
 import { forCommand } from "./context.js";
 import { foldersCommand } from "./folders.js";
 import { renderPage, window, withPaging } from "./paging.js";
+import { rulesCommand } from "./rules.js";
+const EVENTS_DAYS = 7;
 export const chatsCommand = () => {
     const command = new Command("chats").description("the chats this account is in");
     withPaging(command.command("list").description("the chats this account is in"))
@@ -51,6 +53,48 @@ export const chatsCommand = () => {
             }
         });
     });
+    command
+        .command("events")
+        .argument("<chat>", "chat id, or part of a chat name")
+        .option("--since <id-or-time>", `from this message id or ISO 8601 time; ${EVENTS_DAYS} days ago if not given`)
+        .option("--event <names>", "only these, comma-separated, as MAX names them: new, add, remove, pin…")
+        .description("who joined, left, was added or removed, and by whom — from the chat's service messages")
+        .action(async function (chat) {
+        const options = this.optsWithGlobals();
+        const { renderer, settings, format, createClient, run } = forCommand(this);
+        const cache = await openProfileCache(settings.profile, { onProblem: (message) => renderer.note(message) });
+        const only = options.event === undefined
+            ? undefined
+            : new Set(String(options.event)
+                .split(",")
+                .map((e) => e.trim()));
+        await run("chats events", async (events) => {
+            const client = createClient({ events, ...(cache ? { cache } : {}) });
+            try {
+                const since = options.since === undefined
+                    ? Date.now() - EVENTS_DAYS * 86_400_000
+                    : client.messages.moment(String(options.since), "--since");
+                const found = await client.chats.events(chat, { since });
+                const kept = only ? { ...found, events: found.events.filter((one) => only.has(one.event)) } : found;
+                if (format !== "pretty")
+                    renderer.result(kept);
+                else {
+                    renderer.stream(kept.events.map((one) => ({
+                        time: one.timestamp,
+                        event: one.event,
+                        by: one.by.name ?? one.by.id,
+                        people: one.people.map((person) => person.name ?? person.id).join(", "),
+                    })));
+                }
+                if (kept.more)
+                    renderer.note(`more history than one run reads — run again with --since after the last one`);
+            }
+            finally {
+                await client.close();
+                cache?.close();
+            }
+        });
+    });
     command
         .command("inspect")
         .argument("<link>", "an invite link, https://max.ru/join/…, or a public one, https://max.ru/<name>")
@@ -85,7 +129,26 @@ export const chatsCommand = () => {
         .action(async function (title, people) {
         await withClient(this, "chats create", (client) => client.chats.create(title, people));
     });
-    const members = command.command("members").description("add people to a group or channel, or remove them");
+    const members = command.command("members").description("who is in a group or channel; add or remove people");
+    members
+        .command("list")
+        .argument("<chat>", "chat id, or part of a chat name")
+        .description("everyone in a group or channel, from MAX: when their account was made and when they were last seen")
+        .action(async function (chat) {
+        const { renderer, createClient, run } = forCommand(this);
+        await run("chats members list", async (events) => {
+            const client = createClient({ events });
+            try {
+                const found = await client.chats.members.list(chat);
+                renderer.stream(found.members);
+                if (!found.complete)
+                    renderer.note(`only the first ${found.members.length} members were read`);
+            }
+            finally {
+                await client.close();
+            }
+        });
+    });
     annotate(members.command("add"), { mutates: true })
         .argument("<chat>", "chat id, or part of a chat name")
         .argument("<person...>", "an id, or part of a name")
@@ -170,6 +233,7 @@ export const chatsCommand = () => {
         await withClient(this, "chats link reset", (client) => client.chats.resetLink(chat));
     });
     command.addCommand(foldersCommand());
+    command.addCommand(rulesCommand());
     return command;
 };
 const withClient = async (command, label, act) => {