@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/cli/bot/people.js

@@ -0,0 +1,239 @@
+import { CliError, singleLine } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { parseLocator } from "../../domain/locator.js";
+import { renderMessages } from "../../render/messages.js";
+import { pickPerson } from "../../resolve.js";
+import { searchStore } from "../../services/messages.js";
+import { positiveCount } from "../paging.js";
+import { asFirstWord } from "../profile.js";
+import { botContext } from "./context.js";
+import { botCan } from "./messages.js";
+import { ChatRegistry, registryProfiles } from "./registry.js";
+/** What "common chats" rests on: who has written where in this copy, not who is a member. */
+const BASIS = "messages seen";
+/**
+ * This bot's copy, or — when the command asks and `readOtherBots` allows — other bots' copies too.
+ * Identities are per provider, so a person is the same in all of them.
+ */
+const scopeOf = (context, bot, across = {}) => {
+    const own = context.registry.botId();
+    const asked = across.allBots === true || (across.bots?.length ?? 0) > 0;
+    if (!asked) {
+        if (!own) {
+            throw new CliError("not_found", `nothing is recorded for this bot on this machine — run \`${context.words} messages list <chat>\` once`);
+        }
+        return { filter: { account: context.copy.accountOf(own) }, people: { account: own } };
+    }
+    const { profile } = context;
+    const allowed = context.settings.readOtherBots;
+    const fix = `${bot.app.command} ${asFirstWord(profile)}config set --bot readOtherBots true, or a list of bots`;
+    if (allowed === false) {
+        throw new CliError("permission_error", `profile ${profile} may not read other bots' copies (readOtherBots is off, from the ` +
+            `${context.settings.sources.readOtherBots}) — to allow it: ${fix}`);
+    }
+    const named = across.allBots
+        ? allowed === true
+            ? registryProfiles(bot.app, context.env)
+            : [...allowed]
+        : (across.bots ?? []);
+    if (allowed !== true) {
+        const refused = named.filter((name) => !allowed.includes(name));
+        if (refused.length > 0) {
+            throw new CliError("permission_error", `profile ${profile} may read only ${allowed.join(", ") || "no other bot"} (readOtherBots) — not ${refused.join(", ")}`);
+        }
+    }
+    const ids = named
+        .filter((name) => name !== profile)
+        .flatMap((name) => {
+        const id = new ChatRegistry(bot.app, name, context.env).botId();
+        if (id)
+            return [id];
+        if (across.allBots)
+            return [];
+        throw new CliError("not_found", `nothing is recorded for bot ${name} on this machine`);
+    });
+    const accounts = [...new Set([...(own ? [own] : []), ...ids])];
+    return { filter: { provider: bot.provider, accounts }, people: { accounts } };
+};
+/** `--all-bots` and `--bots`, on every command that reads the copy by person or text. */
+const acrossOptions = (command) => command
+    .option("--all-bots", "also read every other bot's copy on this machine that readOtherBots allows")
+    .option("--bots <profiles>", "also read these bots' copies, comma separated — each allowed by readOtherBots", (value) => value
+    .split(",")
+    .map((name) => name.trim())
+    .filter(Boolean));
+const resolve = async (store, bot, references, scope) => {
+    const people = await store.people(bot.provider, scope);
+    return references.map((reference) => pickPerson(reference, people));
+};
+/** Two bots in one group keep a copy each; the reader wants the message once. */
+const once = (messages) => {
+    const seen = new Set();
+    return messages.filter((message) => {
+        const key = `${message.chatId} ${message.id}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+};
+const byTime = (a, b) => a.timestamp.localeCompare(b.timestamp);
+const messagesText = (context, bot, messages) => renderMessages(messages, {
+    verbosity: context.settings.detail,
+    color: context.color,
+    profile: context.profile,
+    provider: bot.provider,
+    locale: bot.app.locale,
+});
+/** Telegram's ids say it: a person is positive, a group negative. */
+const kindByNumber = (hit) => (hit.chatId.startsWith("-") ? "group" : "dialog");
+const nameLine = (person) => singleLine([person.name ?? "(no name)", person.username && `@${person.username}`, person.id].filter(Boolean).join("  "));
+const cardOf = async (store, context, bot, who, across, limit) => {
+    const { filter, people } = scopeOf(context, bot, across);
+    const [person] = (await resolve(store, bot, [who], people));
+    const rows = (await store.find({ ...filter, senders: [person.id], perChat: true, limit: 1 })).items;
+    const latest = rows.filter((hit, index) => rows.findIndex((other) => other.chatId === hit.chatId) === index);
+    const kindOf = bot.chatKindOf ?? kindByNumber;
+    const dialogs = latest.filter((hit) => kindOf(hit) === "dialog");
+    const pages = await Promise.all(dialogs.map((hit) => store.messages({ provider: bot.provider, account: parseLocator(hit.locator).account }, hit.chatId, { limit })));
+    const messages = pages.flatMap((page) => page.items).toSorted(byTime);
+    const card = {
+        ...person,
+        chats: latest.map((hit) => ({
+            id: hit.chatId,
+            title: hit.chatTitle,
+            kind: kindOf(hit),
+            lastMessageAt: hit.timestamp,
+        })),
+        messages: messages.slice(-limit),
+    };
+    return { card, dialogs };
+};
+/** `bot contacts show`: one person this bot has seen write, from the local copy. */
+export const botContactsCommand = (bot) => {
+    const command = new Command("contacts").description(`people this bot has seen write — from the local copy on this machine, never asking ${bot.name ?? "the messenger"} unless told to`);
+    acrossOptions(command.command("show"))
+        .argument("<who>", "an id, @username or part of a name")
+        .option("--limit <n>", "how many messages from the private chat", positiveCount("--limit"))
+        .option("--refresh", "read the private chat with them again from the messenger first — one request")
+        .description("one person: the chats they wrote in (with their last message there) and the latest messages of their " +
+        "private chat with the bot")
+        .action(async function (who, options) {
+        const context = botContext(this, bot);
+        const across = { allBots: options.allBots === true, bots: options.bots ?? [] };
+        const limit = options.limit ?? context.settings.limit;
+        const read = () => context.copy.read((store) => cardOf(store, context, bot, who, across, limit));
+        await context.run(async (events) => {
+            let { card, dialogs } = await read();
+            if (options.refresh) {
+                if (context.settings.offline)
+                    throw new CliError("validation_error", "--refresh asks the messenger; drop --offline");
+                const adapter = await context.authenticated({ events });
+                const history = botCan(adapter, "history", bot, "read a chat back");
+                const self = context.registry.botId();
+                const ours = dialogs.find((hit) => self && parseLocator(hit.locator).account === self);
+                if (!self || !ours) {
+                    context.renderer.note("no private chat with them is recorded for this bot — nothing to refresh");
+                }
+                else {
+                    const fresh = await history(ours.chatId, { limit: Math.min(limit, 100) });
+                    await context.copy.keep(self, fresh, "history", context.renderer.warn, adapter.senders?.());
+                    ({ card } = await read());
+                }
+            }
+            if (context.format !== "pretty") {
+                context.renderer.result(card);
+                return;
+            }
+            const chats = card.chats.map((chat) => `  ${chat.id}  ${chat.kind}  ${singleLine(chat.title ?? "")}  ${chat.lastMessageAt ?? ""}`);
+            context.streams.data([nameLine(card), ...chats, "", messagesText(context, bot, card.messages)].join("\n"));
+        });
+    });
+    return command;
+};
+const search = (context, bot, text, from, options) => {
+    if (text.trim() === "" && from.length === 0) {
+        throw new CliError("validation_error", "say what to find: some text, or who wrote it with --from");
+    }
+    const { people } = scopeOf(context, bot, options);
+    const accounts = ("account" in people ? [people.account] : people.accounts).map(context.copy.accountOf);
+    return context.copy.read(async (store) => {
+        const senders = (await resolve(store, bot, from, people)).map(({ id }) => ({ provider: bot.provider, id }));
+        return searchStore(store, accounts[0], {
+            text,
+            accounts,
+            ...(senders.length > 0 ? { senders } : {}),
+            limit: options.limit ?? context.settings.limit,
+            newest: options.newest === true,
+        });
+    });
+};
+/** `bot search messages`: the messages this bot's local copy holds. */
+export const botSearchCommand = (bot) => {
+    const group = new Command("search").description("find what this bot's local copy holds, by text");
+    acrossOptions(group.command("messages"))
+        .argument("[query...]", "the words to find")
+        .option("--limit <n>", "how many", positiveCount("--limit"))
+        .option("--newest", "newest first instead of best first")
+        .option("--from <who>", "only what this person wrote — an id, @username or part of a name; repeat it for any of several", (value, previous = []) => [...previous, value])
+        .description("search the messages this bot has read, sent or received on this machine — the local copy only, best " +
+        'match first; every word must appear; "a phrase", -word, a OR b, from: chat: after: before: has:; ' +
+        "by text, by --from, or both")
+        .action(async function (query, options) {
+        const context = botContext(this, bot);
+        await context.run(async () => {
+            const found = await search(context, bot, query.join(" "), options.from ?? [], options);
+            for (const { from, to } of found.corrections)
+                context.renderer.note(`${from} → ${to.join(", ")}`);
+            if (!found.wordsReady) {
+                context.renderer.note(`the word index is still being built, so a search by words reads pieces of words until \`${bot.app.command} store migrate\` finishes it`);
+            }
+            if (context.format === "pretty")
+                context.streams.data(messagesText(context, bot, found.items));
+            else if (context.format === "jsonl")
+                context.renderer.stream(found.items);
+            else
+                context.renderer.result({ items: found.items, page: 1, limit: found.items.length, hasMore: found.hasMore });
+        });
+    });
+    return group;
+};
+/** `bot messages between`, over the local copy, added to the shared `messages` group. */
+export const addBotCopyReads = (messages, bot) => {
+    acrossOptions(messages.command("between"))
+        .argument("<people...>", "two or more people — an id, @username or part of a name each")
+        .option("--limit <n>", "how many of the latest messages from each chat", positiveCount("--limit"))
+        .description("what two or more people wrote in the chats they have all written in — from the local copy, grouped by " +
+        "chat, oldest first; --limit counts per chat. Common chats are the ones this copy saw each of them " +
+        `write in, not a member list from ${bot.name ?? "the messenger"}`)
+        .action(async function (references, options) {
+        const context = botContext(this, bot);
+        if (references.length < 2)
+            throw new CliError("validation_error", "name at least two people");
+        const limit = options.limit ?? context.settings.limit;
+        await context.run(async () => {
+            const { filter, people } = scopeOf(context, bot, options);
+            const page = await context.copy.read(async (store) => {
+                const senders = (await resolve(store, bot, references, people)).map(({ id }) => id);
+                return store.find({ ...filter, senders, together: true, perChat: true, limit });
+            });
+            const chats = new Map();
+            for (const hit of once(page.items)) {
+                const chat = chats.get(hit.chatId) ?? { id: hit.chatId, title: hit.chatTitle, messages: [] };
+                chat.messages.push(hit);
+                chats.set(hit.chatId, chat);
+            }
+            const grouped = [...chats.values()].map((chat) => ({
+                ...chat,
+                messages: chat.messages.toSorted(byTime).slice(-limit),
+            }));
+            if (context.format !== "pretty") {
+                context.renderer.result({ basis: BASIS, chats: grouped, hasMore: page.hasMore });
+                return;
+            }
+            const blocks = grouped.map((chat) => `${chat.id}  ${singleLine(chat.title ?? "")}\n${messagesText(context, bot, chat.messages)}`);
+            context.streams.data(blocks.join("\n\n"));
+        });
+    });
+};
+//# sourceMappingURL=people.js.map

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

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

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

