@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/background/wirecat-folder.js

@@ -0,0 +1,339 @@
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { closeSync, constants, copyFileSync, cpSync, existsSync, fsyncSync, linkSync, mkdirSync, openSync, readdirSync, readlinkSync, readSync, renameSync, rmSync, statSync, unlinkSync, } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { CliError, resolvePaths } from "@wirecat/cli-base";
+import { wirecatDirectory } from "../store/path.js";
+import { readLock, releaseLock, takeLock } from "./lock.js";
+import { alive } from "./processes.js";
+// lsof misses a serve between writes: its lock is written and closed again.
+export const liveServes = (dir) => {
+    const serve = join(dir, "serve");
+    if (!existsSync(serve))
+        return [];
+    return readdirSync(serve)
+        .filter((name) => name.endsWith(".lock"))
+        .flatMap((name) => {
+        const pid = readLock(join(serve, name))?.pid;
+        return pid !== undefined && alive(pid) ? [`pid ${pid} (serve, ${dir})`] : [];
+    });
+};
+/** Errors that leave the owner's store in a state no command should run on: they stop the command. */
+class Stop extends CliError {
+    constructor(message) {
+        super("configuration_error", message);
+    }
+}
+const conflict = (pairs) => new Stop(`two different copies of the store: ${pairs.map(([from, to]) => `${from} and ${to}`).join("; ")} — ` +
+    "nothing was moved or changed; keep one of each pair and run again");
+const STORE = "wirecat.db";
+const PARTIAL = ".partial-";
+const SIDECARS = [`${STORE}-wal`, `${STORE}-shm`];
+const isStoreFile = (name) => !name.includes(PARTIAL) &&
+    (name === STORE ||
+        SIDECARS.includes(name) ||
+        name.startsWith(`${STORE}.backup-`) ||
+        name.startsWith(`${STORE}.before-restore-`));
+// The db goes last: while it is still in the old folder the move is unfinished, and the next start resumes it.
+const dbLast = (names) => [...names].sort((a, b) => Number(a === STORE) - Number(b === STORE));
+const storeFiles = (directory) => existsSync(directory) ? dbLast(readdirSync(directory).filter(isStoreFile)) : [];
+const digest = (path) => {
+    const hash = createHash("sha256");
+    const fd = openSync(path, "r");
+    const buffer = Buffer.allocUnsafe(1 << 20);
+    try {
+        for (let read = readSync(fd, buffer); read > 0; read = readSync(fd, buffer))
+            hash.update(buffer.subarray(0, read));
+    }
+    finally {
+        closeSync(fd);
+    }
+    return hash.digest("hex");
+};
+const sameFile = (a, b) => {
+    const [x, y] = [statSync(a, { bigint: true }), statSync(b, { bigint: true })];
+    if (x.dev === y.dev && x.ino === y.ino)
+        return true;
+    return x.size === y.size && digest(a) === digest(b);
+};
+const filesUnder = (root) => readdirSync(root, { recursive: true, withFileTypes: true })
+    .filter((entry) => entry.isFile())
+    .map((entry) => relative(root, join(entry.parentPath, entry.name)))
+    .sort();
+const sameTree = (a, b) => {
+    const [left, right] = [filesUnder(a), filesUnder(b)];
+    return left.join("\n") === right.join("\n") && left.every((file) => sameFile(join(a, file), join(b, file)));
+};
+const flush = (path, mode = "r+") => {
+    const fd = openSync(path, mode);
+    try {
+        fsyncSync(fd);
+    }
+    finally {
+        closeSync(fd);
+    }
+};
+// Windows cannot open a folder to flush it; NTFS orders the rename on its own.
+const flushFolder = (path) => {
+    try {
+        flush(path, "r");
+    }
+    catch { }
+};
+const errno = (error) => error.code;
+const copyAcross = (from, to) => {
+    const partial = `${to}${PARTIAL}${process.pid}`;
+    copyFileSync(from, partial, constants.COPYFILE_EXCL);
+    try {
+        flush(partial);
+        if (!sameFile(from, partial))
+            throw new Error(`the copy of ${from} at ${partial} came out different`);
+        linkSync(partial, to);
+    }
+    catch (error) {
+        if (errno(error) === "EEXIST")
+            throw conflict([[from, to]]);
+        throw error;
+    }
+    finally {
+        rmSync(partial, { force: true });
+    }
+    flushFolder(dirname(to));
+    unlinkSync(from);
+};
+/**
+ * `link` then `unlink`, because `rename` replaces a file already at `to` and `link` refuses to. A crash
+ * between the two leaves one file under both names, which the next start recognises and finishes.
+ */
+export const moveFile = (from, to) => {
+    try {
+        linkSync(from, to);
+    }
+    catch (error) {
+        const code = errno(error);
+        if (code === "EEXIST")
+            throw conflict([[from, to]]);
+        if (code === "EXDEV")
+            return copyAcross(from, to);
+        if (!["EPERM", "ENOTSUP", "EOPNOTSUPP", "ENOSYS"].includes(code ?? ""))
+            throw error;
+        if (existsSync(to))
+            throw conflict([[from, to]]);
+        renameSync(from, to);
+        return;
+    }
+    unlinkSync(from);
+};
+const moveTree = (from, to) => {
+    if (existsSync(to))
+        return;
+    try {
+        renameSync(from, to);
+        return;
+    }
+    catch (error) {
+        if (errno(error) !== "EXDEV")
+            throw error;
+    }
+    const partial = `${to}${PARTIAL}${process.pid}`;
+    try {
+        cpSync(from, partial, { recursive: true, force: false, errorOnExist: true });
+        for (const file of filesUnder(partial))
+            flush(join(partial, file));
+        if (!sameTree(from, partial))
+            throw new Error(`the copy of ${from} at ${partial} came out different`);
+        if (existsSync(to))
+            return;
+        renameSync(partial, to);
+    }
+    finally {
+        rmSync(partial, { recursive: true, force: true });
+    }
+    flushFolder(dirname(to));
+    rmSync(from, { recursive: true, force: true });
+};
+/** A db without its wal loses writes, so a failure part-way puts back what already moved. */
+const moveAll = (names, from, to, move) => {
+    const done = [];
+    try {
+        for (const name of names) {
+            move(join(from, name), join(to, name));
+            done.push(name);
+        }
+    }
+    catch (error) {
+        if (error instanceof Stop)
+            throw error;
+        const stuck = [];
+        for (const name of done.reverse()) {
+            try {
+                move(join(to, name), join(from, name));
+            }
+            catch {
+                stuck.push(join(to, name));
+            }
+        }
+        if (stuck.length > 0)
+            throw new Stop(`${error.message}; and could not put back ${stuck.join(", ")} — they are in ${to}, the rest is in ${from}`);
+        throw error;
+    }
+};
+const pidsOf = (listed) => listed
+    .split("\n")
+    .filter((pid) => pid && pid !== String(process.pid))
+    .map((pid) => `pid ${pid}`);
+/** Processes with a store file open: another tool's serve, mcp or job is not in any lock this one checks. */
+const storeHolders = (oldState, platform) => {
+    if (platform === "darwin") {
+        try {
+            const out = execFileSync("/usr/sbin/lsof", ["-t", "+D", oldState], {
+                encoding: "utf8",
+                stdio: ["ignore", "pipe", "ignore"],
+            });
+            return pidsOf(out);
+        }
+        catch (error) {
+            // lsof exits 1 when nothing is open; any other failure means it could not look, so nothing moves.
+            const failure = error;
+            return failure.status === 1 ? pidsOf(failure.stdout ?? "") : ["lsof could not check"];
+        }
+    }
+    if (platform !== "linux")
+        return [];
+    const holders = [];
+    let pids = [];
+    try {
+        pids = readdirSync("/proc").filter((name) => /^\d+$/.test(name) && Number(name) !== process.pid);
+    }
+    catch {
+        return ["/proc could not be read"];
+    }
+    for (const pid of pids) {
+        try {
+            for (const fd of readdirSync(`/proc/${pid}/fd`)) {
+                let target;
+                try {
+                    target = readlinkSync(`/proc/${pid}/fd/${fd}`);
+                }
+                catch {
+                    continue;
+                }
+                if (target.startsWith(join(oldState, STORE))) {
+                    holders.push(`pid ${pid} (${target})`);
+                    break;
+                }
+            }
+        }
+        catch { }
+    }
+    return holders;
+};
+const LOCK_WAIT_MS = 60_000;
+const waitForLock = (path, waitMs) => {
+    const until = Date.now() + waitMs;
+    for (;;) {
+        const held = takeLock(path, { pid: process.pid, startedAt: new Date().toISOString() });
+        if (!held)
+            return;
+        if (Date.now() >= until)
+            throw new Stop(`pid ${held.pid} is moving the store into ${dirname(path)} — run again once it finishes`);
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 200);
+    }
+};
+let keptStore;
+/** The old store this run keeps using: a unit written now must not pin it, or the move never happens. */
+export const keptOldStore = () => keptStore;
+const keepOld = (env, path) => {
+    env.MESSAGING_STORE = path;
+    keptStore = path;
+};
+/**
+ * Brings the store and the models, which lived in `cli-messaging`'s and `cli-common`'s folders, into the
+ * WireCat folder. Never over a file already there, never when an override says where they are, and never
+ * while something has the old store open: that run keeps using the old file. Two different stores stop
+ * the command rather than pick one.
+ */
+export const migrateToWirecatFolder = (app, options = {}) => {
+    const { env = process.env, platform = process.platform, move = moveFile, lockWaitMs = LOCK_WAIT_MS } = options;
+    const holdersOf = options.holders ?? ((dir) => storeHolders(dir, platform));
+    const warn = options.warn ?? ((line) => process.stderr.write(`${line}\n`));
+    if (env.MESSAGING_STORE || env.WIRECAT_STATE_DIR)
+        return;
+    const target = wirecatDirectory(env);
+    const oldState = resolvePaths({ appName: "cli-messaging", prefix: "MESSAGING", env }).state;
+    const oldDb = join(oldState, STORE);
+    // A store under MESSAGING_STATE_DIR stays where the override put it; a test sandbox's must never reach home.
+    const storeOverridden = env.MESSAGING_STATE_DIR !== undefined;
+    if (storeOverridden && existsSync(oldDb))
+        keepOld(env, oldDb);
+    const oldModels = env.CLI_COMMON_CACHE_DIR
+        ? undefined
+        : join(resolvePaths({ appName: "cli-common", prefix: "CLI_COMMON", env }).cache, "models");
+    const modelsToMove = oldModels !== undefined && existsSync(oldModels) && !existsSync(join(target, "models"));
+    if ((storeOverridden || storeFiles(oldState).length === 0) && !modelsToMove)
+        return;
+    mkdirSync(target, { recursive: true, mode: 0o700 });
+    const lock = join(target, ".moving.lock");
+    waitForLock(lock, lockWaitMs);
+    try {
+        for (const name of readdirSync(target).filter((entry) => /^(wirecat\.db.*|models)\.partial-\d+$/.test(entry)))
+            rmSync(join(target, name), { recursive: true, force: true });
+        try {
+            if (!storeOverridden)
+                moveStore(app, oldState, target, env, holdersOf, move, warn);
+        }
+        catch (error) {
+            if (error instanceof Stop)
+                throw error;
+            if (existsSync(oldDb) && !existsSync(join(target, STORE)))
+                keepOld(env, oldDb);
+            warn(`${app.command}: could not move the store to ${target} — ${error.message}`);
+        }
+        try {
+            if (oldModels && existsSync(oldModels))
+                moveTree(oldModels, join(target, "models"));
+        }
+        catch (error) {
+            warn(`${app.command}: could not move the models to ${target} — ${error.message}`);
+        }
+    }
+    finally {
+        releaseLock(lock);
+    }
+};
+const moveStore = (app, oldState, target, env, holdersOf, move, warn) => {
+    const all = storeFiles(oldState);
+    const names = all.includes(STORE) ? all : all.filter((name) => !SIDECARS.includes(name));
+    const pending = [];
+    const finished = [];
+    const conflicts = [];
+    for (const name of names) {
+        const [from, to] = [join(oldState, name), join(target, name)];
+        if (!existsSync(to))
+            pending.push(name);
+        else if (sameFile(from, to))
+            finished.push(name);
+        else
+            conflicts.push([from, to]);
+    }
+    if (conflicts.length > 0)
+        throw conflict(conflicts);
+    // A wal or shm is only valid beside its own db: without the db moving, they stay where they are.
+    const moving = pending.includes(STORE) ? pending : pending.filter((name) => !SIDECARS.includes(name));
+    if (moving.length === 0 && finished.length === 0)
+        return;
+    const serving = [
+        ...[oldState, resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).state].flatMap(liveServes),
+        ...holdersOf(oldState),
+    ];
+    if (serving.length > 0) {
+        if (existsSync(join(oldState, STORE)))
+            keepOld(env, join(oldState, STORE));
+        warn(`${app.command}: something has the store open (${serving.join(", ")}) — the store moves to ${target} on a run after it stops`);
+        return;
+    }
+    moveAll(moving, oldState, target, move);
+    for (const name of dbLast(finished))
+        unlinkSync(join(oldState, name));
+};
+//# sourceMappingURL=wirecat-folder.js.map

