@leemour/max-cli 0.14.0 → 0.16.0

package/dist/commands/bot-check.js

@@ -0,0 +1,206 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, writeSecurely } from "@leemour/cli-core";
+import { annotate } from "@leemour/cli-core/commands";
+import { Command } from "commander";
+import { JoinLog } from "../bot/joins.js";
+import { forget } from "../bot/keep.js";
+import { botsDirectory } from "../bot/registry.js";
+import { describe, finish, judge, MAX_ACTIONS, } from "../moderation/check.js";
+import { defaultRules, ModerationRules, moderationPathFor, RULE_KEYS } from "../moderation/rules.js";
+import { botContext } from "./bot-context.js";
+import { chatIdOf } from "./bot-reads.js";
+import { guardedCall, operation } from "./bot-sends.js";
+import { environmentOf } from "./context.js";
+const FIRST_LOOK_MS = 24 * 3_600_000;
+const PAGE = 100;
+const READ_AT_MOST = 2000;
+/**
+ * `max <bot> bot chats check` — the group check of `max chats check`, done by the bot (plan
+ * `2026-09-27-bot-moderation-plan.md`). Removing bans unless `--no-ban` (`NEED-336`); joins come
+ * from what `bot updates watch` kept (`NEED-338`); account age and join requests are not in the
+ * Bot API, so those rules never fire here.
+ */
+export const botCheckCommand = () => annotate(new Command("check"), { mutates: true })
+    .argument("<chat>", "chat id, or the title of a chat this bot has seen")
+    .option("--since <time>", "judge what came after this ISO 8601 time; the saved point stays")
+    .option("--dry-run", "judge and plan; do nothing")
+    .option("--allow-dangerous", "do what a rule at consent level flag asks: delete messages, remove people")
+    .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 check; ${MAX_ACTIONS} if not given`)
+    .description("judge a group's new messages and joins by its rules, and act as they allow — as the bot")
+    .action(async function (chat) {
+    const context = botContext(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 ${options.maxActions}`);
+    }
+    const explicit = options.since === undefined ? undefined : Date.parse(options.since);
+    if (explicit !== undefined && Number.isNaN(explicit)) {
+        throw new CliError("validation_error", `--since takes an ISO 8601 time — got ${options.since}`);
+    }
+    const client = context.authenticated();
+    const self = (await client.me()).user_id;
+    context.registry.rememberBot(self);
+    const chatId = chatIdOf(chat, context.registry);
+    const title = context.registry.list().find((one) => one.id === chatId)?.title ?? null;
+    const profile = context.settings.profile;
+    const saved = new ModerationRules(moderationPathFor(profile)).read(chatId);
+    const rules = saved ?? defaultRules(title);
+    const points = botPoints(profile);
+    const point = points.read(chatId);
+    const since = explicit ?? (point === undefined ? Date.now() - FIRST_LOOK_MS : Date.parse(point));
+    const found = await gather(context, client, self, chatId, since);
+    const prepared = {
+        chatId,
+        title,
+        rules,
+        found,
+        findings: judge({ ...found, rules, now: Date.now() }),
+        explicit: explicit !== undefined,
+        notes: [...(saved ? [] : [`${title ?? chatId} has no rules yet — the defaults only report`]), ...found.notes],
+    };
+    const interactive = environmentOf(this).interactive ?? (process.stdin.isTTY === true && process.stderr.isTTY === true);
+    const { rows, notes } = await finish(moderator(context, self, options.ban), points, prepared, {
+        allowDangerous: options.allowDangerous === true,
+        dryRun: options.dryRun === true,
+        maxActions,
+        ...(interactive
+            ? {
+                confirm: async (finding) => /^y(es)?$/i.test((await context.ask(`${describe(finding)}? [y/N] `)).trim()),
+            }
+            : {}),
+    });
+    context.renderer.stream(context.format === "pretty" ? rows.map(pretty) : rows);
+    for (const note of notes)
+        context.streams.diagnostic(note);
+});
+/**
+ * New messages since `since`, oldest first. MAX answers newest first (`BUG-59`), so this walks back
+ * with `before` until a page comes short; past `READ_AT_MOST` only the newest are judged.
+ */
+const readSince = async (client, self, chatId, since) => {
+    const read = new Map();
+    let before;
+    while (read.size < READ_AT_MOST) {
+        const answer = (await client.call(operation("getMessages"), {
+            query: {
+                chat_id: chatId,
+                count: String(PAGE),
+                after: String(since),
+                ...(before === undefined ? {} : { before: String(before) }),
+            },
+        }));
+        const page = (answer?.messages ?? []).map((raw) => client.decodeMessage(raw, self));
+        for (const message of page)
+            read.set(message.id, message);
+        const oldest = page.at(-1);
+        if (page.length < PAGE || !oldest)
+            return { messages: oldestFirst(read), more: false };
+        before = Date.parse(oldest.timestamp);
+    }
+    return { messages: oldestFirst(read), more: true };
+};
+const oldestFirst = (read) => [...read.values()].sort((a, b) => Date.parse(a.timestamp) - Date.parse(b.timestamp));
+const gather = async (context, client, self, chatId, since) => {
+    const notes = [];
+    const { messages, more } = await readSince(client, self, chatId, since);
+    if (more)
+        notes.push(`more than ${READ_AT_MOST} messages since ${new Date(since).toISOString()} — only the newest were judged`);
+    const admins = (await client.call(operation("getAdmins"), { path: { chatId } }));
+    const answerers = new Set((admins?.members ?? []).map((member) => String(member.user_id)));
+    const log = JoinLog.for(context.settings.profile);
+    if (!log.kept())
+        notes.push("no joins kept for this bot — run `bot updates watch` to have them judged");
+    const joined = log
+        .read()
+        .filter((entry) => entry.chatId === chatId && entry.event === "add" && entry.at > since)
+        .map((entry) => ({ id: entry.userId, name: entry.name, username: null, registeredAt: null, lastSeenAt: null }));
+    return {
+        messages: messages,
+        joined,
+        requests: [],
+        answerers,
+        until: messages.at(-1)?.timestamp ?? null,
+        more,
+        notes,
+    };
+};
+const moderator = (context, self, ban) => ({
+    deleteMessage: async (chatId, messageId) => {
+        await guardedCall(context, operation("deleteMessage"), { query: { message_id: messageId } });
+        await forget(self, [{ chatId, messageId }], context.streams.diagnostic);
+    },
+    removePerson: async (chatId, personId) => {
+        await guardedCall(context, operation("removeMember"), {
+            path: { chatId },
+            query: { user_id: personId, ...(ban ? { block: "true" } : {}) },
+        });
+    },
+});
+/** Beside the bot's other state, one file per bot profile. */
+const botPoints = (profile) => {
+    const path = join(botsDirectory(), "checks", `${profile}.json`);
+    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 pretty = (row) => ({
+    what: row.kind,
+    who: row.personName ?? row.personId,
+    rule: row.rule,
+    action: row.action,
+    outcome: row.outcome,
+    ...(row.reason ? { why: row.reason } : {}),
+});
+/** The same rules file as `max chats rules`, the chat named the bot's way. */
+export const botRulesCommand = () => {
+    const command = new Command("rules").description("a chat's moderation rules for this bot, kept on this machine");
+    const show = (context, chatId, rules) => {
+        const saved = rules.read(chatId);
+        const title = context.registry.list().find((one) => one.id === chatId)?.title ?? null;
+        context.renderer.result({
+            chatId,
+            title,
+            file: rules.path,
+            saved: saved !== undefined,
+            rules: saved ?? defaultRules(title),
+        });
+    };
+    const target = (command, chat) => {
+        const context = botContext(command, { offline: true });
+        const chatId = chatIdOf(chat, context.registry);
+        const title = context.registry.list().find((one) => one.id === chatId)?.title ?? null;
+        return { context, chatId, title, rules: new ModerationRules(moderationPathFor(context.settings.profile)) };
+    };
+    command
+        .command("show <chat>")
+        .description("the chat's rules; the defaults, marked not saved, if it has none yet")
+        .action(function (chat) {
+        const { context, chatId, rules } = target(this, chat);
+        show(context, chatId, rules);
+    });
+    command
+        .command("set <chat> <key> <value>")
+        .description(`change one rule — ${RULE_KEYS.join(", ")}`)
+        .action(function (chat, key, value) {
+        const { context, chatId, title, rules } = target(this, chat);
+        rules.set(chatId, title, key, value);
+        show(context, chatId, rules);
+    });
+    command
+        .command("unset <chat> <key>")
+        .description("put one rule back to its default")
+        .action(function (chat, key) {
+        const { context, chatId, title, rules } = target(this, chat);
+        rules.unset(chatId, title, key);
+        show(context, chatId, rules);
+    });
+    return command;
+};
+//# sourceMappingURL=bot-check.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot-comments.d.ts","sourceRoot":"","sources":["../../src/commands/bot-comments.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAW3C,eAAO,MAAM,eAAe,QAAO,OAoElC,CAAA;AAED,eAAO,MAAM,gBAAgB,QAAO,OA4BnC,CAAA"}

package/dist/commands/bot-comments.js

@@ -0,0 +1,97 @@
+import { CliError } from "@leemour/cli-core";
+import { annotate } from "@leemour/cli-core/commands";
+import { Command, Option } from "commander";
+import { plainJson } from "../bot/transport.js";
+import { botContext } from "./bot-context.js";
+import { checked } from "./bot-members.js";
+import { guardedCall, operation, textOf } from "./bot-sends.js";
+const format = () => new Option("--format <format>", "how the text is marked up").choices(["markdown", "html"]);
+const commentBody = (id, text, format) => checked(id, JSON.stringify({ text: textOf(text), ...(format ? { format } : {}) }));
+export const commentsCommand = () => {
+    const command = new Command("comments").description("comments under a channel post — each command takes the post's message id (mid.…) first");
+    command
+        .command("list <message>")
+        .description("the comments under a post, newest last")
+        .option("--limit <n>", "how many, up to 100", (value) => Number.parseInt(value, 10))
+        .action(async function (message) {
+        const context = botContext(this);
+        const limit = context.settings.limit;
+        if (limit > 100)
+            throw new CliError("validation_error", "MAX gives at most 100 at a time — --limit 100");
+        const answer = await context.authenticated().call(operation("getComments"), {
+            path: { messageId: message },
+            query: { count: String(limit) },
+        });
+        context.renderer.result(plainJson(answer)?.messages ?? []);
+    });
+    command
+        .command("get <message> <comment>")
+        .description("one comment under a post")
+        .action(async function (message, comment) {
+        const context = botContext(this);
+        const answer = await context.authenticated().call(operation("getCommentById"), {
+            path: { messageId: message, commentId: comment },
+        });
+        context.renderer.result(plainJson(answer));
+    });
+    annotate(command.command("send <message> <text>"), { mutates: true })
+        .description("comment under a post as the bot; - reads stdin")
+        .addOption(format())
+        .action(async function (message, text) {
+        const context = botContext(this);
+        const answer = await guardedCall(context, operation("sendComment"), {
+            path: { messageId: message },
+            body: commentBody("sendComment", text, this.opts().format),
+        });
+        context.renderer.result(plainJson(answer));
+    });
+    annotate(command.command("edit <message> <comment> <text>"), { mutates: true })
+        .description("replace the text of a comment the bot wrote; - reads stdin")
+        .addOption(format())
+        .action(async function (message, comment, text) {
+        const context = botContext(this);
+        const answer = await guardedCall(context, operation("editComment"), {
+            path: { messageId: message },
+            query: { comment_id: comment },
+            body: commentBody("editComment", text, this.opts().format),
+        });
+        context.renderer.result(plainJson(answer) ?? { success: true });
+    });
+    annotate(command.command("delete <message> <comment>"), { mutates: true })
+        .description("delete a comment under a post")
+        .action(async function (message, comment) {
+        const context = botContext(this);
+        const answer = await guardedCall(context, operation("deleteComment"), {
+            path: { messageId: message },
+            query: { comment_id: comment },
+        });
+        context.renderer.result(plainJson(answer) ?? { success: true });
+    });
+    return command;
+};
+export const callbacksCommand = () => {
+    const command = new Command("callbacks").description("answers to the buttons people press under the bot's messages");
+    annotate(command.command("answer <callback>"), { 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")
+        .option("--text <text>", "the message's new text; - reads stdin")
+        .option("--notification <text>", "a note only the person who pressed sees")
+        .action(async function (callback) {
+        const context = botContext(this);
+        const options = this.opts();
+        if (options.text === undefined && options.notification === undefined) {
+            throw new CliError("validation_error", "an answer needs --text, --notification, or both");
+        }
+        const body = JSON.stringify({
+            ...(options.text === undefined ? {} : { message: { text: textOf(options.text) } }),
+            ...(options.notification === undefined ? {} : { notification: options.notification }),
+        });
+        const answer = await guardedCall(context, operation("answerOnCallback"), {
+            query: { callback_id: callback },
+            body: checked("answerOnCallback", body),
+        });
+        context.renderer.result(plainJson(answer) ?? { success: true });
+    });
+    return command;
+};
+//# sourceMappingURL=bot-comments.js.map

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

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

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

@@ -4,7 +4,10 @@ import { BotTokenStore } from "../bot/auth.js";
 import { BotApiClient } from "../bot/client.js";
 import { ChatRegistry } from "../bot/registry.js";
 import { type Settings } from "../config.js";
-export declare const botContext: (command: Command) => {
+/** `offline` is for the reads the local copy can answer; every other command still refuses the flag. */
+export declare const botContext: (command: Command, { offline: answersOffline }?: {
+    offline?: boolean;
+}) => {
     settings: Settings;
     renderer: import("@leemour/cli-core").Renderer;
     streams: import("@leemour/cli-core").Streams;
@@ -12,9 +15,12 @@ export declare const botContext: (command: Command) => {
     color: boolean;
     store: BotTokenStore;
     registry: ChatRegistry;
-    client: (token: string) => BotApiClient;
+    client: (token: string, stop?: AbortSignal) => BotApiClient;
     ask: import("./context.js").Ask;
-    authenticated: () => BotApiClient;
+    authenticated: (stop?: AbortSignal) => BotApiClient;
+    signal: AbortSignal | undefined;
+    uploadFetch: () => import("@leemour/cli-core/http").FetchLike;
+    offline: boolean;
 };
 /** The personal account's `readOnly` and `allow` hold for the bot too; a prompt was waived (`NEED-304`), a refusal was not. */
 export declare const assertAllowed: (operation: ManifestOperation, settings: Settings) => void;

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

@@ -1 +1 @@
-{"version":3,"file":"bot-context.d.ts","sourceRoot":"","sources":["../../src/commands/bot-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAM/E,eAAO,MAAM,UAAU,YAAa,OAAO;;;;;;;;oBAYlB,MAAM;;;CAsB9B,CAAA;AAED,+HAA+H;AAC/H,eAAO,MAAM,aAAa,cAAe,iBAAiB,YAAY,QAAQ,KAAG,IAkBhF,CAAA"}
+{"version":3,"file":"bot-context.d.ts","sourceRoot":"","sources":["../../src/commands/bot-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAqC,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAA;AAM/E,wGAAwG;AACxG,eAAO,MAAM,UAAU,YAAa,OAAO,gCAAuC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;;;oBAe9E,MAAM,SAAS,WAAW;;2BAanB,WAAW;;;;CA2B1C,CAAA;AAED,+HAA+H;AAC/H,eAAO,MAAM,aAAa,cAAe,iBAAiB,YAAY,QAAQ,KAAG,IAkBhF,CAAA"}

package/dist/commands/bot-context.js

@@ -3,16 +3,20 @@ import { BotTokenStore } from "../bot/auth.js";
 import { BotApiClient } from "../bot/client.js";
 import { BOT_PERMISSIONS } from "../bot/permissions.js";
 import { ChatRegistry } from "../bot/registry.js";
+import { botFetch } from "../bot/transport.js";
 import { resolveSettings } from "../config.js";
 import { resolveOutput } from "../output.js";
 import { asFirstWord } from "../profile.js";
 import { readSecret } from "../session/prompt.js";
 import { environmentOf } from "./context.js";
-export const botContext = (command) => {
+/** `offline` is for the reads the local copy can answer; every other command still refuses the flag. */
+export const botContext = (command, { offline: answersOffline = false } = {}) => {
     const environment = environmentOf(command);
     const flags = command.optsWithGlobals();
-    if (flags.offline)
-        throw new CliError("validation_error", "max bot always asks MAX; --offline cannot apply to it");
+    const offline = flags.offline === true;
+    if (offline && !answersOffline) {
+        throw new CliError("validation_error", `--offline reads the local copy; \`${command.name()}\` has to ask MAX`);
+    }
     const settings = resolveSettings(flags);
     const { renderer, streams, format, color } = resolveOutput({
         ...settings,
@@ -20,25 +24,44 @@ export const botContext = (command) => {
         ...(environment.tty === undefined ? {} : { tty: environment.tty }),
     });
     const store = environment.botStore?.(settings.profile) ?? new BotTokenStore({ profile: settings.profile });
-    const signal = settings.commandTimeoutMs === undefined ? undefined : AbortSignal.timeout(settings.commandTimeoutMs);
-    const client = (token) => new BotApiClient({
-        token,
-        ...(environment.botFetch ? { fetch: environment.botFetch } : {}),
-        ...(environment.botUrl ? { baseUrl: environment.botUrl } : {}),
-        ...(settings.timeoutMs === undefined ? {} : { timeoutMs: settings.timeoutMs }),
-        ...(environment.botRetry ? { retry: environment.botRetry } : {}),
-        ...(signal ? { signal } : {}),
-    });
+    const deadline = settings.commandTimeoutMs === undefined ? undefined : AbortSignal.timeout(settings.commandTimeoutMs);
+    const client = (token, stop) => {
+        const signal = deadline && stop ? AbortSignal.any([deadline, stop]) : (deadline ?? stop);
+        return new BotApiClient({
+            token,
+            ...(environment.botFetch ? { fetch: environment.botFetch } : {}),
+            ...(environment.botUrl ? { baseUrl: environment.botUrl } : {}),
+            ...(settings.timeoutMs === undefined ? {} : { timeoutMs: settings.timeoutMs }),
+            ...(environment.botRetry ? { retry: environment.botRetry } : {}),
+            ...(signal ? { signal } : {}),
+        });
+    };
     const ask = environment.ask ?? ((prompt) => readSecret(prompt, { echo: false }));
-    const authenticated = () => {
+    /** `stop` is for a command that runs until told to — `updates watch` — and ends its request in flight. */
+    const authenticated = (stop) => {
         const stored = store.read();
         if (!stored) {
             throw new CliError("authentication_error", `no bot token for profile "${settings.profile}" — run \`max ${asFirstWord(settings.profile)}bot auth set\``);
         }
-        return client(stored.token);
+        return client(stored.token, stop);
     };
     const registry = environment.botRegistry?.(settings.profile) ?? new ChatRegistry(settings.profile);
-    return { settings, renderer, streams, format, color, store, registry, client, ask, authenticated };
+    const uploadFetch = () => environment.botFetch ?? botFetch();
+    return {
+        settings,
+        renderer,
+        streams,
+        format,
+        color,
+        store,
+        registry,
+        client,
+        ask,
+        authenticated,
+        signal: deadline,
+        uploadFetch,
+        offline,
+    };
 };
 /** The personal account's `readOnly` and `allow` hold for the bot too; a prompt was waived (`NEED-304`), a refusal was not. */
 export const assertAllowed = (operation, settings) => {

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot-mcp.d.ts","sourceRoot":"","sources":["../../src/commands/bot-mcp.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAiCnC,eAAO,MAAM,aAAa,QAAO,OA+DhC,CAAA"}

package/dist/commands/bot-mcp.js

@@ -0,0 +1,69 @@
+import { CliError } from "@leemour/cli-core";
+import { Command } from "commander";
+import { ownScript } from "../install.js";
+import { botContext } from "./bot-context.js";
+import { environmentOf } from "./context.js";
+import { serverEntry } from "./mcp.js";
+const withFlags = (command) => command
+    .option("--allow-send", "offer the tools that write as the bot; without it the server can only read")
+    .option("--confirm-send", "show the owner every write in a form from the server first")
+    .option("--allow-delete", "offer the tools that delete messages and comments; it cannot be undone")
+    .option("--allow-moderate", "offer max_bot_chats_check and adding and removing members — the bot acts on a group's rules");
+const checked = (flags) => {
+    if (flags.confirmSend && !flags.allowSend && !flags.allowDelete && !flags.allowModerate) {
+        throw new CliError("validation_error", "`--confirm-send` confirms writes, and without `--allow-send`, `--allow-delete` or `--allow-moderate` there are none");
+    }
+    return flags;
+};
+export const botMcpCommand = () => {
+    const command = withFlags(new Command("mcp").description("serve this bot to an agent over MCP, on stdin and stdout — `claude mcp add sales-bot -- max sales bot mcp`")).action(async function () {
+        const flags = checked(this.opts());
+        const context = botContext(this);
+        context.authenticated();
+        // Loaded here: every other command would otherwise pay for the SDK.
+        const [{ serveBotOverStdio }, { run }] = await Promise.all([
+            import("../bot-mcp/server.js"),
+            import("../program.js"),
+        ]);
+        await serveBotOverStdio({
+            profile: context.settings.profile,
+            allowSend: flags.allowSend === true,
+            confirmSend: flags.confirmSend === true,
+            allowDelete: flags.allowDelete === true,
+            allowModerate: flags.allowModerate === true,
+            ...(context.settings.allow ? { permitted: context.settings.allow } : {}),
+            run,
+            environment: environmentOf(this),
+        }, context.streams.diagnostic);
+    });
+    command.addCommand(withFlags(new Command("config").description("print the mcpServers entry for Claude Desktop, Cursor and others, with full paths; writes nothing")).action(function () {
+        const flags = checked(this.optsWithGlobals());
+        const { renderer, settings, format, streams } = botContext(this);
+        const entry = serverEntry({
+            profile: settings.profile,
+            flags: {},
+            execPath: process.execPath,
+            scriptPath: ownScript(),
+            env: process.env,
+        });
+        const [name, server] = Object.entries(entry.config.mcpServers)[0];
+        const flagArgs = [
+            ["allowSend", "--allow-send"],
+            ["confirmSend", "--confirm-send"],
+            ["allowDelete", "--allow-delete"],
+            ["allowModerate", "--allow-moderate"],
+        ]
+            .filter(([key]) => flags[key] === true)
+            .map(([, flag]) => flag);
+        const args = server.args.flatMap((arg) => (arg === "mcp" ? ["bot", "mcp", ...flagArgs] : [arg]));
+        const config = { mcpServers: { [name.replace(/^max/, "max-bot")]: { ...server, args } } };
+        if (format === "pretty")
+            streams.data(JSON.stringify(config, null, 2));
+        else
+            renderer.result(config);
+        if (entry.warning)
+            renderer.note(entry.warning);
+    }));
+    return command;
+};
+//# sourceMappingURL=bot-mcp.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot-mcp.js","sourceRoot":"","sources":["../../src/commands/bot-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAStC,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAW,EAAE,CAC9C,OAAO;KACJ,MAAM,CAAC,cAAc,EAAE,4EAA4E,CAAC;KACpG,MAAM,CAAC,gBAAgB,EAAE,4DAA4D,CAAC;KACtF,MAAM,CAAC,gBAAgB,EAAE,wEAAwE,CAAC;KAClG,MAAM,CACL,kBAAkB,EAClB,6FAA6F,CAC9F,CAAA;AAEL,MAAM,OAAO,GAAG,CAAC,KAAY,EAAS,EAAE;IACtC,IAAI,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QACxF,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,qHAAqH,CACtH,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE;IACzC,MAAM,OAAO,GAAG,SAAS,CACvB,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,CAC5B,4GAA4G,CAC7G,CACF,CAAC,MAAM,CAAC,KAAK;QACZ,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAS,CAAC,CAAA;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAChC,OAAO,CAAC,aAAa,EAAE,CAAA;QACvB,oEAAoE;QACpE,MAAM,CAAC,EAAE,iBAAiB,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACzD,MAAM,CAAC,sBAAsB,CAAC;YAC9B,MAAM,CAAC,eAAe,CAAC;SACxB,CAAC,CAAA;QACF,MAAM,iBAAiB,CACrB;YACE,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,OAAO;YACjC,SAAS,EAAE,KAAK,CAAC,SAAS,KAAK,IAAI;YACnC,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;YACvC,WAAW,EAAE,KAAK,CAAC,WAAW,KAAK,IAAI;YACvC,aAAa,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI;YAC3C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxE,GAAG;YACH,WAAW,EAAE,aAAa,CAAC,IAAI,CAAC;SACjC,EACD,OAAO,CAAC,OAAO,CAAC,UAAU,CAC3B,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO,CAAC,UAAU,CAChB,SAAS,CACP,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAC/B,mGAAmG,CACpG,CACF,CAAC,MAAM,CAAC;QACP,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAS,CAAC,CAAA;QACpD,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAChE,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,UAAU,EAAE,SAAS,EAAE;YACvB,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAA;QACF,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAiC,CAAA;QACjG,MAAM,QAAQ,GACZ;YACE,CAAC,WAAW,EAAE,cAAc,CAAC;YAC7B,CAAC,aAAa,EAAE,gBAAgB,CAAC;YACjC,CAAC,aAAa,EAAE,gBAAgB,CAAC;YACjC,CAAC,eAAe,EAAE,kBAAkB,CAAC;SAExC;aACE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAA;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;QAChG,MAAM,MAAM,GAAG,EAAE,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA;QACzF,IAAI,MAAM,KAAK,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;;YACjE,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC5B,IAAI,KAAK,CAAC,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACjD,CAAC,CAAC,CACH,CAAA;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

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

@@ -0,0 +1,12 @@
+import { Command } from "commander";
+/**
+ * User ids as JSON numbers with exactly the digits typed: the schema says int64, and `Number`
+ * would turn an id above 2^53 into somebody else's.
+ */
+export declare const userIdsJson: (ids: readonly string[]) => string;
+/** A friendly command's body meets the same schema check as one given to `max bot api`. */
+export declare const checked: (id: string, text: string) => string;
+export declare const membersCommand: () => Command;
+export declare const ADMIN_PERMISSIONS: readonly ["read_all_messages", "add_remove_members", "add_admins", "change_chat_info", "pin_message", "edit_link", "write", "edit", "delete", "can_call", "view_stats"];
+export declare const adminsCommand: () => Command;
+//# sourceMappingURL=bot-members.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bot-members.d.ts","sourceRoot":"","sources":["../../src/commands/bot-members.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AASnC;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAS,SAAS,MAAM,EAAE,KAAG,MAKpD,CAAA;AAED,2FAA2F;AAC3F,eAAO,MAAM,OAAO,OAAQ,MAAM,QAAQ,MAAM,KAAG,MAAgD,CAAA;AAYnG,eAAO,MAAM,cAAc,QAAO,OA4CjC,CAAA;AAED,eAAO,MAAM,iBAAiB,YAC5B,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,WAAW,EACX,OAAO,EACP,MAAM,EACN,QAAQ,EACR,UAAU,EACV,YAAY,CACJ,CAAA;AAkBV,eAAO,MAAM,aAAa,QAAO,OA2ChC,CAAA"}