@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/cli/messenger/admin-statistics-command.js

@@ -0,0 +1,59 @@
+import { Command } from "commander";
+import { environmentOf } from "../context.js";
+import { positiveCount } from "../paging.js";
+import { messengerContext } from "./context.js";
+const collect = (value, previous = []) => [...previous, value];
+export const adminStatisticsCommand = (messenger, report) => {
+    const descriptions = {
+        unanswered: "oldest detected questions without an observed qualifying explicit reply",
+        responses: "counts and median/p90 latency for selected human answering identities",
+        newcomers: "known-join members and their help within a join window",
+        discussion: "viewed posts with little recorded discussion",
+    };
+    const command = new Command(report).description(descriptions[report]);
+    if (report === "newcomers")
+        command
+            .argument("<chat>", messenger.chatArgument)
+            .option("--since-time <time>", "from this ISO 8601 time, or 2h / 1d ago; 30d ago if not given")
+            .option("--until-time <time>", "through this ISO 8601 time, or 2h / 1d ago")
+            .option("--within <duration>", "the help window after a known newcomer join");
+    else
+        command
+            .argument("[query...]", "a strict Lucene query; none selects every stored message")
+            .option("--chat <chat>", `only this chat; ${messenger.chatArgument}`)
+            .option("--source <accounts>", "every held account of this messenger; personal, bots or all")
+            .option("--exact", "bare words match exact forms rather than stems");
+    command.option("--saved <name|id>", "run a saved report of this kind; typed report options replace stored options");
+    command
+        .option("--timezone <zone>", "the IANA timezone for calendar date boundaries")
+        .option("--limit <n>", "report rows, 1–100; 20 if not given", positiveCount("--limit"));
+    if (report !== "discussion")
+        command.option("--answerer <person>", "stored name, alias, @username, ID or person:provider/account/id; ambiguous names require a choice; repeat for more", collect);
+    if (report === "unanswered")
+        command.option("--older-than <duration>", "minimum age of a question without an observed qualifying answer");
+    if (report === "discussion")
+        command
+            .option("--min-views <n>", "minimum known cumulative views", Number)
+            .option("--max-replies <n>", "maximum observed discussion replies", Number);
+    command.action(async function (argument) {
+        const context = messengerContext(this, messenger);
+        const { answerer, ...options } = this.opts();
+        const found = await context.withServices((services) => services.adminStatistics.report(report, {
+            ...options,
+            limit: options.limit ?? 20,
+            ...(answerer ? { answerers: answerer } : {}),
+            ...(report === "newcomers"
+                ? { chat: argument }
+                : argument.length
+                    ? { text: argument.join(" ") }
+                    : {}),
+            signal: environmentOf(this).commandSignal ?? environmentOf(this).signal,
+        }));
+        if (context.format === "jsonl")
+            context.renderer.stream(found.items.map((item) => ({ ...item, report: found.report, cutoff: found.cutoff, quality: found.quality })));
+        else
+            context.renderer.result(found);
+    });
+    return command;
+};
+//# sourceMappingURL=admin-statistics-command.js.map

package/dist/cli/messenger/admin-statistics-command.js.map

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

package/dist/cli/messenger/after.d.ts

@@ -0,0 +1,20 @@
+import type { After } from "./port.js";
+export interface ListStart {
+    beforeId?: string;
+    beforeTime?: string;
+    afterId?: string;
+    afterTime?: string;
+}
+/** How each starting point is spelled where it was typed: `--before-id` on the command line, `before_id` in MCP. */
+export type Spell = (key: keyof ListStart) => string;
+export declare const flagOf: Spell;
+/**
+ * A list reads one way from one place: at most one starting point. Ids are opaque to us, so
+ * `afterId` is never read as a time, however it looks.
+ */
+export declare const listStart: (start: ListStart, spell?: Spell) => {
+    after?: After;
+    before?: string;
+    beforeTime?: number;
+};
+//# sourceMappingURL=after.d.ts.map

package/dist/cli/messenger/after.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"after.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/after.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEtC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,oHAAoH;AACpH,MAAM,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,MAAM,SAAS,KAAK,MAAM,CAAA;AAEpD,eAAO,MAAM,MAAM,EAAE,KAAqF,CAAA;AAI1G;;;GAGG;AACH,eAAO,MAAM,SAAS,UACb,SAAS,UACT,KAAK,KACX;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAgBvD,CAAA"}