package/dist/background/wirecat-folder.js.map

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

package/dist/botcheck/check.d.ts

@@ -0,0 +1,64 @@
+import type { Id, Message } from "../domain/models.js";
+import { type BotReason } from "./reasons.js";
+import type { RegistryAnswer } from "./registries.js";
+/** Younger than this is `new_account` or `photo_recent`. */
+export declare const NEW_DAYS = 30;
+/** What the messenger says about the person, as much as it said. A field left out is not known. */
+export interface BotSubject {
+    id: Id;
+    name: string | null;
+    usernames: readonly string[];
+    bio?: string | null;
+    flags?: Partial<Record<"bot" | "scam" | "fake" | "deleted", boolean>>;
+    hasPhoto?: boolean;
+    registered?: {
+        at: string;
+        source: string;
+    } | null;
+}
+/** Their stored messages, newest first; `complete` when every stored one was read. */
+export interface StoredActivity {
+    messages: Pick<Message, "chatId" | "text" | "timestamp" | "forwardedFrom">[];
+    complete: boolean;
+    /** Chats shared with them that the store holds anything of. */
+    chatsStored: number;
+}
+export interface PhotoFacts {
+    count: number;
+    /** The oldest photo they still show; an upper bound on the account's age, since photos get deleted. */
+    oldestAt: string | null;
+}
+export interface CheckedReason {
+    reason: BotReason;
+    weight: number;
+    /** Where it was read: `messenger`, `store`, `telegram` / `max` / `estimate` for a registration, `registry:<name>`. */
+    source: string;
+    detail?: string;
+}
+export interface BotCheck {
+    person: {
+        id: Id;
+        name: string | null;
+        username: string | null;
+        provider: string;
+    };
+    score: number;
+    reasons: CheckedReason[];
+    registries: RegistryAnswer[];
+    /** Signals nothing could be read for — the messenger did not say, the store holds none, offline. */
+    unknown: BotReason[];
+    checkedAt: string;
+}
+/**
+ * Every signal about one person, each with where it came from. A hint, never a verdict: the score is
+ * a sum of light weights, and the reasons are what a person should read.
+ */
+export declare const scorePerson: ({ subject, provider, activity, photos, registries, now, }: {
+    subject: BotSubject;
+    provider: string;
+    activity?: StoredActivity;
+    photos?: PhotoFacts;
+    registries: RegistryAnswer[];
+    now?: Date;
+}) => BotCheck;
+//# sourceMappingURL=check.d.ts.map