@@ -0,0 +1,280 @@
+import type { Command } from "commander";
+import type { MarkdownFormatting, TextSpan } from "../../domain/formatting.js";
+import type { Markup } from "../../domain/markdown.js";
+import type { AdminRight, Chat, ChatKind, GroupMember, Id, Member, Message, MessageEvent, Provider } from "../../domain/models.js";
+import type { RunBotCommand } from "../../mcp/bot/server.js";
+import type { BotTool } from "../../mcp/bot/tools.js";
+import type { GuardRequest } from "../../sends/guard.js";
+import type { Upload } from "../../sends/upload.js";
+import type { PersonFacts, StoredHit } from "../../store/index.js";
+import type { AppIdentity } from "../app.js";
+import type { Fetching } from "../messenger/context.js";
+import type { MessagePins, MessengerCore } from "../messenger/port.js";
+import type { EventSink } from "../runs/events.js";
+import type { GlobalFlags, ResolveOptions, Settings } from "../settings.js";
+import type { ChatRegistry } from "./registry.js";
+import type { BotTokenStore } from "./token.js";
+/**
+ * A chat as a bot command names it, resolved: a chat id, or `user:<id>` for the dialog with a person —
+ * MAX's Bot API writes to a person by user id, and Telegram's chat id for a dialog is the person's id.
+ */
+export type BotChatRef = string;
+/** How one bot message goes. A bot send is never repeated — neither Bot API makes a repeat safe — so it has no send id. */
+export interface BotSendOptions {
+    /** A message id in the same chat. */
+    replyTo?: Id;
+    silent?: boolean;
+    /** Spans of `text`, from `--md`. */
+    markup?: Markup[];
+    formatting?: TextSpan[];
+    /** `text` is the messenger's HTML. */
+    html?: boolean;
+    attachments?: Upload[];
+}
+/** Sending, changing and deleting the bot's messages. */
+export interface BotMessaging {
+    send(chat: BotChatRef, text: string, options: BotSendOptions): Promise<Message>;
+    edit(chat: BotChatRef, messageId: Id, text: string, options: {
+        markup?: Markup[];
+        formatting?: TextSpan[];
+        html?: boolean;
+    }): Promise<Message>;
+    delete(chat: BotChatRef, messageIds: Id[]): Promise<void>;
+}
+/** Reading from the messenger, where its Bot API allows it — MAX's does, Telegram's does not. */
+export interface BotHistory {
+    /** The newest `limit`, oldest first. */
+    history(chat: BotChatRef, window: {
+        limit: number;
+    }): Promise<Message[]>;
+    message(chat: BotChatRef, messageId: Id): Promise<Message>;
+    /** Everything sent at `since` (ms) or later, oldest first, up to `limit`; `more` when there was more. */
+    historySince(chat: BotChatRef, since: number, limit: number): Promise<{
+        messages: Message[];
+        more: boolean;
+    }>;
+    /** One page back from `before` (or from now), newest first: what `bot store fetch` walks. */
+    historyBefore(chat: BotChatRef, window: {
+        limit: number;
+        before?: string;
+    }): Promise<{
+        items: Message[];
+        hasMore: boolean;
+    }>;
+}
+/** Who wrote what the adapter read, with what a `Message` has no field for. */
+export interface BotPeople {
+    /** The senders of the messages decoded since the last call — their handle and whether each is a bot — for the local copy. */
+    senders(): PersonFacts[];
+}
+/** What a bot shows in a chat while it works. */
+export declare const BOT_ACTIONS: readonly ["typing", "photo", "video", "voice", "file"];
+export type BotAction = (typeof BOT_ACTIONS)[number];
+/** One chat the bot is in. */
+export interface BotChatTools {
+    chat(chat: BotChatRef): Promise<Chat>;
+    /** Only an admin of the chat can bring the bot back. */
+    leave(chat: BotChatRef): Promise<void>;
+    action(chat: BotChatRef, action: BotAction): Promise<void>;
+}
+/** An admin of a chat, and what they may do. */
+export interface BotChatAdmin extends Member {
+    role: "owner" | "admin";
+    /** In the shared words; a right the messenger has and these words lack is left out. */
+    rights: AdminRight[];
+    /** The title shown beside their name, when they have one. */
+    title: string | null;
+}
+/** Who runs a chat the bot is an admin in. */
+export interface BotChatAdmins {
+    admins(chat: BotChatRef): Promise<BotChatAdmin[]>;
+    /** A right this messenger lacks is refused, never dropped. */
+    addAdmin(chat: BotChatRef, person: Id, rights: AdminRight[], options: {
+        title?: string;
+    }): Promise<void>;
+    /** They stay a member. */
+    removeAdmin(chat: BotChatRef, person: Id): Promise<void>;
+}
+/** Taking people out of a chat the bot is an admin in. */
+export interface BotChatMembers {
+    /** Their messages stay; `block` also keeps them from coming back by the chat's link. */
+    removeMember(chat: BotChatRef, person: Id, options: {
+        block: boolean;
+    }): Promise<void>;
+}
+/** One command in the menu people see when they type `/`. */
+export interface BotMenuEntry {
+    /** Without the `/`. */
+    name: string;
+    description: string | null;
+}
+/** The bot's command menu. */
+export interface BotMenu {
+    menu(): Promise<BotMenuEntry[]>;
+    /** Replaces the whole menu; an empty list clears it. */
+    setMenu(entries: BotMenuEntry[]): Promise<void>;
+}
+/** Where a pressed button was, as `bot watch` kept it. */
+export interface BotPress {
+    chatId: Id;
+    messageId: Id;
+}
+/** Answering a button someone pressed under the bot's message. */
+export interface BotCallbacks {
+    /**
+     * `notification` is shown to the person who pressed; `text` replaces the message the button was
+     * on. `press` is where that was, when `bot watch` kept it — a messenger that cannot find the
+     * message from the callback id alone needs it for `text`.
+     */
+    answer(callbackId: string, answer: {
+        notification?: string;
+        text?: string;
+        press?: BotPress;
+    }): Promise<void>;
+}
+/** An address the messenger pushes this bot's updates to. */
+export interface BotWebhook {
+    url: string;
+    /** The update types it gets, in the messenger's words; `null` is all of them. */
+    types: string[] | null;
+}
+/** While a webhook is set, the messenger gives polling nothing. */
+export interface BotWebhooks {
+    webhooks(): Promise<BotWebhook[]>;
+    setWebhook(url: string, options: {
+        types?: string[];
+        secret?: string;
+    }): Promise<void>;
+    deleteWebhook(url: string): Promise<void>;
+}
+/** What happened in the bot's chats besides messages: a button, people coming and going, a start. */
+export type BotNotice = {
+    event: "callback";
+    callbackId: string;
+    chatId: Id | null;
+    messageId: Id | null;
+    from: Member | null;
+    data: string;
+}
+/** `at` is when it happened, ISO 8601, where the messenger says — `watch` may print it long after. */
+ | {
+    event: "joined" | "left" | "added" | "removed";
+    chatId: Id;
+    person: Member | null;
+    at?: string;
+} | {
+    event: "started";
+    chatId: Id | null;
+    person: Member | null;
+}
+/** An update this adapter does not decode, under the messenger's own type name. */
+ | {
+    event: "other";
+    type: string;
+    chatId: Id | null;
+};
+/** The messenger's own id for the update an event came in, so `bot watch` can recognise a redelivery. */
+export interface BotUpdateRef {
+    id: string;
+    /** The update's type, in the messenger's words. */
+    kind: string;
+}
+/** One update as `bot watch` prints it; without `update`, a redelivery is printed and kept again. */
+export type BotEvent = (MessageEvent | BotNotice) & {
+    update?: BotUpdateRef;
+};
+export interface BotUpdatesPage {
+    events: BotEvent[];
+    /** Where the next call starts; the same as given when nothing came. Opaque to the caller. */
+    cursor: string | undefined;
+}
+/** Taking the bot's updates by polling. A call waits up to `waitSeconds` for the first one. */
+export interface BotUpdates {
+    updates(cursor: string | undefined, options: {
+        types?: string[];
+        waitSeconds: number;
+        signal: AbortSignal;
+    }): Promise<BotUpdatesPage>;
+}
+/**
+ * The part of the personal core a bot can do, and the groups its Bot API has. A bot never gets
+ * `chats` from this type: neither Bot API lists a bot's chats.
+ */
+export type BotAdapter = Pick<MessengerCore, "me" | "close"> & Partial<MarkdownFormatting> & Partial<BotNativeApi> & Partial<BotMessaging> & Partial<BotHistory> & Partial<MessagePins> & Partial<BotChatTools> & Partial<BotChatAdmins> & Partial<BotChatMembers> & Partial<BotMenu> & Partial<BotCallbacks> & Partial<BotWebhooks> & Partial<BotUpdates> & Partial<BotPeople>;
+export interface BotNativeApi {
+    api(method: string, input: {
+        body?: string;
+        files: readonly {
+            field: string;
+            name: string;
+            bytes: Uint8Array;
+        }[];
+        secrets: readonly string[];
+    }, options: {
+        reads: boolean;
+        timeoutMs?: number;
+    }): Promise<unknown>;
+}
+export interface BotConnectOptions {
+    stop?: AbortSignal;
+    events?: EventSink;
+    /** Only `bot store fetch` asks for a history reader; other commands stay on the Bot API. */
+    history?: {
+        from?: string;
+        pauseMs: number;
+    };
+    /** Register a connection before its login can block, so the command deadline can close it. */
+    track?: (client: Pick<BotAdapter, "close">) => void;
+}
+/** What one messenger CLI hands the shared bot commands. */
+export interface BotMessenger {
+    app: AppIdentity;
+    /** How the store tells this messenger's bots from its personal accounts: it ends in `-bot` — `max-bot`, `telegram-bot`. */
+    provider: Provider;
+    /** The messenger's own name, as its users write it — `MAX`, `Telegram`. */
+    name?: string;
+    /** The admin rights `--can` offers; every shared one when unset. */
+    adminRights?: readonly AdminRight[];
+    /** Whether `bot webhooks set --add` keeps the other addresses; a messenger with one address has no `--add`. */
+    manyWebhooks?: boolean;
+    /** Mount shared bot me; consumers with an existing response migrate explicitly. */
+    identity?: boolean;
+    /**
+     * Called by `bot watch` with each batch, after the copy took it and before it is printed. A throw
+     * holds the cursor, so the batch comes again — keep what it writes safe to write twice.
+     */
+    keepUpdates?: (command: Command, profile: string, events: readonly BotEvent[]) => void;
+    /** Who joined a chat at `since` (ms) or later, from what `keepUpdates` kept; `undefined` when nothing was ever kept. */
+    joinsSince?: (command: Command, profile: string, chatId: Id, since: number) => GroupMember[] | undefined;
+    /** Called with `kind: "bot"`. */
+    resolveSettings: (flags: GlobalFlags, options?: ResolveOptions) => Settings;
+    /**
+     * A client for this token. `stop` ends a command that runs until told to, and its request in
+     * flight; `events` is the run's, for each request's trace line and record.
+     */
+    connect: (command: Command, token: string, options?: BotConnectOptions) => Promise<BotAdapter>;
+    /** Where the token lives; the shared `BotTokenStore` when unset. A CLI's tests put their own here. */
+    tokenStore?: (command: Command, profile: string) => BotTokenStore;
+    /** The chats the bot has seen; the shared `ChatRegistry` when unset. */
+    registry?: (command: Command, profile: string) => ChatRegistry;
+    /** A secret typed at a hidden prompt or piped on stdin; the shared `readSecret` when unset. */
+    readSecret?: (command: Command, prompt: string) => Promise<string>;
+    /** What kind of chat a stored message came from; without it a positive id is a dialog, a negative one a group. */
+    chatKindOf?: (hit: StoredHit) => ChatKind;
+    /** How its history pages, for `bot store fetch`, which is mounted only when this is set. */
+    fetching?: Fetching & {
+        from?: string;
+    };
+    permissionFix?: (settings: Settings, request: GuardRequest) => string;
+    /** `bot mcp`, mounted only when this is set. */
+    mcp?: BotMcp;
+}
+export interface BotMcp {
+    /** The CLI's own `run`, loaded when the server starts: this package cannot import the CLI's program. */
+    program: () => Promise<RunBotCommand>;
+    /** The CLI's own tools, for the commands that are still its own. */
+    tools?: readonly BotTool[];
+    /** The CLI's SKILL.md, served as `<command>://skill`. */
+    skill?: URL;
+}
+//# sourceMappingURL=port.d.ts.map

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

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