package/dist/cli/messenger/after.js

@@ -0,0 +1,27 @@
+import { CliError } from "@wirecat/cli-base";
+import { momentOf } from "../../services/moment.js";
+export const flagOf = (key) => `--${key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}`;
+const isId = (value) => value !== "" && !/[\s\p{Cc}]/u.test(value);
+/**
+ * A list reads one way from one place: at most one starting point. Ids are opaque to us, so
+ * `afterId` is never read as a time, however it looks.
+ */
+export const listStart = (start, spell = flagOf) => {
+    const given = Object.keys(start).filter((key) => start[key] !== undefined);
+    if (given.length > 1) {
+        throw new CliError("validation_error", `${given.map(spell).join(" and ")} are two starting points; give one of them`);
+    }
+    const { beforeId, beforeTime, afterId, afterTime } = start;
+    if (beforeTime !== undefined)
+        return { beforeTime: momentOf(beforeTime, spell("beforeTime")) };
+    if (afterTime !== undefined)
+        return { after: { time: momentOf(afterTime, spell("afterTime")) } };
+    const id = (beforeId ?? afterId)?.trim();
+    if (id === undefined)
+        return {};
+    const key = beforeId === undefined ? "afterId" : "beforeId";
+    if (!isId(id))
+        throw new CliError("validation_error", `${spell(key)} takes a message id — not "${start[key]}"`);
+    return key === "beforeId" ? { before: id } : { after: { id } };
+};
+//# sourceMappingURL=after.js.map

package/dist/cli/messenger/after.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"after.js","sourceRoot":"","sources":["../../../src/cli/messenger/after.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AAanD,MAAM,CAAC,MAAM,MAAM,GAAU,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,CAAA;AAE1G,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,KAAgB,EAChB,KAAK,GAAU,MAAM,EACoC,EAAE;IAC3D,MAAM,KAAK,GAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAyB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAA;IACnG,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,4CAA4C,CAC9E,CAAA;IACH,CAAC;IACD,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAA;IAC1D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,CAAA;IAC9F,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,EAAE,EAAE,CAAA;IAChG,MAAM,EAAE,GAAG,CAAC,QAAQ,IAAI,OAAO,CAAC,EAAE,IAAI,EAAE,CAAA;IACxC,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IAC/B,MAAM,GAAG,GAAG,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAA;IAC3D,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,8BAA8B,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC/G,OAAO,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,CAAA;AAChE,CAAC,CAAA"}

package/dist/cli/messenger/archive-commands.d.ts

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/** `store`: the local store of messages — what it holds, filling it, reading it out, and looking after the file. */
+export declare const storeCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=archive-commands.d.ts.map

package/dist/cli/messenger/archive-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-commands.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/archive-commands.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAUnC,OAAO,EAAE,KAAK,SAAS,EAAoB,MAAM,cAAc,CAAA;AAM/D,oHAAoH;AACpH,eAAO,MAAM,YAAY,cAAe,SAAS,KAAG,OAUnD,CAAA"}

package/dist/cli/messenger/archive-commands.js