package/dist/botcheck/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/botcheck/check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAE,KAAK,SAAS,EAA0B,MAAM,cAAc,CAAA;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAGrD,4DAA4D;AAC5D,eAAO,MAAM,QAAQ,KAAK,CAAA;AAI1B,mGAAmG;AACnG,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,EAAE,CAAA;IACN,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;IACrE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,UAAU,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACnD;AAED,sFAAsF;AACtF,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,CAAC,EAAE,CAAA;IAC5E,QAAQ,EAAE,OAAO,CAAA;IACjB,+DAA+D;IAC/D,WAAW,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,uGAAuG;IACvG,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,SAAS,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,sHAAsH;IACtH,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAClF,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,oGAAoG;IACpG,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;CAClB;AAeD;;;GAGG;AACH,eAAO,MAAM,WAAW,8DAOrB;IACD,OAAO,EAAE,UAAU,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,GAAG,CAAC,EAAE,IAAI,CAAA;CACX,KAAG,QAkDH,CAAA"}

package/dist/botcheck/check.js

@@ -0,0 +1,84 @@
+import { LINK, oddName, WEIGHTS } from "./reasons.js";
+const DAY_MS = 86_400_000;
+/** Younger than this is `new_account` or `photo_recent`. */
+export const NEW_DAYS = 30;
+/** Shorter texts repeat honestly — "thanks", "ok", a sticker's caption. */
+const SAME_TEXT_MIN = 20;
+const normalized = (text) => text.toLowerCase().replace(/\s+/g, " ").trim();
+/** The same text of theirs, long enough to mean something, in more than one chat. */
+const repeated = (messages) => {
+    const chatsOf = new Map();
+    for (const { text, chatId } of messages) {
+        const key = normalized(text);
+        if (key.length < SAME_TEXT_MIN)
+            continue;
+        chatsOf.set(key, (chatsOf.get(key) ?? new Set()).add(chatId));
+    }
+    return Math.max(0, ...[...chatsOf.values()].map((chats) => chats.size));
+};
+/**
+ * Every signal about one person, each with where it came from. A hint, never a verdict: the score is
+ * a sum of light weights, and the reasons are what a person should read.
+ */
+export const scorePerson = ({ subject, provider, activity, photos, registries, now = new Date(), }) => {
+    const reasons = [];
+    const unknown = [];
+    const add = (reason, source, detail) => reasons.push({ reason, weight: WEIGHTS[reason], source, ...(detail ? { detail } : {}) });
+    const young = (at) => now.getTime() - Date.parse(at) < NEW_DAYS * DAY_MS;
+    const { flags } = subject;
+    for (const flag of ["bot", "scam", "fake", "deleted"]) {
+        if (flags?.[flag] === undefined)
+            unknown.push(flag);
+        else if (flags[flag])
+            add(flag, "messenger");
+    }
+    const withPhoto = subject.hasPhoto ?? (photos ? photos.count > 0 : undefined);
+    if (withPhoto === undefined)
+        unknown.push("no_photo");
+    else if (!withPhoto)
+        add("no_photo", "messenger");
+    if (subject.usernames.length === 0)
+        add("no_username", "messenger");
+    if (oddName(subject.name))
+        add("odd_name", "messenger");
+    if (subject.bio === undefined)
+        unknown.push("no_bio");
+    else if (!subject.bio?.trim())
+        add("no_bio", "messenger");
+    if (subject.registered === undefined || subject.registered === null)
+        unknown.push("new_account");
+    else if (young(subject.registered.at))
+        add("new_account", subject.registered.source, subject.registered.at);
+    if (photos === undefined)
+        unknown.push("photo_recent");
+    else if (photos.oldestAt && young(photos.oldestAt))
+        add("photo_recent", "messenger", photos.oldestAt);
+    if (activity === undefined || activity.chatsStored === 0)
+        unknown.push("never_wrote", "link_first", "same_text");
+    else {
+        const { messages, complete } = activity;
+        if (messages.length === 0)
+            add("never_wrote", "store");
+        const first = complete ? messages.at(-1) : undefined;
+        if (!complete)
+            unknown.push("link_first");
+        else if (first && (first.forwardedFrom !== null || LINK.test(first.text)))
+            add("link_first", "store");
+        const chats = repeated(messages);
+        if (chats > 1)
+            add("same_text", "store", `one text in ${chats} chats`);
+    }
+    for (const answer of registries) {
+        for (const reason of answer.reasons ?? [])
+            add(reason, `registry:${answer.name}`, answer.detail);
+    }
+    return {
+        person: { id: subject.id, name: subject.name, username: subject.usernames[0] ?? null, provider },
+        score: reasons.reduce((total, { weight }) => total + weight, 0),
+        reasons: reasons.sort((a, b) => b.weight - a.weight),
+        registries,
+        unknown,
+        checkedAt: now.toISOString(),
+    };
+};
+//# sourceMappingURL=check.js.map

