@leemour/cli-messaging 0.145.0 → 0.147.0

package/dist/mcp/tools/review.js

@@ -1,18 +1,24 @@
+import { CliError } from "@leemour/cli-core";
 import * as v from "valibot";
+import { checkPoints } from "../../cli/messenger/points.js";
 import { REVIEW_DAYS, reviewStart, UNANSWERED_HOURS } from "../../services/inbox.js";
 import { momentOf } from "../../services/moment.js";
 import { heard, hearForTool, modelWith } from "../../speech/hearing.js";
 import { chatOf, READ, tool } from "../tool.js";
+import { kindsInput } from "./inbox.js";
 export const reviewTools = (messenger) => ({
     review: tool({
         title: "Review who owes what",
         description: "Every message, the owner's too (outgoing: true), in each chat that changed since a point — for sorting out " +
-            `what the owner owes and what others owe. Without \`since_time\`, the last ${REVIEW_DAYS} days. Muted and archived ` +
+            `what the owner owes and what others owe. Without \`since_time\`, the last ${REVIEW_DAYS} days; with \`new\`, ` +
+            "what changed since the last call with new, from points this tool keeps apart from the owner's own. Muted and archived " +
             "chats are left out unless they mention the owner, or `all` is set. Returns { since, until, complete, chats: " +
             "[{ id, title, messages, more }], skipped, partial, quiet }; when complete, the next review starts at until.",
         input: v.object({
             since_time: v.optional(v.pipe(v.string(), v.description("where the last review ended: ISO 8601, or 2h / 1d ago"))),
+            new: v.optional(v.pipe(v.boolean(), v.description("what changed since the last call with new"))),
             chat: v.optional(chatOf(messenger)),
+            kinds: kindsInput,
             unanswered: v.optional(v.pipe(v.number(), v.minValue(0), v.description(`only questions nobody answered, asked at least this many hours ago (${UNANSWERED_HOURS} is usual)`))),
             all: v.optional(v.pipe(v.boolean(), v.description("muted and archived chats too"))),
             transcribe: v.optional(v.pipe(v.boolean(), v.description("turn voice messages not heard yet into text; can take minutes"))),
@@ -20,12 +26,26 @@ export const reviewTools = (messenger) => ({
         }),
         annotations: READ,
         served: async (services, args, defaults, connect) => {
+            if (args.new && (args.since_time !== undefined || args.unanswered !== undefined)) {
+                // An open question stays open: moving past it would drop it from the next review.
+                throw new CliError("validation_error", "new keeps its own point — not with since_time or unanswered");
+            }
+            const saved = args.new
+                ? checkPoints(messenger.app, {
+                    command: "mcp-review",
+                    profile: defaults.settings.profile,
+                    env: defaults.env,
+                    firstLookMs: REVIEW_DAYS * 86_400_000,
+                })
+                : undefined;
             const model = modelWith(args.transcribe, args.model);
             let hearing;
             const transcribe = args.transcribe === true;
             const found = await services.inbox.review({
-                since: args.since_time === undefined ? reviewStart() : momentOf(args.since_time, "since_time"),
+                since: args.since_time === undefined ? (saved?.first ?? reviewStart()) : momentOf(args.since_time, "since_time"),
+                ...(saved === undefined ? {} : { points: saved.chats }),
                 ...(args.chat === undefined ? {} : { chat: args.chat }),
+                ...(args.kinds === undefined ? {} : { kinds: args.kinds }),
                 ...(args.all ? { all: true } : {}),
                 ...(args.unanswered === undefined ? {} : { unansweredAfterHours: args.unanswered }),
                 enrich: async (raw) => {
@@ -37,6 +57,7 @@ export const reviewTools = (messenger) => ({
                     };
                 },
             });
+            saved?.save(found.checked ?? {});
             return {
                 ...found,
                 complete: found.complete && (hearing?.unheard.length ?? 0) === 0,

package/dist/mcp/tools/review.js.map

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

package/dist/replies/decide.d.ts

@@ -0,0 +1,34 @@
+import type { Chat, Id, Message } from "../domain/models.js";
+import { type ReplyRule } from "./rules.js";
+import { type RepliesState } from "./state.js";
+/** What the matcher knows about one arriving message beyond the message itself. */
+export interface Incoming {
+    message: Message;
+    chat: Pick<Chat, "id" | "kind">;
+    /** The owner, to tell a mention or a reply to them; `null` when the account is not known. */
+    owner: {
+        id: Id | null;
+        username?: string;
+    };
+    sender: {
+        isBot: boolean;
+        isContact: boolean;
+    };
+    /** ms: when `serve` began catching up. Older messages are never answered — a week away must not get a week of replies. */
+    since: number;
+}
+export type Decision = {
+    reply: {
+        text: string;
+        asReply: boolean;
+        model: ReplyRule["reply"]["model"];
+    };
+} | {
+    skip: string;
+};
+/**
+ * Whether `rule` answers this message at `now`, and with what — or why not, in words `replies test`
+ * can print. Pure: it reads `state` and changes nothing; the caller records a reply it sent.
+ */
+export declare const decide: (rule: ReplyRule, incoming: Incoming, state: RepliesState, now: number) => Decision;
+//# sourceMappingURL=decide.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decide.d.ts","sourceRoot":"","sources":["../../src/replies/decide.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAA8B,KAAK,SAAS,EAAe,MAAM,YAAY,CAAA;AACpF,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,YAAY,CAAA;AAE3D,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC,CAAA;IAC/B,6FAA6F;IAC7F,KAAK,EAAE;QAAE,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAA;IAC9C,0HAA0H;IAC1H,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,QAAQ,GAChB;IAAE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAA;KAAE,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAIpB;;;GAGG;AACH,eAAO,MAAM,MAAM,SAAU,SAAS,YAAY,QAAQ,SAAS,YAAY,OAAO,MAAM,KAAG,QAwC9F,CAAA"}

package/dist/replies/decide.js

@@ -0,0 +1,109 @@
+import { DAYS } from "./rules.js";
+import { answeredKey } from "./state.js";
+const skip = (why) => ({ skip: why });
+/**
+ * Whether `rule` answers this message at `now`, and with what — or why not, in words `replies test`
+ * can print. Pure: it reads `state` and changes nothing; the caller records a reply it sent.
+ */
+export const decide = (rule, incoming, state, now) => {
+    const { message, chat, owner, sender } = incoming;
+    if (state.paused)
+        return skip("replies are paused");
+    if (!rule.on)
+        return skip("the rule is off");
+    if (message.outgoing !== false)
+        return skip(message.outgoing ? "your own message" : "the account is not known");
+    if (message.senderIsChat || message.senderId === null)
+        return skip("sent as a chat, not by a person");
+    if (sender.isBot)
+        return skip("sent by a bot");
+    if (chat.kind !== "dialog" && chat.kind !== "group")
+        return skip(`a ${chat.kind} is never answered`);
+    if (message.editedAt !== null)
+        return skip("an edited message");
+    if (message.scheduledFor !== undefined)
+        return skip("a scheduled message");
+    if (Date.parse(message.timestamp) < incoming.since)
+        return skip("older than the catch-up start");
+    if (state.answered.includes(answeredKey(message)))
+        return skip("already answered");
+    const { where, when } = rule;
+    if (where.kinds.length > 0 && !where.kinds.includes(chat.kind))
+        return skip(`the rule does not answer a ${chat.kind}`);
+    if (where.chats.length > 0 && !where.chats.includes(chat.id))
+        return skip("not one of the rule's chats");
+    if (where.notChats.includes(chat.id))
+        return skip("one of the chats the rule leaves out");
+    const toMe = mentionsOwner(message, owner);
+    if (chat.kind === "group" && !where.chats.includes(chat.id) && !toMe) {
+        return skip("a group message that neither mentions you nor replies to you");
+    }
+    if (when.hours && !outside(when.hours, now))
+        return skip("inside the hours the rule leaves alone");
+    if (when.words.length > 0 && !when.words.some((word) => hasWord(message.text, word))) {
+        return skip("none of the rule's words");
+    }
+    if (when.question && !isQuestion(message.text))
+        return skip("not a question");
+    if (when.mentionsMe && !toMe)
+        return skip("does not mention you or reply to you");
+    const { from } = when;
+    if (from.people.length > 0 && !from.people.includes(message.senderId))
+        return skip("not from the rule's people");
+    if (from.notPeople.includes(message.senderId))
+        return skip("from a person the rule leaves out");
+    if (from.contactsOnly && !sender.isContact)
+        return skip("not from a contact");
+    const sent = state.sent[rule.id];
+    if (over(sent?.chats[chat.id], rule.limits.perChat, now))
+        return skip("the chat's limit is reached");
+    if (over(sent?.people[message.senderId], rule.limits.perPerson, now))
+        return skip("the person's limit is reached");
+    const text = filled(rule.reply.template, message.senderName);
+    if (text === undefined)
+        return skip("the template needs a name the sender has not given");
+    return { reply: { text, asReply: rule.reply.asReply, model: rule.reply.model } };
+};
+const mentionsOwner = (message, owner) => message.replyTo?.outgoing === true ||
+    (owner.id !== null && (message.mentions ?? []).includes(owner.id)) ||
+    (owner.username !== undefined && hasWord(message.text, `@${owner.username}`));
+const local = (zone, now) => {
+    const parts = new Intl.DateTimeFormat("en-US", {
+        timeZone: zone,
+        weekday: "short",
+        hour: "2-digit",
+        minute: "2-digit",
+        hourCycle: "h23",
+    }).formatToParts(now);
+    const part = (type) => parts.find((one) => one.type === type)?.value ?? "";
+    return {
+        day: part("weekday").toLowerCase(),
+        minute: Number(part("hour")) * 60 + Number(part("minute")),
+    };
+};
+/**
+ * Outside the working time: not on one of `days`, or on one but not inside the window. A window that
+ * crosses midnight belongs to the day it starts on, so Friday 22:00–02:00 covers Saturday 01:00.
+ */
+const outside = ({ outside: window, days, timezone }, now) => {
+    const { day, minute } = local(timezone, now);
+    const crosses = window.to < window.from;
+    const working = crosses
+        ? (days.includes(day) && minute >= window.from) || (days.includes(dayBefore(day)) && minute < window.to)
+        : days.includes(day) && minute >= window.from && minute < window.to;
+    return !working;
+};
+const dayBefore = (day) => DAYS[(DAYS.indexOf(day) + 6) % 7];
+const escaped = (text) => text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/** Whole words, any case, any script: `price` is not found in `prices`, `цена` is found in `Цена?`. */
+const hasWord = (text, word) => new RegExp(`(?<![\\p{L}\\p{N}_])${escaped(word.trim())}(?![\\p{L}\\p{N}_])`, "iu").test(text);
+/** A shared link's query string is not a question. */
+const isQuestion = (text) => text.replace(/https?:\/\/\S+/g, "").includes("?");
+const over = (sent, { count, ms }, now) => (sent ?? []).filter((at) => now - Date.parse(at) < ms).length >= count;
+const filled = (template, senderName) => {
+    const name = senderName?.trim() ?? "";
+    if (/\{(firstName|name)\}/.test(template) && name === "")
+        return undefined;
+    return template.replaceAll("{firstName}", name.split(/\s+/)[0] ?? name).replaceAll("{name}", name);
+};
+//# sourceMappingURL=decide.js.map

package/dist/replies/decide.js.map

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

package/dist/replies/rules.d.ts

@@ -0,0 +1,127 @@
+import * as v from "valibot";
+import type { AppIdentity } from "../cli/app.js";
+export declare const REPLY_ACTIONS: readonly ["reply", "task"];
+export declare const REPLY_MODELS: readonly ["fill-only", "may-reword"];
+/** Channels, saved messages and chats of unknown kind are never answered, so a rule cannot name them. */
+export declare const REPLY_KINDS: readonly ["dialog", "group"];
+export declare const PLACEHOLDERS: readonly ["firstName", "name"];
+export declare const DAYS: readonly ["mon", "tue", "wed", "thu", "fri", "sat", "sun"];
+export type Day = (typeof DAYS)[number];
+/** Minutes after midnight, `[from, to)`; `to` below `from` crosses midnight. */
+export interface Window {
+    from: number;
+    to: number;
+}
+/** At most `count` sends inside any `ms`. */
+export interface Limit {
+    count: number;
+    ms: number;
+}
+declare const rule: v.SchemaWithPipe<readonly [v.StrictObjectSchema<{
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a rule id is lower-case letters, digits and -">]>;
+    readonly on: v.BooleanSchema<undefined>;
+    readonly do: v.SchemaWithPipe<readonly [v.ArraySchema<v.PicklistSchema<readonly ["reply", "task"], undefined>, undefined>, v.MinLengthAction<("reply" | "task")[], 1, "a rule has to do something: reply">]>;
+    readonly where: v.StrictObjectSchema<{
+        readonly kinds: v.ArraySchema<v.PicklistSchema<readonly ["dialog", "group"], undefined>, undefined>;
+        readonly chats: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly notChats: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+    }, undefined>;
+    readonly when: v.StrictObjectSchema<{
+        readonly hours: v.NullableSchema<v.StrictObjectSchema<{
+            readonly outside: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a window is written \"09:00-19:00\", 24-hour">, v.TransformAction<string, Window>, v.CheckAction<Window, "a window has to start and end at different times">]>;
+            readonly days: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TransformAction<string, ("fri" | "mon" | "sat" | "sun" | "thu" | "tue" | "wed")[] | undefined>, v.CheckAction<("fri" | "mon" | "sat" | "sun" | "thu" | "tue" | "wed")[] | undefined, `days are written "mon-fri" or "sat,sun", from ${string}`>, v.TransformAction<("fri" | "mon" | "sat" | "sun" | "thu" | "tue" | "wed")[] | undefined, ("fri" | "mon" | "sat" | "sun" | "thu" | "tue" | "wed")[]>]>;
+            readonly timezone: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.CheckAction<string, "a time zone is written as \"Europe/Madrid\"">]>;
+        }, undefined>, undefined>;
+        readonly words: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.TrimAction, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+        readonly question: v.BooleanSchema<undefined>;
+        readonly mentionsMe: v.BooleanSchema<undefined>;
+        readonly from: v.StrictObjectSchema<{
+            readonly people: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+            readonly notPeople: v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
+            readonly contactsOnly: v.BooleanSchema<undefined>;
+        }, undefined>;
+    }, undefined>;
+    readonly reply: v.StrictObjectSchema<{
+        readonly template: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, "a reply template cannot be empty">, v.CheckAction<string, `a template fills only ${string}`>]>;
+        readonly model: v.PicklistSchema<readonly ["fill-only", "may-reword"], undefined>;
+        readonly asReply: v.BooleanSchema<undefined>;
+    }, undefined>;
+    readonly limits: v.StrictObjectSchema<{
+        readonly perChat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a limit is written \"1/12h\": this many replies in this long — m, h or d">, v.TransformAction<string, Limit>]>;
+        readonly perPerson: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.RegexAction<string, "a limit is written \"1/12h\": this many replies in this long — m, h or d">, v.TransformAction<string, Limit>]>;
+    }, undefined>;
+}, undefined>, v.CheckAction<{
+    id: string;
+    on: boolean;
+    do: ("reply" | "task")[];
+    where: {
+        kinds: ("dialog" | "group")[];
+        chats: string[];
+        notChats: string[];
+    };
+    when: {
+        hours: {
+            outside: Window;
+            days: ("fri" | "mon" | "sat" | "sun" | "thu" | "tue" | "wed")[];
+            timezone: string;
+        } | null;
+        words: string[];
+        question: boolean;
+        mentionsMe: boolean;
+        from: {
+            people: string[];
+            notPeople: string[];
+            contactsOnly: boolean;
+        };
+    };
+    reply: {
+        template: string;
+        model: "fill-only" | "may-reword";
+        asReply: boolean;
+    };
+    limits: {
+        perChat: Limit;
+        perPerson: Limit;
+    };
+}, "\"task\" waits for the tasks package; only \"reply\" works now">]>;
+export type ReplyRule = v.InferOutput<typeof rule>;
+/**
+ * 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 declare const defaultRule: (id: string) => {
+    id: string;
+    on: boolean;
+    do: string[];
+    where: {
+        kinds: string[];
+        chats: never[];
+        notChats: never[];
+    };
+    when: {
+        hours: null;
+        words: never[];
+        question: boolean;
+        mentionsMe: boolean;
+        from: {
+            people: never[];
+            notPeople: never[];
+            contactsOnly: boolean;
+        };
+    };
+    reply: {
+        template: string;
+        model: string;
+        asReply: boolean;
+    };
+    limits: {
+        perChat: string;
+        perPerson: string;
+    };
+};
+export declare const repliesPathFor: (app: AppIdentity, profile: string, env?: NodeJS.ProcessEnv) => string;
+/** The owner's rules, in file order. No file is no rules; a file that does not check out refuses, naming the field. */
+export declare const readReplyRules: (path: string) => ReplyRule[];
+export declare const parseReplyRules: (parsed: unknown, path: string) => ReplyRule[];
+export {};
+//# sourceMappingURL=rules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/replies/rules.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,eAAO,MAAM,aAAa,YAAI,OAAO,EAAE,MAAM,CAAU,CAAA;AACvD,eAAO,MAAM,YAAY,YAAI,WAAW,EAAE,YAAY,CAAU,CAAA;AAChE,yGAAyG;AACzG,eAAO,MAAM,WAAW,YAAI,QAAQ,EAAE,OAAO,CAAU,CAAA;AACvD,eAAO,MAAM,YAAY,YAAI,WAAW,EAAE,MAAM,CAAU,CAAA;AAC1D,eAAO,MAAM,IAAI,YAAI,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAU,CAAA;AAE9E,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAA;AAMvC,gFAAgF;AAChF,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED,6CAA6C;AAC7C,MAAM,WAAW,KAAK;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;CACX;AAoED,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sEAkBT,CAAA;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,CAAA;AAUlD;;;GAGG;AACH,eAAO,MAAM,WAAW,OAAQ,MAAM;;;;;QAI3B,KAAK;QAAc,KAAK;QAAM,QAAQ;;;QAE7C,KAAK;QACL,KAAK;QACL,QAAQ;QACR,UAAU;QACV,IAAI;YAAI,MAAM;YAAM,SAAS;YAAM,YAAY;;;;QAExC,QAAQ;QAAM,KAAK;QAAe,OAAO;;;QACxC,OAAO;QAAU,SAAS;;CACpC,CAAA;AAEF,eAAO,MAAM,cAAc,QAAS,WAAW,WAAW,MAAM,QAAO,MAAM,CAAC,UAAU,KAAiB,MACG,CAAA;AAE5G,uHAAuH;AACvH,eAAO,MAAM,cAAc,SAAU,MAAM,KAAG,SAAS,EAStD,CAAA;AAED,eAAO,MAAM,eAAe,WAAY,OAAO,QAAQ,MAAM,KAAG,SAAS,EAIxE,CAAA"}

package/dist/replies/rules.js

@@ -0,0 +1,119 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { CliError, resolvePaths } from "@leemour/cli-core";
+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.minLength(1, "a reply template cannot be empty"), 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.picklist(REPLY_MODELS), asReply: v.boolean() }),
+    limits: v.strictObject({ perChat: limit, perPerson: limit }),
+}), 
+// NEED-582: a rule may open a task, but there is no tasks package to open it in yet.
+v.check((one) => !one.do.includes("task"), '"task" waits for the tasks package; only "reply" works now'));
+const file = v.pipe(v.strictObject({ 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: "", model: "fill-only", 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`);
+/** 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) => {
+    if (!existsSync(path))
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch (error) {
+        throw broken(path, error instanceof Error ? error.message : String(error));
+    }
+    return parseReplyRules(parsed, path);
+};
+export const parseReplyRules = (parsed, path) => {
+    const checked = v.safeParse(file, parsed);
+    if (!checked.success)
+        throw broken(path, checked.issues.map(problem).join("; "));
+    return checked.output.rules;
+};
+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/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 "@leemour/cli-core";
+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