@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/replies/rules.js

@@ -0,0 +1,201 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@wirecat/cli-base";
+import * as v from "valibot";
+export const REPLY_ACTIONS = ["reply", "task"];
+export const REPLY_MODELS = ["fill-only", "may-reword"];
+/** Channels, saved messages and chats of unknown kind are never answered, so a rule cannot name them. */
+export const REPLY_KINDS = ["dialog", "group"];
+export const PLACEHOLDERS = ["firstName", "name"];
+export const DAYS = ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+const WINDOW = /^([01]\d|2[0-3]):([0-5]\d)-([01]\d|2[0-3]):([0-5]\d)$/;
+const LIMIT = /^([1-9]\d*)\/([1-9]\d*)(m|h|d)$/;
+const UNIT_MS = { m: 60_000, h: 3_600_000, d: 86_400_000 };
+const minutes = (hours, mins) => Number(hours) * 60 + Number(mins);
+const window = v.pipe(v.string(), v.regex(WINDOW, 'a window is written "09:00-19:00", 24-hour'), v.transform((typed) => {
+    const [, h1, m1, h2, m2] = WINDOW.exec(typed);
+    return { from: minutes(h1, m1), to: minutes(h2, m2) };
+}), v.check((one) => one.from !== one.to, "a window has to start and end at different times"));
+const dayOf = (typed) => DAYS.indexOf(typed);
+/** `mon-fri`, `sat,sun`, `fri-mon` across the week's end. */
+const days = v.pipe(v.string(), v.transform((typed) => {
+    const found = new Set();
+    for (const part of typed.split(",").map((one) => one.trim().toLowerCase())) {
+        const [first = "", last = first] = part.split("-");
+        const from = dayOf(first);
+        const to = dayOf(last);
+        if (from < 0 || to < 0)
+            return undefined;
+        for (let at = from;; at = (at + 1) % 7) {
+            found.add(DAYS[at]);
+            if (at === to)
+                break;
+        }
+    }
+    return DAYS.filter((day) => found.has(day));
+}), v.check((one) => one !== undefined, `days are written "mon-fri" or "sat,sun", from ${DAYS.join(", ")}`), v.transform((one) => one));
+const knownZone = (zone) => {
+    try {
+        new Intl.DateTimeFormat("en-US", { timeZone: zone });
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+const timezone = v.pipe(v.string(), v.check(knownZone, 'a time zone is written as "Europe/Madrid"'));
+const limit = v.pipe(v.string(), v.regex(LIMIT, 'a limit is written "1/12h": this many replies in this long — m, h or d'), v.transform((typed) => {
+    const [, count, amount, unit] = LIMIT.exec(typed);
+    return { count: Number(count), ms: Number(amount) * (UNIT_MS[unit ?? ""] ?? 0) };
+}));
+const ids = v.array(v.pipe(v.string(), v.minLength(1)));
+const template = v.pipe(v.string(), v.check((text) => [...text.matchAll(/(?<!\{)\{(\w*)\}(?!\})/g)].every(([, name]) => PLACEHOLDERS.includes(name)), `a template fills only ${PLACEHOLDERS.map((name) => `{${name}}`).join(", ")}`));
+const rule = v.pipe(v.strictObject({
+    id: v.pipe(v.string(), v.regex(/^[a-z0-9][a-z0-9-]*$/, "a rule id is lower-case letters, digits and -")),
+    on: v.boolean(),
+    do: v.pipe(v.array(v.picklist(REPLY_ACTIONS)), v.minLength(1, "a rule has to do something: reply")),
+    where: v.strictObject({ kinds: v.array(v.picklist(REPLY_KINDS)), chats: ids, notChats: ids }),
+    when: v.strictObject({
+        hours: v.nullable(v.strictObject({ outside: window, days, timezone })),
+        words: v.array(v.pipe(v.string(), v.trim(), v.minLength(1))),
+        question: v.boolean(),
+        mentionsMe: v.boolean(),
+        from: v.strictObject({ people: ids, notPeople: ids, contactsOnly: v.boolean() }),
+    }),
+    reply: v.strictObject({ template, model: v.optional(v.picklist(REPLY_MODELS), "fill-only"), asReply: v.boolean() }),
+    limits: v.strictObject({ perChat: limit, perPerson: limit }),
+}), v.forward(v.check((one) => !one.on || !one.do.includes("reply") || one.reply.template.trim().length > 0, "an enabled reply rule needs a nonempty template — edit its template before turning it on"), ["reply", "template"]));
+const legacyTester = v.strictObject({
+    provider: v.optional(v.pipe(v.string(), v.minLength(1))),
+    id: v.pipe(v.string(), v.minLength(1)),
+});
+const side = v.optional(v.strictObject({ people: v.optional(ids, []), chats: v.optional(ids, []) }), {
+    people: [],
+    chats: [],
+});
+/**
+ * Who may get an answer at all, whatever a rule says: everyone, or only those listed in `allow`; and
+ * never anyone in `deny`, which wins when an id is in both. Tasks are not limited by it. A file that
+ * does not say answers everyone a rule matches; `replies.send` is what keeps a new file silent.
+ */
+const audienceShape = v.optional(v.strictObject({ reply: v.optional(v.picklist(["all", "listed"]), "all"), allow: side, deny: side }), { reply: "all", allow: { people: [], chats: [] }, deny: { people: [], chats: [] } });
+const file = v.pipe(v.strictObject({ audience: audienceShape, rules: v.array(rule) }), v.check(({ rules }) => new Set(rules.map((one) => one.id)).size === rules.length, "two rules share an id; each needs its own"));
+/**
+ * Every key written out, so the file shows all there is to set, as moderation's does (max-cli
+ * `NEED-314`). Off until the owner turns it on, and the limits are the tightest worth having.
+ */
+export const defaultRule = (id) => ({
+    id,
+    on: false,
+    do: ["reply"],
+    where: { kinds: ["dialog"], chats: [], notChats: [] },
+    when: {
+        hours: null,
+        words: [],
+        question: false,
+        mentionsMe: false,
+        from: { people: [], notPeople: [], contactsOnly: false },
+    },
+    reply: { template: "", asReply: true },
+    limits: { perChat: "1/1d", perPerson: "1/1d" },
+});
+export const repliesPathFor = (app, profile, env = process.env) => join(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).config, `${profile}.replies.json`);
+export const EVERYONE = { reply: "all", allow: { people: [], chats: [] }, deny: { people: [], chats: [] } };
+/** Why nobody may be answered here, or `null` when the audience lets the reply go. */
+export const outsideAudience = (audience, person, chat) => {
+    if (person !== null && audience.deny.people.includes(person))
+        return "a person on the deny list";
+    if (audience.deny.chats.includes(chat))
+        return "a chat on the deny list";
+    if (audience.reply === "all")
+        return null;
+    const listed = (person !== null && audience.allow.people.includes(person)) || audience.allow.chats.includes(chat);
+    return listed ? null : "not on the allow list";
+};
+/** What in the audience does not do what it seems to say — said, never refused. */
+export const audienceWarnings = ({ reply, allow, deny }) => [
+    ...allow.people
+        .filter((id) => deny.people.includes(id))
+        .map((id) => `person ${id} is on both lists: deny wins, nobody answers them`),
+    ...allow.chats
+        .filter((id) => deny.chats.includes(id))
+        .map((id) => `chat ${id} is on both lists: deny wins, nothing is answered there`),
+    ...(reply === "all" && allow.people.length + allow.chats.length > 0
+        ? ['the allow list does nothing while audience.reply is "all" — set it to "listed" to answer only those']
+        : []),
+    ...(reply === "listed" && allow.people.length + allow.chats.length === 0
+        ? ['audience.reply is "listed" and the allow list is empty: nobody is answered']
+        : []),
+];
+/** The owner's rules, in file order. No file is no rules; a file that does not check out refuses, naming the field. */
+export const readReplyRules = (path) => readReplies(path, "").rules;
+/** `provider`: the messenger reading the file, which an older file's `testers` may have named. */
+export const readReplies = (path, provider) => {
+    return parseReplies(readRepliesFile(path, provider), path, provider);
+};
+// Hours and limits are transformed by parsing; editing must keep their file input forms.
+export const readRepliesFile = (path, provider) => {
+    if (!existsSync(path))
+        return { audience: structuredClone(EVERYONE), rules: [] };
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw broken(path, error instanceof Error ? error.message : String(error));
+    }
+    const upgraded = withoutTesters(parsed, provider, path);
+    const checked = parseReplies(upgraded, path, provider);
+    return { ...upgraded, audience: checked.audience };
+};
+/**
+ * A file from before the audience took over still has `testers`: then a reply went only to a sender
+ * who was a tester (with no `provider`, or this one) and also inside the audience. The audience that
+ * answers exactly them is `listed` with the testers as its people — under `listed` already, only the
+ * testers its people list also names. Its allowed chats are dropped: "a tester in this chat" has no
+ * audience form, and keeping a chat would answer everyone in it. Deny lists stay. No testers, nobody.
+ * Read here on every load; the next edit writes the result back.
+ */
+const withoutTesters = (parsed, provider, path) => {
+    if (typeof parsed !== "object" || parsed === null || !("testers" in parsed))
+        return parsed;
+    const { testers, ...rest } = parsed;
+    const named = v.safeParse(v.array(legacyTester), testers);
+    if (!named.success)
+        throw broken(path, `testers: ${named.issues.map((issue) => issue.message).join("; ")}`);
+    const ids = [
+        ...new Set(named.output.filter((one) => one.provider === undefined || one.provider === provider).map((one) => one.id)),
+    ];
+    const audience = (rest.audience ?? {});
+    if (typeof audience !== "object" ||
+        audience === null ||
+        ![undefined, "all", "listed"].includes(audience.reply))
+        return rest;
+    const listed = Array.isArray(audience.allow?.people) ? audience.allow.people : [];
+    const people = audience.reply === "listed" ? ids.filter((id) => listed.includes(id)) : ids;
+    return { ...rest, audience: { ...audience, reply: "listed", allow: { people, chats: [] } } };
+};
+export const writeRepliesFile = (path, contents) => {
+    const checked = v.safeParse(file, contents);
+    if (!checked.success) {
+        throw new CliError("validation_error", `reply edit cannot be saved (${checked.issues.map(problem).join("; ")})`);
+    }
+    writeSecurely(path, `${JSON.stringify(contents, null, 2)}\n`, 0o600);
+};
+export const parseReplyRules = (parsed, path) => parseReplies(parsed, path, "").rules;
+export const parseReplies = (parsed, path, provider) => {
+    const checked = v.safeParse(file, withoutTesters(parsed, provider, path));
+    if (!checked.success)
+        throw broken(path, checked.issues.map(problem).join("; "));
+    return checked.output;
+};
+const problem = (issue) => {
+    const at = v.getDotPath(issue) ?? "the file";
+    if (issue.kind === "schema" && issue.expected === "never")
+        return `${at} is not a field a rule has`;
+    if (issue.expected === "Object" && issue.received === "undefined")
+        return `${at} is missing`;
+    return `${at}: ${issue.message}`;
+};
+const broken = (path, why) => new CliError("configuration_error", `the reply rules ${path} cannot be read (${why}) — fix the file`);
+//# sourceMappingURL=rules.js.map