package/dist/botcheck/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/botcheck/check.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAGrE,MAAM,MAAM,GAAG,UAAU,CAAA;AACzB,4DAA4D;AAC5D,MAAM,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAA;AAC1B,2EAA2E;AAC3E,MAAM,aAAa,GAAG,EAAE,CAAA;AA6CxB,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;AAEnF,qFAAqF;AACrF,MAAM,QAAQ,GAAG,CAAC,QAAoC,EAAU,EAAE;IAChE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC1C,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,CAAA;QAC5B,IAAI,GAAG,CAAC,MAAM,GAAG,aAAa;YAAE,SAAQ;QACxC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAA;AACzE,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAC1B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,MAAM,EACN,UAAU,EACV,GAAG,GAAG,IAAI,IAAI,EAAE,GAQjB,EAAY,EAAE;IACb,MAAM,OAAO,GAAoB,EAAE,CAAA;IACnC,MAAM,OAAO,GAAgB,EAAE,CAAA;IAC/B,MAAM,GAAG,GAAG,CAAC,MAAiB,EAAE,MAAc,EAAE,MAAe,EAAE,EAAE,CACjE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;IAC1F,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,QAAQ,GAAG,MAAM,CAAA;IAEhF,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAA;IACzB,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAU,EAAE,CAAC;QAC/D,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;aAC9C,IAAI,KAAK,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;IAC7E,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;SAChD,IAAI,CAAC,SAAS;QAAE,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IACjD,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,GAAG,CAAC,aAAa,EAAE,WAAW,CAAC,CAAA;IACnE,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;IACvD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;SAChD,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;IAEzD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;SAC3F,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAAE,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;IAE3G,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;SACjD,IAAI,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAAE,GAAG,CAAC,cAAc,EAAE,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAErG,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,WAAW,CAAC,CAAA;SAC3G,CAAC;QACJ,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAA;QACvC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,GAAG,CAAC,aAAa,EAAE,OAAO,CAAC,CAAA;QACtD,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;QACpD,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;aACpC,IAAI,KAAK,IAAI,CAAC,KAAK,CAAC,aAAa,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAAE,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAA;QACrG,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChC,IAAI,KAAK,GAAG,CAAC;YAAE,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,eAAe,KAAK,QAAQ,CAAC,CAAA;IACxE,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,UAAU,EAAE,CAAC;QAChC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE;YAAE,GAAG,CAAC,MAAM,EAAE,YAAY,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAClG,CAAC;IAED,OAAO;QACL,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,QAAQ,EAAE;QAChG,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,GAAG,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACpD,UAAU;QACV,OAAO;QACP,SAAS,EAAE,GAAG,CAAC,WAAW,EAAE;KAC7B,CAAA;AACH,CAAC,CAAA"}

