@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/cli/bot/api-rpc.js

@@ -0,0 +1,173 @@
+import { CliError } from "@wirecat/cli-base";
+import { identifier } from "@wirecat/cli-base/codegen";
+import { isLosslessNumber, LosslessNumber } from "lossless-json";
+import { apiJson, parseApiJson } from "./api-input.js";
+const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value) && !isLosslessNumber(value);
+const resolved = (node, definitions) => {
+    const seen = new Set();
+    let nullable = node.nullable;
+    let sensitive = node.sensitive;
+    while (node.type === "ref") {
+        if (seen.has(node.ref))
+            throw new CliError("configuration_error", "a generated API reference cycle cannot be resolved");
+        seen.add(node.ref);
+        const next = definitions[identifier(node.ref)];
+        if (!next)
+            throw new CliError("configuration_error", `the generated API has no schema ${node.ref}`);
+        nullable ||= next.nullable;
+        sensitive ||= next.sensitive;
+        node = next;
+    }
+    return { ...node, ...(nullable ? { nullable } : {}), ...(sensitive ? { sensitive } : {}) };
+};
+const matches = (value, original, definitions, depth = 0) => {
+    if (depth > 128)
+        throw new CliError("validation_error", "the API body is nested too deeply");
+    const node = resolved(original, definitions);
+    if (value === null && node.nullable)
+        return true;
+    switch (node.type) {
+        case "union":
+            return node.of.some((member) => matches(value, member, definitions, depth + 1));
+        case "allOf":
+            return node.of.every((member) => matches(value, member, definitions, depth + 1));
+        case "string":
+            return typeof value === "string" && (!node.enum || node.enum.includes(value));
+        case "integer":
+            return isLosslessNumber(value)
+                ? /^-?\d+$/.test(value.value)
+                : typeof value === "number" && Number.isSafeInteger(value);
+        case "number":
+            return typeof value === "number" || isLosslessNumber(value);
+        case "boolean":
+            return typeof value === "boolean" && (!node.enum || node.enum.includes(value));
+        case "array":
+            return Array.isArray(value) && value.every((item) => matches(item, node.items, definitions, depth + 1));
+        case "object":
+            return (object(value) &&
+                node.required.every((name) => value[name] !== undefined) &&
+                Object.entries(node.properties).every(([name, field]) => value[name] === undefined || matches(value[name], field, definitions, depth + 1)));
+        case "unknown":
+            return true;
+        case "ref":
+            return false;
+    }
+};
+const flagValue = (raw, original, definitions) => {
+    const node = resolved(original, definitions);
+    switch (node.type) {
+        case "string":
+            return raw;
+        case "boolean":
+            if (raw === "true" || raw === "false")
+                return raw === "true";
+            break;
+        case "integer":
+            if (/^-?\d+$/.test(raw))
+                return new LosslessNumber(raw);
+            break;
+        case "number": {
+            const value = parseApiJson(raw);
+            if (typeof value === "number" || isLosslessNumber(value))
+                return value;
+            break;
+        }
+        case "union":
+            for (const member of node.of) {
+                try {
+                    const value = flagValue(raw, member, definitions);
+                    if (matches(value, member, definitions))
+                        return value;
+                }
+                catch (error) {
+                    if (error.code === "configuration_error")
+                        throw error;
+                }
+            }
+            break;
+        case "object":
+        case "array":
+        case "allOf":
+        case "unknown":
+            return parseApiJson(raw);
+        case "ref":
+            break;
+    }
+    throw new CliError("validation_error", "an API parameter does not match its declared type");
+};
+export const prepareRpcApiBody = (operation, input, definitions) => {
+    const parsed = input.body?.trim() ? parseApiJson(input.body) : {};
+    if (!object(parsed))
+        throw new CliError("validation_error", "an RPC API body must be a JSON object");
+    const value = { ...parsed };
+    for (const parameter of operation.parameters) {
+        const raw = input.fields[parameter.name];
+        if (raw === undefined)
+            continue;
+        if (parameter.sensitive)
+            throw new CliError("validation_error", "secret API fields must be read from stdin or a JSON file");
+        if (Object.hasOwn(value, parameter.name))
+            throw new CliError("validation_error", `${parameter.name} was given in both the body and a flag`);
+        value[parameter.name] = flagValue(raw, parameter.schema, definitions);
+    }
+    const files = [];
+    const secrets = [];
+    const references = new Set();
+    let depth = 0;
+    const walk = (current, original) => {
+        if (++depth > 128)
+            throw new CliError("validation_error", "the API body is nested too deeply");
+        try {
+            const node = resolved(original, definitions);
+            if (node.sensitive && typeof current === "string" && current !== "")
+                secrets.push(current);
+            if (node.type === "union") {
+                const member = node.of.find((candidate) => matches(current, candidate, definitions));
+                return member ? walk(current, member) : current;
+            }
+            if (node.type === "allOf")
+                return node.of.reduce((part, member) => walk(part, member), current);
+            if (node.type === "array" && Array.isArray(current))
+                return current.map((item) => walk(item, node.items));
+            if (node.type === "object" && object(current))
+                return Object.fromEntries(Object.entries(current).map(([name, field]) => {
+                    const schema = node.properties[name] ?? node.additionalProperties;
+                    return [name, schema ? walk(field, schema) : field];
+                }));
+            if (node.type === "string" && node.format && typeof current === "string") {
+                if (current.startsWith("@")) {
+                    const path = current.slice(1);
+                    if (!path)
+                        throw new CliError("validation_error", "an API file reference needs a path after @");
+                    let field = `_api_file_${files.length}`;
+                    while (Object.hasOwn(value, field) || files.some((file) => file.field === field))
+                        field += "_";
+                    files.push({ field, path });
+                    return `attach://${field}`;
+                }
+                if (current.startsWith("attach://"))
+                    references.add(current.slice(9));
+            }
+            return current;
+        }
+        finally {
+            depth--;
+        }
+    };
+    const schema = operation.request?.schema ? definitions[operation.request.schema] : undefined;
+    if (operation.request?.schema && !schema)
+        throw new CliError("configuration_error", "the generated API request schema is missing");
+    const prepared = schema ? walk(value, schema) : value;
+    if (secrets.length > 0 && input.bodySource === "argument")
+        throw new CliError("validation_error", "secret API fields must be read from stdin or a JSON file");
+    for (const field of references)
+        if (!files.some((file) => file.field === field))
+            throw new CliError("validation_error", "an API multipart reference has no corresponding file; use @path");
+    return {
+        value: prepared,
+        ...(operation.request || Object.keys(value).length ? { text: apiJson(prepared) } : {}),
+        files,
+        secrets,
+    };
+};
+//# sourceMappingURL=api-rpc.js.map

