@wirecat/cli-core 0.380.0 → 0.382.0

package/CHANGELOG.md

@@ -5,12 +5,73 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
-## Unreleased
+## 0.382.0 — 22.10.2026
+
+### Added
+
+- **A chat's state from the phone (store version 28).** The store keeps `Chat.muted`, `Chat.archived` and two new
+  fields: `mutedUntil` (when a mute ends, UTC; none is for good) and `markedUnread` (the owner marked the chat unread).
+  A `ChatUpdate` that leaves one out keeps the stored value, and a mute past its end reads as over. Stored chats show
+  them, and `chat` gains `muted_until` and `marked_unread`. So `inbox` and `review` over the store now leave out muted
+  and archived chats, as they do for a messenger that answers live, and `inbox` takes in a chat marked unread with its
+  newest message from someone else. tg and max send `muted` and `archived` in their chat lists, so their stored chats
+  now show them too.
+- **The store can count unread messages** for a messenger that sets `unreadCounts: "store"`: each new message from
+  someone else that `watch` or `listen` saves after the messenger's last count adds one, and a whole-chat `chats read`
+  stores 0. `store.messages.saveMessages` takes `countUnread`. tg and max leave it unset and count as before. See
+  [adapters](docs/dev/ADAPTERS.md).
+- **Delivered and read on the owner's own messages (store version 27).** `Message.delivery` (`delivered` or `read`)
+  says how far the owner's message in a one-to-one chat got; a `watch` event `{ event: "delivery", chatId, chatTitle,
+  messageId, delivery, at }` (`MessageDeliveryEvent`) carries a receipt as it comes. `store.messages.saveDelivery` and
+  a saved message's own `delivery` keep it in the new `messages.delivery` column, only on the owner's messages and
+  only ever forward. Stored messages show it as `delivery`. tg and max send none and see no change. See
+  [adapters](docs/dev/ADAPTERS.md).
+
+## 0.381.0 — 22.10.2026
+
+### Added
+
+- **Meeting search finds words speech recognition cut off.** A stored word of four letters or more that begins a
+  query word, and that the Russian dictionary does not know, widens it: «може» for «может», «напри» for «например».
+  Real shorter words («после» for «последующих») still do not. This is ztx's rule, behind the dictionary.
+- **A meeting answer names what about it is doubtful, in `issues`.** `MEETING_ISSUES` lists the values; today one,
+  `time_without_zone`: the provider sent a time with no zone, and it was read in the computer's zone. A provider
+  adapter keeps the data and puts the issue in the meeting's `metadata.issues`; `meetingItem` shows the known ones and
+  leaves the field out when there are none. No store change.
+
+- **People's reactions in the store (store version 26).** For a messenger that sends one person's reaction change at a
+  time (WhatsApp), a `watch` event `{ event: "person_reaction", chatId, chatTitle, messageId, reaction }`
+  (`PersonReactionEvent`) and a pushed batch's `reactions` (`HistoryReaction`) carry `PersonReaction`
+  (`{ person, own, reaction, reactedAt }`, `reaction: null` a take-back). `store.messages.saveReaction` and
+  `saveMessages({ reactions })` keep each person's newest in the new `message_reactions` table, so an older history
+  push never undoes a newer live change, and write the message's `reactions` totals from them: readers, output and
+  MCP see the same shape. tg and max keep sending totals; a message with people's reactions keeps the derived ones.
+  See [adapters](docs/dev/ADAPTERS.md).
+
+### Fixed
+
+- **A chat or person is found by a name copied with its emoji.** A copied emoji often carries an invisible mark
+  (U+FE0F, U+FE0E, or the U+200D joiner) that a typed one lacks, so "Семья❤️" did not find the chat "Семья❤". Names
+  now compare without those marks and with accented letters in one form, still ignoring case, wherever a chat or a
+  person is named (`pickChat`, `pickPerson`, a stored alias).
+- **`from:` finds a speaker known only by name across meetings.** A participant keyed by name in one meeting
+  (`name:…@account/occurrence:n`, as zoom-cli's `.txt` speakers and nameless API participants are) is grouped with
+  the same name elsewhere, and with the one identified speaker of that name when there is exactly one. Before,
+  each meeting's copy was a separate candidate, so `from:"Name"` was ambiguous. Candidates with an email show it.
+
+- **A store the process may not write is a permission error, not a crash.** Opening the store for writing where the
+  file or its folder is read-only (`EROFS`, `EACCES`, `EPERM`) was reported as `internal_error` "this is a bug".
+  It is now `permission_error` (exit 5) with reason `store.not-writable`, and the message names no path.
 
 ## 0.380.0 — 21.10.2026
 
 ### Added
 
+- **A file's copy and the provider's copy of one meeting are one record.** `MeetingSave.fromFile` marks a save read
+  from a file; it joins the provider's record of the same occurrence (same series key, start within 15 minutes)
+  and only fills a missing transcript there. A provider record saved after a file takes over that record and its
+  key, and a provider transcript supersedes transcripts with source `file`. Two provider records never merge.
+  See [meetings](docs/dev/MEETINGS.md).
 - **Meetings import text transcripts.** `parseTranscriptText` reads the text form zoom-searcher wrote: the header
   (`Встреча:` title, `Дата:` start as written, `Zoom ID:`, `Говорят:` speakers) and `[hh:mm:ss] Speaker: text`
   blocks, a block running over several lines. `ImportFile.format: "text"` makes `importFiles` use it; `vtt` stays
@@ -18,6 +79,7 @@ shape of this file.
 - **An import says the zone it read file times in, and a host can explain its file names.** `RunReport.timezone` is
   set when every imported file's meeting carries one zone; `MeetingCommandDeps.importHelp` adds the host's note
   (file name patterns, how their time is read) under `meetings import --help`.
+||||||| Stash base
 - **Meeting search finds words spread over neighbouring lines.** `"циан риелтор"~3` in a meeting query finds a
   transcript line with one of the words when the others are at most three lines away in the same transcript; `~0`
   is one line, any order; at most 20. The words widen to garbled spellings as single words do. It needs

package/dist/cli/bot/watch.js

@@ -131,7 +131,7 @@ export const botWatchCommand = (bot) => annotate(new Command("watch"), { effects
         else if (event.event === "delete") {
             context.streams.data(`deleted in ${title(event.chatId)}: message ${event.messageId}\n`);
         }
-        else if (event.event === "reaction") {
+        else if (event.event === "reaction" || event.event === "person_reaction") {
             context.streams.data(`reactions in ${title(event.chatId)} on message ${event.messageId}\n`);
         }
         else if (event.event === "vote") {
@@ -140,6 +140,9 @@ export const botWatchCommand = (bot) => annotate(new Command("watch"), { effects
         else if (event.event === "star") {
             context.streams.data(`${event.starred ? "starred" : "unstarred"} in ${title(event.chatId)}: message ${event.messageId}\n`);
         }
+        else if (event.event === "delivery") {
+            context.streams.data(`${event.delivery} in ${title(event.chatId)}: message ${event.messageId}\n`);
+        }
         else if (event.event === "chat_event") {
             context.streams.data(`${event.change.event} in ${title(event.chatId)}\n`);
         }

package/dist/cli/index.d.ts

@@ -11,7 +11,7 @@ export { callMeetingSeriesInventoryTool, meetingSeriesInventoryTool } from "../m
 export { registerLinkConversationsPrompt } from "../mcp/prompts.js";
 export { agentBody, agentJson, agentResult, UNTRUSTED, UNTRUSTED_INSTRUCTION } from "../mcp/text.js";
 export { type AppIdentity, envName, readOnlyLockOf, readOnlyRefusal } from "../ports/app.js";
-export type { AccountEditing, AccountHealth, AccountRecords, AccountSettings, AccountStanding, AccountTools, After, BotChats, ChannelComments, ChatDeletion, ChatFolders, ChatReading, ContactBook, Download, ForumControl, ForumState, GroupAdmin, GroupModeration, HistoryBatch, HistoryChatEvent, HistoryStar, HistoryVote, InviteLinks, JoinRequests, LiveUpdates, MessageButtons, MessageEditing, MessageMedia, MessagePermalinks, MessagePins, MessagePolls, MessageReactions, MessageSearch, MessageStars, MessengerAdapter, MessengerCore, NewPoll, OfficialStats, PassiveUpdates, PersonProfiles, ProfileChange, ProfilePhotos, PushedHistory, ReadState, RemoteFile, ScheduledMessages, SenderIdentities, SenderSearch, SendOptions, Sent, ServerQuery, ServerReads, ThreadAddressing, TopicEditing, TopicHistory, TopicReadState, Transcript, } from "../ports/messenger.js";
+export type { AccountEditing, AccountHealth, AccountRecords, AccountSettings, AccountStanding, AccountTools, After, BotChats, ChannelComments, ChatDeletion, ChatFolders, ChatReading, ContactBook, Download, ForumControl, ForumState, GroupAdmin, GroupModeration, HistoryBatch, HistoryChatEvent, HistoryReaction, HistoryStar, HistoryVote, InviteLinks, JoinRequests, LiveUpdates, MessageButtons, MessageEditing, MessageMedia, MessagePermalinks, MessagePins, MessagePolls, MessageReactions, MessageSearch, MessageStars, MessengerAdapter, MessengerCore, NewPoll, OfficialStats, PassiveUpdates, PersonProfiles, ProfileChange, ProfilePhotos, PushedHistory, ReadState, RemoteFile, ScheduledMessages, SenderIdentities, SenderSearch, SendOptions, Sent, ServerQuery, ServerReads, ThreadAddressing, TopicEditing, TopicHistory, TopicReadState, Transcript, } from "../ports/messenger.js";
 export type { Fetching, MediaOption, MessengerTraits } from "../ports/traits.js";
 export { senderFacts } from "../replies/dry-run.js";
 export { type ReplyRender, replyRenderer } from "../replies/rendering.js";

package/dist/cli/messenger/chat-answers.d.ts

@@ -61,7 +61,9 @@ export declare const chatShown: (account: AccountKey, card: Parameters<typeof ch
     last_message_at: string | null;
     participants_count: number | null;
     muted?: boolean | undefined;
+    muted_until?: string | undefined;
     archived?: boolean | undefined;
+    marked_unread?: boolean | undefined;
     membership_state?: "archived" | "external" | "imported" | "joined" | "left" | "public" | undefined;
     parent_chat_id?: string | undefined;
     scope?: "personal" | "work" | undefined;

package/dist/cli/messenger/chat-answers.js

@@ -28,7 +28,9 @@ export const chatAnswer = (account, chat) => defined({
     last_message_at: chat.lastMessageAt,
     participants_count: chat.participantsCount,
     muted: chat.muted,
+    muted_until: chat.mutedUntil ?? undefined,
     archived: chat.archived,
+    marked_unread: chat.markedUnread,
     membership_state: chat.membershipState,
     parent_chat_id: chat.parentChatId ?? undefined,
     scope: chat.scope,

package/dist/cli/messenger/chat-lists.d.ts

@@ -21,7 +21,9 @@ export declare const chatsList: (services: Services, query: QueryWords, paging:
     last_message_at: string | null;
     participants_count: number | null;
     muted?: boolean | undefined;
+    muted_until?: string | undefined;
     archived?: boolean | undefined;
+    marked_unread?: boolean | undefined;
     membership_state?: "archived" | "external" | "imported" | "joined" | "left" | "public" | undefined;
     parent_chat_id?: string | undefined;
     scope?: "personal" | "work" | undefined;

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

@@ -236,12 +236,12 @@ type ConnectionWaits = Pick<BaseEnvironment, "closeWaitMs" | "rekeyPacing">;
  * does not `watch` is open: what it queued while nothing was connected is delivered once and cannot be fetched again.
  * A connection opened with `listen: true` is left to its `watch` and `feed`, which save the same.
  */
-export declare const connected: (connection: MessengerAdapter, { app, provider, name, deletedWithoutChat, pace, history, savedChatId, }: Pick<Messenger, "app" | "provider" | "name" | "deletedWithoutChat" | "pace" | "history" | "savedChatId">, { settings, env, renderer }: Pick<BaseContext, "settings" | "env" | "renderer">, events: EventSink, store?: LazyStore, { listen: watching, closeWaitMs, rekeyPacing, }?: Pick<ConnectOptions, "listen"> & ConnectionWaits) => {
+export declare const connected: (connection: MessengerAdapter, { app, provider, name, deletedWithoutChat, pace, history, savedChatId, unreadCounts, }: Pick<Messenger, "app" | "provider" | "name" | "deletedWithoutChat" | "pace" | "history" | "savedChatId" | "unreadCounts">, { settings, env, renderer }: Pick<BaseContext, "settings" | "env" | "renderer">, events: EventSink, store?: LazyStore, { listen: watching, closeWaitMs, rekeyPacing, }?: Pick<ConnectOptions, "listen"> & ConnectionWaits) => {
     adapter: MessengerAdapter;
     close: () => Promise<void>;
 };
 /** `connectFor` and then `connected`, over one store handle: what the reads save and what the adapter looks up. */
-export declare const connectedFor: (command: Command, messenger: Pick<Messenger, "connect" | "app" | "provider" | "name" | "deletedWithoutChat" | "pace" | "history" | "savedChatId">, base: BaseContext, options: ConnectOptions & {
+export declare const connectedFor: (command: Command, messenger: Pick<Messenger, "connect" | "app" | "provider" | "name" | "deletedWithoutChat" | "pace" | "history" | "savedChatId" | "unreadCounts">, base: BaseContext, options: ConnectOptions & {
     events: EventSink;
 }) => Promise<{
     connection: MessengerAdapter;

package/dist/cli/messenger/context.js

@@ -189,7 +189,7 @@ const waitsOf = (command) => {
  * does not `watch` is open: what it queued while nothing was connected is delivered once and cannot be fetched again.
  * A connection opened with `listen: true` is left to its `watch` and `feed`, which save the same.
  */
-export const connected = (connection, { app, provider, name, deletedWithoutChat, pace, history, savedChatId, }, { settings, env, renderer }, events, store = lazyStore(env, app.command), { listen: watching = false, closeWaitMs = SAVES_WAIT_MS, rekeyPacing, } = {}) => {
+export const connected = (connection, { app, provider, name, deletedWithoutChat, pace, history, savedChatId, unreadCounts, }, { settings, env, renderer }, events, store = lazyStore(env, app.command), { listen: watching = false, closeWaitMs = SAVES_WAIT_MS, rekeyPacing, } = {}) => {
     const self = connection.self();
     if (self !== null)
         rememberAccount(app, settings.profile, self, env);
@@ -220,6 +220,7 @@ export const connected = (connection, { app, provider, name, deletedWithoutChat,
             rekeyed: (from, to) => rekeyRecipients(app, settings.profile, env, renderer.warn, from, to),
             recipientIds: () => (new RecipientList(recipientsPathFor(app, settings.profile, env), app.command).read() ?? []).flatMap((recipient) => [recipient.id, ...(recipient.partnerId ? [recipient.partnerId] : [])]),
             ...(history === "store" ? { namesFromStore: savedChatId ? { savedChatId } : {} } : {}),
+            ...(unreadCounts === "store" ? { countsUnread: true } : {}),
         });
     const passives = history === "store" && self !== null && !watching
         ? passivesOf(saving).map((passive) => listened(passive, events, renderer.warn, closeWaitMs))

package/dist/cli/messenger/conversation-answers.d.ts

@@ -175,6 +175,7 @@ export declare const conversationShown: (account: AccountKey, { summary, message
         } | null | undefined;
         scheduled_for?: string | undefined;
         starred?: true | undefined;
+        delivery?: "delivered" | "read" | undefined;
         email?: {
             subject: string | null;
             from: {

package/dist/cli/messenger/message-answers.d.ts

@@ -152,6 +152,7 @@ export declare const threadAnswer: ({ items, ...thread }: ThreadContext, reader:
         } | null | undefined;
         scheduled_for?: string | undefined;
         starred?: true | undefined;
+        delivery?: "delivered" | "read" | undefined;
         email?: {
             subject: string | null;
             from: {

package/dist/cli/messenger/message-items.js

@@ -59,6 +59,7 @@ export const messageItem = (message, reader) => {
         reactions: message.reactions,
         scheduled_for: message.scheduledFor,
         starred: message.starred === true ? true : undefined,
+        delivery: message.delivery,
         email: message.email === undefined
             ? undefined
             : {

package/dist/cli/messenger/message-writes.d.ts

@@ -154,6 +154,7 @@ export declare const writtenAnswer: ({ operationId, sendId, message, scheduledFo
         } | null | undefined;
         scheduled_for?: string | undefined;
         starred?: true | undefined;
+        delivery?: "delivered" | "read" | undefined;
         email?: {
             subject: string | null;
             from: {

package/dist/cli/messenger/serve-relay.d.ts

@@ -32,6 +32,7 @@ export declare const serveRelay: (command: Command, messenger: Messenger) => {
         fetching?: import("../index.js").Fetching;
         history?: "server" | "store";
         historyOnDemand?: boolean;
+        unreadCounts?: "messenger" | "store";
         serverSearch?: boolean | "chat";
         services?: import("../../services/index.js").Override;
         connection?: "exclusive";

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

@@ -39,6 +39,8 @@ export interface Saving {
      * titles `watch` leaves out, are answered from the store first. Its server has no directory to ask.
      */
     namesFromStore?: Pick<MessengerTraits, "savedChatId">;
+    /** `MessengerTraits.unreadCounts: "store"`: a message `watch` or `listen` saves raises its chat's unread count. */
+    countsUnread?: boolean;
 }
 /**
  * The adapter, with what each read answers written to the store. **A failed write never fails the
@@ -48,4 +50,4 @@ export interface Saving {
  * would erase what `chats list` stored. Nor are `chat` and `contact`: a card's member list is not
  * known to be whole, and `saveMembers` replaces the list.
  */
-export declare const stored: (messenger: MessengerAdapter, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, rekeyPacing, closing, namesFromStore, recipientIds, }: Saving) => MessengerAdapter;
+export declare const stored: (messenger: MessengerAdapter, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, rekeyPacing, closing, namesFromStore, recipientIds, countsUnread, }: Saving) => MessengerAdapter;

package/dist/cli/messenger/stored.js

@@ -1,6 +1,6 @@
 import { CliError } from "@wirecat/cli-base";
 import { capability, throughWrapper } from "../../ports/messenger.js";
-import { isId, pickPerson } from "../../resolve.js";
+import { foldName, isId, pickPerson } from "../../resolve.js";
 import { codeOf } from "../../sends/guarded.js";
 import { chatIdIn } from "../../services/message-resolution.js";
 const REKEY_PACING = { lockMs: 50, pauseMs: 25 };
@@ -12,7 +12,7 @@ const REKEY_PACING = { lockMs: 50, pauseMs: 25 };
  * would erase what `chats list` stored. Nor are `chat` and `contact`: a card's member list is not
  * known to be whole, and `saveMembers` replaces the list.
  */
-export const stored = (messenger, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, rekeyPacing = REKEY_PACING, closing, namesFromStore, recipientIds, }) => {
+export const stored = (messenger, { account, store, warn, events, pending, announcing, deletedWithoutChat, profile, rekeyed, rekeyPacing = REKEY_PACING, closing, namesFromStore, recipientIds, countsUnread = false, }) => {
     let warned = false;
     let recorded = profile === undefined;
     const notWritten = (operation, error) => {
@@ -212,8 +212,8 @@ export const stored = (messenger, { account, store, warn, events, pending, annou
             const { id, held } = namesFromStore ? await storedChat(opened, scoped, namesFromStore, reference) : {};
             if (!isId(reference)) {
                 const people = await opened.people.people(scoped.provider, { account: scoped.account });
-                const wanted = reference.trim().toLowerCase();
-                if (people.all().some((person) => person.alias?.toLowerCase().includes(wanted))) {
+                const wanted = foldName(reference.trim());
+                if (people.all().some((person) => person.alias && foldName(person.alias).includes(wanted))) {
                     const person = pickPerson(reference, people);
                     const chats = (await opened.chats.chatsWith(scoped, person.id)).filter((chat) => chat.kind === "dialog");
                     if (chats.length !== 1 || !chats[0])
@@ -318,7 +318,7 @@ export const stored = (messenger, { account, store, warn, events, pending, annou
                         await rememberTitles(store, account, titles);
                     return (messenger.watch?.((event) => {
                         const seenAt = Date.now();
-                        void save("messages.watch", (opened) => keep(opened, account, event, seenAt, deletedWithoutChat));
+                        void save("messages.watch", (opened) => keep(opened, account, event, seenAt, deletedWithoutChat, countsUnread));
                         onEvent(namesFromStore ? titled(event, titles) : event);
                     }, signal, onReady) ?? Promise.resolve());
                 },
@@ -327,7 +327,7 @@ export const stored = (messenger, { account, store, warn, events, pending, annou
         ...(messenger.listen
             ? {
                 listen: (onEvent, signal) => messenger.listen?.((event) => {
-                    void save("messages.listen", (opened) => keep(opened, account, event, Date.now(), deletedWithoutChat));
+                    void save("messages.listen", (opened) => keep(opened, account, event, Date.now(), deletedWithoutChat, countsUnread));
                     onEvent(event);
                 }, signal) ?? Promise.resolve(),
             }
@@ -517,7 +517,7 @@ const fill = async (store, account, batch) => {
         await store.people.savePeople(account, batch.people);
     const byChat = new Map();
     const of = (chatId) => {
-        const held = byChat.get(chatId) ?? { messages: [], votes: [], stars: [] };
+        const held = byChat.get(chatId) ?? { messages: [], votes: [], reactions: [], stars: [] };
         byChat.set(chatId, held);
         return held;
     };
@@ -525,10 +525,12 @@ const fill = async (store, account, batch) => {
         of(message.chatId).messages.push(message);
     for (const { chatId, messageId, vote } of batch.votes ?? [])
         of(chatId).votes.push({ messageId, vote });
+    for (const { chatId, messageId, reaction } of batch.reactions ?? [])
+        of(chatId).reactions.push({ messageId, reaction });
     for (const { chatId, messageId, starred } of batch.stars ?? [])
         of(chatId).stars.push({ messageId, starred });
-    for (const [chatId, { messages, votes, stars }] of byChat)
-        await store.messages.saveMessages(account, chatId, messages, { via: "history", votes, stars });
+    for (const [chatId, { messages, votes, reactions, stars }] of byChat)
+        await store.messages.saveMessages(account, chatId, messages, { via: "history", votes, reactions, stars });
     const changes = new Map();
     for (const { chatId, change } of batch.events ?? [])
         changes.set(chatId, [...(changes.get(chatId) ?? []), change]);
@@ -537,14 +539,18 @@ const fill = async (store, account, batch) => {
 };
 /**
  * Each change as the store keeps it: a message or an edit upserted, a deletion a tombstone, reactions replaced, a
- * voter's vote replacing their older one, a star set or taken off, a chat event kept once.
+ * voter's vote or a person's reaction replacing their older one, a star set or taken off, a chat event kept once.
  */
-const keep = async (store, account, event, seenAt, among) => {
+const keep = async (store, account, event, seenAt, among, countsUnread) => {
     switch (event.event) {
         case "message":
         case "edit": {
             const { chatTitle, ...message } = event.message;
-            await store.messages.saveMessages(account, message.chatId, [message], { via: "update", seenAt });
+            await store.messages.saveMessages(account, message.chatId, [message], {
+                via: "update",
+                seenAt,
+                ...(countsUnread && event.event === "message" ? { countUnread: true } : {}),
+            });
             return;
         }
         case "delete":
@@ -553,9 +559,15 @@ const keep = async (store, account, event, seenAt, among) => {
         case "vote":
             await store.messages.saveVote(account, event.chatId, event.messageId, event.vote);
             return;
+        case "person_reaction":
+            await store.messages.saveReaction(account, event.chatId, event.messageId, event.reaction);
+            return;
         case "star":
             await store.messages.saveStar(account, event.chatId, event.messageId, event.starred);
             return;
+        case "delivery":
+            await store.messages.saveDelivery(account, event.chatId, event.messageId, event.delivery);
+            return;
         case "chat_event":
             await store.roster.saveChatEvents(account, event.chatId, [event.change]);
             return;

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

@@ -110,8 +110,16 @@ const describe = (event, render) => {
             const choice = answers.length > 0 ? answers.join(", ") : "took it back";
             return `vote in ${event.chatTitle ?? event.chatId} on poll ${event.messageId}: ${person.name ?? person.id} — ${choice}\n`;
         }
+        case "person_reaction": {
+            const { person, reaction } = event.reaction;
+            const who = person.name ?? person.id;
+            const what = reaction === null ? "took their reaction back" : `reacted ${reaction}`;
+            return `${who} ${what} in ${event.chatTitle ?? event.chatId} on message ${event.messageId}\n`;
+        }
         case "star":
             return `${event.starred ? "starred" : "unstarred"} in ${event.chatTitle ?? event.chatId}: message ${event.messageId}\n`;
+        case "delivery":
+            return `${event.delivery} in ${event.chatTitle ?? event.chatId}: message ${event.messageId}\n`;
         case "chat_event": {
             const { event: action, by, people } = event.change;
             const who = people.map((one) => one.name ?? one.id).join(", ");

package/dist/domain/models.d.ts

@@ -33,9 +33,16 @@ export interface Chat {
     /** ISO 8601, or `null` when the chat has never had a message. */
     lastMessageAt: string | null;
     participantsCount: number | null;
-    /** Absent where the messenger does not say. */
+    /** Absent where the messenger does not say. A mute that has ended reads as `false`. */
     muted?: boolean;
+    /**
+     * ISO 8601 UTC: when the mute ends. `null` or absent with `muted` is for good. Saving a chat: absent keeps the stored
+     * end, and `muted: false` clears it.
+     */
+    mutedUntil?: string | null;
     archived?: boolean;
+    /** The owner marked the chat unread, whatever its count; absent where the messenger does not say. */
+    markedUnread?: boolean;
     /** Unread messages that mention the owner or reply to them. */
     unreadMentions?: number;
     /** Absent where the messenger does not say. */
@@ -50,7 +57,8 @@ export interface Chat {
  * A chat as an adapter saves it. A `title`, `unreadCount`, `lastMessageAt`, `participantsCount` or `membershipState`
  * left out keeps the stored value; `null` stores none. So a push that knows only some of them, such as a notice that
  * a group left its community, leaves the rest out. `membershipState: "member"` says the owner is in the chat again: it
- * takes off a "left" mark and keeps any other state, such as "archived". It is never stored.
+ * takes off a "left" mark and keeps any other state, such as "archived". It is never stored. `muted`, `mutedUntil`,
+ * `archived` and `markedUnread` left out keep the stored value too.
  */
 export type ChatUpdate = Omit<Chat, KeptFields | "membershipState"> & Partial<Pick<Chat, KeptFields>> & {
     membershipState?: MembershipState | "member" | null;
@@ -263,6 +271,19 @@ export interface Reactions {
     mine: string | null;
     total: number;
 }
+/**
+ * One person's reaction to a message, for a messenger that sends a reaction change at a time (WhatsApp) instead of
+ * totals. `reaction` is `null` when they took it back. The store keeps each person's newest by `reactedAt` and derives
+ * the message's `Reactions` from them.
+ */
+export interface PersonReaction {
+    person: Member;
+    /** The owner's own reaction, which becomes `Reactions.mine`. */
+    own: boolean;
+    reaction: string | null;
+    /** ISO 8601 — when the person reacted, as the messenger says, not when it arrived. */
+    reactedAt: string;
+}
 /** The message a reply answers or a forward carries. */
 export interface QuotedMessage {
     id: Id;
@@ -319,7 +340,15 @@ export interface Message {
      * keeps what the store holds: a fetch, an edit or another messenger's message says nothing about it.
      */
     starred?: boolean;
+    /**
+     * How far the owner's own message got in a one-to-one chat, from the messenger's receipts: `read` once the other
+     * person opened it. Absent when no receipt came. On a save, absent keeps what the store holds, and a state never
+     * moves back: a late `delivered` after `read` changes nothing.
+     */
+    delivery?: Delivery;
 }
+/** `delivered` reached the other person's phone; `read` they opened it (a voice note or view-once file played counts). */
+export type Delivery = "delivered" | "read";
 /**
  * A message found by searching, carrying the chat's name as well as its id: a search spans every
  * chat, so an answer that named only the id would make the reader look each one up.
@@ -384,6 +413,14 @@ export interface PollVoteEvent {
     messageId: Id;
     vote: PollVote;
 }
+/** One person reacted to `messageId`, changed their reaction, or took it back; saved, an older one never wins. */
+export interface PersonReactionEvent {
+    event: "person_reaction";
+    chatId: Id;
+    chatTitle: string | null;
+    messageId: Id;
+    reaction: PersonReaction;
+}
 /** The owner starred a message or took the star off, here or on another device; saved, the same twice is one. */
 export interface MessageStarEvent {
     event: "star";
@@ -392,6 +429,16 @@ export interface MessageStarEvent {
     messageId: Id;
     starred: boolean;
 }
+/** A receipt for the owner's own message in a one-to-one chat; saved, it never moves the stored state back. */
+export interface MessageDeliveryEvent {
+    event: "delivery";
+    chatId: Id;
+    chatTitle: string | null;
+    messageId: Id;
+    delivery: Delivery;
+    /** ISO 8601 — when the receipt says it happened. */
+    at: string;
+}
 /** Who joined, left, was added, removed, promoted or demoted, or a new title, as it happens; saved for `chats events`. */
 export interface ChatEventNotice {
     event: "chat_event";
@@ -399,13 +446,14 @@ export interface ChatEventNotice {
     chatTitle: string | null;
     change: ChatEvent;
 }
-/** What a listening connection reports: a new message, a change to one, a vote, a star, or a change to a chat. */
+/** What a listening connection reports: a message, a change to one, a vote, a reaction, a star, a receipt, a chat change. */
 export type MessageEvent = {
     event: "message";
     message: MessageHit;
-} | MessageChange | PollVoteEvent | MessageStarEvent | ChatEventNotice;
+} | MessageChange | PollVoteEvent | PersonReactionEvent | MessageStarEvent | MessageDeliveryEvent | ChatEventNotice;
 /** One chat's share of `inbox`: other people's messages since the last check, oldest first. */
 export interface InboxChat extends Pick<Chat, "id" | "title" | "kind" | "unreadCount"> {
+    /** A chat marked unread with nothing counted: its newest message from someone else. */
     messages: Message[];
     /** There are more than `--limit`; these are the newest of them. */
     more: boolean;

package/dist/entities/chat.d.ts

@@ -11,7 +11,11 @@ export declare const chat: v.StrictObjectSchema<{
     readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** When the mute ends; absent with `muted` true is for good. */
+    readonly muted_until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
     readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** The owner marked it unread, whatever `unread_count` says. */
+    readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
     readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
     readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;

package/dist/entities/chat.js

@@ -14,7 +14,11 @@ export const chat = v.strictObject({
     last_message_at: v.nullable(time),
     participants_count: v.nullable(count),
     muted: v.optional(v.boolean()),
+    /** When the mute ends; absent with `muted` true is for good. */
+    muted_until: v.optional(time),
     archived: v.optional(v.boolean()),
+    /** The owner marked it unread, whatever `unread_count` says. */
+    marked_unread: v.optional(v.boolean()),
     membership_state: v.optional(v.picklist(["joined", "left", "public", "imported", "archived", "external"])),
     parent_chat_id: v.optional(id),
     scope: v.optional(v.picklist(["personal", "work"])),

package/dist/entities/contact.d.ts

@@ -24,7 +24,9 @@ export declare const contact: v.StrictObjectSchema<{
         readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly muted_until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
         readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
         readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;
@@ -72,7 +74,9 @@ export declare const contact: v.StrictObjectSchema<{
             readonly last_message_at: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly participants_count: v.NullableSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
             readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly muted_until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            readonly marked_unread: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly membership_state: v.OptionalSchema<v.PicklistSchema<["joined", "left", "public", "imported", "archived", "external"], undefined>, undefined>;
             readonly parent_chat_id: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>, undefined>;
             readonly scope: v.OptionalSchema<v.PicklistSchema<["personal", "work"], undefined>, undefined>;

package/dist/entities/evidence.d.ts

@@ -142,6 +142,7 @@ export declare const contribution: v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -322,6 +323,7 @@ export declare const contribution: v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -540,6 +542,7 @@ export declare const contribution: v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -720,6 +723,7 @@ export declare const contribution: v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -974,6 +978,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1154,6 +1159,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1372,6 +1378,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
         }, undefined>, undefined>, undefined>;
         readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
         readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
         readonly email: v.OptionalSchema<v.StrictObjectSchema<{
             readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from: v.NullableSchema<v.StrictObjectSchema<{
@@ -1552,6 +1559,7 @@ export declare const evidence: v.UnionSchema<[v.StrictObjectSchema<{
             }, undefined>, undefined>, undefined>;
             readonly scheduled_for: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, "an ISO 8601 time in UTC">, v.EndsWithAction<string, "Z", "an ISO 8601 time in UTC, ending in `Z`">]>, undefined>;
             readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly delivery: v.OptionalSchema<v.PicklistSchema<["delivered", "read"], undefined>, undefined>;
             readonly email: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly subject: v.NullableSchema<v.StringSchema<undefined>, undefined>;
                 readonly from: v.NullableSchema<v.StrictObjectSchema<{