package/dist/botcheck/reasons.d.ts

@@ -0,0 +1,15 @@
+/** What `chats members audit` judges from a member list and the store. */
+export type AuditReason = "bot" | "scam" | "fake" | "deleted" | "no_photo" | "no_username" | "odd_name" | "never_wrote" | "link_first" | "burst_join" | "mass_invited";
+/** What only a look at one person adds: their profile, all their stored messages, the registries. */
+export type PersonReason = "new_account" | "no_bio" | "same_text" | "photo_recent" | RegistryReason;
+export type RegistryReason = "cas_banned" | "lols_banned" | "lols_scammer";
+export type BotReason = AuditReason | PersonReason;
+/**
+ * Light on purpose: real people without a photo, a username or a bio are common. A messenger's own
+ * mark or a ban list's entry weighs more, because somebody already looked.
+ */
+export declare const WEIGHTS: Record<BotReason, number>;
+export declare const LINK: RegExp;
+/** No name, a long run of digits, or a link in it. */
+export declare const oddName: (name: string | null) => boolean;
+//# sourceMappingURL=reasons.d.ts.map

package/dist/botcheck/reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../../src/botcheck/reasons.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GACnB,KAAK,GACL,MAAM,GACN,MAAM,GACN,SAAS,GACT,UAAU,GACV,aAAa,GACb,UAAU,GACV,aAAa,GACb,YAAY,GACZ,YAAY,GACZ,cAAc,CAAA;AAElB,qGAAqG;AACrG,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,cAAc,GAAG,cAAc,CAAA;AAEnG,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,CAAA;AAE1E,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,YAAY,CAAA;AAElD;;;GAGG;AACH,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAmB7C,CAAA;AAED,eAAO,MAAM,IAAI,QAA+B,CAAA;AAGhD,sDAAsD;AACtD,eAAO,MAAM,OAAO,SAAU,MAAM,GAAG,IAAI,YAA0D,CAAA"}