package/dist/replies/rules.js.map

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

package/dist/replies/serve.d.ts

@@ -0,0 +1,55 @@
+import type { Id, Message } from "../domain/models.js";
+import type { ReplyChat, ReplyRender } from "./rendering.js";
+export declare const NOT_ALLOWED = "replies.send is not allow";
+export declare const NO_RULES = "no rules";
+export declare const ONLY_TASK = "opened a task, sent nothing";
+export declare const NO_TASKS = "this serve cannot open tasks";
+/** `task`: the rule that opened a task for the message — beside a reply, or beside why none went. */
+export type Replied = {
+    sent: string;
+    task?: string;
+} | {
+    skip: string;
+    task?: string;
+};
+export interface Replier {
+    /** The profile's rules and state files, read on every message so an edit or `replies pause` applies at once. */
+    rulesPath: string;
+    statePath: string;
+    provider: string;
+    owner: {
+        id: Id | null;
+        username?: string;
+    };
+    /** ms: when `serve` began; what is older came in the catch-up and is never answered. */
+    since: number;
+    /** Whether the profile's `replies.send` is `allow`. `ask` is no: `serve` has nobody to ask. */
+    allowed: () => boolean;
+    chatOf: (chat: Id) => Promise<ReplyChat>;
+    render?: ReplyRender;
+    warn?: (message: string) => void;
+    senderOf: (person: Id) => Promise<{
+        isBot: boolean;
+        isContact: boolean;
+    }>;
+    send: (reply: {
+        chat: Id;
+        text: string;
+        replyTo?: Id;
+        sendId: string;
+        origin: string;
+    }) => Promise<unknown>;
+    newSendId: () => string;
+    /** A rule's `task` action: a `request` task for the message; `false` when the message already had one. */
+    openTask?: (message: Message, origin: string) => Promise<boolean>;
+    now?: () => number;
+}
+/**
+ * One arriving message through the rules, in file order, the first that matches acting: a task opens
+ * for anyone (NEED-582), a reply goes only to a sender the file's audience allows and only with
+ * `replies.send` at `allow`. A send that fails is
+ * tried once more with the same send id, so the messenger delivers at most one; a message whose
+ * reply may have gone is kept as answered.
+ */
+export declare const replyTo: (deps: Replier, message: Message) => Promise<Replied>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/replies/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/replies/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAK5D,eAAO,MAAM,WAAW,8BAA8B,CAAA;AACtD,eAAO,MAAM,QAAQ,aAAa,CAAA;AAClC,eAAO,MAAM,SAAS,gCAAgC,CAAA;AACtD,eAAO,MAAM,QAAQ,iCAAiC,CAAA;AAEtD,qGAAqG;AACrG,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvF,MAAM,WAAW,OAAO;IACtB,gHAAgH;IAChH,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE;QAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,wFAAwF;IACxF,KAAK,EAAE,MAAM,CAAA;IACb,+FAA+F;IAC/F,OAAO,EAAE,MAAM,OAAO,CAAA;IACtB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IACxC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAChC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACzE,IAAI,EAAE,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,EAAE,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IAC3G,SAAS,EAAE,MAAM,MAAM,CAAA;IACvB,0GAA0G;IAC1G,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACjE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAKD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,SAAgB,OAAO,WAAW,OAAO,KAAG,OAAO,CAAC,OAAO,CAuF9E,CAAA"}