package/dist/cli/bot/api-rpc.js.map

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

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

@@ -0,0 +1,25 @@
+import type { ManifestOperation, SchemaNode } from "@wirecat/cli-base/codegen";
+import { Command } from "commander";
+export interface ApiCommandInput {
+    path: Record<string, string>;
+    query: Record<string, string>;
+    headers: Record<string, string>;
+    fields: Record<string, string>;
+    body?: string;
+    bodySource?: "argument" | "stdin" | "file";
+    tokenProfile?: string;
+}
+export interface ApiCommands {
+    operations: readonly ManifestOperation[];
+    description?: string;
+    checkParameter: (name: string, schema: SchemaNode, raw: string) => string | undefined;
+    checkBody?: (operation: ManifestOperation, text: string | undefined) => string | undefined;
+    before?: (command: Command, operation: ManifestOperation) => void | Promise<void>;
+    readBody?: (command: Command, options: {
+        body?: string;
+        bodyFile?: string;
+    }) => string | undefined;
+    execute: (command: Command, operation: ManifestOperation, input: ApiCommandInput) => Promise<void>;
+}
+export declare const generatedApiCommand: (api: ApiCommands) => Command;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/api.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE9E,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAG3C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,MAAM,CAAA;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACxC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;IACrF,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,MAAM,GAAG,SAAS,CAAA;IAC1F,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACjF,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAA;IAClG,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnG;AAED,eAAO,MAAM,mBAAmB,QAAS,WAAW,KAAG,OAsEtD,CAAA"}

package/dist/cli/bot/api.js

