@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/cli/messenger/messages-search-command.js

@@ -0,0 +1,244 @@
+import { CliError } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { parseLocator } from "../../domain/locator.js";
+import { SAVE_HELP } from "../../meetings/index.js";
+import { renderMessages } from "../../render/messages.js";
+import { renderThreadLinks } from "../../render/thread-context.js";
+import { NO_MAIL } from "../../services/search-kind.js";
+import { environmentOf } from "../context.js";
+import { positiveCount } from "../paging.js";
+import { archiveSummary } from "./archive-summary.js";
+import { messengerContext } from "./context.js";
+import { backendOptions, backendRequest, noteServer } from "./search-backend-options.js";
+import { syncOptions, syncRequest } from "./search-sync-options.js";
+import { threadOptions, threadRequest } from "./thread-options.js";
+const PLACES = { transcript: "transcript", filename: "file name", file: "file text" };
+const TYPES = { text: "NOT has:attachment", voice: "has:voice", file: "has:file" };
+const typeOf = (value) => {
+    if (!Object.hasOwn(TYPES, value))
+        throw new CliError("validation_error", "--type takes text, voice or file");
+    return value;
+};
+/** `search messages`, or with `mail` the same leaf over the mailboxes only — never both, so they do not overlap. */
+export const messagesSearchCommand = (messenger, kind = "messages") => {
+    const mail = kind === "mail";
+    const base = new Command(kind);
+    const command = mail ? base : backendOptions(threadOptions(syncOptions(base)), messenger);
+    command
+        .description(mail
+        ? "search the mail imported into the local store — memo sync --mail brings it in"
+        : messenger.serverSearch
+            ? "search messenger messages in the local store and on the messenger's server (--backend); optionally fetches new messages with --sync-first; --discover searches the archive only"
+            : "search messenger messages in the local store — what was read, fetched or kept by serve; optionally fetches new messages with --sync-first; --discover searches the archive only")
+        .argument("[query...]", mail
+        ? 'strict Lucene query: words, "phrases", AND/OR/NOT, field groups and date ranges'
+        : 'strict Lucene query: words, "phrases", AND/OR/NOT, field groups and date ranges; --language legacy keeps discovery; with --saved, more words AND-ed to it')
+        .option("--chat <chat>", mail
+        ? "only this mail thread, by id or subject"
+        : `only this chat — the same as chat: in the query; ${messenger.chatArgument}`);
+    if (mail)
+        command.option("--source <accounts>", "only these mail accounts, separated by commas: email:<address> as a hit shows it, email, mail or " +
+            "group:<name>; every mail account when unset");
+    else
+        command
+            .option("--source <accounts>", "every account of this messenger held in the store; personal, bots or all — the same as in: in the query; " +
+            "or a list: group:work,telegram:Alice,email:me@example.com")
+            .option("--type <text|voice|file>", "only messages of this type: text alone, a voice message, or a file", typeOf);
+    command
+        .option("--limit <n>", "how many", positiveCount("--limit"))
+        .option("--offset <n>", "skip this many, for the next page", wholeCount)
+        .option("--newest", "newest first instead of best first")
+        .option("--exact", "bare words and quotes match their exact form only, as exact:word does; text: still matches every form")
+        .option("--context <n>", "messages before and after each hit; 2 in the terminal, 0 otherwise", wholeCount);
+    if (!mail) {
+        command.option("--discover", "find partial lexical matches and eligible replies in the local archive; results are evidence, not confirmed answers");
+        command.option("--language <lucene|legacy>", "the query language: strict Lucene or legacy discovery", languageOf);
+    }
+    command.option("--timezone <zone>", "the IANA timezone for calendar date boundaries");
+    command.addHelpText("after", SAVE_HELP);
+    if (mail)
+        return command
+            .addHelpText("after", `content: narrows a search to the text of attachments, filename: to their names —
+\`${messenger.app.command} search mail 'content:invoice'\`. --json: the list is items; each email's reference is locator.`)
+            .action(searchAction(messenger, kind));
+    return command
+        .addHelpText("after", `Search reads the local archive: a chat never fetched is not searched. Prepare it once with
+\`${messenger.app.command} messages sync --all --background\` (the last 90 days of every chat); the answer's
+coverage says what was searched and coverage.next what would improve it. Mail is \`${messenger.app.command} search mail\`;
+everything at once is \`${messenger.app.command} search all\`.
+A bare word looks in message text, voice transcripts, file names and file text. text:, transcript:,
+content: (the text of files) and filename: (their names) narrow it to one —
+\`${messenger.app.command} search messages 'content:invoice'\`. --json: the list is items; each hit's reference is locator.
+Search guide: https://github.com/WireCatLabs/cli-core/blob/main/docs/search/query-language.md`)
+        .option("--regex", "the words are one regular expression, case-insensitive, tested against every stored text")
+        .option("--saved <name|id>", "run a saved search or an earlier run; options typed here replace its own")
+        .action(searchAction(messenger, kind));
+};
+const searchAction = (messenger, kind) => async function (given) {
+    const context = messengerContext(this, messenger);
+    const type = this.opts().type;
+    const words = type === undefined ? given : given.length === 0 ? [TYPES[type]] : [`(${given.join(" ")}) AND ${TYPES[type]}`];
+    const { chat, source, regex, language, discover, timezone, newest, exact, context: around, limit: typedLimit, offset, saved, } = this.opts();
+    if (saved === undefined && words.length === 0)
+        throw new CliError("validation_error", "give a query, or --saved <name> to run a saved search");
+    if (saved !== undefined && regex)
+        throw new CliError("validation_error", "--regex is kept with the saved search; not with --saved");
+    const controller = new AbortController();
+    context.track({ close: async () => controller.abort() });
+    const external = environmentOf(this).signal;
+    const signal = external ? AbortSignal.any([external, controller.signal]) : controller.signal;
+    const typed = {
+        ...(chat === undefined ? {} : { chat }),
+        ...(source === undefined ? {} : { source }),
+        ...(discover === undefined ? {} : { discover }),
+        ...(language === undefined ? {} : { language }),
+        ...(timezone === undefined ? {} : { timezone }),
+        ...(newest ? { newest: true } : {}),
+        ...(exact ? { exact: true } : {}),
+        ...(around === undefined ? {} : { context: around }),
+        ...(typedLimit === undefined ? {} : { limit: typedLimit }),
+    };
+    let limit = context.settings.limit;
+    const found = await context
+        .withServices(async (services) => {
+        if (saved === undefined) {
+            const pattern = regex ? patternOf(words.join(" ")) : undefined;
+            return services.messages.search({
+                kind,
+                ...syncRequest(this, context),
+                ...backendRequest(this),
+                ...threadRequest(this),
+                ...typed,
+                ...(pattern ? { pattern } : { text: words.join(" ") }),
+                limit,
+                ...(offset === undefined ? {} : { offset }),
+                signal,
+                language: language ?? (pattern ? "legacy" : "lucene"),
+                newest: newest === true,
+                context: around ?? (context.format === "pretty" ? 2 : 0),
+            });
+        }
+        const { id, params, pattern } = await services.searches.resolve(saved, { ...typed, text: words.join(" ") });
+        limit = params.limit ?? limit;
+        return services.messages.search({
+            kind,
+            ...syncRequest(this, context),
+            ...backendRequest(this),
+            ...threadRequest(this),
+            ...(pattern ? { pattern } : params.text === undefined ? {} : { text: params.text }),
+            ...(params.ast === undefined ? {} : { ast: params.ast }),
+            ...(params.chat === undefined ? {} : { chat: params.chat }),
+            ...(params.source === undefined ? {} : { source: params.source }),
+            ...(params.timezone === undefined ? {} : { timezone: params.timezone }),
+            limit,
+            ...(offset === undefined ? {} : { offset }),
+            signal,
+            language: params.language ?? (pattern ? "legacy" : "lucene"),
+            newest: params.newest === true,
+            ...(params.discover === undefined ? {} : { discover: params.discover }),
+            ...(params.exact ? { exact: true } : {}),
+            context: params.context ?? (context.format === "pretty" ? 2 : 0),
+            saved: id,
+        });
+    })
+        .catch((error) => {
+        // Nothing to search is an empty answer, as `search all` treats it, not a failure.
+        if (!(error instanceof CliError && error.details.reason === NO_MAIL))
+            throw error;
+        context.renderer.note(error.message);
+        return { items: [], hasMore: false, corrections: [], completeness: [], wordsReady: true };
+    });
+    for (const hit of found.items) {
+        if (hit.thread?.fallback)
+            context.renderer.note(`thread context uses time neighbours: ${hit.thread.fallback}`);
+        if (hit.thread?.stale)
+            context.renderer.note("thread graph may be stale; stale links were not followed");
+        if (hit.thread?.stopped.length)
+            context.renderer.note(`thread context stopped: ${hit.thread.stopped.join(", ")}`);
+    }
+    noteServer(context, found.server);
+    const { command } = messenger.app;
+    for (const { from, to } of found.corrections)
+        context.renderer.note(`${from} → ${to.join(", ")}`);
+    for (const { source, reason } of found.skipped ?? [])
+        context.renderer.note(`${source} not searched: ${reason}`);
+    const stemming = found.query?.stemming;
+    const forms = (stemming?.applied ? stemming.terms : []).filter(({ stemmer }) => stemmer !== "none");
+    if (forms.length > 0)
+        context.renderer.note(`also found other forms: ${forms.map(({ word, stem, stemmer }) => `${word} → ${stem}* (${stemmer})`).join(", ")} — --exact for the exact words only`);
+    if (stemming?.applied === false)
+        context.renderer.note(stemming.reason === "building"
+            ? `other forms of words are not searched yet: the stems are ${Math.floor((stemming.done / Math.max(stemming.total, 1)) * 100)}% built — \`${command} store migrate\` finishes them`
+            : "other forms of words are not searched: the store asks for stemmers this tool does not know — upgrade this tool");
+    if (!found.wordsReady) {
+        context.renderer.note(found.query
+            ? `the word index is still being built, so a search by words fails until \`${command} store migrate\` finishes it`
+            : `the word index is still being built, so a search by words reads pieces of words until \`${command} store migrate\` finishes it`);
+    }
+    const incomplete = found.completeness.filter((chat) => chat.state !== "complete");
+    const chats = incomplete.filter((chat) => chat.provider !== "email").length;
+    const summary = found.coverage ? archiveSummary(found.coverage, found.items.length) : undefined;
+    if (summary)
+        context.renderer.note(summary);
+    else if (!found.coverage && chats > 0) {
+        context.renderer.note(`${chats} of the chats searched are not held in full — \`${command} messages sync <chat>\` syncs one`);
+    }
+    if (kind === "mail" || incomplete.some((chat) => chat.provider === "email")) {
+        context.renderer.note("mail search covers imported messages only; older or unimported mail may be missing — `memo sync --mail --since-time <time>` imports more");
+    }
+    if (context.format === "pretty") {
+        const options = {
+            color: context.color,
+            verbosity: context.settings.detail,
+            senderColors: context.settings.senderColors,
+            profile: context.profile,
+            provider: messenger.provider,
+            locale: messenger.app.locale,
+        };
+        const hits = found.items.map((hit) => ({ hit, at: parseLocator(hit.locator) }));
+        const spans = new Set(hits.map(({ at }) => `${at.provider}/${at.account}`)).size > 1;
+        context.streams.data(hits
+            .map(({ hit, at }) => {
+            const title = hit.chatTitle ?? hit.chatId;
+            const links = hit.thread ? renderThreadLinks(hit.thread) : "";
+            const place = hit.matchedIn && hit.matchedIn !== "text" && "excerpt" in hit
+                ? `\n  found in the ${PLACES[hit.matchedIn]}: ${String(hit.excerpt)}`
+                : "";
+            return `${spans ? `${at.provider} · ${title}` : title}  ${hit.locator}\n${renderMessages(hit.thread?.items ?? hit.context ?? [hit], options)}${place}${links ? `\n${links}` : ""}`;
+        })
+            .join("\n\n"));
+        const elsewhere = [...new Set(hits.map(({ at }) => at.provider))].filter((one) => one !== messenger.provider);
+        if (elsewhere.length > 0) {
+            context.renderer.note(`hits in ${elsewhere.join(", ")} open in that messenger's own CLI, by the locator: messages context msg:…`);
+        }
+        if (found.items.length === 0)
+            context.renderer.note(found.server && !found.server.skipped
+                ? "nothing found in the local store or on the messenger's server"
+                : "nothing found — only what is in the local store is searched");
+        return;
+    }
+    if (context.format === "jsonl")
+        context.renderer.stream(found.items);
+    else
+        context.renderer.result({ ...found, page: 1, limit });
+};
+const patternOf = (source) => {
+    try {
+        return new RegExp(source, "iu");
+    }
+    catch {
+        throw new CliError("validation_error", "not a regular expression — check JavaScript syntax or use Lucene regex");
+    }
+};
+export const wholeCount = (value) => {
+    if (!/^\d+$/.test(value.trim())) {
+        throw new CliError("validation_error", `--context takes a whole number from 0 upwards, not "${value}"`);
+    }
+    return Number(value);
+};
+export const languageOf = (value) => {
+    if (value !== "lucene" && value !== "legacy")
+        throw new CliError("validation_error", "--language takes lucene or legacy");
+    return value;
+};
+//# sourceMappingURL=messages-search-command.js.map

