@wirecat/cli-core 0.475.0 → 0.477.0

package/CHANGELOG.md

@@ -5,7 +5,46 @@ 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.477.0 — 29.10.2026
+
+### Added
+
+- **A shared contact card is an attachment with a `contact` field** (store version 36). `Attachment.contact`
+  (`SharedContact`: `name`, `firstName?`, `lastName?`, `phone?`, `userId?`) and, in every message answer,
+  `attachments[].contact` (`name`, `first_name?`, `last_name?`, `phone?`, `user_id?`), the phone whole. The store keeps it in
+  the new column `attachments.contact`, so a card read with `--offline` is the card the messenger sent; a later copy of the
+  message without it keeps the stored one. The terminal shows `👤 name · phone`. Additive: `minCompatible` stays 34.
+  What an adapter does: set `contact` on the attachment instead of putting a masked phone in `title`.
+- **`--hide-phone`** on `account show`, `account update` and `contacts show`: the answer without the phone number.
+- **`reactions list <chat> <message> [reaction:<emoji>] [--limit <n>] [--cursor <cursor>]`** (read) shows who reacted
+  to a message, newest first, as `{ person: { id, name, username }, reaction, reacted_at }` rows paged by cursor. A
+  messenger turns it on with `Messenger.reactionsList` and `MessageReactions.reactors`; where the chat hides the list
+  it refuses with `reactions.list-hidden` (or `reactions.broadcast` for a channel) instead of answering with none. The
+  permission key is `reactions.list`. New entity `reaction`, new type `Reactor`.
+
+### Changed — may break callers
+
+- **Phone numbers are shown whole.** `account show`, `account update` and `contacts show` print the number the messenger
+  gave, in the CLI and over MCP; they are the owner's own data. `--show-phone` is gone (a script that passes it is refused
+  as an unknown option; drop it), and so is `maskedAccount` from `/cli`: `withoutPhone(answer)` is what `--hide-phone` uses.
+- **`contacts info` is folded into `contacts show`, with no alias.** `contacts show <person>` returns the card as before (alias,
+  shared chats, `--with-notes`) and, with it, the messenger's profile: `usernames`, `birthday`, `phone`, `flags`, `seen`,
+  `contact`, `mutual_contact`, `common_chats_count`, `registered`, `has_photo` and `aliases` (earlier names), and in each shared
+  chat `their_messages`, `first_at`, `last_at` and `complete`. The profile's `bio` is `description`. `--offline` answers from
+  the store alone, as every read does. The entity `contact_profile` and the MCP tool `contacts info` are gone, and `PeopleService.profile`
+  takes the card as an optional second argument. Permission keys are read only as written (0.421.0): a saved
+  `contacts.info` is refused as a key no command checks, with the `config unset` that removes it; `contacts.show` now covers
+  the profile too.
+
+## 0.476.0 — 29.10.2026
+
+### Fixed
+
+- **A sign-in that cannot be read says why under `--debug` and in the run record.** `credentialStorage` threw
+  `configuration_error` (`oauth.not-saved`, "could not reach the saved sign-in") and dropped the keyring's own error,
+  so a locked keyring, a missing Secret Service and an unreachable D-Bus looked the same. The keyring's message is now
+  the error's `cause`: `--debug` and `runs show` print it, the JSON answer still does not. A secret the keyring echoes
+  back on a failed write is masked first.
 
 ## 0.475.0 — 29.10.2026
 

package/dist/calendar/mcp/index.d.ts