@@ -0,0 +1,203 @@
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { Readable } from "node:stream";
+import { CliError } from "@wirecat/cli-base";
+import { Command } from "commander";
+import { toMarkdown } from "../../render/markdown.js";
+import { renderMessages } from "../../render/messages.js";
+import { seal } from "../../sealed.js";
+import { CHAT_KINDS } from "../../services/chats.js";
+import { kindsOf } from "../../services/inbox.js";
+import { momentOf } from "../../services/moment.js";
+import { listed, renderList } from "../paging.js";
+import { jobsCommand } from "./backfill-command.js";
+import { messengerContext } from "./context.js";
+import { admitPassword, linesOf, openFolder, runFileFor, saveManifest, sealRun, writeChanges } from "./export-folder.js";
+import { gapsCommand } from "./gaps-command.js";
+import { ENCRYPT_OPTION, passwordOf } from "./password.js";
+import { storeMaintenanceCommands } from "./store-maintenance-command.js";
+/** `store`: the local store of messages — what it holds, filling it, reading it out, and looking after the file. */
+export const storeCommand = (messenger) => {
+    const store = new Command("store")
+        .description("the local store of messages")
+        .addCommand(statusCommand(messenger))
+        .addCommand(gapsCommand(messenger))
+        .addCommand(jobsCommand(messenger))
+        .addCommand(exportCommand(messenger))
+        .addCommand(clearCommand(messenger));
+    for (const command of storeMaintenanceCommands(messenger))
+        store.addCommand(command);
+    return store;
+};
+/**
+ * What the local store holds, per chat — read from the store alone. Whether a fetch reached a
+ * chat's very first message is not recorded, so it is not claimed: the stretches held are shown.
+ */
+const statusCommand = (messenger) => new Command("status")
+    .description("per chat: messages stored, the oldest and newest, and the stretches held completely")
+    .argument("[chat]", messenger.chatArgument)
+    .action(async function (chat) {
+    const context = messengerContext(this, messenger);
+    const rows = await context.withServices((services) => services.archive.status(chat));
+    renderList(context.renderer, context.format, rows);
+    if (rows.length === 0)
+        context.renderer.note("the store holds no messages for this profile yet");
+});
+/**
+ * Deletes from the store, which is the archive: only what `--left` names, and only with
+ * `--allow-dangerous`, since a chat the account left cannot be fetched again. Emptying the whole
+ * store is not offered.
+ */
+const clearCommand = (messenger) => new Command("clear")
+    .description("delete from the store the chats this account has left, with their messages")
+    .option("--left", "the chats this account has left — the only thing this clears")
+    .option("--allow-dangerous", "yes, delete — it cannot be undone, and a chat you left cannot be fetched again")
+    .action(async function () {
+    const { left, allowDangerous } = this.opts();
+    if (!left) {
+        throw new CliError("validation_error", "say what to clear: --left, the chats this account has left — emptying the whole store is not offered");
+    }
+    const context = messengerContext(this, messenger);
+    const found = await context.withServices((services) => services.archive.left());
+    if (found.chats > 0 && !allowDangerous) {
+        throw new CliError("confirmation_required", `this deletes ${found.chats} chat(s) this account has left and their ${found.messages} message(s) ` +
+            "from the store, and it cannot be undone — add --allow-dangerous to go ahead");
+    }
+    const cleared = found.chats > 0 ? await context.withServices((services) => services.archive.left({ clear: true })) : found;
+    context.renderer.result({ cleared: cleared.chats > 0, ...cleared });
+    if (cleared.chats === 0)
+        context.renderer.note("the store holds no chats this account has left");
+    else
+        context.renderer.success(`deleted ${cleared.chats} chat(s) and ${cleared.messages} message(s)`);
+});
+/**
+ * One chat's stored messages, oldest first — `--jsonl` for a file or a pipe, one message per line,
+ * `--format markdown` for a transcript a person reads. With `--to`, any number of chats into a
+ * folder, and each later run into the same folder adds only what changed.
+ */
+const exportCommand = (messenger) => new Command("export")
+    .description("a chat's stored messages, oldest first: --jsonl one message per line, --json one { items, page, limit, hasMore } object; never asks the messenger")
+    .argument("[chats...]", `${messenger.chatArgument}; several with --to`)
+    .option("--format <format>", "jsonl: one message per line, the default with --output; markdown: a transcript with a heading per day, replies and forwards quoted")
+    .option("--since-time <time>", "only from this ISO 8601 time, or 30m / 2h / 1d ago, on")
+    .option("--output <file>", "write JSON lines, or the transcript, to this new file, readable only by you")
+    .option("--to <dir>", "write into this folder, a file per chat and a manifest; run again on it for only what changed since")
+    .option("--kind <kinds>", `with --to: every stored chat of these kinds, comma-separated: ${CHAT_KINDS.join(", ")}`)
+    .option("--all", "with --to: every stored chat of this account")
+    .option(...ENCRYPT_OPTION)
+    .action(async function (chats) {
+    const { format, sinceTime: since, output, to, kind, all, encrypt, } = this.opts();
+    if (format !== undefined && format !== "markdown" && format !== "jsonl") {
+        throw new CliError("validation_error", `--format is jsonl or markdown, not "${format}"`);
+    }
+    const context = messengerContext(this, messenger);
+    if (to !== undefined) {
+        if (format === "markdown" || since !== undefined || output !== undefined) {
+            throw new CliError("validation_error", "--to writes JSON lines and keeps its own point — not with --format markdown, --since-time or --output");
+        }
+        if (chats.length === 0 && kind === undefined && all !== true) {
+            throw new CliError("validation_error", "--to needs chats, --kind or --all");
+        }
+        const kinds = kind === undefined ? undefined : kindsOf(kind);
+        const dir = resolve(to);
+        const password = encrypt ? await passwordOf(this, { twice: true }) : undefined;
+        context.renderer.result(await context.withServices(async (services) => {
+            const { account, chats: chosen } = await services.archive.exportable({
+                chats,
+                ...(kinds === undefined ? {} : { kinds }),
+            });
+            const manifest = openFolder(dir, account, password !== undefined);
+            if (password !== undefined)
+                await admitPassword(manifest, password);
+            const run = runFileFor(new Date().toISOString());
+            const written = [];
+            const exportChat = async function* ({ id, title: named }) {
+                const title = password === undefined ? named : null;
+                const before = manifest.chats[id];
+                const changes = await services.archive.changes(id, before?.mark);
+                const empty = changes.messages.length === 0 && changes.deleted.length === 0;
+                let file = null;
+                if (password !== undefined) {
+                    yield* linesOf(id, changes);
+                    if (!empty)
+                        file = run;
+                }
+                else if (before === undefined || !empty)
+                    file = writeChanges(dir, id, changes.mark, changes);
+                manifest.chats[id] = {
+                    title,
+                    mark: changes.mark,
+                    files: [...(before?.files ?? []), ...(file === null ? [] : [file])],
+                    messages: (before?.messages ?? 0) + changes.messages.length,
+                    deleted: (before?.deleted ?? 0) + changes.deleted.length,
+                };
+                written.push({ id, title, file, messages: changes.messages.length, deleted: changes.deleted.length });
+            };
+            const everyChat = async function* () {
+                for (const chat of chosen)
+                    yield* exportChat(chat);
+            };
+            if (password !== undefined)
+                await sealRun(dir, run, everyChat(), password);
+            // Unsealed, each chat is written as it is read; nothing is yielded, the walk is the work.
+            else
+                for await (const _ of everyChat())
+                    void _;
+            saveManifest(dir, manifest);
+            return { path: dir, ...(password === undefined ? {} : { encrypted: true }), chats: written };
+        }));
+        return;
+    }
+    if (chats.length !== 1 || kind !== undefined || all === true) {
+        throw new CliError("validation_error", "one chat at a time without --to; --kind and --all need --to");
+    }
+    if (encrypt && output === undefined) {
+        throw new CliError("validation_error", "--encrypt writes a file — with --output or --to");
+    }
+    const password = encrypt ? await passwordOf(this, { twice: true }) : undefined;
+    const chat = chats[0];
+    const from = since === undefined ? undefined : new Date(momentOf(since, "--since-time")).toISOString();
+    const { title, messages } = await context.withServices((services) => services.archive.export(chat, from === undefined ? {} : { since: from }));
+    if (output !== undefined) {
+        const path = resolve(output);
+        const body = format === "markdown"
+            ? toMarkdown(title, messages)
+            : messages.map((message) => `${JSON.stringify(message)}\n`).join("");
+        try {
+            if (password !== undefined)
+                await seal(() => Readable.from([body]), path, password);
+            else
+                writeFileSync(path, body, { flag: "wx", mode: 0o600 });
+        }
+        catch (error) {
+            if (error.code === "EEXIST")
+                throw new CliError("validation_error", `${path} exists — an export never overwrites a file`);
+            throw error;
+        }
+        context.renderer.result({
+            path,
+            format: format ?? "jsonl",
+            count: messages.length,
+            ...(password === undefined ? {} : { encrypted: true }),
+        });
+        return;
+    }
+    if (format === "markdown")
+        context.streams.data(toMarkdown(title, messages).replace(/\n$/, ""));
+    else if (format === "jsonl" || context.format === "jsonl")
+        for (const message of messages)
+            context.streams.data(JSON.stringify(message));
+    else if (context.format === "json")
+        context.renderer.result(listed(messages));
+    else
+        context.streams.data(renderMessages(messages, {
+            color: context.color,
+            verbosity: context.settings.detail,
+            senderColors: context.settings.senderColors,
+            profile: context.profile,
+            provider: messenger.provider,
+            locale: messenger.app.locale,
+        }));
+    context.renderer.note(`${messages.length} messages`);
+});
+//# sourceMappingURL=archive-commands.js.map