package/dist/cli/messenger/messages-search-command.js.map

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

package/dist/cli/messenger/messages-send-command.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/**
+ * **Asked before it goes, told after, on every outcome** — the guard's journal is the only record
+ * of what this profile tried to send, and it never holds the text.
+ */
+export declare const HTML_HELP = "the text is HTML: <b>, <i>, <a href>, <code>";
+export declare const sendCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=messages-send-command.d.ts.map

package/dist/cli/messenger/messages-send-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-send-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/messages-send-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAI/D;;;GAGG;AACH,eAAO,MAAM,SAAS,iDAAiD,CAAA;AAEvE,eAAO,MAAM,WAAW,cAAe,SAAS,KAAG,OAuClD,CAAA"}

package/dist/cli/messenger/messages-send-command.js

@@ -0,0 +1,100 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { sendTime } from "../../domain/send-time.js";
+import { typedSendAs } from "../../sends/send-as.js";
+import { readAttachments } from "../../sends/upload.js";
+import { messengerContext } from "./context.js";
+import { readAll } from "./stdin.js";
+import { threadIdOf } from "./thread.js";
+/**
+ * **Asked before it goes, told after, on every outcome** — the guard's journal is the only record
+ * of what this profile tried to send, and it never holds the text.
+ */
+export const HTML_HELP = "the text is HTML: <b>, <i>, <a href>, <code>";
+export const sendCommand = (messenger) => {
+    const send = annotate(new Command("send"), { mutates: true })
+        .description("send a text message; without [text], the text is read from stdin")
+        .argument("<chat>", messenger.chatArgument)
+        .argument("[text]", "the message")
+        .option("--topic <id>", "send to this forum topic; unsupported by messengers without topics")
+        .option("--reply-to <message>", "answer this message, by its id in the same chat")
+        .option("--comment-to <post>", "comment on this post of the channel; it goes to the post's discussion group")
+        .option("--send-as <id>", "post as one of the identities `chats send-as` lists; required where the chat posts as someone else by default")
+        .option("--send-id <id>", "repeat a send whose outcome was unknown, without risking a second copy")
+        .option("--silent", "deliver without a notification")
+        .option("--no-preview", "no preview card for a link in the text")
+        .option("--md", "read this messenger's Markdown; see its formatting guide for supported syntax")
+        .option("--file <file>", "attach a file; the text becomes its caption")
+        .option("--photo <file>", "attach a .jpg, .png or .webp as a photo; the text becomes its caption")
+        .option("--as-file", "send the --file as a file to download, a video included")
+        .option("--voice <file>", "send an Ogg Opus file as a voice message, alone, with no text")
+        .option("--allow-any-file", "send a file even from credential folders or this CLI's own folders")
+        .option("--at-time <time>", "let the messenger send it later, even with this machine off: 2026-09-25T09:00 (local time), or 30m, 2h, 1d from now")
+        .action(async function (chat, text) {
+        await sendText(this, messenger, chat, text);
+    });
+    // Offered only where the messenger lists them, so a CLI never shows a flag it would refuse.
+    if (messenger.mediaOptions?.includes("spoiler"))
+        send.option("--spoiler", "hide the --photo or video behind a spoiler until tapped");
+    if (messenger.mediaOptions?.includes("captionAbove"))
+        send.option("--caption-above", "show the text above the --photo or --file, not below it");
+    if (messenger.mediaOptions?.includes("fileName"))
+        send.option("--filename <name>", "the name others see for the --file, instead of its name on disk");
+    if (messenger.html)
+        send.option("--html", HTML_HELP);
+    if (messenger.stickers === true)
+        send.option("--sticker <id>", "send this sticker, alone; `stickers list` finds its id");
+    return send;
+};
+const sendText = async (command, messenger, chat, text) => {
+    const context = messengerContext(command, messenger);
+    const { topic, replyTo: typedReplyTo, commentTo: typedCommentTo, sendAs: givenSendAs, sendId, silent, preview, md: markdown, html, atTime: at, file, photo, voice, asFile, filename, allowAnyFile, spoiler, captionAbove, sticker, } = command.opts();
+    const threadId = threadIdOf(topic);
+    const scheduledFor = at === undefined ? undefined : sendTime(at);
+    const replyTo = typedReplyTo?.trim();
+    if (replyTo === "")
+        throw new CliError("validation_error", "--reply-to needs the id of the message to answer");
+    const sendAs = typedSendAs(givenSendAs);
+    const commentTo = typedCommentTo?.trim();
+    if (commentTo === "")
+        throw new CliError("validation_error", "--comment-to needs the post's message id");
+    const read = { app: messenger.app, env: context.env, anyFile: allowAnyFile === true };
+    const attachments = await readAttachments({
+        ...(photo === undefined ? {} : { photo }),
+        ...(file === undefined ? {} : { file }),
+        ...(voice === undefined ? {} : { voice }),
+        ...(text === undefined ? {} : { text }),
+        asFile: asFile === true,
+        ...(filename === undefined ? {} : { filename }),
+    }, read);
+    const body = text ?? (attachments.length > 0 || sticker !== undefined ? "" : await readAll(context.stdin));
+    if (body.trim() === "" && attachments.length === 0 && sticker === undefined) {
+        throw new CliError("validation_error", "nothing to send — give the text or pipe it in");
+    }
+    const sent = await context.withServices((services) => services.messages.send({
+        chat,
+        text: body,
+        ...(sendId === undefined ? {} : { sendId }),
+        ...(replyTo === undefined ? {} : { replyTo }),
+        ...(commentTo === undefined ? {} : { commentTo }),
+        ...(threadId === undefined ? {} : { threadId }),
+        ...(sendAs === undefined ? {} : { sendAs }),
+        ...(silent === true ? { silent } : {}),
+        ...(preview === false ? { noPreview: true } : {}),
+        ...(markdown === true ? { markdown } : {}),
+        ...(html === true ? { html } : {}),
+        ...(scheduledFor === undefined ? {} : { at: scheduledFor }),
+        ...(attachments.length > 0 ? { attachments } : {}),
+        ...(spoiler === true ? { spoiler } : {}),
+        ...(captionAbove === true ? { captionAbove } : {}),
+        ...(sticker === undefined ? {} : { sticker }),
+    }));
+    if (scheduledFor !== undefined) {
+        context.renderer.note(`scheduled for ${scheduledFor} — it gets a new id when it is sent`);
+        context.renderer.result({ sendId: sent.sendId, operationId: sent.operationId, message: sent.message, scheduledFor });
+    }
+    else
+        context.renderer.result({ sendId: sent.sendId, operationId: sent.operationId, message: sent.message });
+};
+//# sourceMappingURL=messages-send-command.js.map