@@ -10,13 +10,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
-            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -38,9 +38,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -50,9 +50,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };
@@ -71,13 +71,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
-            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -99,9 +99,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -111,9 +111,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };
@@ -132,13 +132,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
-            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -160,9 +160,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -172,9 +172,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };
@@ -193,13 +193,13 @@ export declare const calendarTools: ({
     inputSchema: {
         type: string;
         properties: {
-            limit?: undefined;
             account_id: {
                 type: string;
                 minimum: number;
             };
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
         } | {
             account_id: {
@@ -221,9 +221,9 @@ export declare const calendarTools: ({
             };
             event?: undefined;
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event: {
                 type: string;
                 minLength: number;
@@ -233,9 +233,9 @@ export declare const calendarTools: ({
                 minimum: number;
             };
         } | {
-            limit?: undefined;
             words?: undefined;
             timezone?: undefined;
+            limit?: undefined;
             event?: undefined;
             account_id?: undefined;
         };

package/dist/cli/index.d.ts

@@ -33,7 +33,7 @@ export { guardedClose, guardedCreatePoll, guardedVote } from "../sends/polls.js"
 export type { InboxReader } from "../services/inbox.js";
 export { INBOX_CHATS, newIn, REVIEW_CHATS, reviewIn, unreadIn } from "../services/inbox.js";
 export { type DateWindow, dateWindow, momentOf } from "../services/moment.js";
-export { maskedAccount } from "../services/people.js";
+export { withoutPhone } from "../services/people.js";
 export { unanswered } from "../services/questions.js";
 export { openRequestTask } from "../services/task-rules.js";
 export { TASK_PAIR_QUERY, TASK_QUERY } from "../services/tasks.js";

package/dist/cli/index.js

@@ -28,7 +28,7 @@ export { guardedApp, guardedPress, guardedStart } from "../sends/buttons.js";
 export { guardedClose, guardedCreatePoll, guardedVote } from "../sends/polls.js";
 export { INBOX_CHATS, newIn, REVIEW_CHATS, reviewIn, unreadIn } from "../services/inbox.js";
 export { dateWindow, momentOf } from "../services/moment.js";
-export { maskedAccount } from "../services/people.js";
+export { withoutPhone } from "../services/people.js";
 export { unanswered } from "../services/questions.js";
 export { openRequestTask } from "../services/task-rules.js";
 export { TASK_PAIR_QUERY, TASK_QUERY } from "../services/tasks.js";

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

@@ -1,7 +1,7 @@
 import { existsSync } from "node:fs";
 import { annotate } from "@wirecat/cli-base/commands";
 import { Command } from "commander";
-import { maskedAccount } from "../../services/people.js";
+import { withoutPhone } from "../../services/people.js";
 import { storePath } from "../../store/path.js";
 import { openStore } from "../../store/store.js";
 import { REMOTE_READ, REMOTE_WRITE } from "../effects.js";
@@ -61,13 +61,13 @@ export const accountCommand = (messenger) => {
         output: { entity: "account" },
         examples: [`${tool} account show`],
     })
-        .description("who this profile is logged in as; the phone number shows its last four digits")
-        .option("--show-phone", "print the whole phone number")
+        .description("who this profile is logged in as, with the phone number")
+        .option("--hide-phone", "leave the phone number out")
         .action(async function () {
-        const whole = this.opts().showPhone === true;
+        const hide = this.opts().hidePhone === true;
         const context = messengerContext(this, messenger);
         const account = await context.withMessenger((connection) => connection.me());
-        renderAnswer(this, context, itemOf(accountAnswer(messenger.provider, whole ? account : maskedAccount(account))));
+        renderAnswer(this, context, itemOf(accountAnswer(messenger.provider, hide ? withoutPhone(account) : account)));
     }))
         .addCommand(annotate(new Command("update"), {
         effects: REMOTE_WRITE,
@@ -79,16 +79,18 @@ export const accountCommand = (messenger) => {
         .option("--last-name <name>", "your last name")
         .option("--description <text>", "about you")
         .option("--photo <file>", `a new profile photo — ${photoHelp(messenger)}`)
+        .option("--hide-phone", "leave the phone number out of the answer")
         .action(async function () {
         const context = messengerContext(this, messenger);
-        const { firstName, lastName, description, photo } = this.opts();
+        const { firstName, lastName, description, photo, hidePhone } = this.opts();
         const upload = photo === undefined ? undefined : await readProfilePhoto(messenger, photo, context.env);
-        renderItem(this, context, await context.withServices((services) => services.account.update({
+        const changed = await context.withServices((services) => services.account.update({
             ...(firstName === undefined ? {} : { firstName }),
             ...(lastName === undefined ? {} : { lastName }),
             ...(description === undefined ? {} : { description }),
             ...(upload === undefined ? {} : { photo: upload }),
-        })));
+        }));
+        renderItem(this, context, hidePhone ? { ...changed, account: withoutPhone(changed.account) } : changed);
     }))
         .addCommand(accountSessionsCommand(messenger));
     if (messenger.privacy === true)

package/dist/cli/messenger/catch-up-answers.d.ts

@@ -43,6 +43,13 @@ export declare const inboxAnswer: (inbox: Inbox, hearing: Hearing | undefined, r
             error?: string | undefined;
         } | undefined;
         local_path?: string | undefined;
+        contact?: {
+            name: string;
+            first_name?: string | undefined;
+            last_name?: string | undefined;
+            phone?: string | undefined;
+            user_id?: string | undefined;
+        } | undefined;
         buttons?: {
             kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
             text: string;
@@ -90,6 +97,13 @@ export declare const reviewAnswer: (found: Review, hearing: Hearing | undefined,
             error?: string | undefined;
         } | undefined;
         local_path?: string | undefined;
+        contact?: {
+            name: string;
+            first_name?: string | undefined;
+            last_name?: string | undefined;
+            phone?: string | undefined;
+            user_id?: string | undefined;
+        } | undefined;
         buttons?: {
             kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
             text: string;

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

@@ -2,8 +2,8 @@ import { type QueryAst } from "@wirecat/cli-base/query";
 import type { NextStep } from "@wirecat/cli-base/standards";
 import type { Command } from "commander";
 import type * as v from "valibot";
-import type { Account, AccountSession, Chat, ChatCard, ChatEvent, Contact, Folder, GroupCard, GroupMember, InviteLink, JoinRequest, Member, PersonCard, PollVote, Topic } from "../../domain/models.js";
-import type { account as accountSchema, chatEvent as chatEventSchema, chat as chatSchema, contact as contactSchema, folder as folderSchema, inviteLink as inviteLinkSchema, joinRequest as joinRequestSchema, member as memberSchema, pollVote as pollVoteSchema, topic as topicSchema } from "../../entities/index.js";
+import type { Account, AccountSession, Chat, ChatCard, ChatEvent, Contact, Folder, GroupCard, GroupMember, InviteLink, JoinRequest, Member, PersonCard, PersonProfile, PollVote, Reactor, Topic } from "../../domain/models.js";
+import type { account as accountSchema, chatEvent as chatEventSchema, chat as chatSchema, contact as contactSchema, folder as folderSchema, inviteLink as inviteLinkSchema, joinRequest as joinRequestSchema, member as memberSchema, pollVote as pollVoteSchema, reaction as reactionSchema, topic as topicSchema } from "../../entities/index.js";
 import type { ChatDocument } from "../../services/chat-documents.js";
 import type { FolderShown } from "../../services/folders.js";
 import type { MemberEvent } from "../../services/member-history.js";
@@ -21,11 +21,17 @@ export declare const chatAnswer: (account: AccountKey, chat: ShownChat) => Out<t
 export declare const memberAnswer: (member: Member | GroupMember | AuditedMember) => Out<typeof memberSchema>;
 export declare const contactRef: (provider: string, id: string) => string;
 export declare const contactAnswer: (account: AccountKey, contact: Contact | PersonCard) => Out<typeof contactSchema>;
+/**
+ * `contacts show`: the card (the owner's alias and notes, the chats shared) with what the messenger says about the
+ * person, and in each shared chat how much of their writing the store holds.
+ */
+export declare const contactShown: (account: AccountKey, card: PersonCard, profile: PersonProfile) => Out<typeof contactSchema>;
 export declare const chatEventAnswer: (chatId: string, event: ChatEvent) => Out<typeof chatEventSchema>;
 export declare const memberEventAnswer: (chatId: string, event: MemberEvent) => Out<typeof chatEventSchema>;
 export declare const inviteLinkAnswer: (link: InviteLink) => Out<typeof inviteLinkSchema>;
 export declare const joinRequestAnswer: (request: JoinRequest) => Out<typeof joinRequestSchema>;
 export declare const pollVoteAnswer: (vote: PollVote) => Out<typeof pollVoteSchema>;
+export declare const reactorAnswer: (reactor: Reactor) => Out<typeof reactionSchema>;
 export declare const topicAnswer: (topic: Topic) => Out<typeof topicSchema>;
 export declare const folderAnswer: (folder: Folder | FolderShown) => Out<typeof folderSchema>;
 /** A person's view of a list: one line per item. */

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

@@ -88,6 +88,44 @@ export const contactAnswer = (account, contact) => {
         })),
     });
 };
+/**
+ * `contacts show`: the card (the owner's alias and notes, the chats shared) with what the messenger says about the
+ * person, and in each shared chat how much of their writing the store holds.
+ */
+export const contactShown = (account, card, profile) => {
+    const { id: _id, name: _name, bio, chats, ...facts } = profile;
+    const listed = new Map(card.chats.map((chat) => [chat.id, chat]));
+    const active = new Set(chats.map(({ id }) => id));
+    const shared = [
+        ...chats.map((chat) => ({
+            ref: chatRef(account, chat.id),
+            id: chat.id,
+            title: chat.title,
+            kind: chat.kind,
+            last_message_at: listed.get(chat.id)?.lastMessageAt ?? chat.lastAt,
+            their_messages: chat.theirMessages,
+            first_at: chat.firstAt,
+            last_at: chat.lastAt,
+            complete: chat.complete,
+        })),
+        ...card.chats
+            .filter(({ id }) => !active.has(id))
+            .map((chat) => ({
+            ref: chatRef(account, chat.id),
+            id: chat.id,
+            title: chat.title,
+            kind: chat.kind,
+            last_message_at: chat.lastMessageAt,
+        })),
+    ];
+    const answer = contactAnswer(account, card);
+    return {
+        ...answer,
+        ...snakeKeys(facts),
+        description: answer.description ?? bio,
+        chats: shared,
+    };
+};
 export const chatEventAnswer = (chatId, event) => defined({
     chat_id: chatId,
     time: event.timestamp,
@@ -130,6 +168,11 @@ export const pollVoteAnswer = (vote) => ({
     answers: vote.answers,
     voted_at: vote.votedAt,
 });
+export const reactorAnswer = (reactor) => ({
+    person: { id: reactor.person.id, name: reactor.person.name, username: reactor.person.username },
+    reaction: reactor.reaction,
+    reacted_at: reactor.reactedAt,
+});
 export const topicAnswer = (topic) => defined({
     id: topic.id,
     title: topic.title,

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

@@ -7,7 +7,7 @@ import { secretInput } from "../../runs/run-context.js";
 import { levelFor } from "../../sends/permissions.js";
 import { phoneOf } from "../../services/index.js";
 import { dateWindow } from "../../services/moment.js";
-import { maskedAccount } from "../../services/people.js";
+import { withoutPhone } from "../../services/people.js";
 import { CHAT_MESSAGES, CONTEXT_BYTES, CONTEXT_MESSAGES } from "../../services/person-context.js";
 import { SCOPES, TIMELINE_ITEMS } from "../../services/person-timeline.js";
 import { readSecret } from "../../terminal/prompt.js";
@@ -19,7 +19,7 @@ import { positiveCount, window, withPaging } from "../paging.js";
 import { casKey } from "../registry-keys.js";
 import { commandAt, nextStep } from "../steps.js";
 import { contactWriteCommands } from "./admin-contacts-command.js";
-import { contactAnswer, lines, pageOf } from "./chat-answers.js";
+import { contactAnswer, contactShown, lines, pageOf } from "./chat-answers.js";
 import { messengerContext } from "./context.js";
 import { hideNever } from "./lacks.js";
 import { CONTACTS_QUERY, notesAllowed } from "./people-queries.js";
@@ -71,37 +71,32 @@ export const contactsCommand = (messenger) => {
         }), lines(({ id, name, username, last_messaged_at }) => [id, name ?? "", username ? `@${username}` : "", last_messaged_at ?? ""].join("  ")));
     }));
     contacts.addCommand(annotate(annotate(new Command("show"), { effects: REMOTE_READ })
-        .description("one person and the chats you share with them")
+        .summary("one person's profile, your alias and notes, and the chats you share")
+        .description("one person: what the messenger says about them — handles, flags, last seen, phone, when they registered — " +
+        "your alias, the chats you share, how many of their messages the store holds in each, and the earlier " +
+        "names and usernames the store saw them with; --offline answers from the store alone")
         .argument("<person>", "their id, @username, or part of their name")
-        .option("--with-notes", "include your private notes, subject to contacts.notes.list permission"), { output: { entity: "contact" } }).action(async function (person) {
+        .option("--with-notes", "include your private notes, subject to contacts.notes.list permission")
+        .option("--hide-phone", "leave the phone number out"), { output: { entity: "contact" } }).action(async function (person) {
         const context = messengerContext(this, messenger);
-        const { withNotes } = this.opts();
+        const { withNotes, hidePhone } = this.opts();
         if (withNotes && levelFor(context.settings.permissions, "contacts.notes.list").level === "deny")
             throw new CliError("permission_error", "profile denies contacts.notes.list");
-        const { card, account } = await context.withServices(async (services) => ({
-            card: await services.people.show(person, { notes: withNotes }),
-            account: await services.chats.account(),
-        }));
-        renderAnswer(this, context, itemOf(contactAnswer(account, card)));
-    }));
-    annotate(contacts.command("info"), { effects: REMOTE_READ, output: { entity: "contact_profile" } })
-        .summary("a person's profile from the messenger")
-        .description("everything the messenger says about one person — handles, flags, last seen, when they registered — and " +
-        "how many of their messages the store holds in each chat you share, the first and the last, and the " +
-        "earlier names and usernames the store saw them with")
-        .argument("<person>", "their id, @username, or part of their name")
-        .option("--show-phone", "print the whole phone number")
-        .action(async function (person) {
-        const whole = this.opts().showPhone === true;
-        const context = messengerContext(this, messenger);
-        const found = await context.withServices((services) => services.people.profile(person));
-        const partial = found.chats.filter(({ complete }) => !complete);
-        renderAnswer(this, context, itemOf(snakeKeys(whole ? found : maskedAccount(found)), {
+        const { card, profile, account } = await context.withServices(async (services) => {
+            const card = await services.people.show(person, { notes: withNotes });
+            return {
+                card,
+                profile: await services.people.profile(person, card),
+                account: await services.chats.account(),
+            };
+        });
+        const partial = profile.chats.filter(({ complete }) => !complete);
+        renderAnswer(this, context, itemOf(contactShown(account, card, hidePhone ? withoutPhone(profile) : profile), {
             next: syncsFirst(messenger)
                 ? partial.map((one) => nextStep("messages.sync", { args: { chat: one.id } }))
                 : [],
         }));
-    });
+    }));
     const contextCommand = annotate(contacts.command("context"), {
         effects: REMOTE_READ,
         output: { entity: "contact_context" },

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

@@ -80,6 +80,8 @@ export interface Messenger extends ServiceMessenger {
     pollQuiz?: boolean;
     /** How many seconds after sending a poll may close by itself — `polls create --close-time`; none when unset. */
     pollCloseSeconds?: readonly [min: number, max: number];
+    /** Whether `reactions list` shows who reacted to a message; no when unset. */
+    reactionsList?: boolean;
     /** Whether `polls voters` lists who voted for what; no when unset. */
     pollVoters?: boolean;
     /** Whether a poll can be closed — `polls close`; yes when unset. WhatsApp's stay open. */

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

@@ -96,6 +96,13 @@ export declare const conversationShown: (account: AccountKey, { summary, message
                 error?: string | undefined;
             } | undefined;
             local_path?: string | undefined;
+            contact?: {
+                name: string;
+                first_name?: string | undefined;
+                last_name?: string | undefined;
+                phone?: string | undefined;
+                user_id?: string | undefined;
+            } | undefined;
             buttons?: {
                 kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                 text: string;
@@ -128,6 +135,13 @@ export declare const conversationShown: (account: AccountKey, { summary, message
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -163,6 +177,13 @@ export declare const conversationShown: (account: AccountKey, { summary, message
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;

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

@@ -73,6 +73,13 @@ export declare const threadAnswer: ({ items, ...thread }: ThreadContext, reader:
                 error?: string | undefined;
             } | undefined;
             local_path?: string | undefined;
+            contact?: {
+                name: string;
+                first_name?: string | undefined;
+                last_name?: string | undefined;
+                phone?: string | undefined;
+                user_id?: string | undefined;
+            } | undefined;
             buttons?: {
                 kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                 text: string;
@@ -105,6 +112,13 @@ export declare const threadAnswer: ({ items, ...thread }: ThreadContext, reader:
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -140,6 +154,13 @@ export declare const threadAnswer: ({ items, ...thread }: ThreadContext, reader:
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;

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

@@ -11,6 +11,14 @@ const attachmentItem = (attachment) => defined({
     width: attachment.width,
     height: attachment.height,
     duration: attachment.duration,
+    contact: attachment.contact &&
+        defined({
+            name: attachment.contact.name,
+            first_name: attachment.contact.firstName,
+            last_name: attachment.contact.lastName,
+            phone: attachment.contact.phone,
+            user_id: attachment.contact.userId,
+        }),
     buttons: attachment.buttons,
 });
 const quotedItem = (quoted) => quoted === null

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

@@ -77,6 +77,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                 error?: string | undefined;
             } | undefined;
             local_path?: string | undefined;
+            contact?: {
+                name: string;
+                first_name?: string | undefined;
+                last_name?: string | undefined;
+                phone?: string | undefined;
+                user_id?: string | undefined;
+            } | undefined;
             buttons?: {
                 kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                 text: string;
@@ -109,6 +116,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -144,6 +158,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -268,6 +289,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                 error?: string | undefined;
             } | undefined;
             local_path?: string | undefined;
+            contact?: {
+                name: string;
+                first_name?: string | undefined;
+                last_name?: string | undefined;
+                phone?: string | undefined;
+                user_id?: string | undefined;
+            } | undefined;
             buttons?: {
                 kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                 text: string;
@@ -300,6 +328,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;
@@ -335,6 +370,13 @@ export declare const writtenAnswer: ({ operationId, sendId, message, messages, s
                     error?: string | undefined;
                 } | undefined;
                 local_path?: string | undefined;
+                contact?: {
+                    name: string;
+                    first_name?: string | undefined;
+                    last_name?: string | undefined;
+                    phone?: string | undefined;
+                    user_id?: string | undefined;
+                } | undefined;
                 buttons?: {
                     kind: "app" | "callback" | "chat" | "clipboard" | "contact" | "link" | "location" | "message" | "other";
                     text: string;

package/dist/cli/messenger/people-queries.d.ts

@@ -9,3 +9,5 @@ export declare const CONTACTS_QUERY: QueryRegistry;
 export declare const notesAllowed: (permissions: Parameters<typeof levelFor>[0], notes: Predicate | undefined) => void;
 /** The messenger keeps the voters of one answer; one answer id at a time. */
 export declare const VOTERS_QUERY: QueryRegistry;
+/** Telegram keeps the people who chose one reaction; one emoji at a time. */
+export declare const REACTORS_QUERY: QueryRegistry;