package/dist/botcheck/reasons.js

@@ -0,0 +1,29 @@
+/**
+ * Light on purpose: real people without a photo, a username or a bio are common. A messenger's own
+ * mark or a ban list's entry weighs more, because somebody already looked.
+ */
+export const WEIGHTS = {
+    bot: 3,
+    scam: 3,
+    fake: 3,
+    deleted: 1,
+    no_photo: 1,
+    no_username: 1,
+    odd_name: 1,
+    never_wrote: 1,
+    link_first: 2,
+    burst_join: 1,
+    mass_invited: 1,
+    new_account: 2,
+    no_bio: 1,
+    same_text: 2,
+    photo_recent: 1,
+    cas_banned: 3,
+    lols_banned: 3,
+    lols_scammer: 3,
+};
+export const LINK = /https?:\/\/|t\.me\/|www\./i;
+const DIGITS = /\d{5,}/;
+/** No name, a long run of digits, or a link in it. */
+export const oddName = (name) => !name?.trim() || DIGITS.test(name) || LINK.test(name);
+//# sourceMappingURL=reasons.js.map

package/dist/botcheck/reasons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.js","sourceRoot":"","sources":["../../src/botcheck/reasons.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAA8B;IAChD,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,QAAQ,EAAE,CAAC;IACX,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,CAAC;IACf,WAAW,EAAE,CAAC;IACd,MAAM,EAAE,CAAC;IACT,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;CAChB,CAAA;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,4BAA4B,CAAA;AAChD,MAAM,MAAM,GAAG,QAAQ,CAAA;AAEvB,sDAAsD;AACtD,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAmB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA"}