package/dist/cli/messenger/archive-commands.js.map

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

package/dist/cli/messenger/archive-summary.d.ts

@@ -0,0 +1,7 @@
+import type { SearchCoverage } from "../../services/messages-search.js";
+/**
+ * One line on what the archive held for a search, when it could hold more or nothing was found:
+ * "searched 12,430 messages in 37 chats — 5 never fetched, 2 behind; `tg messages sync --all --background` fetches them".
+ */
+export declare const archiveSummary: (coverage: SearchCoverage, hits: number) => string | undefined;
+//# sourceMappingURL=archive-summary.d.ts.map

package/dist/cli/messenger/archive-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-summary.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/archive-summary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAIvE;;;GAGG;AACH,eAAO,MAAM,cAAc,aAAc,cAAc,QAAQ,MAAM,KAAG,MAAM,GAAG,SAWhF,CAAA"}

package/dist/cli/messenger/archive-summary.js

@@ -0,0 +1,19 @@
+const count = new Intl.NumberFormat("en");
+/**
+ * One line on what the archive held for a search, when it could hold more or nothing was found:
+ * "searched 12,430 messages in 37 chats — 5 never fetched, 2 behind; `tg messages sync --all --background` fetches them".
+ */
+export const archiveSummary = (coverage, hits) => {
+    const { neverFetched, behind, withGaps } = coverage.chats;
+    if (!neverFetched && !behind && !withGaps && hits > 0)
+        return undefined;
+    const problems = [
+        neverFetched ? `${neverFetched} never fetched` : "",
+        behind ? `${behind} behind` : "",
+        withGaps ? `${withGaps} with gaps` : "",
+    ].filter(Boolean);
+    const searched = `searched ${count.format(coverage.messages)} messages in ${count.format(coverage.coveredChats)} chats`;
+    const advice = coverage.next ? `; \`${coverage.next}\` fetches ${problems.length ? "them" : "more"}` : "";
+    return `${searched}${problems.length ? ` — ${problems.join(", ")}` : ""}${advice}`;
+};
+//# sourceMappingURL=archive-summary.js.map