package/dist/replies/serve.js

@@ -0,0 +1,113 @@
+import { codeOf } from "../sends/guarded.js";
+import { decide } from "./decide.js";
+import { outsideAudience, readReplies } from "./rules.js";
+import { readRepliesState, recordReply, writeRepliesState } from "./state.js";
+import { renderReplyTemplate } from "./template.js";
+export const NOT_ALLOWED = "replies.send is not allow";
+export const NO_RULES = "no rules";
+export const ONLY_TASK = "opened a task, sent nothing";
+export const NO_TASKS = "this serve cannot open tasks";
+/** Refusals that a second try with the same id would only repeat. */
+const FINAL = new Set(["permission_error", "confirmation_required", "rate_limited", "validation_error", "not_found"]);
+/**
+ * One arriving message through the rules, in file order, the first that matches acting: a task opens
+ * for anyone (NEED-582), a reply goes only to a sender the file's audience allows and only with
+ * `replies.send` at `allow`. A send that fails is
+ * tried once more with the same send id, so the messenger delivers at most one; a message whose
+ * reply may have gone is kept as answered.
+ */
+export const replyTo = async (deps, message) => {
+    const { rules, audience } = readReplies(deps.rulesPath, deps.provider);
+    if (rules.length === 0)
+        return { skip: NO_RULES };
+    let state = readRepliesState(deps.statePath);
+    const now = deps.now?.() ?? Date.now();
+    const outside = outsideAudience(audience, message.senderId, message.chatId);
+    // Asked only where a rule may act: for a sender the audience allows, or when a rule opens tasks for anyone.
+    const looks = outside === null || rules.some((rule) => rule.on && rule.do.includes("task"));
+    const chat = looks ? await deps.chatOf(message.chatId) : { id: message.chatId, kind: "unknown" };
+    const facts = looks && message.senderId !== null ? await deps.senderOf(message.senderId) : { isBot: false, isContact: false };
+    const incoming = {
+        message,
+        chat,
+        owner: deps.owner,
+        sender: facts,
+        outside,
+        since: deps.since,
+    };
+    let why = "no rule matched";
+    for (const rule of rules) {
+        const decision = decide(rule, incoming, state, now);
+        if ("skip" in decision) {
+            why = decision.skip;
+            continue;
+        }
+        const origin = `rule:${rule.id}`;
+        let task;
+        if (decision.actions.includes("task")) {
+            if (deps.openTask) {
+                await deps.openTask(message, origin);
+                task = rule.id;
+            }
+            else if (decision.reply === null)
+                return { skip: NO_TASKS };
+        }
+        const opened = task === undefined ? {} : { task };
+        if (decision.reply === null) {
+            writeRepliesState(deps.statePath, recordReply(readRepliesState(deps.statePath), rule, message, now));
+            return { skip: ONLY_TASK, ...opened };
+        }
+        if (!deps.allowed())
+            return { skip: NOT_ALLOWED, ...opened };
+        const rendered = deps.render
+            ? await deps.render(rule, message, chat, now)
+            : await renderReplyTemplate(rule.reply, {
+                senderName: message.senderName,
+                chat,
+                now,
+                timezone: rule.when.hours?.timezone,
+                data: message.text,
+            });
+        for (const warning of rendered.warnings)
+            deps.warn?.(warning);
+        if (rendered.text === null)
+            return { skip: rendered.reason ?? "reply template produced no reply", ...opened };
+        // Pause and consent can be revoked while an async model request is in flight.
+        if (readRepliesState(deps.statePath).paused || !deps.allowed())
+            return { skip: "replies paused or permission revoked during rendering", ...opened };
+        const fresh = readReplies(deps.rulesPath, deps.provider);
+        if (JSON.stringify(fresh.rules.find((one) => one.id === rule.id)) !== JSON.stringify(rule) ||
+            outsideAudience(fresh.audience, message.senderId, message.chatId)) {
+            return { skip: "reply rule or audience changed during rendering", ...opened };
+        }
+        const sendId = deps.newSendId();
+        const reply = {
+            chat: message.chatId,
+            text: rendered.text,
+            ...(decision.reply.asReply ? { replyTo: message.id } : {}),
+            sendId,
+            origin,
+        };
+        let failed;
+        try {
+            await deps.send(reply);
+        }
+        catch (error) {
+            if (FINAL.has(codeOf(error)))
+                return { skip: codeOf(error), ...opened };
+            try {
+                await deps.send(reply);
+            }
+            catch (again) {
+                failed = again;
+            }
+        }
+        state = recordReply(readRepliesState(deps.statePath), rule, message, now);
+        writeRepliesState(deps.statePath, state);
+        if (failed !== undefined)
+            throw failed;
+        return { sent: rule.id, ...opened };
+    }
+    return { skip: why };
+};
+//# sourceMappingURL=serve.js.map