@@ -0,0 +1,65 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command, Option } from "commander";
+import { apiFlagOf, apiOptionKey, readApiBody } from "./api-input.js";
+export const generatedApiCommand = (api) => {
+    const group = new Command("api").description(api.description ?? "every operation of the official Bot API, generated from its schema");
+    group.option("--store-token <profile>", "keep a returned authentication token only in this bot profile's OS keyring; never print it");
+    for (const operation of api.operations) {
+        const binding = operation.binding.kind === "http"
+            ? `${operation.binding.method} ${operation.binding.path}`
+            : operation.binding.name;
+        const command = new Command(operation.command).description(`${operation.summary ?? operation.id} — ${operation.effect} (${binding})`);
+        for (const parameter of operation.parameters) {
+            if (parameter.sensitive)
+                continue;
+            const option = new Option(`--${apiFlagOf(parameter.name)} <value>`, parameter.description?.split("\n")[0] ?? parameter.name);
+            command.addOption(parameter.required && parameter.in !== "body" ? 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", operation_id: operation.id, mutates: operation.effect !== "read" });
+        command.action(async function () {
+            const options = this.opts();
+            const input = { path: {}, query: {}, headers: {}, fields: {} };
+            const tokenProfile = group.opts().storeToken;
+            if (operation.response?.sensitive) {
+                if (!tokenProfile?.trim())
+                    throw new CliError("validation_error", "--store-token <profile> is required for this credential-returning operation");
+                input.tokenProfile = tokenProfile;
+                if (!/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/.test(tokenProfile))
+                    throw new CliError("validation_error", "--store-token needs a bot profile name using letters, digits, underscores or hyphens");
+            }
+            else if (tokenProfile !== undefined) {
+                throw new CliError("validation_error", "--store-token is only supported for credential-returning operations");
+            }
+            for (const parameter of operation.parameters) {
+                const raw = options[apiOptionKey(parameter.name)];
+                if (raw === undefined)
+                    continue;
+                if (parameter.in !== "body") {
+                    const problem = api.checkParameter(parameter.name, parameter.schema, raw);
+                    if (problem)
+                        throw new CliError("validation_error", problem);
+                }
+                const target = parameter.in === "body" ? input.fields : parameter.in === "header" ? input.headers : input[parameter.in];
+                target[parameter.name] = raw;
+            }
+            await api.before?.(this, operation);
+            const text = (api.readBody ?? ((_command, body) => readApiBody(body)))(this, options);
+            if (options.body !== undefined)
+                input.bodySource = options.body === "-" ? "stdin" : "argument";
+            else if (options.bodyFile !== undefined)
+                input.bodySource = options.bodyFile === "-" ? "stdin" : "file";
+            const body = operation.binding.kind === "rpc" ? text : api.checkBody ? api.checkBody(operation, text) : text;
+            if (body !== undefined)
+                input.body = body;
+            await api.execute(this, operation, input);
+        });
+        group.addCommand(command);
+    }
+    return group;
+};
+//# sourceMappingURL=api.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAY,OAAO,EAAE,MAAM,WAAW,CAAA;AAW7C,OAAO,EAA+B,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA;AAqP1E,eAAO,MAAM,UAAU,QAAS,YAAY,KAAG,OAqB9C,CAAA"}

package/dist/cli/bot/command.js

@@ -0,0 +1,249 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Argument, Command } from "commander";
+import { guardedWrite } from "../../sends/guarded.js";
+import { newOperationId } from "../../sends/send-id.js";
+import { envName } from "../app.js";
+import { renderList } from "../paging.js";
+import { botAdminsCommand, botMembersCommand } from "./admins.js";
+import { botContext, online } from "./context.js";
+import { botMcpCommand } from "./mcp.js";
+import { botCan, botIdOf, botMessagesCommand } from "./messages.js";
+import { botModerateCommand, botRulesCommand } from "./moderation.js";
+import { addBotCopyReads, botContactsCommand, botSearchCommand } from "./people.js";
+import { BOT_ACTIONS } from "./port.js";
+import { registryProfiles } from "./registry.js";
+import { botCallbacksCommand, botMenuCommand, botWebhooksCommand } from "./setup.js";
+import { botStoreCommand } from "./store.js";
+import { BotTokenStore } from "./token.js";
+import { botWatchCommand } from "./watch.js";
+const authCommand = (bot, tokenVariable) => {
+    const auth = new Command("auth").description("the bot token this profile uses");
+    annotate(auth.command("set"), { mutates: true, local: true })
+        .description(`check a bot token with ${bot.name ?? "the messenger"}, then keep it — typed at a hidden prompt or piped on stdin`)
+        .action(async function () {
+        const context = online(botContext(this, bot), this);
+        await context.run(async (events) => {
+            const token = (await context.readSecret("Bot token: ")).trim();
+            if (!token)
+                throw new CliError("validation_error", "no token given");
+            const account = await (await context.connect(token, { events })).me();
+            const stored = context.tokens.write(token);
+            context.registry.touch();
+            if (context.env[tokenVariable]) {
+                context.streams.diagnostic(`${tokenVariable} is set, and it wins over the token just kept until it is unset`);
+            }
+            context.renderer.result({
+                profile: context.profile,
+                stored,
+                bot: account.name,
+                id: account.id,
+                username: account.username,
+            });
+        });
+    });
+    auth
+        .command("show")
+        .description("where this profile's bot token comes from, and which bot it is")
+        .action(async function () {
+        const context = online(botContext(this, bot), this);
+        await context.run(async (events) => {
+            const source = context.tokens.read()?.source;
+            const account = await (await context.authenticated({ events })).me();
+            context.renderer.result({
+                profile: context.profile,
+                source,
+                bot: account.name,
+                id: account.id,
+                username: account.username,
+            });
+        });
+    });
+    annotate(auth.command("remove"), { mutates: true, local: true })
+        .description("forget this profile's bot token")
+        .action(async function () {
+        const context = botContext(this, bot);
+        await context.run(async () => context.renderer.result({ profile: context.profile, removed: context.tokens.remove() }));
+    });
+    return auth;
+};
+const meCommand = (bot) => new Command("me")
+    .description("the bot this profile's token belongs to: id, name and username")
+    .action(async function () {
+    const context = online(botContext(this, bot), this);
+    await context.run(async (events) => {
+        const adapter = await context.authenticated({ events });
+        try {
+            context.renderer.result(await adapter.me());
+        }
+        finally {
+            await adapter.close();
+        }
+    });
+});
+const listCommand = (bot, tokenVariable) => new Command("list")
+    .description(`every name on this machine that has a bot token; --check asks ${bot.name ?? "the messenger"} which bot each is`)
+    .option("--check", "ask the messenger who each bot is, with its token")
+    .action(async function () {
+    const context = botContext(this, bot);
+    const check = this.opts().check === true;
+    if (check)
+        online(context, this);
+    await context.run(async (events) => {
+        const names = [
+            ...new Set(["default", ...context.settings.configuredProfiles, ...registryProfiles(bot.app, context.env)]),
+        ].sort();
+        if (context.env[tokenVariable]) {
+            context.streams.diagnostic(`${tokenVariable} is set, so every name uses that one token`);
+        }
+        const rows = [];
+        for (const name of names) {
+            const tokens = bot.tokenStore?.(this, name) ?? new BotTokenStore({ app: bot.app, profile: name, env: context.env });
+            const stored = tokens.read();
+            if (!stored)
+                continue;
+            const row = { name, token: stored.source };
+            if (check) {
+                try {
+                    const account = await (await context.connect(stored.token, { events })).me();
+                    Object.assign(row, { bot: account.username ?? account.name, id: account.id });
+                }
+                catch (error) {
+                    row.problem = error.code ?? "failed";
+                }
+            }
+            rows.push(row);
+        }
+        renderList(context.renderer, context.format, rows);
+    });
+});
+const recipientsCommand = (bot) => {
+    const command = new Command("recipients").description("the chats this bot may write to; with no list, every chat — `clear` removes the list");
+    command
+        .command("list")
+        .description("the chats on the list, or nothing when there is no list")
+        .action(async function () {
+        const context = botContext(this, bot);
+        await context.run(async () => renderList(context.renderer, context.format, context.recipients().read() ?? []));
+    });
+    annotate(command.command("add <chat>"), { mutates: true, local: true })
+        .description("allow a chat: its id, `user:<id>`, or the title of a chat this bot has seen")
+        .action(async function (chat) {
+        const context = botContext(this, bot);
+        await context.run(async () => {
+            const id = context.chatRef(chat);
+            const title = context.registry.list().find((seen) => seen.id === id)?.title ?? null;
+            context.recipients().add({ id, title, addedAt: new Date().toISOString() });
+            renderList(context.renderer, context.format, context.recipients().read() ?? []);
+        });
+    });
+    annotate(command.command("remove <chat>"), { mutates: true, local: true })
+        .description("take a chat off the list")
+        .action(async function (chat) {
+        const context = botContext(this, bot);
+        await context.run(async () => context.renderer.result({ removed: context.recipients().remove(chat) ?? null }));
+    });
+    annotate(command.command("clear"), { mutates: true, local: true })
+        .description("remove the list: the bot may write to any chat again")
+        .action(async function () {
+        const context = botContext(this, bot);
+        await context.run(async () => context.renderer.result({ removed: context.recipients().off() }));
+    });
+    return command;
+};
+const sendsCommand = (bot) => new Command("sends")
+    .description("what this bot sent, edited and deleted from this machine — ids and outcomes, never text")
+    .addCommand(new Command("list").action(async function () {
+    const context = botContext(this, bot);
+    await context.run(async () => renderList(context.renderer, context.format, context.journal().entries()));
+}));
+const chatsCommand = (bot) => {
+    const command = new Command("chats").description(`the chats this bot is in — ${bot.name ?? "the messenger"} 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 ${bot.name ?? "the messenger"}`)
+        .action(async function () {
+        const context = botContext(this, bot);
+        await context.run(async () => renderList(context.renderer, context.format, context.registry.list()));
+    });
+    command
+        .command("show")
+        .description(`one chat from ${bot.name ?? "the messenger"}, and remember it`)
+        .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+        .action(async function (chat) {
+        const context = online(botContext(this, bot), this);
+        const ref = context.chatRef(chat);
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            const found = await botCan(adapter, "chat", bot, "describe a chat")(ref);
+            context.registry.observe([found]);
+            await context.copy.keepChat(await botIdOf(context, adapter), found, context.renderer.warn);
+            context.renderer.result(found);
+        });
+    });
+    annotate(command.command("leave"), { mutates: true })
+        .description("take the bot out of a chat; only an admin of the chat can bring it back")
+        .argument("<chat>", "a chat id, or the title of a chat this bot has seen")
+        .action(async function (chat) {
+        const context = online(botContext(this, bot), this);
+        const ref = context.chatRef(chat);
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            const leave = botCan(adapter, "leave", bot, "leave a chat");
+            const operationId = newOperationId();
+            await guardedWrite(context.guard(), { operationId, chatId: ref, kind: "chat", action: "leave", key: "bot.chats.leave" }, () => leave(ref));
+            context.renderer.result({ operationId, chatId: ref, left: true });
+        });
+    });
+    annotate(command.command("action"), { mutates: true })
+        .description("show what the bot is doing in a chat — typing, sending a photo — for a few seconds")
+        .argument("<chat>", "a chat id, user:<id> for a person, or the title of a chat this bot has seen")
+        .addArgument(new Argument("<action>", "what the chat sees").choices(BOT_ACTIONS))
+        .action(async function (chat, action) {
+        const context = online(botContext(this, bot), this);
+        const ref = context.chatRef(chat);
+        await context.run(async (events) => {
+            const adapter = await context.authenticated({ events });
+            const act = botCan(adapter, "action", bot, "show an action");
+            const operationId = newOperationId();
+            await guardedWrite(context.guard(), { operationId, chatId: ref, kind: "chat", key: "bot.chats.action" }, () => act(ref, action));
+            context.renderer.result({ operationId, chatId: ref, action });
+        });
+    });
+    command.addCommand(botAdminsCommand(bot));
+    command.addCommand(botMembersCommand(bot));
+    command.addCommand(botRulesCommand(bot));
+    command.addCommand(botModerateCommand(bot));
+    return command;
+};
+/**
+ * The `bot` group: a bot account through the messenger's official Bot API and a bot token. A CLI adds
+ * the commands that are still its own with `addCommand`, on this group or on its `chats`.
+ */
+const withCopyReads = (messages, bot) => {
+    addBotCopyReads(messages, bot);
+    return messages;
+};
+export const botCommand = (bot) => {
+    const tokenVariable = envName(bot.app, "BOT_TOKEN");
+    const command = new Command("bot")
+        .description(`a ${bot.name ?? "messenger"} bot, through the official Bot API and a bot token — not your personal account`)
+        .addCommand(authCommand(bot, tokenVariable))
+        .addCommand(listCommand(bot, tokenVariable))
+        .addCommand(chatsCommand(bot))
+        .addCommand(withCopyReads(botMessagesCommand(bot), bot))
+        .addCommand(botSearchCommand(bot))
+        .addCommand(recipientsCommand(bot))
+        .addCommand(sendsCommand(bot))
+        .addCommand(botWatchCommand(bot))
+        .addCommand(botCallbacksCommand(bot))
+        .addCommand(botMenuCommand(bot))
+        .addCommand(botWebhooksCommand(bot))
+        .addCommand(botContactsCommand(bot));
+    if (bot.identity)
+        command.addCommand(meCommand(bot));
+    if (bot.fetching)
+        command.addCommand(botStoreCommand(bot, bot.fetching));
+    return bot.mcp ? command.addCommand(botMcpCommand(bot)) : command;
+};
+//# sourceMappingURL=command.js.map

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

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

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

