@wirecat/whatsapp-cli 0.1.0 → 0.2.0

package/dist/engine/contract.d.ts

@@ -1,5 +1,8 @@
 import * as v from "valibot";
+import type { ChannelEngine } from "./channels.js";
 import type { GroupEngine } from "./groups.js";
+import type { PrivacyEngine } from "./privacy.js";
+import type { SettingsEngine } from "./settings.js";
 /**
  * What the engine and the adapter say to each other, in WhatsApp's own terms. The Go engine speaks it as JSON
  * lines; `FakeEngine` speaks it in memory. Bump `PROTOCOL` on any change an older peer would misread — the
@@ -10,16 +13,94 @@ import type { GroupEngine } from "./groups.js";
  * emits a chat (cli-private plans/2026-10-16-whatsapp-foundation.md, decision 3). Names are what the address book or the
  * person set; a phone number is never a name.
  */
-export declare const PROTOCOL = 10;
+export declare const PROTOCOL = 41;
+/**
+ * Every request the engine answers. A write changes something on WhatsApp or sends something: cut by a dropped
+ * connection or the engine's end, it may have gone through, so it answers `outcome_unknown`, never a retryable error
+ * (WC-LIFE-9). The engine's `writes` (engine/cmd/wa-engine/errors.go) must name the same writes; its tests check
+ * that and that it dispatches exactly these ops.
+ */
+export declare const ENGINE_OPS: {
+    readonly send: "write";
+    readonly sendMedia: "write";
+    readonly sendAlbum: "write";
+    readonly forward: "write";
+    readonly edit: "write";
+    readonly revoke: "write";
+    readonly react: "write";
+    readonly read: "write";
+    readonly createPoll: "write";
+    readonly vote: "write";
+    readonly pin: "write";
+    readonly unpin: "write";
+    readonly createGroup: "write";
+    readonly join: "write";
+    readonly leave: "write";
+    readonly updateGroup: "write";
+    readonly setGroupPhoto: "write";
+    readonly resetLink: "write";
+    readonly participants: "write";
+    readonly answerRequest: "write";
+    readonly block: "write";
+    readonly setPrivacy: "write";
+    readonly mute: "write";
+    readonly updateProfile: "write";
+    readonly deleteChat: "write";
+    readonly clearChat: "write";
+    readonly deleteForMe: "write";
+    readonly star: "write";
+    readonly archiveChat: "write";
+    readonly unarchiveChat: "write";
+    readonly pinChat: "write";
+    readonly unpinChat: "write";
+    readonly markChatRead: "write";
+    readonly markChatUnread: "write";
+    readonly followChannel: "write";
+    readonly unfollowChannel: "write";
+    readonly logout: "write";
+    readonly connect: "read";
+    readonly close: "read";
+    readonly link: "read";
+    readonly me: "read";
+    readonly directory: "read";
+    readonly chat: "read";
+    readonly download: "read";
+    readonly older: "read";
+    readonly group: "read";
+    readonly requests: "read";
+    readonly profile: "read";
+    readonly lookup: "read";
+    readonly contacts: "read";
+    readonly privacy: "read";
+    readonly channel: "read";
+    readonly channelMessages: "read";
+    readonly storedChats: "read";
+    readonly canonicalChat: "read";
+};
+export type EngineOp = keyof typeof ENGINE_OPS;
+export declare const isWrite: (op: EngineOp) => boolean;
 export declare const waChat: v.StrictObjectSchema<{
     readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
-    readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    /**
+     * `unread` and `lastMessageAt` are absent when the source does not say. Only a notice, such as a group leaving its
+     * community, leaves out `name` and `participants`: a pushed chat keeps the stored value of whatever is absent.
+     */
+    readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
     readonly kind: v.PicklistSchema<["dm", "self", "group", "newsletter", "broadcast"], undefined>;
-    readonly unread: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
-    readonly lastMessageAt: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>;
-    readonly participants: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+    readonly unread: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+    readonly lastMessageAt: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>, undefined>;
+    readonly participants: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
     readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
     readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    /** The community a group is linked to; `null` when a live read says it is in none, absent when nothing said. */
+    readonly parent: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>, undefined>;
+    /** A community itself: a group that holds other groups. */
+    readonly community: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    /**
+     * `left` when WhatsApp said the owner left the group or was removed, `member` when it said the owner was added back;
+     * never `null`, which clears `archived` too.
+     */
+    readonly membershipState: v.OptionalSchema<v.PicklistSchema<["left", "member"], undefined>, undefined>;
 }, undefined>;
 export declare const waContact: v.StrictObjectSchema<{
     readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
@@ -35,10 +116,43 @@ export declare const waMediaRef: v.StrictObjectSchema<{
     readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+}, undefined>;
+/**
+ * A download's answer: the new path when the phone had to upload the file again, `null` when WhatsApp still kept it.
+ * The key stays that of the stored ref; the checksums come too when the phone encrypted the file again.
+ */
+export declare const waDownloaded: v.NullableSchema<v.StrictObjectSchema<{
+    readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+    readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>, undefined>;
+/** A place as its message carried it, kept so a forward sends it again; `geo:` in `url` rounds the coordinates. */
+export declare const waPlaceRef: v.StrictObjectSchema<{
+    readonly place: v.StrictObjectSchema<{
+        readonly latitude: v.NumberSchema<undefined>;
+        readonly longitude: v.NumberSchema<undefined>;
+        readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+}, undefined>;
+/**
+ * A contact card as its message carried it, kept so a forward sends it again. The vCard holds a phone number: it
+ * stays in the opaque `providerRef`, which cli-core never prints, and never reaches a log or an error.
+ */
+export declare const waCardRef: v.StrictObjectSchema<{
+    readonly card: v.StrictObjectSchema<{
+        readonly name: v.StringSchema<undefined>;
+        readonly vcard: v.StringSchema<undefined>;
+    }, undefined>;
 }, undefined>;
 /**
  * cli-core's Attachment in WhatsApp's terms: `photo`, `video`, `voice`, `audio`, `document`, `sticker`, `location`
- * (`url` is a `geo:` link), `contact` (its name only — the card holds a phone number). `ref` only for a file.
+ * (`url` is a `geo:` link), `contact` (its name; the card itself only in `ref`). `ref` is a file's keys, or what a
+ * place or a contact card needs to be sent again; a live location has none.
  */
 export declare const waAttachment: v.StrictObjectSchema<{
     readonly kind: v.PicklistSchema<["photo", "video", "voice", "audio", "document", "sticker", "location", "contact"], undefined>;
@@ -50,13 +164,29 @@ export declare const waAttachment: v.StrictObjectSchema<{
     readonly size: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-    readonly ref: v.OptionalSchema<v.StrictObjectSchema<{
+    readonly ref: v.OptionalSchema<v.UnionSchema<[v.StrictObjectSchema<{
         readonly media: v.PicklistSchema<["image", "video", "audio", "document", "sticker"], undefined>;
         readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
         readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-    }, undefined>, undefined>;
+        /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+        readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    }, undefined>, v.StrictObjectSchema<{
+        readonly place: v.StrictObjectSchema<{
+            readonly latitude: v.NumberSchema<undefined>;
+            readonly longitude: v.NumberSchema<undefined>;
+            readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>;
+    }, undefined>, v.StrictObjectSchema<{
+        readonly card: v.StrictObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly vcard: v.StringSchema<undefined>;
+        }, undefined>;
+    }, undefined>], undefined>, undefined>;
 }, undefined>;
 /**
  * A poll as its message carries it. An answer's `id` is the start of the SHA-256 of its text, which is what a vote
@@ -91,13 +221,29 @@ export declare const waMessage: v.StrictObjectSchema<{
         readonly size: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-        readonly ref: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly ref: v.OptionalSchema<v.UnionSchema<[v.StrictObjectSchema<{
             readonly media: v.PicklistSchema<["image", "video", "audio", "document", "sticker"], undefined>;
             readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
             readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-        }, undefined>, undefined>;
+            /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+            readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        }, undefined>, v.StrictObjectSchema<{
+            readonly place: v.StrictObjectSchema<{
+                readonly latitude: v.NumberSchema<undefined>;
+                readonly longitude: v.NumberSchema<undefined>;
+                readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>;
+        }, undefined>, v.StrictObjectSchema<{
+            readonly card: v.StrictObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly vcard: v.StringSchema<undefined>;
+            }, undefined>;
+        }, undefined>], undefined>, undefined>;
     }, undefined>, undefined>, undefined>;
     readonly poll: v.OptionalSchema<v.StrictObjectSchema<{
         readonly question: v.StringSchema<undefined>;
@@ -107,6 +253,10 @@ export declare const waMessage: v.StrictObjectSchema<{
         }, undefined>, undefined>;
         readonly multiple: v.BooleanSchema<undefined>;
     }, undefined>, undefined>;
+    /** Only ever `true`, on a pushed message the owner starred: a push may be older than a star taken off since. */
+    readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    /** A channel post's number on WhatsApp's servers: a channel's history is read back from it. */
+    readonly serverId: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
 }, undefined>;
 /**
  * One person's newest choice in a poll: `selected` is the full SHA-256 of each chosen answer's text, and none takes
@@ -130,21 +280,63 @@ export declare const waVote: v.StrictObjectSchema<{
         readonly multiple: v.BooleanSchema<undefined>;
     }, undefined>, undefined>;
 }, undefined>;
+/**
+ * A one-to-one chat the engine emitted before in phone form (`from`), now named by its person's LID (`to`). The store
+ * moves the old chat to the new id before anything under the new id lands. The engine repeats a re-key for a while,
+ * since the CLI may not have been listening; a repeat changes nothing.
+ */
+export declare const waRekey: v.StrictObjectSchema<{
+    readonly from: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly to: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+}, undefined>;
+/**
+ * Who joined, left, was added, removed, promoted or demoted in a group, or its new title, live or from the group's
+ * service message in a history push. WhatsApp gives a live change no id, so `id` is derived from the chat, the time in
+ * seconds, the action and the sorted people: both paths give one change the same id, and the store keeps it once.
+ * `by` and `people` are in LID form like a sender; `by` is `null` where WhatsApp did not say who.
+ */
+export declare const waChatEvent: v.StrictObjectSchema<{
+    readonly chat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+    readonly timestamp: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>;
+    readonly event: v.PicklistSchema<["join", "leave", "add", "remove", "promote", "demote", "title"], undefined>;
+    readonly by: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>;
+    readonly byName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    readonly people: v.ArraySchema<v.StrictObjectSchema<{
+        readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+}, undefined>;
 /**
  * One push from the phone. `kind` follows whatsmeow's sync types; the adapter treats them all alike. `votes` are the
- * votes in the pushed polls, which the store saves with the push, not as `vote` events.
+ * votes in the pushed polls, which the store saves with the push, not as `vote` events. `events` are the groups'
+ * service messages in the push, which come as no message. `rekeys` apply first.
  */
 export declare const waHistory: v.StrictObjectSchema<{
     readonly kind: v.PicklistSchema<["bootstrap", "recent", "full", "on_demand", "push_name", "other"], undefined>;
     readonly chats: v.ArraySchema<v.StrictObjectSchema<{
         readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
-        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * `unread` and `lastMessageAt` are absent when the source does not say. Only a notice, such as a group leaving its
+         * community, leaves out `name` and `participants`: a pushed chat keeps the stored value of whatever is absent.
+         */
+        readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly kind: v.PicklistSchema<["dm", "self", "group", "newsletter", "broadcast"], undefined>;
-        readonly unread: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
-        readonly lastMessageAt: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>;
-        readonly participants: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly unread: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly lastMessageAt: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>, undefined>;
+        readonly participants: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** The community a group is linked to; `null` when a live read says it is in none, absent when nothing said. */
+        readonly parent: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>, undefined>;
+        /** A community itself: a group that holds other groups. */
+        readonly community: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        /**
+         * `left` when WhatsApp said the owner left the group or was removed, `member` when it said the owner was added back;
+         * never `null`, which clears `archived` too.
+         */
+        readonly membershipState: v.OptionalSchema<v.PicklistSchema<["left", "member"], undefined>, undefined>;
     }, undefined>, undefined>;
     readonly contacts: v.ArraySchema<v.StrictObjectSchema<{
         readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
@@ -170,13 +362,29 @@ export declare const waHistory: v.StrictObjectSchema<{
             readonly size: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-            readonly ref: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly ref: v.OptionalSchema<v.UnionSchema<[v.StrictObjectSchema<{
                 readonly media: v.PicklistSchema<["image", "video", "audio", "document", "sticker"], undefined>;
                 readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
                 readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, undefined>;
+                /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly place: v.StrictObjectSchema<{
+                    readonly latitude: v.NumberSchema<undefined>;
+                    readonly longitude: v.NumberSchema<undefined>;
+                    readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly card: v.StrictObjectSchema<{
+                    readonly name: v.StringSchema<undefined>;
+                    readonly vcard: v.StringSchema<undefined>;
+                }, undefined>;
+            }, undefined>], undefined>, undefined>;
         }, undefined>, undefined>, undefined>;
         readonly poll: v.OptionalSchema<v.StrictObjectSchema<{
             readonly question: v.StringSchema<undefined>;
@@ -186,6 +394,10 @@ export declare const waHistory: v.StrictObjectSchema<{
             }, undefined>, undefined>;
             readonly multiple: v.BooleanSchema<undefined>;
         }, undefined>, undefined>;
+        /** Only ever `true`, on a pushed message the owner starred: a push may be older than a star taken off since. */
+        readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        /** A channel post's number on WhatsApp's servers: a channel's history is read back from it. */
+        readonly serverId: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>, undefined>;
     readonly votes: v.ArraySchema<v.StrictObjectSchema<{
         readonly chat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
@@ -203,6 +415,23 @@ export declare const waHistory: v.StrictObjectSchema<{
             readonly multiple: v.BooleanSchema<undefined>;
         }, undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly rekeys: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly from: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+        readonly to: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    }, undefined>, undefined>, undefined>;
+    readonly events: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+        readonly chat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+        readonly timestamp: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>;
+        readonly event: v.PicklistSchema<["join", "leave", "add", "remove", "promote", "demote", "title"], undefined>;
+        readonly by: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>;
+        readonly byName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly people: v.ArraySchema<v.StrictObjectSchema<{
+            readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>, undefined>, undefined>;
 }, undefined>;
 /**
  * The phone's answer to `older`: the chat's messages sent before the anchor, as many as were asked or fewer. No
@@ -230,13 +459,29 @@ export declare const waOlder: v.StrictObjectSchema<{
             readonly size: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-            readonly ref: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly ref: v.OptionalSchema<v.UnionSchema<[v.StrictObjectSchema<{
                 readonly media: v.PicklistSchema<["image", "video", "audio", "document", "sticker"], undefined>;
                 readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
                 readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, undefined>;
+                /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly place: v.StrictObjectSchema<{
+                    readonly latitude: v.NumberSchema<undefined>;
+                    readonly longitude: v.NumberSchema<undefined>;
+                    readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly card: v.StrictObjectSchema<{
+                    readonly name: v.StringSchema<undefined>;
+                    readonly vcard: v.StringSchema<undefined>;
+                }, undefined>;
+            }, undefined>], undefined>, undefined>;
         }, undefined>, undefined>, undefined>;
         readonly poll: v.OptionalSchema<v.StrictObjectSchema<{
             readonly question: v.StringSchema<undefined>;
@@ -246,6 +491,10 @@ export declare const waOlder: v.StrictObjectSchema<{
             }, undefined>, undefined>;
             readonly multiple: v.BooleanSchema<undefined>;
         }, undefined>, undefined>;
+        /** Only ever `true`, on a pushed message the owner starred: a push may be older than a star taken off since. */
+        readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        /** A channel post's number on WhatsApp's servers: a channel's history is read back from it. */
+        readonly serverId: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>, undefined>;
     readonly more: v.BooleanSchema<undefined>;
 }, undefined>;
@@ -257,13 +506,26 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
         readonly kind: v.PicklistSchema<["bootstrap", "recent", "full", "on_demand", "push_name", "other"], undefined>;
         readonly chats: v.ArraySchema<v.StrictObjectSchema<{
             readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
-            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            /**
+             * `unread` and `lastMessageAt` are absent when the source does not say. Only a notice, such as a group leaving its
+             * community, leaves out `name` and `participants`: a pushed chat keeps the stored value of whatever is absent.
+             */
+            readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
             readonly kind: v.PicklistSchema<["dm", "self", "group", "newsletter", "broadcast"], undefined>;
-            readonly unread: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
-            readonly lastMessageAt: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>;
-            readonly participants: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+            readonly unread: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+            readonly lastMessageAt: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>, undefined>;
+            readonly participants: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
             readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
             readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+            /** The community a group is linked to; `null` when a live read says it is in none, absent when nothing said. */
+            readonly parent: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>, undefined>;
+            /** A community itself: a group that holds other groups. */
+            readonly community: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            /**
+             * `left` when WhatsApp said the owner left the group or was removed, `member` when it said the owner was added back;
+             * never `null`, which clears `archived` too.
+             */
+            readonly membershipState: v.OptionalSchema<v.PicklistSchema<["left", "member"], undefined>, undefined>;
         }, undefined>, undefined>;
         readonly contacts: v.ArraySchema<v.StrictObjectSchema<{
             readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
@@ -289,13 +551,29 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
                 readonly size: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
                 readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-                readonly ref: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly ref: v.OptionalSchema<v.UnionSchema<[v.StrictObjectSchema<{
                     readonly media: v.PicklistSchema<["image", "video", "audio", "document", "sticker"], undefined>;
                     readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
                     readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                     readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-                }, undefined>, undefined>;
+                    /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+                }, undefined>, v.StrictObjectSchema<{
+                    readonly place: v.StrictObjectSchema<{
+                        readonly latitude: v.NumberSchema<undefined>;
+                        readonly longitude: v.NumberSchema<undefined>;
+                        readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                        readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    }, undefined>;
+                }, undefined>, v.StrictObjectSchema<{
+                    readonly card: v.StrictObjectSchema<{
+                        readonly name: v.StringSchema<undefined>;
+                        readonly vcard: v.StringSchema<undefined>;
+                    }, undefined>;
+                }, undefined>], undefined>, undefined>;
             }, undefined>, undefined>, undefined>;
             readonly poll: v.OptionalSchema<v.StrictObjectSchema<{
                 readonly question: v.StringSchema<undefined>;
@@ -305,6 +583,10 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
                 }, undefined>, undefined>;
                 readonly multiple: v.BooleanSchema<undefined>;
             }, undefined>, undefined>;
+            /** Only ever `true`, on a pushed message the owner starred: a push may be older than a star taken off since. */
+            readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            /** A channel post's number on WhatsApp's servers: a channel's history is read back from it. */
+            readonly serverId: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         }, undefined>, undefined>;
         readonly votes: v.ArraySchema<v.StrictObjectSchema<{
             readonly chat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
@@ -322,6 +604,23 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
                 readonly multiple: v.BooleanSchema<undefined>;
             }, undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly rekeys: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly from: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly to: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+        }, undefined>, undefined>, undefined>;
+        readonly events: v.OptionalSchema<v.ArraySchema<v.StrictObjectSchema<{
+            readonly chat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+            readonly timestamp: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>;
+            readonly event: v.PicklistSchema<["join", "leave", "add", "remove", "promote", "demote", "title"], undefined>;
+            readonly by: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>;
+            readonly byName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            readonly people: v.ArraySchema<v.StrictObjectSchema<{
+                readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+                readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+            readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>, undefined>;
     }, undefined>;
 }, undefined>, v.StrictObjectSchema<{
     readonly event: v.LiteralSchema<"message", undefined>;
@@ -345,13 +644,29 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
             readonly size: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-            readonly ref: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly ref: v.OptionalSchema<v.UnionSchema<[v.StrictObjectSchema<{
                 readonly media: v.PicklistSchema<["image", "video", "audio", "document", "sticker"], undefined>;
                 readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
                 readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, undefined>;
+                /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly place: v.StrictObjectSchema<{
+                    readonly latitude: v.NumberSchema<undefined>;
+                    readonly longitude: v.NumberSchema<undefined>;
+                    readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly card: v.StrictObjectSchema<{
+                    readonly name: v.StringSchema<undefined>;
+                    readonly vcard: v.StringSchema<undefined>;
+                }, undefined>;
+            }, undefined>], undefined>, undefined>;
         }, undefined>, undefined>, undefined>;
         readonly poll: v.OptionalSchema<v.StrictObjectSchema<{
             readonly question: v.StringSchema<undefined>;
@@ -361,6 +676,10 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
             }, undefined>, undefined>;
             readonly multiple: v.BooleanSchema<undefined>;
         }, undefined>, undefined>;
+        /** Only ever `true`, on a pushed message the owner starred: a push may be older than a star taken off since. */
+        readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        /** A channel post's number on WhatsApp's servers: a channel's history is read back from it. */
+        readonly serverId: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>;
 }, undefined>, v.StrictObjectSchema<{
     readonly event: v.LiteralSchema<"edit", undefined>;
@@ -384,13 +703,29 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
             readonly size: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
             readonly mime: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
             readonly duration: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
-            readonly ref: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly ref: v.OptionalSchema<v.UnionSchema<[v.StrictObjectSchema<{
                 readonly media: v.PicklistSchema<["image", "video", "audio", "document", "sticker"], undefined>;
                 readonly directPath: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
                 readonly mediaKey: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
                 readonly fileEncSha256: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
-            }, undefined>, undefined>;
+                /** The upload's URL: a phone does not show a photo or a video whose message lacks it. */
+                readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly mediaKeyTimestamp: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly place: v.StrictObjectSchema<{
+                    readonly latitude: v.NumberSchema<undefined>;
+                    readonly longitude: v.NumberSchema<undefined>;
+                    readonly name: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly address: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                    readonly url: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                }, undefined>;
+            }, undefined>, v.StrictObjectSchema<{
+                readonly card: v.StrictObjectSchema<{
+                    readonly name: v.StringSchema<undefined>;
+                    readonly vcard: v.StringSchema<undefined>;
+                }, undefined>;
+            }, undefined>], undefined>, undefined>;
         }, undefined>, undefined>, undefined>;
         readonly poll: v.OptionalSchema<v.StrictObjectSchema<{
             readonly question: v.StringSchema<undefined>;
@@ -400,6 +735,10 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
             }, undefined>, undefined>;
             readonly multiple: v.BooleanSchema<undefined>;
         }, undefined>, undefined>;