package/dist/botcheck/registries.d.ts

@@ -0,0 +1,40 @@
+import type { Id } from "../domain/models.js";
+import type { RegistryReason } from "./reasons.js";
+export type RegistryName = "cas" | "lols";
+export interface RegistryAnswer {
+    name: RegistryName;
+    /** `unknown` when the registry did not answer, refused, or answered something this build cannot read. */
+    answer: "listed" | "clean" | "unknown";
+    checkedAt: string;
+    /** Why `unknown`, or what the listing says — never the address asked or a key. */
+    detail?: string;
+    /** The reasons a listing adds to the score. */
+    reasons?: RegistryReason[];
+}
+export interface RegistryOptions {
+    fetch?: typeof fetch;
+    /** Combot's key, where the owner keeps one; CAS answers without one for now. */
+    casKey?: string;
+    now?: () => Date;
+    timeoutMs?: number;
+}
+/** Where each one is documented, for the help text and the MCP description. */
+export declare const REGISTRIES: Record<RegistryName, {
+    title: string;
+    docs: string;
+}>;
+/**
+ * Asks each registry about one Telegram id, side by side. A registry down or refusing is `unknown`,
+ * never an error: the rest of the check still answers. Nothing here may put the request's address
+ * in a message — a key could sit in it — so failures are described, not quoted.
+ */
+export declare const askRegistries: (id: Id, options?: RegistryOptions) => Promise<RegistryAnswer[]>;
+/** `ok: true` with a result is a listing; `ok: false` "Record not found." is clean (seen 2026-10-06). */
+export declare const askCas: (id: Id, options?: RegistryOptions) => Promise<RegistryAnswer>;
+/** `banned` and `scammer` per lols.bot's own OpenAPI description. */
+export declare const askLols: (id: Id, options?: RegistryOptions) => Promise<RegistryAnswer>;
+/** The registries list Telegram accounts only. */
+export declare const registriesCover: (provider: string) => boolean;
+/** For a messenger the registries do not cover: every one `unknown`, saying why. */
+export declare const notCovered: (provider: string, now?: Date) => RegistryAnswer[];
+//# sourceMappingURL=registries.d.ts.map

package/dist/botcheck/registries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registries.d.ts","sourceRoot":"","sources":["../../src/botcheck/registries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,CAAA;AAEzC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAA;IAClB,yGAAyG;IACzG,MAAM,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;IACtC,SAAS,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,OAAO,CAAC,EAAE,cAAc,EAAE,CAAA;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,+EAA+E;AAC/E,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAG5E,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,aAAa,OAAc,EAAE,YAAW,eAAe,KAAQ,OAAO,CAAC,cAAc,EAAE,CAC1C,CAAA;AA4B1D,yGAAyG;AACzG,eAAO,MAAM,MAAM,OAAc,EAAE,YAAW,eAAe,KAAQ,OAAO,CAAC,cAAc,CA6B1F,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,OAAO,OAAc,EAAE,YAAW,eAAe,KAAQ,OAAO,CAAC,cAAc,CAsB3F,CAAA;AAED,kDAAkD;AAClD,eAAO,MAAM,eAAe,aAAc,MAAM,KAAG,OAAkC,CAAA;AAErF,oFAAoF;AACpF,eAAO,MAAM,UAAU,aAAc,MAAM,iBAAqB,cAAc,EAMzE,CAAA"}