@@ -0,0 +1,56 @@
+import type { Command } from "commander";
+import { SendJournal } from "../../sends/journal.js";
+import type { Level, PermissionKey } from "../../sends/permissions.js";
+import { RecipientList } from "../../sends/recipients.js";
+import type { BotAdapter, BotChatRef, BotConnectOptions, BotMessenger } from "./port.js";
+import { ChatRegistry } from "./registry.js";
+import { BotTokenStore } from "./token.js";
+/** How the owner types this bot — `max sales bot` — so a refusal names the command that fixes it. */
+export declare const botWords: (bot: BotMessenger, profile: string) => string;
+/** What a bot command needs, resolved once: the bot's settings, its token, its lists. */
+export declare const botContext: (command: Command, bot: BotMessenger) => {
+    settings: import("../settings.js").Settings;
+    renderer: import("@wirecat/cli-base").Renderer;
+    format: import("@wirecat/cli-base").RenderFormat;
+    color: boolean;
+    streams: import("@wirecat/cli-base").Streams;
+    env: NodeJS.ProcessEnv;
+    run: <T>(body: (events: import("../index.js").EventSink) => Promise<T>, options?: {
+        unbounded?: boolean;
+        name?: string;
+    }) => Promise<T>;
+    track: (closeable: import("../deadline.js").Closeable) => void;
+    profile: string;
+    words: string;
+    tokens: BotTokenStore;
+    registry: ChatRegistry;
+    recipients: () => RecipientList;
+    journal: () => SendJournal;
+    /** What this bot has read, sent and received, in the shared store. */
+    copy: {
+        accountOf: (botId: string) => import("../../store/store.js").AccountKey;
+        keep: (botId: string, messages: readonly import("../../index.js").Message[], via: import("../../store/store.js").IngestedVia, warn: (message: string) => void, senders?: readonly import("../../store/store.js").PersonFacts[]) => Promise<boolean>;
+        keepChat: (botId: string, chat: import("../../index.js").Chat, warn: (message: string) => void) => Promise<void>;
+        forget: (botId: string, chatId: string, messageIds: string[], warn: (message: string) => void) => Promise<boolean>;
+        received: (botId: string, events: readonly import("./port.js").BotEvent[], warn: (message: string) => void) => Promise<Set<string>>;
+        settle: (botId: string, events: readonly import("./port.js").BotEvent[], error: string | null, warn: (message: string) => void) => Promise<void>;
+        read: <T>(read: (store: import("../../store/store.js").MessageStore) => Promise<T>) => Promise<T>;
+    };
+    /**
+     * The profile's guard with this bot's recipient list and journal. `profile` reads as the words
+     * a fix is typed with — `max sales bot recipients add …` — and a bot has no hourly limit unless
+     * its section sets one.
+     */
+    guard: (permissionDefaults?: Readonly<Record<PermissionKey, Level>>) => import("../../sends/guard.js").SendGuard;
+    /** A chat id, `user:<id>`, or the title of a chat this bot has seen — never a guess. */
+    chatRef: (typed: string) => BotChatRef;
+    readSecret: (prompt: string) => Promise<string>;
+    /** A client for this token, closed when the command ends. */
+    connect: (token: string, options?: BotConnectOptions) => Promise<BotAdapter>;
+    /** A client for the stored token, or a refusal that says how to store one. */
+    authenticated: (options?: BotConnectOptions) => Promise<BotAdapter>;
+};
+export type BotContext = ReturnType<typeof botContext>;
+/** `--offline` reads the local copy; a command that has to ask the messenger refuses it rather than ignoring it. */
+export declare const online: (context: BotContext, command: Command) => BotContext;
+//# sourceMappingURL=context.d.ts.map