+        /** Only ever `true`, on a pushed message the owner starred: a push may be older than a star taken off since. */
+        readonly starred: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        /** A channel post's number on WhatsApp's servers: a channel's history is read back from it. */
+        readonly serverId: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     }, undefined>;
 }, undefined>, v.StrictObjectSchema<{
     readonly event: v.LiteralSchema<"delete", undefined>;
@@ -423,22 +762,51 @@ export declare const engineEvent: v.VariantSchema<"event", [v.StrictObjectSchema
             readonly multiple: v.BooleanSchema<undefined>;
         }, undefined>, undefined>;
     }, undefined>;
+}, undefined>, v.StrictObjectSchema<{
+    readonly event: v.LiteralSchema<"chat_event", undefined>;
+    readonly change: v.StrictObjectSchema<{
+        readonly chat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+        readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+        readonly timestamp: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>;
+        readonly event: v.PicklistSchema<["join", "leave", "add", "remove", "promote", "demote", "title"], undefined>;
+        readonly by: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>;
+        readonly byName: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        readonly people: v.ArraySchema<v.StrictObjectSchema<{
+            readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+            readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly title: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    }, undefined>;
+}, undefined>, v.StrictObjectSchema<{
+    readonly event: v.LiteralSchema<"star", undefined>;
+    readonly chat: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly id: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.NonEmptyAction<string, undefined>]>;
+    readonly starred: v.BooleanSchema<undefined>;
+}, undefined>, v.StrictObjectSchema<{
+    readonly from: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly to: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
+    readonly event: v.LiteralSchema<"rekey", undefined>;
 }, undefined>, v.StrictObjectSchema<{
     readonly event: v.LiteralSchema<"connection", undefined>;
     readonly state: v.PicklistSchema<["connected", "disconnected", "logged_out", "replaced", "banned", "outdated", "stopped"], undefined>;
+    readonly until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>;
 }, undefined>], undefined>;
 export declare const engineErrorCode: v.PicklistSchema<["validation_error", "authentication_error", "permission_error", "not_found", "rate_limited", "timeout", "network_error", "provider_error", "provider_unavailable", "outcome_unknown"], undefined>;
 /**
  * Why, for the refusals an agent recovers from differently than their code says: another process holds the device
  * (`device.in-use`), WhatsApp handed the login to another connection (`device.replaced`), logged the device out, refuses
  * this version (`client.outdated`), banned the account, or asked it to slow down (`account.rate-limited`, never the
- * engine's own lookup pace). The CLI registers each one (`src/reasons.ts`).
+ * engine's own lookup pace), or has not yet sent the keys a settings change is sealed with (`settings.keys-missing`).
+ * A download WhatsApp no longer keeps the file for says how asking the phone to upload it again ended (`media.*`), or
+ * that the engine stopped while it waited (`engine.stopped`). The CLI registers each one (`src/reasons.ts`).
  */