package/dist/replies/serve.js.map

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

package/dist/replies/state.d.ts

@@ -0,0 +1,36 @@
+import * as v from "valibot";
+import type { AppIdentity } from "../cli/app.js";
+import type { Message } from "../domain/models.js";
+import type { ReplyRule } from "./rules.js";
+/** Enough to cover any restart's catch-up; older ids are past the catch-up start and never answered anyway. */
+export declare const ANSWERED_KEPT = 1000;
+declare const stateFile: v.ObjectSchema<{
+    readonly paused: v.BooleanSchema<undefined>;
+    /** `<chat>:<message>`, oldest first. */
+    readonly answered: v.ArraySchema<v.StringSchema<undefined>, undefined>;
+    /** Per rule, when it replied, by chat and by person: what its limits count. */
+    readonly sent: v.RecordSchema<v.StringSchema<undefined>, v.ObjectSchema<{
+        readonly chats: v.RecordSchema<v.StringSchema<undefined>, v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+        readonly people: v.RecordSchema<v.StringSchema<undefined>, v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type RepliesState = v.InferOutput<typeof stateFile>;
+export declare const emptyState: () => RepliesState;
+export declare const answeredKey: (message: Pick<Message, "chatId" | "id">) => string;
+/**
+ * What the rules did, apart from the rules: editing the rules file never forgets what was already
+ * answered. Read on every message, so `pause` stops a running `serve` without a restart.
+ */
+export declare const repliesStatePathFor: (app: AppIdentity, profile: string, env?: NodeJS.ProcessEnv) => string;
+/** A file that does not check out refuses: guessing would forget what was answered, and answer it twice. */
+export declare const readRepliesState: (path: string) => RepliesState;
+export declare const writeRepliesState: (path: string, state: RepliesState) => void;
+export declare const paused: (state: RepliesState, on: boolean) => RepliesState;
+/**
+ * The state after `rule` replied to `message` at `now`: the message answered, the reply counted for
+ * its chat and its sender. Counts older than the rule's longest limit are dropped, since no limit
+ * reads them.
+ */
+export declare const recordReply: (state: RepliesState, rule: Pick<ReplyRule, "id" | "limits">, message: Pick<Message, "chatId" | "id" | "senderId">, now: number) => RepliesState;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/replies/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/replies/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAK,EAAM,OAAO,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,+GAA+G;AAC/G,eAAO,MAAM,aAAa,OAAO,CAAA;AAIjC,QAAA,MAAM,SAAS;;IAEb,wCAAwC;;IAExC,+EAA+E;;;;;aAE/E,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,SAAS,CAAC,CAAA;AAE1D,eAAO,MAAM,UAAU,QAAO,YAA2D,CAAA;AAEzF,eAAO,MAAM,WAAW,YAAa,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC,KAAG,MAA2C,CAAA;AAEjH;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAS,WAAW,WAAW,MAAM,QAAO,MAAM,CAAC,UAAU,KAAiB,MACG,CAAA;AAEjH,4GAA4G;AAC5G,eAAO,MAAM,gBAAgB,SAAU,MAAM,KAAG,YAa/C,CAAA;AAED,eAAO,MAAM,iBAAiB,SAAU,MAAM,SAAS,YAAY,KAAG,IACZ,CAAA;AAE1D,eAAO,MAAM,MAAM,UAAW,YAAY,MAAM,OAAO,KAAG,YAA0C,CAAA;AAEpG;;;;GAIG;AACH,eAAO,MAAM,WAAW,UACf,YAAY,QACb,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,QAAQ,CAAC,WAC7B,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,GAAG,UAAU,CAAC,OAC/C,MAAM,KACV,YAsBF,CAAA"}

package/dist/replies/state.js

@@ -0,0 +1,67 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths, writeSecurely } from "@wirecat/cli-base";
+import * as v from "valibot";
+/** Enough to cover any restart's catch-up; older ids are past the catch-up start and never answered anyway. */
+export const ANSWERED_KEPT = 1000;
+const times = v.record(v.string(), v.array(v.string()));
+const stateFile = v.object({
+    paused: v.boolean(),
+    /** `<chat>:<message>`, oldest first. */
+    answered: v.array(v.string()),
+    /** Per rule, when it replied, by chat and by person: what its limits count. */
+    sent: v.record(v.string(), v.object({ chats: times, people: times })),
+});
+export const emptyState = () => ({ paused: false, answered: [], sent: {} });
+export const answeredKey = (message) => `${message.chatId}:${message.id}`;
+/**
+ * What the rules did, apart from the rules: editing the rules file never forgets what was already
+ * answered. Read on every message, so `pause` stops a running `serve` without a restart.
+ */
+export const repliesStatePathFor = (app, profile, env = process.env) => join(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).state, `${profile}.replies-state.json`);
+/** A file that does not check out refuses: guessing would forget what was answered, and answer it twice. */
+export const readRepliesState = (path) => {
+    if (!existsSync(path))
+        return emptyState();
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw broken(path, error instanceof Error ? error.message : String(error));
+    }
+    const checked = v.safeParse(stateFile, parsed);
+    if (!checked.success) {
+        throw broken(path, checked.issues.map((issue) => `${v.getDotPath(issue) ?? "file"}: ${issue.message}`).join("; "));
+    }
+    return checked.output;
+};
+export const writeRepliesState = (path, state) => writeSecurely(path, `${JSON.stringify(state)}\n`, 0o600);
+export const paused = (state, on) => ({ ...state, paused: on });
+/**
+ * The state after `rule` replied to `message` at `now`: the message answered, the reply counted for
+ * its chat and its sender. Counts older than the rule's longest limit are dropped, since no limit
+ * reads them.
+ */
+export const recordReply = (state, rule, message, now) => {
+    const oldest = now - Math.max(rule.limits.perChat.ms, rule.limits.perPerson.ms);
+    const kept = (all, key) => {
+        const recent = Object.fromEntries(Object.entries(all)
+            .map(([id, at]) => [id, at.filter((one) => Date.parse(one) > oldest)])
+            .filter(([, at]) => at.length > 0));
+        if (key === null)
+            return recent;
+        return { ...recent, [key]: [...(recent[key] ?? []), new Date(now).toISOString()] };
+    };
+    const before = state.sent[rule.id] ?? { chats: {}, people: {} };
+    return {
+        ...state,
+        answered: [...state.answered.filter((one) => one !== answeredKey(message)), answeredKey(message)].slice(-ANSWERED_KEPT),
+        sent: {
+            ...state.sent,
+            [rule.id]: { chats: kept(before.chats, message.chatId), people: kept(before.people, message.senderId) },
+        },
+    };
+};
+const broken = (path, why) => new CliError("configuration_error", `the reply state ${path} cannot be read (${why}) — fix or move the file`);
+//# sourceMappingURL=state.js.map