package/dist/cli/bot/port.js

@@ -0,0 +1,3 @@
+/** What a bot shows in a chat while it works. */
+export const BOT_ACTIONS = ["typing", "photo", "video", "voice", "file"];
+//# sourceMappingURL=port.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../../../src/cli/bot/port.ts"],"names":[],"mappings":"AA8EA,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA"}

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

@@ -0,0 +1,40 @@
+import type { Chat } from "../../domain/models.js";
+import type { AppIdentity } from "../app.js";
+export interface SeenChat extends Chat {
+    firstSeenAt: string;
+    lastSeenAt: string;
+}
+/** Everything this machine keeps about its bots: seen chats, recipients, the send journal. */
+export declare const botsDirectory: (app: AppIdentity, env?: NodeJS.ProcessEnv) => string;
+/** One bot's files. The names are what max-cli has always used: a moved path would lose a recipient list, and with it the limit. */
+export declare const botFiles: (app: AppIdentity, profile: string, env?: NodeJS.ProcessEnv) => {
+    registry: string;
+    recipients: string;
+    journal: string;
+    updates: string;
+    presses: string;
+    checks: string;
+};
+/**
+ * The chats this bot has seen, because neither MAX's nor Telegram's Bot API has a call that lists them.
+ *
+ * State, not cache: the messenger cannot give it back, so clearing a cache must not take it. Titles
+ * are in it, hence 0600.
+ */
+export declare class ChatRegistry {
+    #private;
+    constructor(app: AppIdentity, profile: string, env?: NodeJS.ProcessEnv);
+    list(): SeenChat[];
+    /** The bot's own user id, once any command has learned it — the key its messages are stored under. */
+    botId(): string | undefined;
+    rememberBot(id: string): void;
+    /** Makes this bot known to `bot list` before it has seen any chat. */
+    touch(): void;
+    /** Newer facts win; a chat seen only as an id keeps the title it had. */
+    observe(chats: readonly (Partial<Chat> & {
+        id: string;
+    })[], now?: Date): void;
+}
+/** Every profile that has ever kept a registry — the bots this machine has used. */
+export declare const registryProfiles: (app: AppIdentity, env?: NodeJS.ProcessEnv) => string[];
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/cli/bot/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAA;AAClD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,MAAM,WAAW,QAAS,SAAQ,IAAI;IACpC,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,8FAA8F;AAC9F,eAAO,MAAM,aAAa,QAAS,WAAW,QAAO,MAAM,CAAC,UAAU,KAAiB,MACC,CAAA;AAExF,oIAAoI;AACpI,eAAO,MAAM,QAAQ,QAAS,WAAW,WAAW,MAAM,QAAO,MAAM,CAAC,UAAU;IAG9E,QAAQ;IACR,UAAU;IACV,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;CAET,CAAA;AAED;;;;;GAKG;AACH,qBAAa,YAAY;;IAGvB,YAAY,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAElF;IAED,IAAI,IAAI,QAAQ,EAAE,CAGjB;IAED,sGAAsG;IACtG,KAAK,IAAI,MAAM,GAAG,SAAS,CAG1B;IAED,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAG5B;IAED,sEAAsE;IACtE,KAAK,IAAI,IAAI,CAEZ;IAED,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI,CAuBxF;CAeF;AAED,oFAAoF;AACpF,eAAO,MAAM,gBAAgB,QAAS,WAAW,QAAO,MAAM,CAAC,UAAU,KAAiB,MAAM,EAO/F,CAAA"}