-export declare const engineReason: v.PicklistSchema<["device.in-use", "device.replaced", "device.logged-out", "client.outdated", "account.banned", "account.rate-limited"], undefined>;
+export declare const engineReason: v.PicklistSchema<["device.in-use", "device.replaced", "device.logged-out", "client.outdated", "account.banned", "account.rate-limited", "settings.keys-missing", "media.not-on-phone", "media.phone-cannot-decrypt", "media.phone-answer-unreadable", "media.phone-failed", "media.phone-timeout", "media.retry-failed", "engine.stopped"], undefined>;
 export declare const engineError: v.StrictObjectSchema<{
     readonly code: v.PicklistSchema<["validation_error", "authentication_error", "permission_error", "not_found", "rate_limited", "timeout", "network_error", "provider_error", "provider_unavailable", "outcome_unknown"], undefined>;
     readonly message: v.StringSchema<undefined>;
-    readonly reason: v.OptionalSchema<v.PicklistSchema<["device.in-use", "device.replaced", "device.logged-out", "client.outdated", "account.banned", "account.rate-limited"], undefined>, undefined>;
+    readonly reason: v.OptionalSchema<v.PicklistSchema<["device.in-use", "device.replaced", "device.logged-out", "client.outdated", "account.banned", "account.rate-limited", "settings.keys-missing", "media.not-on-phone", "media.phone-cannot-decrypt", "media.phone-answer-unreadable", "media.phone-failed", "media.phone-timeout", "media.retry-failed", "engine.stopped"], undefined>, undefined>;
+    /** When a temporary ban ends, if WhatsApp said. */
+    readonly until: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>;
 }, undefined>;
 /** The engine's first line: its protocol and the linked account (`self()`), or `null` before a login. */
 export declare const hello: v.StrictObjectSchema<{
@@ -454,13 +822,26 @@ export declare const waAccount: v.StrictObjectSchema<{
 export declare const waChatCard: v.StrictObjectSchema<{
     readonly chat: v.StrictObjectSchema<{
         readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
-        readonly name: v.NullableSchema<v.StringSchema<undefined>, undefined>;
+        /**
+         * `unread` and `lastMessageAt` are absent when the source does not say. Only a notice, such as a group leaving its
+         * community, leaves out `name` and `participants`: a pushed chat keeps the stored value of whatever is absent.
+         */
+        readonly name: v.OptionalSchema<v.NullableSchema<v.StringSchema<undefined>, undefined>, undefined>;
         readonly kind: v.PicklistSchema<["dm", "self", "group", "newsletter", "broadcast"], undefined>;
-        readonly unread: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
-        readonly lastMessageAt: v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>;
-        readonly participants: v.NullableSchema<v.NumberSchema<undefined>, undefined>;
+        readonly unread: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
+        readonly lastMessageAt: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IsoTimestampAction<string, undefined>]>, undefined>, undefined>;
+        readonly participants: v.OptionalSchema<v.NullableSchema<v.NumberSchema<undefined>, undefined>, undefined>;
         readonly archived: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
         readonly muted: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        /** The community a group is linked to; `null` when a live read says it is in none, absent when nothing said. */
+        readonly parent: v.OptionalSchema<v.NullableSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>, undefined>, undefined>;
+        /** A community itself: a group that holds other groups. */
+        readonly community: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        /**
+         * `left` when WhatsApp said the owner left the group or was removed, `member` when it said the owner was added back;
+         * never `null`, which clears `archived` too.
+         */
+        readonly membershipState: v.OptionalSchema<v.PicklistSchema<["left", "member"], undefined>, undefined>;
     }, undefined>;
     readonly members: v.NullableSchema<v.ArraySchema<v.StrictObjectSchema<{
         readonly jid: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.IncludesAction<string, "@", undefined>]>;
@@ -480,9 +861,14 @@ export type WaContact = v.InferOutput<typeof waContact>;
 export type WaMessage = v.InferOutput<typeof waMessage>;
 export type WaPoll = v.InferOutput<typeof waPoll>;
 export type WaVote = v.InferOutput<typeof waVote>;
+export type WaChatEvent = v.InferOutput<typeof waChatEvent>;
 export type WaMediaRef = v.InferOutput<typeof waMediaRef>;
+export type WaDownloaded = v.InferOutput<typeof waDownloaded>;
+export type WaPlaceRef = v.InferOutput<typeof waPlaceRef>;
+export type WaCardRef = v.InferOutput<typeof waCardRef>;
 export type WaAttachment = v.InferOutput<typeof waAttachment>;
 export type WaHistory = v.InferOutput<typeof waHistory>;
+export type WaRekey = v.InferOutput<typeof waRekey>;
 export type EngineEvent = v.InferOutput<typeof engineEvent>;
 export type ConnectionState = v.InferOutput<typeof connectionState>;
 export type EngineErrorCode = v.InferOutput<typeof engineErrorCode>;
@@ -513,14 +899,18 @@ export interface WaQuote {
     sender: string | null;
     text: string;
 }
-/** One file from this machine, sent with `text` as its caption. `kind` is decided as tg decides it. */
+/** One file from this machine, sent with `text` as its caption. `kind` is decided as tg decides it; a sticker goes alone. */
 export interface WaSendMedia extends WaSend {
     file: {
-        kind: "photo" | "video" | "voice" | "document";
+        kind: "photo" | "video" | "voice" | "document" | "sticker";
         path: string;
         name: string;
     };
 }
+/** Photos and videos sent as one album, `text` as the first one's caption. */
+export interface WaSendAlbum extends WaSend {
+    files: WaSendMedia["file"][];
+}
 /** A poll to send; `multiple` lets a voter pick any number of answers, else one. */
 export interface WaNewPoll {
     chat: string;
@@ -529,7 +919,10 @@ export interface WaNewPoll {
     answers: string[];
     multiple: boolean;
 }
-/** A stored message sent again, marked forwarded: its text and its one file, by the keys the store holds. */
+/**
+ * A stored message sent again, marked forwarded: its text and its one file by the keys the store holds, or its place
+ * or contact card as the store kept it.
+ */
 export interface WaForward {
     chat: string;
     id: string;
@@ -548,6 +941,13 @@ export interface WaKey {
     /** Who sent it; in a group, required for someone else's message. */
     sender: string | null;
 }
+/** A message key as the engine reads it from a request. */
+export declare const keyFields: ({ chat, id, fromMe, sender }: WaKey) => {
+    chat: string;
+    message: string;
+    fromMe: boolean;
+    sender?: string | undefined;
+};
 /** The most messages one `older` request asks the phone for, as WhatsApp's own clients ask. */
 export declare const OLDER_MAX = 50;
 /** A stored message the phone counts back from: WhatsApp needs its id, whether it is the account's own, and its time. */
@@ -561,14 +961,18 @@ export interface WaAnchor extends WaKey {
 export declare class EngineError extends Error {
     readonly code: EngineErrorCode;
     readonly reason?: WaReason | undefined;
-    constructor(code: EngineErrorCode, message: string, reason?: WaReason | undefined);
+    /** When a temporary ban ends, if WhatsApp said. */
+    readonly until?: string | undefined;
+    constructor(code: EngineErrorCode, message: string, reason?: WaReason | undefined, 
+    /** When a temporary ban ends, if WhatsApp said. */
+    until?: string | undefined);
 }
 /**
  * The engine as the adapter sees it. `GoEngine` runs whatsmeow in a child process; `FakeEngine` serves tests.
  * An event nobody listens for yet is kept and handed to the first listener of its kind, so a history push that
  * comes right after connecting is not lost to a `feed` that started a moment after `watch`.
  */
-export interface WhatsAppEngine extends GroupEngine {
+export interface WhatsAppEngine extends GroupEngine, PrivacyEngine, SettingsEngine, ChannelEngine {
     /**
      * The linked account, from the engine's own store: no request. `null` before a login. Always the user JID in LID
      * form with no device part (`…@lid`, not `…:12@s.whatsapp.net`): the store keys the account by it, so a change of
@@ -592,12 +996,28 @@ export interface WhatsAppEngine extends GroupEngine {
     markRead(key: WaKey): Promise<void>;
     /** Uploads the file, then sends it; a failed upload sent nothing. */
     sendMedia(request: WaSendMedia): Promise<WaMessage>;
-    /** Writes a stored file to `path`, which must not exist yet; the engine creates it readable by this user alone. */
-    download(attachment: WaAttachment, path: string): Promise<void>;
+    /**
+     * Uploads every file, then sends the album and each file tied to it. The answer is the first file's message, under
+     * the send id; the others carry ids derived from it, so a repeat sends the same ones.
+     */
+    sendAlbum(request: WaSendAlbum): Promise<WaMessage>;
+    /**
+     * Writes a stored file to `path`, which must not exist yet; the engine creates it readable by this user alone. A
+     * file WhatsApp no longer keeps is asked of the owner's phone again, for the message `key` names, and fetched from
+     * its new upload, and the answer is that upload's path; a phone that does not answer in time is a `timeout`.
+     */
+    download(attachment: WaAttachment, path: string, key: WaKey): Promise<WaDownloaded>;
     forward(request: WaForward): Promise<WaMessage>;
     createPoll(request: WaNewPoll): Promise<WaMessage>;
     /** The account's vote in a poll, by the answers' texts; none takes it back. Everyone in the chat sees it. */
     vote(key: WaKey, answers: string[]): Promise<void>;
+    /**
+     * Pins the message for everyone in the chat: WhatsApp has no pin only the account sees. `duration` is 86400,
+     * 604800 or 2592000 seconds. cli-core always sends one; the engine pins for 7 days without one,
+     * which keeps a wa built on cli-core before 0.339.0 working.
+     */
+    pin(key: WaKey, duration?: number): Promise<void>;
+    unpin(key: WaKey): Promise<void>;
     /**
      * Asks the phone for up to `count` of the chat's messages sent before `anchor`, and waits for its answer. WhatsApp
      * keeps no history on its servers: the phone answers only while it is online, and a phone that does not answer in
@@ -610,6 +1030,18 @@ export interface WhatsAppEngine extends GroupEngine {
      */
     link(request: WaLink, onCode: (code: LoginCode) => void): Promise<WaAccount>;
     logout(): Promise<void>;
+    /**
+     * The store's one-to-one chats in phone form, once as `serve` or `watch` starts. One stored so before the engine kept
+     * its table of them is known to it no other way: it goes out as a `rekey` event if its LID is known, and waits for the
+     * paced lookups if not. `recipients` are recipient-list ids the store holds no chat for: one in phone form whose LID
+     * the device knows goes out as a `rekey` event too, and none is looked up or recorded. Never connects.
+     */
+    storedChats(chats: string[], recipients?: string[]): Promise<void>;
+    /**
+     * The chat id the store keeps a typed one-to-one chat under: its LID when whatsmeow's map knows it, else the id as
+     * typed. Reads the map only, never connects, and records nothing.
+     */
+    canonicalChat(jid: string): Promise<string>;
     /** Events of the given kinds until the returned function is called. */
     listen(kinds: readonly EngineEvent["event"][], onEvent: (event: EngineEvent) => void): () => void;
     close(): Promise<void>;