package/dist/cli/messenger/messages-send-command.js.map

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

package/dist/cli/messenger/messages-stats-command.d.ts

@@ -0,0 +1,6 @@
+import { Command } from "commander";
+import type { StatsGrouping } from "../../services/messages-search.js";
+import { type Messenger } from "./context.js";
+export declare const messagesStatsCommand: (messenger: Messenger) => Command;
+export declare const groupingOf: (value: string) => StatsGrouping;
+//# sourceMappingURL=messages-stats-command.d.ts.map

package/dist/cli/messenger/messages-stats-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-stats-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/messages-stats-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAA;AAEtE,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAK/D,eAAO,MAAM,oBAAoB,cAAe,SAAS,KAAG,OA0GtD,CAAA;AAEN,eAAO,MAAM,UAAU,UAAW,MAAM,KAAG,aAI1C,CAAA"}

package/dist/cli/messenger/messages-stats-command.js

@@ -0,0 +1,80 @@
+import { CliError } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { positiveCount } from "../paging.js";
+import { messengerContext } from "./context.js";
+import { syncOptions, syncRequest } from "./search-sync-options.js";
+const GROUPINGS = ["chat", "sender", "day", "hour"];
+export const messagesStatsCommand = (messenger) => syncOptions(new Command("show"))
+    .description("how many stored messages match, by chat, sender, day or hour — the local store only; optionally fetches new messages with --sync-first")
+    .argument("[query...]", "a strict Lucene query, as for search messages; none counts every stored message; with --saved, more words AND-ed to it")
+    .option("--by <chat|sender|day|hour>", "what to count by (default: chat)", groupingOf)
+    .option("--chat <chat>", `only this chat — the same as chat: in the query; ${messenger.chatArgument}`)
+    .option("--source <accounts>", "every account of this messenger held in the store; personal, bots or all — the same as in: in the query")
+    .option("--limit <n>", "how many rows", positiveCount("--limit"))
+    .option("--timezone <zone>", "the IANA timezone for calendar days and hours")
+    .option("--exact", "bare words and quotes match their exact form only, as exact:word does; text: still matches every form")
+    .option("--saved <name|id>", "count what a saved search or an earlier run matches; options typed here replace its own")
+    .addHelpText("after", "Search guide: https://github.com/WireCatLabs/cli-core/blob/main/docs/search/query-language.md")
+    .action(async function (words) {
+    const context = messengerContext(this, messenger);
+    const { by, chat, source, timezone, exact, limit: typedLimit, saved, } = this.opts();
+    const syncing = syncRequest(this, context);
+    const typed = {
+        ...(by === undefined ? {} : { by }),
+        ...(chat === undefined ? {} : { chat }),
+        ...(source === undefined ? {} : { source }),
+        ...(timezone === undefined ? {} : { timezone }),
+        ...(exact ? { exact: true } : {}),
+        ...(typedLimit === undefined ? {} : { limit: typedLimit }),
+    };
+    let limit = context.settings.limit;
+    const stats = await context.withServices(async (services) => {
+        if (saved === undefined)
+            return services.messages.stats({
+                ...syncing,
+                ...typed,
+                ...(words.length ? { text: words.join(" ") } : {}),
+                by: by ?? "chat",
+                limit,
+                language: "lucene",
+            });
+        const { id, params } = await services.searches.resolve(saved, { ...typed, text: words.join(" ") });
+        if (params.regex || params.language === "legacy")
+            throw new CliError("validation_error", "stats messages show counts strict Lucene queries; this saved search is legacy");
+        limit = params.limit ?? limit;
+        return services.messages.stats({
+            ...syncing,
+            ...(params.text === undefined ? {} : { text: params.text }),
+            ...(params.ast === undefined ? {} : { ast: params.ast }),
+            ...(params.chat === undefined ? {} : { chat: params.chat }),
+            ...(params.source === undefined ? {} : { source: params.source }),
+            ...(params.timezone === undefined ? {} : { timezone: params.timezone }),
+            ...(params.exact ? { exact: true } : {}),
+            by: params.by ?? "chat",
+            limit,
+            language: "lucene",
+            saved: id,
+        });
+    });
+    const incomplete = stats.completeness.filter((one) => one.state !== "complete").length;
+    if (incomplete > 0)
+        context.renderer.note(`${incomplete} of the chats counted are not held in full, so these are lower bounds — \`${messenger.app.command} messages sync <chat>\` syncs one`);
+    if (context.format === "pretty") {
+        const width = String(Math.max(0, ...stats.items.map(({ count }) => count))).length;
+        context.streams.data(stats.items
+            .map(({ key, name, count }) => `${String(count).padStart(width)}  ${name ? `${name} (${key})` : key}`)
+            .join("\n"));
+        context.renderer.note(`${stats.total} messages${stats.hasMore ? `; more rows than --limit ${limit}` : ""}`);
+        return;
+    }
+    if (context.format === "jsonl")
+        context.renderer.stream(stats.items);
+    else
+        context.renderer.result({ ...stats, page: 1, limit });
+});
+export const groupingOf = (value) => {
+    if (!GROUPINGS.includes(value))
+        throw new CliError("validation_error", `--by takes ${GROUPINGS.join(", ")}`);
+    return value;
+};
+//# sourceMappingURL=messages-stats-command.js.map