package/dist/cli/messenger/archive-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-summary.js","sourceRoot":"","sources":["../../../src/cli/messenger/archive-summary.ts"],"names":[],"mappings":"AAEA,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAwB,EAAE,IAAY,EAAsB,EAAE;IAC3F,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAA;IACzD,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,SAAS,CAAA;IACvE,MAAM,QAAQ,GAAG;QACf,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,gBAAgB,CAAC,CAAC,CAAC,EAAE;QACnD,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE;QAChC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,YAAY,CAAC,CAAC,CAAC,EAAE;KACxC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IACjB,MAAM,QAAQ,GAAG,YAAY,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,gBAAgB,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAA;IACvH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,QAAQ,CAAC,IAAI,cAAc,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACzG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAA;AACpF,CAAC,CAAA"}

package/dist/cli/messenger/ask.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+import type { Asker } from "../../sends/guard.js";
+import { skipFlagFor } from "../../sends/permissions.js";
+export { skipFlagFor };
+/** The owner's answer, or `null` with nobody at a terminal — and always under `--json` or `--jsonl`. */
+export declare const answerOf: (command: Command, question: string) => Promise<string | null>;
+/**
+ * For a command a person typed: the flag says yes, or the terminal asks, or nobody can — and it is
+ * refused. Never asks under `--json` or `--jsonl`: a program reads those, and a harness that gives
+ * an agent a terminal would otherwise wait for ever.
+ */
+export declare const terminalAsker: (command: Command) => Asker;
+//# sourceMappingURL=ask.d.ts.map