package/dist/replies/state.js.map

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

package/dist/replies/template.d.ts

@@ -0,0 +1,38 @@
+import type { ReplyRule } from "./rules.js";
+export declare const TEMPLATE_LIMITS: {
+    parse: number;
+    renders: number;
+    memory: number;
+    milliseconds: number;
+    output: number;
+    aiOutput: number;
+    calls: number;
+};
+export interface TemplateBlock {
+    instruction: string;
+    fallback: string | null;
+}
+export interface TemplateResult {
+    text: string | null;
+    warnings: string[];
+    blocks: TemplateBlock[];
+    reason?: string;
+}
+export interface TemplateInput {
+    senderName: string | null;
+    chat: {
+        kind: string;
+        title?: string | null;
+    };
+    now: number;
+    timezone?: string;
+    data: string;
+    allowAI?: boolean;
+    preview?: boolean;
+    complete?: (instruction: string, data: string) => Promise<{
+        text: string;
+    }>;
+    limits?: Partial<typeof TEMPLATE_LIMITS>;
+}
+export declare const renderReplyTemplate: (reply: ReplyRule["reply"], input: TemplateInput) => Promise<TemplateResult>;
+//# sourceMappingURL=template.d.ts.map

package/dist/replies/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/replies/template.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,eAAO,MAAM,eAAe;IAC1B,KAAK;IACL,OAAO;IACP,MAAM;IACN,YAAY;IACZ,MAAM;IACN,QAAQ;IACR,KAAK;CACN,CAAA;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB;AACD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AACD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IAC3E,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,eAAe,CAAC,CAAA;CACzC;AAED,eAAO,MAAM,mBAAmB,UAAiB,SAAS,CAAC,OAAO,CAAC,SAAS,aAAa,KAAG,OAAO,CAAC,cAAc,CA0JjH,CAAA"}