package/dist/cli/messenger/messages-stats-command.js.map

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

package/dist/cli/messenger/metadata-command.d.ts

@@ -0,0 +1,4 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+export declare const metadataCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=metadata-command.d.ts.map

package/dist/cli/messenger/metadata-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/metadata-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,KAAK,SAAS,EAAsC,MAAM,cAAc,CAAA;AAEjF,eAAO,MAAM,eAAe,cAAe,SAAS,KAAG,OA2CtD,CAAA"}

package/dist/cli/messenger/metadata-command.js

@@ -0,0 +1,47 @@
+import { CliError } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import { positiveCount } from "../paging.js";
+import { messengerContext, refuseLocalWrite } from "./context.js";
+export const metadataCommand = (messenger) => {
+    const command = new Command("metadata").description("cached group/channel descriptions for local automatic tags");
+    command
+        .command("get")
+        .requiredOption("--chat <chat>", "a stored chat")
+        .action(async function () {
+        const context = messengerContext(this, messenger);
+        const { chat } = this.opts();
+        context.renderer.result(await context.withServices((services) => services.metadata.get(chat)));
+    });
+    annotate(command.command("refresh"), { mutates: true, local: true })
+        .option("--chat <chat>", "stored group/channel; repeat for several", (value, previous) => [...previous, value], [])
+        .option("--only-missing", "only chats with no metadata yet; without --chat, every stored group/channel")
+        .option("--limit <number>", "process at most 1–500 chats", positiveCount("--limit"), 50)
+        .action(async function () {
+        const context = messengerContext(this, messenger);
+        refuseLocalWrite(context, messenger.app.command, "metadata.refresh");
+        const options = this.opts();
+        const limit = Number(options.limit);
+        if (!Number.isSafeInteger(limit) || limit < 1 || limit > 500)
+            throw new CliError("validation_error", "--limit takes 1–500");
+        if (options.chat.length === 0 && !options.onlyMissing)
+            throw new CliError("validation_error", "name a chat with --chat, or give --only-missing");
+        const chats = options.onlyMissing
+            ? await context.withServices((services) => services.metadata.missing(options.chat))
+            : options.chat;
+        const items = [];
+        for (const chat of chats.slice(0, limit)) {
+            try {
+                items.push(await context.withServices((services) => services.metadata.refresh(chat)));
+            }
+            catch (error) {
+                if (!(error instanceof CliError))
+                    throw error;
+                items.push({ chatId: chat, error: { code: error.code, message: error.message } });
+            }
+        }
+        context.renderer.result({ items, hasMore: chats.length > limit });
+    });
+    return command;
+};
+//# sourceMappingURL=metadata-command.js.map

package/dist/cli/messenger/metadata-command.js.map

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

package/dist/cli/messenger/models-command.d.ts

@@ -0,0 +1,9 @@
+import { Command } from "commander";
+import type { Messenger } from "./context.js";
+/**
+ * Models that run on this machine, by what they work on; `audio` is the speech models behind
+ * `messages transcribe --local`, `text` the embedding models behind `conversations embed`. Nothing here talks to the messenger. The folder is shared by every
+ * messenger CLI, so a model downloaded once serves them all.
+ */
+export declare const modelsCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=models-command.d.ts.map

package/dist/cli/messenger/models-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/models-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAmB3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,aAAa,cAAe,SAAS,KAAG,OA4JpD,CAAA"}