package/dist/cli/messenger/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/ask.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAGxD,OAAO,EAAE,WAAW,EAAE,CAAA;AAuCtB,wGAAwG;AACxG,eAAO,MAAM,QAAQ,YAAmB,OAAO,YAAY,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAIxF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,YACd,OAAO,KAAG,KAsBnB,CAAA"}

package/dist/cli/messenger/ask.js

@@ -0,0 +1,73 @@
+import { openSync } from "node:fs";
+import { createInterface } from "node:readline";
+import { ReadStream } from "node:tty";
+import { CliError } from "@wirecat/cli-base";
+import { skipFlagFor } from "../../sends/permissions.js";
+import { environmentOf } from "../context.js";
+export { skipFlagFor };
+/**
+ * One line from the terminal itself, not stdin — stdin may be the text being sent. `null` when no
+ * person is there. Ctrl-C and a closed terminal cancel, as `readSecret` does.
+ */
+const fromTerminal = async (question) => {
+    if (!process.stdin.isTTY || !process.stderr.isTTY)
+        return null;
+    let input;
+    try {
+        input = new ReadStream(openSync("/dev/tty", "r"));
+    }
+    catch {
+        return null;
+    }
+    const reader = createInterface({ input, output: process.stderr, terminal: true });
+    try {
+        return await new Promise((resolve, reject) => {
+            const cancel = () => reject(new CliError("cancelled", "cancelled — nothing was done"));
+            reader.once("SIGINT", cancel);
+            reader.once("close", cancel);
+            reader.question(question, resolve);
+        });
+    }
+    finally {
+        reader.close();
+        input.destroy();
+    }
+};
+const what = (key, { chatId, count, personIds, forEveryone }) => [
+    key,
+    forEveryone ? "for everyone" : undefined,
+    count !== undefined ? `${count} ${count === 1 ? "item" : "items"}` : undefined,
+    personIds?.length ? `${personIds.length} ${personIds.length === 1 ? "person" : "people"}` : undefined,
+    chatId !== null ? `in chat ${chatId}` : undefined,
+]
+    .filter(Boolean)
+    .join(", ");
+/** The owner's answer, or `null` with nobody at a terminal — and always under `--json` or `--jsonl`. */
+export const answerOf = async (command, question) => {
+    const given = command.optsWithGlobals();
+    if (given.json === true || given.jsonl === true)
+        return null;
+    return (environmentOf(command).answer ?? fromTerminal)(question);
+};
+/**
+ * For a command a person typed: the flag says yes, or the terminal asks, or nobody can — and it is
+ * refused. Never asks under `--json` or `--jsonl`: a program reads those, and a harness that gives
+ * an agent a terminal would otherwise wait for ever.
+ */
+export const terminalAsker = (command) => async (key, request) => {
+    const flag = skipFlagFor(key);
+    const given = command.optsWithGlobals();
+    if (flag === "--yes" ? given.yes === true : given.allowDangerous === true)
+        return;
+    const machine = given.json === true || given.jsonl === true;
+    const answer = machine
+        ? null
+        : await (environmentOf(command).answer ?? fromTerminal)(`${what(key, request)} — go ahead? [y/N] `);
+    if (answer === null) {
+        throw new CliError("confirmation_required", `${key} asks before it acts (its permission level is ask), and nobody is at a terminal to answer — ` +
+            `add ${flag} to go ahead`);
+    }
+    if (!/^\s*y(es)?\s*$/i.test(answer))
+        throw new CliError("cancelled", `${key}: not done — the answer was no`);
+};
+//# sourceMappingURL=ask.js.map

package/dist/cli/messenger/ask.js.map

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

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

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+import { type Messenger } from "./context.js";
+/** Files of stored messages: what is in them, for `content:` in a search. Nothing here is sent. */
+export declare const attachmentsCommand: (messenger: Messenger) => Command;
+//# sourceMappingURL=attachments-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"attachments-command.d.ts","sourceRoot":"","sources":["../../../src/cli/messenger/attachments-command.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAOnC,OAAO,EAAE,KAAK,SAAS,EAAsC,MAAM,cAAc,CAAA;AA4NjF,mGAAmG;AACnG,eAAO,MAAM,kBAAkB,cAAe,SAAS,KAAG,OAMnB,CAAA"}