@n4tzz/n4lyx 2.7.1

package/WAProto/WAProto.proto

@@ -0,0 +1,2995 @@
+syntax = "proto3";
+package proto;
+
+// ─── ENUMS ───────────────────────────────────────────────────
+
+enum ADVEncryptionType {
+    E2EE   = 0;
+    HOSTED = 1;
+}
+
+enum BotMetricsEntryPoint {
+    FAVICON                         = 1;
+    CHATLIST                        = 2;
+    AISEARCH_NULL_STATE_PAPER_PLANE = 3;
+    AISEARCH_NULL_STATE_SUGGESTION  = 4;
+    AISEARCH_TYPE_AHEAD_SUGGESTION  = 5;
+    AISEARCH_TYPE_AHEAD_PAPER_PLANE = 6;
+    AISEARCH_TYPE_AHEAD_RESULT_CHATLIST  = 7;
+    AISEARCH_TYPE_AHEAD_RESULT_MESSAGES  = 8;
+    AIVOICE_SEARCH_BAR              = 9;
+    AIVOICE_FAVICON                 = 10;
+    AISTUDIO                        = 11;
+    DEEPLINK                        = 12;
+    NOTIFICATION                    = 13;
+    PROFILE_MESSAGE_BUTTON          = 14;
+    FORWARD                         = 15;
+    APP_SHORTCUT                    = 16;
+    FF_FAMILY                       = 17;
+    AI_TAB                          = 18;
+    AI_HOME                         = 19;
+    AI_DEEPLINK_IMMERSIVE           = 20;
+    AI_DEEPLINK                     = 21;
+    META_AI_CHAT_SHORTCUT_AI_STUDIO = 22;
+    UGC_CHAT_SHORTCUT_AI_STUDIO     = 23;
+    NEW_CHAT_AI_STUDIO              = 24;
+    AIVOICE_FAVICON_CALL_HISTORY    = 25;
+}
+
+enum BotMetricsThreadEntryPoint {
+    AI_TAB_THREAD              = 1;
+    AI_HOME_THREAD             = 2;
+    AI_DEEPLINK_IMMERSIVE_THREAD = 3;
+    AI_DEEPLINK_THREAD         = 4;
+}
+
+enum BotSessionSource {
+    NONE              = 0;
+    NULL_STATE        = 1;
+    TYPEAHEAD         = 2;
+    USER_INPUT        = 3;
+    EMU_FLASH         = 4;
+    EMU_FLASH_FOLLOWUP = 5;
+    VOICE             = 6;
+}
+
+enum KeepType {
+    UNKNOWN        = 0;
+    KEEP_FOR_ALL   = 1;
+    UNDO_KEEP_FOR_ALL = 2;
+}
+
+enum MediaVisibility {
+    DEFAULT = 0;
+    OFF     = 1;
+    ON      = 2;
+}
+
+enum PrivacySystemMessage {
+    E2EE_MSG   = 1;
+    NE2EE_SELF = 2;
+    NE2EE_OTHER = 3;
+}
+
+
+// ─── ADV ─────────────────────────────────────────────────────
+
+message ADVDeviceIdentity {
+    optional uint32          rawId       = 1;
+    optional uint64          timestamp   = 2;
+    optional uint32          keyIndex    = 3;
+    optional ADVEncryptionType accountType = 4;
+    optional ADVEncryptionType deviceType  = 5;
+}
+
+message ADVKeyIndexList {
+    optional uint32          rawId        = 1;
+    optional uint64          timestamp    = 2;
+    optional uint32          currentIndex = 3;
+    repeated uint32          validIndexes = 4 [packed=true];
+    optional ADVEncryptionType accountType = 5;
+}
+
+message ADVSignedDeviceIdentity {
+    optional bytes details             = 1;
+    optional bytes accountSignatureKey = 2;
+    optional bytes accountSignature    = 3;
+    optional bytes deviceSignature     = 4;
+}
+
+message ADVSignedDeviceIdentityHMAC {
+    optional bytes             details     = 1;
+    optional bytes             hmac        = 2;
+    optional ADVEncryptionType accountType = 3;
+}
+
+message ADVSignedKeyIndexList {
+    optional bytes details             = 1;
+    optional bytes accountSignature    = 2;
+    optional bytes accountSignatureKey = 3;
+}
+
+
+// ─── ACCOUNT ─────────────────────────────────────────────────
+
+message Account {
+    optional string lid               = 1;
+    optional string username          = 2;
+    optional string countryCode       = 3;
+    optional bool   isUsernameDeleted = 4;
+}
+
+message ActionLink {
+    optional string url         = 1;
+    optional string buttonTitle = 2;
+}
+
+message AutoDownloadSettings {
+    optional bool downloadImages   = 1;
+    optional bool downloadAudio    = 2;
+    optional bool downloadVideo    = 3;
+    optional bool downloadDocuments = 4;
+}
+
+message AvatarUserSettings {
+    optional string fbid     = 1;
+    optional string password = 2;
+}
+
+
+// ─── BIZ ─────────────────────────────────────────────────────
+
+message BizAccountLinkInfo {
+    optional uint64 whatsappBizAcctFbid  = 1;
+    optional string whatsappAcctNumber   = 2;
+    optional uint64 issueTime            = 3;
+    optional HostStorageType hostStorage = 4;
+    optional AccountType     accountType = 5;
+
+    enum AccountType     { ENTERPRISE  = 0; }
+    enum HostStorageType { ON_PREMISE  = 0; FACEBOOK = 1; }
+}
+
+message BizAccountPayload {
+    optional VerifiedNameCertificate vnameCert      = 1;
+    optional bytes                   bizAcctLinkInfo = 2;
+}
+
+message BizIdentityInfo {
+    optional VerifiedLevelValue      vlevel        = 1;
+    optional VerifiedNameCertificate vnameCert     = 2;
+    optional bool                    signed        = 3;
+    optional bool                    revoked       = 4;
+    optional HostStorageType         hostStorage   = 5;
+    optional ActualActorsType        actualActors  = 6;
+    optional uint64                  privacyModeTs = 7;
+    optional uint64                  featureControls = 8;
+
+    enum ActualActorsType  { SELF = 0; BSP  = 1; }
+    enum HostStorageType   { ON_PREMISE = 0; FACEBOOK = 1; }
+    enum VerifiedLevelValue { UNKNOWN = 0; LOW = 1; HIGH = 2; }
+}
+
+
+// ─── BOT ─────────────────────────────────────────────────────
+
+message BotAgeCollectionMetadata {
+    optional bool ageCollectionEligible              = 1;
+    optional bool shouldTriggerAgeCollectionOnClient = 2;
+}
+
+message BotAvatarMetadata {
+    optional uint32 sentiment     = 1;
+    optional string behaviorGraph = 2;
+    optional uint32 action        = 3;
+    optional uint32 intensity     = 4;
+    optional uint32 wordCount     = 5;
+}
+
+message BotCapabilityMetadata {
+    repeated BotCapabilityType capabilities = 1;
+
+    enum BotCapabilityType {
+        UNKNOWN                            = 0;
+        PROGRESS_INDICATOR                 = 1;
+        RICH_RESPONSE_HEADING              = 2;
+        RICH_RESPONSE_NESTED_LIST          = 3;
+        AI_MEMORY                          = 4;
+        RICH_RESPONSE_THREAD_SURFING       = 5;
+        RICH_RESPONSE_TABLE                = 6;
+        RICH_RESPONSE_CODE                 = 7;
+        RICH_RESPONSE_STRUCTURED_RESPONSE  = 8;
+        RICH_RESPONSE_INLINE_IMAGE         = 9;
+        WA_IG_1P_PLUGIN_RANKING_CONTROL    = 10;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_1   = 11;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_2   = 12;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_3   = 13;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_4   = 14;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_5   = 15;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_6   = 16;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_7   = 17;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_8   = 18;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_9   = 19;
+        WA_IG_1P_PLUGIN_RANKING_UPDATE_10  = 20;
+        RICH_RESPONSE_SUB_HEADING          = 21;
+        RICH_RESPONSE_GRID_IMAGE           = 22;
+        AI_STUDIO_UGC_MEMORY               = 23;
+        RICH_RESPONSE_LATEX                = 24;
+        RICH_RESPONSE_MAPS                 = 25;
+        RICH_RESPONSE_INLINE_REELS         = 26;
+        AGENTIC_PLANNING                   = 27;
+        ACCOUNT_LINKING                    = 28;
+        STREAMING_DISAGGREGATION           = 29;
+        RICH_RESPONSE_GRID_IMAGE_3P        = 30;
+        RICH_RESPONSE_LATEX_INLINE         = 31;
+        QUERY_PLAN                         = 32;
+        PROACTIVE_MESSAGE                  = 33;
+        RICH_RESPONSE_UNIFIED_RESPONSE     = 34;
+        PROMOTION_MESSAGE                  = 35;
+        SIMPLIFIED_PROFILE_PAGE            = 36;
+    }
+}
+
+message BotImagineMetadata {
+    optional ImagineType imagineType = 1;
+    enum ImagineType { UNKNOWN = 0; IMAGINE = 1; MEMU = 2; FLASH = 3; EDIT = 4; }
+}
+
+message BotLinkedAccount {
+    optional BotLinkedAccountType type = 1;
+    enum BotLinkedAccountType { BOT_LINKED_ACCOUNT_TYPE_1P = 0; }
+}
+
+message BotLinkedAccountsMetadata {
+    repeated BotLinkedAccount accounts     = 1;
+    optional bytes            acAuthTokens = 2;
+    optional int32            acErrorCode  = 3;
+}
+
+message BotMediaMetadata {
+    optional string          fileSha256         = 1;
+    optional string          mediaKey           = 2;
+    optional string          fileEncSha256      = 3;
+    optional string          directPath         = 4;
+    optional int64           mediaKeyTimestamp  = 5;
+    optional string          mimetype           = 6;
+    optional OrientationType orientationType    = 7;
+
+    enum OrientationType { CENTER = 1; LEFT = 2; RIGHT = 3; }
+}
+
+message BotMemoryFact {
+    optional string fact   = 1;
+    optional string factId = 2;
+}
+
+message BotMemoryMetadata {
+    repeated BotMemoryFact addedFacts   = 1;
+    repeated BotMemoryFact removedFacts = 2;
+    optional string        disclaimer   = 3;
+}
+
+message BotMemuMetadata {
+    repeated BotMediaMetadata faceImages = 1;
+}
+
+message BotMetadata {
+    optional BotAvatarMetadata              avatarMetadata              = 1;
+    optional string                         personaId                   = 2;
+    optional BotPluginMetadata              pluginMetadata              = 3;
+    optional BotSuggestedPromptMetadata     suggestedPromptMetadata     = 4;
+    optional string                         invokerJid                  = 5;
+    optional BotSessionMetadata             sessionMetadata             = 6;
+    optional BotMemuMetadata                memuMetadata                = 7;
+    optional string                         timezone                    = 8;
+    optional BotReminderMetadata            reminderMetadata            = 9;
+    optional BotModelMetadata               modelMetadata               = 10;
+    optional string                         messageDisclaimerText       = 11;
+    optional BotProgressIndicatorMetadata   progressIndicatorMetadata   = 12;
+    optional BotCapabilityMetadata          capabilityMetadata          = 13;
+    optional BotImagineMetadata             imagineMetadata             = 14;
+    optional BotMemoryMetadata              memoryMetadata              = 15;
+    optional BotRenderingMetadata           renderingMetadata           = 16;
+    optional BotMetricsMetadata             botMetricsMetadata          = 17;
+    optional BotLinkedAccountsMetadata      botLinkedAccountsMetadata   = 18;
+    optional BotSourcesMetadata             richResponseSourcesMetadata = 19;
+    optional bytes                          aiConversationContext       = 20;
+    optional BotPromotionMessageMetadata    botPromotionMessageMetadata = 21;
+    optional BotModeSelectionMetadata       botModeSelectionMetadata    = 22;
+    optional BotQuotaMetadata               botQuotaMetadata            = 23;
+    optional BotAgeCollectionMetadata       botAgeCollectionMetadata    = 24;
+    optional string                         conversationStarterPromptId = 25;
+    optional string                         botResponseId               = 26;
+    optional BotSignatureVerificationMetadata verificationMetadata      = 27;
+}
+
+message BotMetricsMetadata {
+    optional string                    destinationId         = 1;
+    optional BotMetricsEntryPoint      destinationEntryPoint = 2;
+    optional BotMetricsThreadEntryPoint threadOrigin         = 3;
+}
+
+message BotModeSelectionMetadata {
+    repeated BotUserSelectionMode mode = 1;
+    enum BotUserSelectionMode { UNKNOWN_MODE = 0; REASONING_MODE = 1; }
+}
+
+message BotModelMetadata {
+    optional ModelType         modelType          = 1;
+    optional PremiumModelStatus premiumModelStatus = 2;
+
+    enum ModelType          { UNKNOWN_TYPE = 0; LLAMA_PROD = 1; LLAMA_PROD_PREMIUM = 2; }
+    enum PremiumModelStatus { UNKNOWN_STATUS = 0; AVAILABLE = 1; QUOTA_EXCEED_LIMIT = 2; }
+}
+
+message BotPluginMetadata {
+    optional SearchProvider provider            = 1;
+    optional PluginType     pluginType          = 2;
+    optional string         thumbnailCdnUrl     = 3;
+    optional string         profilePhotoCdnUrl  = 4;
+    optional string         searchProviderUrl   = 5;
+    optional uint32         referenceIndex      = 6;
+    optional uint32         expectedLinksCount  = 7;
+    optional string         searchQuery         = 9;
+    optional MessageKey     parentPluginMessageKey = 10;
+    optional PluginType     parentPluginType    = 12;
+    optional string         faviconCdnUrl       = 13;
+
+    enum PluginType    { UNKNOWN_PLUGIN = 0; REELS = 1; SEARCH = 2; }
+    enum SearchProvider { UNKNOWN = 0; BING = 1; GOOGLE = 2; SUPPORT = 3; }
+}
+
+message BotProgressIndicatorMetadata {
+    optional string                  progressDescription = 1;
+    repeated BotPlanningStepMetadata stepsMetadata       = 2;
+
+    message BotPlanningStepMetadata {
+        optional string                          statusTitle       = 1;
+        optional string                          statusBody        = 2;
+        repeated BotPlanningSearchSourcesMetadata sourcesMetadata  = 3;
+        optional PlanningStepStatus              status            = 4;
+        optional bool                            isReasoning       = 5;
+        optional bool                            isEnhancedSearch  = 6;
+        repeated BotPlanningStepSectionMetadata  sections          = 7;
+
+        message BotPlanningSearchSourcesMetadata {
+            optional string                     sourceTitle = 1;
+            optional BotPlanningSearchSourceProvider provider = 2;
+            optional string                     sourceUrl   = 3;
+
+            enum BotPlanningSearchSourceProvider {
+                UNKNOWN = 0; OTHER = 1; GOOGLE = 2; BING = 3;
+            }
+        }
+
+        message BotPlanningStepSectionMetadata {
+            optional string sectionTitle  = 1;
+            optional string sectionBody   = 2;
+        }
+
+        enum PlanningStepStatus { UNKNOWN = 0; PLANNED = 1; EXECUTING = 2; FINISHED = 3; }
+    }
+}
+
+message BotPromotionMessageMetadata {
+    optional BotPromotionType promotionType = 1;
+    optional string           buttonTitle   = 2;
+
+    enum BotPromotionType { UNKNOWN_TYPE = 0; C50 = 1; }
+}
+
+message BotPromptSuggestion {
+    optional string prompt   = 1;
+    optional string promptId = 2;
+}
+
+message BotPromptSuggestions {
+    repeated BotPromptSuggestion suggestions = 1;
+}
+
+message BotQuotaMetadata {
+    repeated BotFeatureQuotaMetadata botFeatureQuotaMetadata = 1;
+
+    message BotFeatureQuotaMetadata {
+        optional BotFeatureType featureType      = 1;
+        optional uint32         remainingQuota   = 2;
+        optional uint64         expirationTimestamp = 3;
+
+        enum BotFeatureType { UNKNOWN_FEATURE = 0; REASONING_FEATURE = 1; }
+    }
+}
+
+message BotReminderMetadata {
+    optional MessageKey       requestMessageKey    = 1;
+    optional ReminderAction   action               = 2;
+    optional string           name                 = 3;
+    optional uint64           nextTriggerTimestamp = 4;
+    optional ReminderFrequency frequency           = 5;
+
+    enum ReminderAction    { NOTIFY = 1; CREATE = 2; DELETE = 3; UPDATE = 4; }
+    enum ReminderFrequency { ONCE = 1; DAILY = 2; WEEKLY = 3; BIWEEKLY = 4; MONTHLY = 5; }
+}
+
+message BotRenderingMetadata {
+    repeated Keyword keywords = 1;
+
+    message Keyword {
+        optional string        value            = 1;
+        repeated string        associatedPrompts = 2;
+    }
+}
+
+message BotSessionMetadata {
+    optional string          sessionId     = 1;
+    optional BotSessionSource sessionSource = 2;
+}
+
+message BotSignatureVerificationMetadata {
+    repeated BotSignatureVerificationUseCaseProof proofs = 1;
+}
+
+message BotSignatureVerificationUseCaseProof {
+    optional int32               version          = 1;
+    optional BotSignatureUseCase useCase          = 2;
+    optional bytes               signature        = 3;
+    optional bytes               certificateChain = 4;
+
+    enum BotSignatureUseCase { WA_BOT_MSG = 0; }
+}
+
+message BotSourcesMetadata {
+    repeated BotSourceItem sources = 1;
+
+    message BotSourceItem {
+        optional SourceProvider provider          = 1;
+        optional string         thumbnailCdnUrl   = 2;
+        optional string         sourceProviderUrl = 3;
+        optional string         sourceQuery       = 4;
+        optional string         faviconCdnUrl     = 5;
+        optional uint32         citationNumber    = 6;
+
+        enum SourceProvider { UNKNOWN = 0; BING = 1; GOOGLE = 2; SUPPORT = 3; }
+    }
+}
+
+message BotSuggestedPromptMetadata {
+    repeated string          suggestedPrompts    = 1;
+    optional uint32          selectedPromptIndex = 2;
+    optional BotPromptSuggestions promptSuggestions = 3;
+    optional string          selectedPromptId    = 4;
+}
+
+
+// ─── CALL ────────────────────────────────────────────────────
+
+message CallLogRecord {
+    optional CallResult callResult      = 1;
+    optional bool       isDndMode       = 2;
+    optional SilenceReason silenceReason = 3;
+    optional int64      duration        = 4;
+    optional int64      startTime       = 5;
+    optional bool       isIncoming      = 6;
+    optional bool       isVideo         = 7;
+    optional bool       isCallLink      = 8;
+    optional string     callLinkToken   = 9;
+    optional string     scheduledCallId = 10;
+    optional string     callId          = 11;
+    optional string     callCreatorJid  = 12;
+    optional string     groupJid        = 13;
+    repeated ParticipantInfo participants = 14;
+    optional CallType   callType        = 15;
+
+    enum CallResult {
+        CONNECTED        = 0;
+        REJECTED         = 1;
+        CANCELLED        = 2;
+        ACCEPTEDELSEWHERE = 3;
+        MISSED           = 4;
+        INVALID          = 5;
+        UNAVAILABLE      = 6;
+        UPCOMING         = 7;
+        FAILED           = 8;
+        ABANDONED        = 9;
+        ONGOING          = 10;
+    }
+    enum CallType { REGULAR = 0; SCHEDULED_CALL = 1; VOICE_CHAT = 2; }
+
+    message ParticipantInfo {
+        optional string     userJid    = 1;
+        optional CallResult callResult = 2;
+    }
+
+    enum SilenceReason { NONE = 0; SCHEDULED = 1; PRIVACY = 2; LIGHTWEIGHT = 3; }
+}
+
+
+// ─── CERT ────────────────────────────────────────────────────
+
+message CertChain {
+    optional NoiseCertificate leaf         = 1;
+    optional NoiseCertificate intermediate = 2;
+
+    message NoiseCertificate {
+        optional bytes   details   = 1;
+        optional bytes   signature = 2;
+
+        message Details {
+            optional uint32 serial       = 1;
+            optional uint32 issuerSerial = 2;
+            optional bytes  key          = 3;
+            optional uint64 notBefore    = 4;
+            optional uint64 notAfter     = 5;
+        }
+    }
+}
+
+message NoiseCertificate {
+    optional bytes details   = 1;
+    optional bytes signature = 2;
+
+    message Details {
+        optional uint32 serial  = 1;
+        optional string issuer  = 2;
+        optional uint64 expires = 3;
+        optional string subject = 4;
+        optional bytes  key     = 5;
+    }
+}
+
+
+// ─── CHAT ────────────────────────────────────────────────────
+
+message ChatLockSettings {
+    optional bool          hideLockedChats = 1;
+    optional UserPassword  secretCode      = 2;
+}
+
+message ChatRowOpaqueData {
+    optional DraftMessage draftMessage = 1;
+
+    message DraftMessage {
+        optional string          text                = 1;
+        optional string          omittedUrl          = 2;
+        optional CtwaContextData ctwaContext         = 4;
+        optional int64           timestamp           = 5;
+
+        message CtwaContextData {
+            optional string conversionSource = 1;
+            optional bytes  conversionData   = 2;
+            optional string sourceUrl        = 3;
+            optional string sourceId         = 4;
+            optional string sourceType       = 5;
+            optional string title            = 6;
+            optional string description      = 7;
+            optional string thumbnailUrl     = 9;
+            optional string mediaUrl         = 11;
+            optional bool   isSuspiciousLink = 12;
+        }
+    }
+}
+
+message Citation {
+    optional string title    = 1;
+    optional string subtitle = 2;
+    optional string cmsId    = 3;
+    optional string imageUrl = 4;
+}
+
+message ClientPairingProps {
+    optional bool isChatDbLidMigrated           = 1;
+    optional bool isSyncdPureLidSession         = 2;
+    optional bool isSyncdSnapshotRecoveryEnabled = 3;
+}
+
+
+// ─── CONTEXT ─────────────────────────────────────────────────
+
+message ContextInfo {
+    optional string  stanzaId                    = 1;
+    optional string  participant                 = 2;
+    optional Message quotedMessage               = 3;
+    optional string  remoteJid                   = 4;
+    repeated string  mentionedJid                = 15;
+    optional string  conversionSource            = 18;
+    optional bytes   conversionData              = 19;
+    optional uint32  conversionDelaySeconds      = 20;
+    optional uint32  forwardingScore             = 21;
+    optional bool    isForwarded                 = 22;
+    optional AdReplyInfo quotedAd                = 23;
+    optional MessageKey  placeholderKey          = 24;
+    optional uint32  expiration                  = 25;
+    optional int64   ephemeralSettingTimestamp   = 26;
+    optional bytes   ephemeralSharedSecret       = 27;
+    optional ExternalAdReplyInfo externalAdReply = 28;
+    optional string  entryPointConversionSource  = 29;
+    optional string  entryPointConversionApp     = 30;
+    optional uint32  entryPointConversionDelaySeconds = 31;
+    optional DisappearingMode disappearingMode   = 32;
+    optional ActionLink actionLink               = 33;
+    optional string  groupSubject                = 34;
+    optional string  parentGroupJid              = 35;
+    optional string  trustBannerType             = 37;
+    optional uint32  trustBannerAction           = 38;
+    optional bool    isSampled                   = 39;
+    repeated GroupMention groupMentions          = 40;
+    optional UTMInfo utm                         = 41;
+    optional ForwardedNewsletterMessageInfo forwardedNewsletterMessageInfo = 43;
+    optional BusinessMessageForwardInfo businessMessageForwardInfo         = 44;
+    optional string  smbClientCampaignId         = 45;
+    optional string  smbServerCampaignId         = 46;
+    optional DataSharingContext dataSharingContext = 47;
+    optional bool    alwaysShowAdAttribution     = 48;
+    optional FeatureEligibilities featureEligibilities = 49;
+    optional bool    isTagAll                    = 50; // n4lyx: tag all support flag
+    optional MemberLabel memberLabel             = 62;
+    optional bool    isQuestion                  = 63;
+
+    message AdReplyInfo {
+        optional string    advertiserName = 1;
+        optional MediaType mediaType      = 2;
+        optional bytes     jpegThumbnail  = 16;
+        optional string    caption        = 17;
+        enum MediaType { NONE = 0; IMAGE = 1; VIDEO = 2; }
+    }
+
+    message BusinessMessageForwardInfo {
+        optional string businessOwnerJid = 1;
+    }
+
+    message DataSharingContext {
+        optional bool showMmDisclosure = 1;
+    }
+
+    message ExternalAdReplyInfo {
+        optional string    title               = 1;
+        optional string    body                = 2;
+        optional MediaType mediaType           = 3;
+        optional string    thumbnailUrl        = 4;
+        optional string    mediaUrl            = 5;
+        optional bytes     thumbnail           = 6;
+        optional string    sourceType          = 7;
+        optional string    sourceId            = 8;
+        optional string    sourceUrl           = 9;
+        optional bool      containsAutoReply   = 10;
+        optional bool      renderLargerThumbnail = 11;
+        optional bool      showAdAttribution   = 12;
+        optional string    ctwaClid            = 13;
+        optional string    ref                 = 14;
+        optional bool      clickToWhatsappCall = 15;
+        optional string    sourceApp           = 17;
+        optional AdType    adType              = 25;
+
+        enum AdType    { CTWA = 0; CAWC = 1; }
+        enum MediaType { NONE = 0; IMAGE = 1; VIDEO = 2; }
+    }
+
+    message FeatureEligibilities {
+        optional bool cannotBeReactedTo = 1;
+        optional bool cannotBeRanked    = 2;
+        optional bool canRequestFeedback = 3;
+        optional bool canBeReshared     = 4;
+    }
+
+    message ForwardedNewsletterMessageInfo {
+        optional string      newsletterJid  = 1;
+        optional int32       serverMessageId = 2;
+        optional string      newsletterName = 3;
+        optional ContentType contentType    = 4;
+        optional string      accessibilityText = 5;
+        enum ContentType { UPDATE = 1; UPDATE_CARD = 2; LINK_CARD = 3; }
+    }
+
+    message UTMInfo {
+        optional string utmSource   = 1;
+        optional string utmCampaign = 2;
+    }
+}
+
+message Conversation {
+    optional string id                   = 1;
+    repeated HistorySyncMsg messages     = 2;
+    optional string newJid               = 3;
+    optional string oldJid               = 4;
+    optional uint64 lastMsgTimestamp     = 5;
+    optional uint32 unreadCount          = 6;
+    optional bool   readOnly             = 7;
+    optional bool   endOfHistoryTransfer = 8;
+    optional uint32 ephemeralExpiration  = 9;
+    optional int64  ephemeralSettingTimestamp = 10;
+    optional EndOfHistoryTransferType endOfHistoryTransferType = 11;
+    optional uint64 conversationTimestamp = 12;
+    optional string name                 = 13;
+    optional string pHash                = 14;
+    optional bool   notSpam              = 15;
+    optional bool   archived             = 16;
+    optional DisappearingMode disappearingMode = 17;
+    optional uint32 unreadMentionCount   = 18;
+    optional bool   markedAsUnread       = 19;
+    repeated GroupParticipant participant = 20;
+    optional bytes  tcToken              = 21;
+    optional uint64 tcTokenTimestamp     = 22;
+    optional bytes  contactPrimaryIdentityKey = 23;
+    optional uint32 pinned               = 24;
+    optional uint64 muteEndTime          = 25;
+    optional WallpaperSettings wallpaper = 26;
+    optional MediaVisibility mediaVisibility = 27;
+    optional bool   suspended            = 29;
+    optional bool   terminated           = 30;
+    optional uint64 createdAt            = 31;
+    optional string createdBy            = 32;
+    optional string description          = 33;
+    optional bool   support              = 34;
+    optional bool   isParentGroup        = 35;
+    optional string parentGroupId        = 37;
+    optional bool   isDefaultSubgroup    = 36;
+    optional string displayName          = 38;
+    optional string pnJid                = 39;
+    optional bool   shareOwnPn           = 40;
+    optional string lidJid               = 42;
+    optional string username             = 43;
+    optional uint32 commentsCount        = 45;
+    optional bool   locked               = 46;
+    optional PrivacySystemMessage systemMessageToInsert = 47;
+    optional bool   capiCreatedGroup     = 48;
+    optional string accountLid           = 49;
+
+    enum EndOfHistoryTransferType {
+        COMPLETE_BUT_MORE_MESSAGES_REMAIN_ON_PRIMARY      = 0;
+        COMPLETE_AND_NO_MORE_MESSAGE_REMAIN_ON_PRIMARY    = 1;
+        COMPLETE_ON_DEMAND_SYNC_BUT_MORE_MSG_REMAIN_ON_PRIMARY = 2;
+    }
+}
+
+
+// ─── DEVICE ──────────────────────────────────────────────────
+
+message DeviceCapabilities {
+    optional ChatLockSupportLevel chatLockSupportLevel = 1;
+    optional LIDMigration         lidMigration         = 2;
+
+    enum ChatLockSupportLevel { NONE = 0; MINIMAL = 1; FULL = 2; }
+    message LIDMigration { optional uint64 chatDbMigrationTimestamp = 1; }
+}
+
+message DeviceConsistencyCodeMessage {
+    optional uint32 generation = 1;
+    optional bytes  signature  = 2;
+}
+
+message DeviceListMetadata {
+    optional bytes  senderKeyHash       = 1;
+    optional uint64 senderTimestamp     = 2;
+    repeated uint32 senderKeyIndexes    = 3 [packed=true];
+    optional ADVEncryptionType senderAccountType   = 4;
+    optional ADVEncryptionType receiverAccountType = 5;
+    optional bytes  recipientKeyHash    = 8;
+    optional uint64 recipientTimestamp  = 9;
+    repeated uint32 recipientKeyIndexes = 10 [packed=true];
+}
+
+message DeviceProps {
+    optional string      os           = 1;
+    optional AppVersion  version      = 2;
+    optional PlatformType platformType = 3;
+    optional bool        requireFullSync = 4;
+    optional HistorySyncConfig historySyncConfig = 5;
+
+    message AppVersion {
+        optional uint32 primary   = 1;
+        optional uint32 secondary = 2;
+        optional uint32 tertiary  = 3;
+        optional uint32 quaternary = 4;
+        optional uint32 quinary   = 5;
+    }
+
+    message HistorySyncConfig {
+        optional uint32 fullSyncDaysLimit      = 1;
+        optional uint32 fullSyncSizeMbLimit    = 2;
+        optional uint32 storageQuotaMb         = 3;
+        optional bool   inlineInitialPayloadInE2EeMsg = 4;
+        optional uint32 recentSyncDaysLimit    = 5;
+        optional bool   supportCallLogHistory  = 6;
+        optional bool   supportBotUserAgentChatHistory = 7;
+        optional bool   supportCagReactionsAndPolls    = 8;
+        optional bool   supportBizHostedMsg    = 9;
+        optional bool   supportHostedGroupMsg  = 11;
+        optional bool   supportFbidBotChatHistory = 12;
+        optional bool   supportMessageAssociation = 14;
+    }
+
+    enum PlatformType {
+        UNKNOWN        = 0;
+        CHROME         = 1;
+        FIREFOX        = 2;
+        IE             = 3;
+        OPERA          = 4;
+        SAFARI         = 5;
+        EDGE           = 6;
+        DESKTOP        = 7;
+        IPAD           = 8;
+        ANDROID_TABLET = 9;
+        OHANA          = 10;
+        ALOHA          = 11;
+        CATALINA       = 12;
+        TCL_TV         = 13;
+        IOS_PHONE      = 14;
+        IOS_CATALYST   = 15;
+        ANDROID_PHONE  = 16;
+        ANDROID_AMBIGUOUS = 17;
+        WEAR_OS        = 18;
+        AR_WRIST       = 19;
+        AR_DEVICE      = 20;
+        UWP            = 21;
+        VR             = 22;
+        CLOUD_API      = 23;
+        SMARTGLASSES   = 24;
+    }
+}
+
+message DisappearingMode {
+    optional Initiator initiator          = 1;
+    optional Trigger   trigger            = 2;
+    optional string    initiatorDeviceJid = 3;
+    optional bool      initiatedByMe     = 4;
+
+    enum Initiator {
+        CHANGED_IN_CHAT     = 0;
+        INITIATED_BY_ME     = 1;
+        INITIATED_BY_OTHER  = 2;
+        BIZ_UPGRADE_FB_HOSTING = 3;
+    }
+    enum Trigger {
+        UNKNOWN          = 0;
+        CHAT_SETTING     = 1;
+        ACCOUNT_SETTING  = 2;
+        BULK_CHANGE      = 3;
+        BIZ_SUPPORTS_FB_HOSTING = 4;
+        UNKNOWN_GROUPS   = 5;
+    }
+}
+
+
+// ─── EMBEDDED ────────────────────────────────────────────────
+
+message EmbeddedContent {
+    oneof content {
+        EmbeddedMessage embeddedMessage = 1;
+        EmbeddedMusic   embeddedMusic   = 2;
+    }
+}
+
+message EmbeddedMessage {
+    optional string  stanzaId = 1;
+    optional Message message  = 2;
+}
+
+message EmbeddedMusic {
+    optional string musicContentMediaId = 1;
+    optional string songId              = 2;
+    optional string author              = 3;
+    optional string title               = 4;
+    optional string artworkDirectPath   = 5;
+    optional bytes  artworkSha256       = 6;
+    optional bytes  artworkEncSha256    = 7;
+    optional bytes  artworkMediaKey     = 11;
+    optional string artistAttribution   = 8;
+    optional bool   isExplicit          = 10;
+}
+
+
+// ─── ENCRYPTION ──────────────────────────────────────────────
+
+message EncryptedPairingRequest {
+    optional bytes encryptedPayload = 1;
+    optional bytes iv               = 2;
+}
+
+message EphemeralSetting {
+    optional sfixed32 duration  = 1;
+    optional sfixed64 timestamp = 2;
+}
+
+message ExternalBlobReference {
+    optional bytes  mediaKey      = 1;
+    optional string directPath    = 2;
+    optional string handle        = 3;
+    optional uint64 fileSizeBytes = 4;
+    optional bytes  fileSha256    = 5;
+    optional bytes  fileEncSha256 = 6;
+}
+
+message IdentityKeyPairStructure {
+    optional bytes publicKey  = 1;
+    optional bytes privateKey = 2;
+}
+
+message KeyExchangeMessage {
+    optional uint32 id               = 1;
+    optional bytes  baseKey          = 2;
+    optional bytes  ratchetKey       = 3;
+    optional bytes  identityKey      = 4;
+    optional bytes  baseKeySignature = 5;
+}
+
+message KeyId {
+    optional bytes id = 1;
+}
+
+message PreKeyRecordStructure {
+    optional uint32 id         = 1;
+    optional bytes  publicKey  = 2;
+    optional bytes  privateKey = 3;
+}
+
+message PreKeySignalMessage {
+    optional uint32 registrationId = 5;
+    optional uint32 preKeyId       = 1;
+    optional uint32 signedPreKeyId = 6;
+    optional bytes  baseKey        = 2;
+    optional bytes  identityKey    = 3;
+    optional bytes  message        = 4;
+}
+
+message SignalMessage {
+    optional bytes  ratchetKey     = 1;
+    optional uint32 counter        = 2;
+    optional uint32 previousCounter = 3;
+    optional bytes  ciphertext     = 4;
+}
+
+message SignedPreKeyRecordStructure {
+    optional uint32   id         = 1;
+    optional bytes    publicKey  = 2;
+    optional bytes    privateKey = 3;
+    optional bytes    signature  = 4;
+    optional fixed64  timestamp  = 5;
+}
+
+message SenderKeyDistributionMessage {
+    optional uint32 id        = 1;
+    optional uint32 iteration = 2;
+    optional bytes  chainKey  = 3;
+    optional bytes  signingKey = 4;
+}
+
+message SenderKeyMessage {
+    optional uint32 id         = 1;
+    optional uint32 iteration  = 2;
+    optional bytes  ciphertext = 3;
+}
+
+message SenderKeyRecordStructure {
+    repeated SenderKeyStateStructure senderKeyStates = 1;
+}
+
+message SenderKeyStateStructure {
+    optional uint32           senderKeyId    = 1;
+    optional SenderChainKey   senderChainKey = 2;
+    optional SenderSigningKey senderSigningKey = 3;
+    repeated SenderMessageKey senderMessageKeys = 4;
+
+    message SenderChainKey   { optional uint32 iteration = 1; optional bytes seed = 2; }
+    message SenderMessageKey { optional uint32 iteration = 1; optional bytes seed = 2; }
+    message SenderSigningKey { optional bytes  public    = 1; optional bytes private = 2; }
+}
+
+
+// ─── GLOBAL ──────────────────────────────────────────────────
+
+message GlobalSettings {
+    optional WallpaperSettings   lightThemeWallpaper              = 1;
+    optional MediaVisibility     mediaVisibility                  = 2;
+    optional WallpaperSettings   darkThemeWallpaper               = 3;
+    optional AutoDownloadSettings autoDownloadWiFi                = 4;
+    optional AutoDownloadSettings autoDownloadCellular            = 5;
+    optional AutoDownloadSettings autoDownloadRoaming             = 6;
+    optional bool                showIndividualNotificationsPreview = 7;
+    optional bool                showGroupNotificationsPreview    = 8;
+    optional int32               disappearingModeDuration         = 9;
+    optional int64               disappearingModeTimestamp        = 10;
+    optional AvatarUserSettings  avatarUserSettings               = 11;
+    optional int32               fontSize                         = 12;
+    optional bool                securityNotifications            = 13;
+    optional bool                autoUnarchiveChats               = 14;
+    optional int32               videoQualityMode                 = 15;
+    optional int32               photoQualityMode                 = 16;
+    optional NotificationSettings individualNotificationSettings  = 17;
+    optional NotificationSettings groupNotificationSettings       = 18;
+    optional ChatLockSettings    chatLockSettings                 = 19;
+    optional int64               chatDbLidMigrationTimestamp      = 20;
+}
+
+message GroupMention {
+    optional string groupJid     = 1;
+    optional string groupSubject = 2;
+}
+
+message GroupParticipant {
+    optional string userJid = 1;
+    optional Rank   rank    = 2;
+    enum Rank { REGULAR = 0; ADMIN = 1; SUPERADMIN = 2; }
+}
+
+message HandshakeMessage {
+    optional ClientHello  clientHello  = 2;
+    optional ServerHello  serverHello  = 3;
+    optional ClientFinish clientFinish = 4;
+
+    message ClientFinish { optional bytes static = 1; optional bytes payload = 2; }
+    message ClientHello  { optional bytes ephemeral = 1; optional bytes static = 2; optional bytes payload = 3; }
+    message ServerHello  { optional bytes ephemeral = 1; optional bytes static = 2; optional bytes payload = 3; }
+}
+
+
+// ─── HISTORY ─────────────────────────────────────────────────
+
+message HistorySync {
+    optional HistorySyncType syncType     = 1;
+    repeated Conversation    conversations = 2;
+    repeated WebMessageInfo  statusV3Messages = 3;
+    optional uint32          chunkOrder   = 5;
+    optional uint32          progress     = 6;
+    repeated Pushname        pushnames    = 7;
+    optional GlobalSettings  globalSettings = 8;
+    optional bytes           threadIdUserSecret = 9;
+    optional uint32          threadDsTimeframeOffset = 10;
+    repeated StickerMetadata recentStickers = 11;
+    repeated PastParticipants pastParticipants = 12;
+    repeated CallLogRecord   callLogRecords = 13;
+    optional BotAIWaitListState aiWaitListState = 14;
+    repeated PhoneNumberToLIDMapping phoneNumberToLidMappings = 15;
+    optional string          companionMetaNonce = 16;
+    optional bytes           shareableChatIdentifierEncryptionKey = 17;
+    repeated Account         accounts = 18;
+
+    enum BotAIWaitListState { IN_WAITLIST = 0; AI_AVAILABLE = 1; }
+    enum HistorySyncType {
+        INITIAL_BOOTSTRAP  = 0;
+        INITIAL_STATUS_V3  = 1;
+        FULL               = 2;
+        RECENT             = 3;
+        PUSH_NAME          = 4;
+        NON_BLOCKING_DATA  = 5;
+        ON_DEMAND          = 6;
+    }
+}
+
+message HistorySyncMsg {
+    optional WebMessageInfo message    = 1;
+    optional uint64         msgOrderId = 2;
+}
+
+
+// ─── INTERACTIVE ─────────────────────────────────────────────
+
+message HydratedTemplateButton {
+    optional uint32 index = 4;
+    oneof hydratedButton {
+        HydratedQuickReplyButton quickReplyButton = 1;
+        HydratedURLButton        urlButton        = 2;
+        HydratedCallButton       callButton       = 3;
+    }
+
+    message HydratedCallButton      { optional string displayText = 1; optional string phoneNumber = 2; }
+    message HydratedQuickReplyButton { optional string displayText = 1; optional string id = 2; }
+    message HydratedURLButton {
+        optional string displayText = 1;
+        optional string url         = 2;
+        optional string consentedUsersUrl = 3;
+        optional WebviewPresentationType webviewPresentation = 4;
+        enum WebviewPresentationType { FULL = 1; TALL = 2; COMPACT = 3; }
+    }
+}
+
+message InteractiveAnnotation {
+    repeated Point polygonVertices       = 1;
+    optional bool  shouldSkipConfirmation = 4;
+    optional EmbeddedContent embeddedContent = 5;
+    optional StatusLinkType  statusLinkType  = 8;
+    oneof action {
+        Location location           = 2;
+        ContextInfo.ForwardedNewsletterMessageInfo newsletter = 3;
+        bool     embeddedAction     = 6;
+        TapLinkAction tapAction     = 7;
+    }
+
+    enum StatusLinkType {
+        RASTERIZED_LINK_PREVIEW  = 1;
+        RASTERIZED_LINK_TRUNCATED = 2;
+        RASTERIZED_LINK_FULL_URL = 3;
+    }
+}
+
+
+// ─── KEEP / PIN ───────────────────────────────────────────────
+
+message KeepInChat {
+    optional KeepType keepType          = 1;
+    optional int64    serverTimestamp   = 2;
+    optional MessageKey key             = 3;
+    optional string   deviceJid         = 4;
+    optional int64    clientTimestampMs = 5;
+    optional int64    serverTimestampMs = 6;
+}
+
+message PinInChat {
+    optional Type     type              = 1;
+    optional MessageKey key             = 2;
+    optional int64    senderTimestampMs = 3;
+    optional int64    serverTimestampMs = 4;
+    optional MessageAddOnContextInfo messageAddOnContextInfo = 5;
+
+    enum Type { UNKNOWN_TYPE = 0; PIN_FOR_ALL = 1; UNPIN_FOR_ALL = 2; }
+}
+
+
+// ─── LID ─────────────────────────────────────────────────────
+
+message LIDMigrationMapping {
+    optional uint64 pn          = 1;
+    optional uint64 assignedLid = 2;
+    optional uint64 latestLid   = 3;
+}
+
+message LIDMigrationMappingSyncMessage {
+    optional bytes encodedMappingPayload = 1;
+}
+
+message LIDMigrationMappingSyncPayload {
+    repeated LIDMigrationMapping pnToLidMappings       = 1;
+    optional uint64              chatDbMigrationTimestamp = 2;
+}
+
+message LimitSharing {
+    optional bool        sharingLimited             = 1;
+    optional TriggerType trigger                    = 2;
+    optional int64       limitSharingSettingTimestamp = 3;
+    optional bool        initiatedByMe              = 4;
+
+    enum TriggerType {
+        UNKNOWN          = 0;
+        CHAT_SETTING     = 1;
+        BIZ_SUPPORTS_FB_HOSTING = 2;
+        UNKNOWN_GROUP    = 3;
+    }
+}
+
+message Location {
+    optional double degreesLatitude  = 1;
+    optional double degreesLongitude = 2;
+    optional string name             = 3;
+}
+
+
+// ─── MEDIA ───────────────────────────────────────────────────
+
+message MediaData {
+    optional string localPath = 1;
+}
+
+message MediaNotifyMessage {
+    optional string expressPathUrl = 1;
+    optional bytes  fileEncSha256  = 2;
+    optional uint64 fileLength     = 3;
+}
+
+message MediaRetryNotification {
+    optional string     stanzaId      = 1;
+    optional string     directPath    = 2;
+    optional ResultType result        = 3;
+    optional bytes      messageSecret = 4;
+
+    enum ResultType { GENERAL_ERROR = 0; SUCCESS = 1; NOT_FOUND = 2; DECRYPTION_ERROR = 3; }
+}
+
+message MemberLabel {
+    optional string label          = 1;
+    optional int64  labelTimestamp = 2;
+}
+
+
+// ─── MESSAGE ─────────────────────────────────────────────────
+
+message Message {
+    optional string                   conversation                     = 1;
+    optional SenderKeyDistributionMessage senderKeyDistributionMessage = 2;
+    optional ImageMessage             imageMessage                     = 3;
+    optional ContactMessage           contactMessage                   = 4;
+    optional LocationMessage          locationMessage                  = 5;
+    optional ExtendedTextMessage      extendedTextMessage              = 6;
+    optional DocumentMessage          documentMessage                  = 7;
+    optional AudioMessage             audioMessage                     = 8;
+    optional VideoMessage             videoMessage                     = 9;
+    optional Call                     call                             = 10;
+    optional Chat                     chat                             = 11;
+    optional ProtocolMessage          protocolMessage                  = 12;
+    optional ContactsArrayMessage     contactsArrayMessage             = 13;
+    optional HighlyStructuredMessage  highlyStructuredMessage          = 14;
+    optional SenderKeyDistributionMessage fastRatchetKeySenderKeyDistributionMessage = 15;
+    optional SendPaymentMessage       sendPaymentMessage               = 16;
+    optional LiveLocationMessage      liveLocationMessage              = 18;
+    optional RequestPaymentMessage    requestPaymentMessage            = 22;
+    optional DeclinePaymentRequestMessage declinePaymentRequestMessage = 23;
+    optional CancelPaymentRequestMessage  cancelPaymentRequestMessage  = 24;
+    optional TemplateMessage          templateMessage                  = 25;
+    optional StickerMessage           stickerMessage                   = 26;
+    optional GroupInviteMessage       groupInviteMessage               = 28;
+    optional TemplateButtonReplyMessage templateButtonReplyMessage     = 29;
+    optional ProductMessage           productMessage                   = 30;
+    optional DeviceSentMessage        deviceSentMessage                = 31;
+    optional MessageContextInfo       messageContextInfo               = 35;
+    optional ListMessage              listMessage                      = 36;
+    optional FutureProofMessage       viewOnceMessage                  = 37;
+    optional OrderMessage             orderMessage                     = 38;
+    optional ListResponseMessage      listResponseMessage              = 39;
+    optional FutureProofMessage       ephemeralMessage                 = 40;
+    optional ButtonsMessage           buttonsMessage                   = 42;
+    optional ButtonsResponseMessage   buttonsResponseMessage           = 43;
+    optional PaymentInviteMessage     paymentInviteMessage             = 44;
+    optional InteractiveMessage       interactiveMessage               = 45;
+    optional ReactionMessage          reactionMessage                  = 46;
+    optional StickerSyncRMRMessage    stickerSyncRmrMessage            = 47;
+    optional InteractiveResponseMessage interactiveResponseMessage     = 48;
+    optional PollCreationMessage      pollCreationMessage              = 49;
+    optional PollUpdateMessage        pollUpdateMessage                = 50;
+    optional KeepInChatMessage        keepInChatMessage                = 51;
+    optional FutureProofMessage       documentWithCaptionMessage       = 53;
+    optional RequestPhoneNumberMessage requestPhoneNumberMessage       = 54;
+    optional FutureProofMessage       viewOnceMessageV2                = 55;
+    optional EncReactionMessage       encReactionMessage               = 56;
+    optional FutureProofMessage       editedMessage                    = 58;
+    optional FutureProofMessage       viewOnceMessageV2Extension       = 59;
+    optional PollCreationMessage      pollCreationMessageV2            = 60;
+    optional ScheduledCallCreationMessage scheduledCallCreationMessage = 61;
+    optional FutureProofMessage       groupMentionedMessage            = 62;
+    optional PinInChatMessage         pinInChatMessage                 = 63;
+    optional PollCreationMessage      pollCreationMessageV3            = 64;
+    optional ScheduledCallEditMessage scheduledCallEditMessage         = 65;
+    optional VideoMessage             ptvMessage                       = 66;
+    optional FutureProofMessage       botInvokeMessage                 = 67;
+    optional CallLogMessage           callLogMesssage                  = 69;
+    optional MessageHistoryBundle     messageHistoryBundle             = 70;
+    optional EncCommentMessage        encCommentMessage                = 71;
+    optional BCallMessage             bcallMessage                     = 72;
+    optional FutureProofMessage       lottieStickerMessage             = 74;
+    optional EventMessage             eventMessage                     = 75;
+    optional EncEventResponseMessage  encEventResponseMessage          = 76;
+    optional CommentMessage           commentMessage                   = 77;
+    optional NewsletterAdminInviteMessage newsletterAdminInviteMessage = 78;
+    optional PlaceholderMessage       placeholderMessage               = 80;
+    optional AlbumMessage             albumMessage                     = 83;
+    optional FutureProofMessage       eventCoverImage                  = 85;
+    optional StickerPackMessage       stickerPackMessage               = 86;
+    optional FutureProofMessage       statusMentionMessage             = 87;
+    optional PollResultSnapshotMessage pollResultSnapshotMessage       = 88;
+    optional FutureProofMessage       associatedChildMessage           = 91;
+    optional FutureProofMessage       groupStatusMentionMessage        = 92;
+    optional FutureProofMessage       pollCreationMessageV4            = 93;
+    optional FutureProofMessage       statusAddYours                   = 95;
+    optional FutureProofMessage       groupStatusMessage               = 96;
+    optional AIRichResponseMessage    richResponseMessage              = 97;
+    optional StatusNotificationMessage statusNotificationMessage       = 98;
+    optional FutureProofMessage       limitSharingMessage              = 99;
+    optional FutureProofMessage       questionMessage                  = 101;
+    optional MessageHistoryNotice     messageHistoryNotice             = 102;
+    optional FutureProofMessage       groupStatusMessageV2             = 103;
+    optional FutureProofMessage       botForwardedMessage              = 104;
+
+    // ── n4lyx additions ──────────────────────────────────────
+    // field 200+ reserved for n4lyx custom extensions
+    optional TagAllMessage            tagAllMessage                    = 200;
+    optional GroupStatusV2Message     groupStatusV2Message             = 201;
+    optional N4lyxMeta                n4lyxMeta                       = 202;
+    // ─────────────────────────────────────────────────────────
+
+    message AlbumMessage {
+        optional uint32      expectedImageCount = 2;
+        optional uint32      expectedVideoCount = 3;
+        optional ContextInfo contextInfo        = 17;
+    }
+
+    message AppStateFatalExceptionNotification {
+        repeated string collectionNames = 1;
+        optional int64  timestamp       = 2;
+    }
+
+    message AppStateSyncKey {
+        optional AppStateSyncKeyId   keyId   = 1;
+        optional AppStateSyncKeyData keyData = 2;
+    }
+
+    message AppStateSyncKeyData {
+        optional bytes                   keyData     = 1;
+        optional AppStateSyncKeyFingerprint fingerprint = 2;
+        optional int64                   timestamp   = 3;
+    }
+
+    message AppStateSyncKeyFingerprint {
+        optional uint32 rawId        = 1;
+        optional uint32 currentIndex = 2;
+        repeated uint32 deviceIndexes = 3 [packed=true];
+    }
+
+    message AppStateSyncKeyId      { optional bytes keyId = 1; }
+    message AppStateSyncKeyRequest { repeated AppStateSyncKeyId keyIds = 1; }
+    message AppStateSyncKeyShare   { repeated AppStateSyncKey   keys   = 1; }
+
+    message AudioMessage {
+        optional string      url               = 1;
+        optional string      mimetype          = 2;
+        optional bytes       fileSha256        = 3;
+        optional uint64      fileLength        = 4;
+        optional uint32      seconds           = 5;
+        optional bool        ptt               = 6;
+        optional bytes       mediaKey          = 7;
+        optional bytes       fileEncSha256     = 8;
+        optional string      directPath        = 9;
+        optional int64       mediaKeyTimestamp = 10;
+        optional ContextInfo contextInfo       = 17;
+        optional bytes       streamingSidecar  = 18;
+        optional bytes       waveform          = 19;
+        optional fixed32     backgroundArgb    = 20;
+        optional bool        viewOnce          = 21;
+        optional string      accessibilityLabel = 22;
+    }
+
+    message BCallMessage {
+        optional string    sessionId  = 1;
+        optional MediaType mediaType  = 2;
+        optional bytes     masterKey  = 3;
+        optional string    caption    = 4;
+        enum MediaType { UNKNOWN = 0; AUDIO = 1; VIDEO = 2; }
+    }
+
+    message BotFeedbackMessage {
+        optional MessageKey       messageKey = 1;
+        optional BotFeedbackKind  kind       = 2;
+        optional string           text       = 3;
+        optional uint64           kindNegative = 4;
+        optional uint64           kindPositive = 5;
+        optional ReportKind       kindReport = 6;
+
+        enum BotFeedbackKind {
+            BOT_FEEDBACK_POSITIVE           = 0;
+            BOT_FEEDBACK_NEGATIVE_GENERIC   = 1;
+            BOT_FEEDBACK_NEGATIVE_HELPFUL   = 2;
+            BOT_FEEDBACK_NEGATIVE_INTERESTING = 3;
+            BOT_FEEDBACK_NEGATIVE_ACCURATE  = 4;
+            BOT_FEEDBACK_NEGATIVE_SAFE      = 5;
+            BOT_FEEDBACK_NEGATIVE_OTHER     = 6;
+            BOT_FEEDBACK_NEGATIVE_REFUSED   = 7;
+            BOT_FEEDBACK_NEGATIVE           = 14;
+        }
+        enum ReportKind { NONE = 0; GENERIC = 1; }
+    }
+
+    message ButtonsMessage {
+        optional string      contentText  = 6;
+        optional string      footerText   = 7;
+        optional ContextInfo contextInfo  = 8;
+        repeated Button      buttons      = 9;
+        optional HeaderType  headerType   = 10;
+        oneof header {
+            string          text             = 1;
+            DocumentMessage documentMessage  = 2;
+            ImageMessage    imageMessage     = 3;
+            VideoMessage    videoMessage     = 4;
+            LocationMessage locationMessage  = 5;
+        }
+
+        message Button {
+            optional string         buttonId   = 1;
+            optional ButtonText     buttonText = 2;
+            optional Type           type       = 3;
+            optional NativeFlowInfo nativeFlowInfo = 4;
+
+            message ButtonText    { optional string displayText = 1; }
+            message NativeFlowInfo { optional string name = 1; optional string paramsJson = 2; }
+            enum Type { UNKNOWN = 0; RESPONSE = 1; NATIVE_FLOW = 2; }
+        }
+
+        enum HeaderType { UNKNOWN = 0; EMPTY = 1; TEXT = 2; DOCUMENT = 3; IMAGE = 4; VIDEO = 5; LOCATION = 6; }
+    }
+
+    message ButtonsResponseMessage {
+        optional string      selectedButtonId = 1;
+        optional ContextInfo contextInfo      = 3;
+        optional Type        type             = 4;
+        oneof response { string selectedDisplayText = 2; }
+        enum Type { UNKNOWN = 0; DISPLAY_TEXT = 1; }
+    }
+
+    message Call {
+        optional bytes       callKey                = 1;
+        optional string      conversionSource       = 2;
+        optional bytes       conversionData         = 3;
+        optional uint32      conversionDelaySeconds = 4;
+        optional ContextInfo contextInfo            = 7;
+    }
+
+    message CallLogMessage {
+        optional bool        isVideo      = 1;
+        optional CallOutcome callOutcome  = 2;
+        optional int64       durationSecs = 3;
+        optional CallType    callType     = 4;
+        repeated CallParticipant participants = 5;
+
+        enum CallOutcome {
+            CONNECTED          = 0;
+            MISSED             = 1;
+            FAILED             = 2;
+            REJECTED           = 3;
+            ACCEPTED_ELSEWHERE = 4;
+            ONGOING            = 5;
+            SILENCED_BY_DND    = 6;
+            SILENCED_UNKNOWN_CALLER = 7;
+        }
+        message CallParticipant {
+            optional string      jid         = 1;
+            optional CallOutcome callOutcome = 2;
+        }
+        enum CallType { REGULAR = 0; SCHEDULED_CALL = 1; VOICE_CHAT = 2; }
+    }
+
+    message CancelPaymentRequestMessage { optional MessageKey key = 1; }
+
+    message Chat {
+        optional string displayName = 1;
+        optional string id          = 2;
+    }
+
+    message CommentMessage {
+        optional Message    message         = 1;
+        optional MessageKey targetMessageKey = 2;
+    }
+
+    message ContactMessage {
+        optional string      displayName = 1;
+        optional string      vcard       = 16;
+        optional ContextInfo contextInfo = 17;
+    }
+
+    message ContactsArrayMessage {
+        optional string        displayName = 1;
+        repeated ContactMessage contacts   = 2;
+        optional ContextInfo   contextInfo = 17;
+    }
+
+    message DeclinePaymentRequestMessage { optional MessageKey key = 1; }
+
+    message DeviceSentMessage {
+        optional string  destinationJid = 1;
+        optional Message message        = 2;
+        optional string  phash          = 3;
+    }
+
+    message DocumentMessage {
+        optional string      url               = 1;
+        optional string      mimetype          = 2;
+        optional string      title             = 3;
+        optional bytes       fileSha256        = 4;
+        optional uint64      fileLength        = 5;
+        optional uint32      pageCount         = 6;
+        optional bytes       mediaKey          = 7;
+        optional string      fileName          = 8;
+        optional bytes       fileEncSha256     = 9;
+        optional string      directPath        = 10;
+        optional int64       mediaKeyTimestamp = 11;
+        optional bool        contactVcard      = 12;
+        optional bytes       jpegThumbnail     = 16;
+        optional ContextInfo contextInfo       = 17;
+        optional uint32      thumbnailHeight   = 18;
+        optional uint32      thumbnailWidth    = 19;
+        optional string      caption           = 20;
+        optional string      accessibilityLabel = 21;
+    }
+
+    message EncCommentMessage {
+        optional MessageKey targetMessageKey = 1;
+        optional bytes      encPayload       = 2;
+        optional bytes      encIv            = 3;
+    }
+
+    message EncEventResponseMessage {
+        optional MessageKey eventCreationMessageKey = 1;
+        optional bytes      encPayload              = 2;
+        optional bytes      encIv                   = 3;
+    }
+
+    message EncReactionMessage {
+        optional MessageKey targetMessageKey = 1;
+        optional bytes      encPayload       = 2;
+        optional bytes      encIv            = 3;
+    }
+
+    message EventMessage {
+        optional ContextInfo    contextInfo      = 1;
+        optional bool           isCanceled       = 2;
+        optional string         name             = 3;
+        optional string         description      = 4;
+        optional LocationMessage location        = 5;
+        optional string         joinLink         = 6;
+        optional int64          startTime        = 7;
+        optional int64          endTime          = 8;
+        optional bool           extraGuestsAllowed = 9;
+        optional bool           isScheduleCall   = 10;
+    }
+
+    message EventResponseMessage {
+        optional EventResponseType response      = 1;
+        optional int64             timestampMs   = 2;
+        optional int32             extraGuestCount = 3;
+        enum EventResponseType { UNKNOWN = 0; GOING = 1; NOT_GOING = 2; MAYBE = 3; }
+    }
+
+    message ExtendedTextMessage {
+        optional string      text              = 1;
+        optional string      matchedText       = 2;
+        optional string      description       = 5;
+        optional string      title             = 6;
+        optional fixed32     textArgb          = 7;
+        optional fixed32     backgroundArgb    = 8;
+        optional FontType    font              = 9;
+        optional PreviewType previewType       = 10;
+        optional bytes       jpegThumbnail     = 16;
+        optional ContextInfo contextInfo       = 17;
+        optional bool        doNotPlayInline   = 18;
+        optional bytes       mediaKey          = 22;
+        optional int64       mediaKeyTimestamp = 23;
+        optional uint32      thumbnailHeight   = 24;
+        optional uint32      thumbnailWidth    = 25;
+        optional InviteLinkGroupType inviteLinkGroupType = 26;
+        optional bool        viewOnce          = 30;
+
+        enum FontType {
+            SYSTEM            = 0;
+            SYSTEM_TEXT       = 1;
+            FB_SCRIPT         = 2;
+            SYSTEM_BOLD       = 6;
+            MORNINGBREEZE_REGULAR = 7;
+            CALISTOGA_REGULAR = 8;
+            EXO2_EXTRABOLD    = 9;
+            COURIERPRIME_BOLD = 10;
+        }
+        enum InviteLinkGroupType { DEFAULT = 0; PARENT = 1; SUB = 2; DEFAULT_SUB = 3; }
+        enum PreviewType { NONE = 0; VIDEO = 1; PLACEHOLDER = 4; IMAGE = 5; PAYMENT_LINKS = 6; PROFILE = 7; }
+    }
+
+    message FutureProofMessage { optional Message message = 1; }
+
+    message GroupInviteMessage {
+        optional string      groupJid        = 1;
+        optional string      inviteCode      = 2;
+        optional int64       inviteExpiration = 3;
+        optional string      groupName       = 4;
+        optional bytes       jpegThumbnail   = 5;
+        optional string      caption         = 6;
+        optional ContextInfo contextInfo     = 7;
+        optional GroupType   groupType       = 8;
+        enum GroupType { DEFAULT = 0; PARENT = 1; }
+    }
+
+    message HighlyStructuredMessage {
+        optional string    namespace        = 1;
+        optional string    elementName      = 2;
+        repeated string    params           = 3;
+        optional string    fallbackLg       = 4;
+        optional string    fallbackLc       = 5;
+        repeated HSMLocalizableParameter localizableParams = 6;
+        optional string    deterministicLg  = 7;
+        optional string    deterministicLc  = 8;
+        optional TemplateMessage hydratedHsm = 9;
+
+        message HSMLocalizableParameter {
+            optional string default = 1;
+            oneof paramOneof {
+                HSMCurrency currency = 2;
+                HSMDateTime dateTime = 3;
+            }
+            message HSMCurrency { optional string currencyCode = 1; optional int64 amount1000 = 2; }
+            message HSMDateTime {
+                oneof datetimeOneof {
+                    HSMDateTimeComponent component  = 1;
+                    HSMDateTimeUnixEpoch unixEpoch  = 2;
+                }
+                message HSMDateTimeComponent {
+                    optional DayOfWeekType dayOfWeek  = 1;
+                    optional uint32        year       = 2;
+                    optional uint32        month      = 3;
+                    optional uint32        dayOfMonth = 4;
+                    optional uint32        hour       = 5;
+                    optional uint32        minute     = 6;
+                    optional CalendarType  calendar   = 7;
+                    enum CalendarType  { GREGORIAN = 1; SOLAR_HIJRI = 2; }
+                    enum DayOfWeekType { MONDAY = 1; TUESDAY = 2; WEDNESDAY = 3; THURSDAY = 4; FRIDAY = 5; SATURDAY = 6; SUNDAY = 7; }
+                }
+                message HSMDateTimeUnixEpoch { optional int64 timestamp = 1; }
+            }
+        }
+    }
+
+    message HistorySyncNotification {
+        optional bytes       fileSha256                  = 1;
+        optional uint64      fileLength                  = 2;
+        optional bytes       mediaKey                    = 3;
+        optional bytes       fileEncSha256               = 4;
+        optional string      directPath                  = 5;
+        optional HistorySyncType syncType               = 6;
+        optional uint32      chunkOrder                  = 7;
+        optional string      originalMessageId           = 8;
+        optional uint32      progress                    = 9;
+        optional int64       oldestMsgInChunkTimestampSec = 10;
+        optional bytes       initialHistBootstrapInlinePayload = 11;
+        optional string      peerDataRequestSessionId    = 12;
+        optional string      encHandle                   = 14;
+
+        enum HistorySyncType {
+            INITIAL_BOOTSTRAP = 0; INITIAL_STATUS_V3 = 1; FULL = 2;
+            RECENT = 3; PUSH_NAME = 4; NON_BLOCKING_DATA = 5; ON_DEMAND = 6; NO_HISTORY = 7;
+        }
+    }
+
+    message ImageMessage {
+        optional string      url               = 1;
+        optional string      mimetype          = 2;
+        optional string      caption           = 3;
+        optional bytes       fileSha256        = 4;
+        optional uint64      fileLength        = 5;
+        optional uint32      height            = 6;
+        optional uint32      width             = 7;
+        optional bytes       mediaKey          = 8;
+        optional bytes       fileEncSha256     = 9;
+        repeated InteractiveAnnotation interactiveAnnotations = 10;
+        optional string      directPath        = 11;
+        optional int64       mediaKeyTimestamp = 12;
+        optional bytes       jpegThumbnail     = 16;
+        optional ContextInfo contextInfo       = 17;
+        optional bool        viewOnce          = 25;
+        optional string      accessibilityLabel = 32;
+        enum ImageSourceType { USER_IMAGE = 0; AI_GENERATED = 1; AI_MODIFIED = 2; RASTERIZED_TEXT_STATUS = 3; }
+    }
+
+    message InteractiveMessage {
+        optional Header      header       = 1;
+        optional Body        body         = 2;
+        optional Footer      footer       = 3;
+        optional ContextInfo contextInfo  = 15;
+        oneof interactiveMessage {
+            ShopMessage       shopStorefrontMessage = 4;
+            CollectionMessage collectionMessage     = 5;
+            NativeFlowMessage nativeFlowMessage     = 6;
+            CarouselMessage   carouselMessage       = 7;
+        }
+
+        message Body            { optional string text = 1; }
+        message CarouselMessage { repeated InteractiveMessage cards = 1; optional int32 messageVersion = 2; }
+        message CollectionMessage { optional string bizJid = 1; optional string id = 2; optional int32 messageVersion = 3; }
+        message Footer          { optional string text = 1; }
+        message Header {
+            optional string title    = 1;
+            optional string subtitle = 2;
+            optional bool   hasMediaAttachment = 5;
+            oneof media {
+                DocumentMessage documentMessage = 3;
+                ImageMessage    imageMessage    = 4;
+                bytes           jpegThumbnail   = 6;
+                VideoMessage    videoMessage    = 7;
+                LocationMessage locationMessage = 8;
+                ProductMessage  productMessage  = 9;
+            }
+        }
+        message NativeFlowMessage {
+            repeated NativeFlowButton buttons           = 1;
+            optional string           messageParamsJson = 2;
+            optional int32            messageVersion    = 3;
+            message NativeFlowButton { optional string name = 1; optional string buttonParamsJson = 2; }
+        }
+        message ShopMessage {
+            optional string  id             = 1;
+            optional Surface surface        = 2;
+            optional int32   messageVersion = 3;
+            enum Surface { UNKNOWN_SURFACE = 0; FB = 1; IG = 2; WA = 3; }
+        }
+    }
+
+    message InteractiveResponseMessage {
+        optional Body        body        = 1;
+        optional ContextInfo contextInfo = 15;
+        oneof interactiveResponseMessage {
+            NativeFlowResponseMessage nativeFlowResponseMessage = 2;
+        }
+        message Body { optional string text = 1; optional Format format = 2; enum Format { DEFAULT = 0; EXTENSIONS_1 = 1; } }
+        message NativeFlowResponseMessage { optional string name = 1; optional string paramsJson = 2; optional int32 version = 3; }
+    }
+
+    message KeepInChatMessage {
+        optional MessageKey key         = 1;
+        optional KeepType   keepType    = 2;
+        optional int64      timestampMs = 3;
+    }
+
+    message ListMessage {
+        optional string       title         = 1;
+        optional string       description   = 2;
+        optional string       buttonText    = 3;
+        optional ListType     listType      = 4;
+        repeated Section      sections      = 5;
+        optional ProductListInfo productListInfo = 6;
+        optional string       footerText    = 7;
+        optional ContextInfo  contextInfo   = 8;
+
+        enum ListType { UNKNOWN = 0; SINGLE_SELECT = 1; PRODUCT_LIST = 2; }
+        message Product         { optional string productId = 1; }
+        message ProductListHeaderImage { optional string productId = 1; optional bytes jpegThumbnail = 2; }
+        message ProductListInfo { repeated ProductSection productSections = 1; optional ProductListHeaderImage headerImage = 2; optional string businessOwnerJid = 3; }
+        message ProductSection  { optional string title = 1; repeated Product products = 2; }
+        message Row             { optional string title = 1; optional string description = 2; optional string rowId = 3; }
+        message Section         { optional string title = 1; repeated Row rows = 2; }
+    }
+
+    message ListResponseMessage {
+        optional string           title            = 1;
+        optional ListType         listType         = 2;
+        optional SingleSelectReply singleSelectReply = 3;
+        optional ContextInfo      contextInfo      = 4;
+        optional string           description      = 5;
+        enum ListType { UNKNOWN = 0; SINGLE_SELECT = 1; }
+        message SingleSelectReply { optional string selectedRowId = 1; }
+    }
+
+    message LiveLocationMessage {
+        optional double      degreesLatitude   = 1;
+        optional double      degreesLongitude  = 2;
+        optional uint32      accuracyInMeters  = 3;
+        optional float       speedInMps        = 4;
+        optional uint32      degreesClockwiseFromMagneticNorth = 5;
+        optional string      caption           = 6;
+        optional int64       sequenceNumber    = 7;
+        optional uint32      timeOffset        = 8;
+        optional bytes       jpegThumbnail     = 16;
+        optional ContextInfo contextInfo       = 17;
+    }
+
+    message LocationMessage {
+        optional double      degreesLatitude   = 1;
+        optional double      degreesLongitude  = 2;
+        optional string      name              = 3;
+        optional string      address           = 4;
+        optional string      url               = 5;
+        optional bool        isLive            = 6;
+        optional uint32      accuracyInMeters  = 7;
+        optional float       speedInMps        = 8;
+        optional uint32      degreesClockwiseFromMagneticNorth = 9;
+        optional string      comment           = 11;
+        optional bytes       jpegThumbnail     = 16;
+        optional ContextInfo contextInfo       = 17;
+    }
+
+    message MessageHistoryBundle {
+        optional string      mimetype              = 1;
+        optional bytes       fileSha256            = 2;
+        optional bytes       mediaKey              = 3;
+        optional bytes       fileEncSha256         = 4;
+        optional string      directPath            = 5;
+        optional int64       mediaKeyTimestamp     = 6;
+        optional ContextInfo contextInfo           = 7;
+        optional MessageHistoryMetadata messageHistoryMetadata = 8;
+    }
+
+    message MessageHistoryMetadata {
+        repeated string historyReceivers    = 1;
+        optional int64  firstMessageTimestamp = 2;
+        optional int64  messageCount        = 3;
+    }
+
+    message MessageHistoryNotice {
+        optional ContextInfo            contextInfo           = 1;
+        optional MessageHistoryMetadata messageHistoryMetadata = 2;
+    }
+
+    message NewsletterAdminInviteMessage {
+        optional string      newsletterJid  = 1;
+        optional string      newsletterName = 2;
+        optional bytes       jpegThumbnail  = 3;
+        optional string      caption        = 4;
+        optional int64       inviteExpiration = 5;
+        optional ContextInfo contextInfo    = 6;
+    }
+
+    message OrderMessage {
+        optional string      orderId          = 1;
+        optional bytes       thumbnail        = 2;
+        optional int32       itemCount        = 3;
+        optional OrderStatus status           = 4;
+        optional OrderSurface surface         = 5;
+        optional string      message          = 6;
+        optional string      orderTitle       = 7;
+        optional string      sellerJid        = 8;
+        optional string      token            = 9;
+        optional int64       totalAmount1000  = 10;
+        optional string      totalCurrencyCode = 11;
+        optional ContextInfo contextInfo      = 17;
+        optional int32       messageVersion   = 12;
+
+        enum OrderStatus  { INQUIRY = 1; ACCEPTED = 2; DECLINED = 3; }
+        enum OrderSurface { CATALOG = 1; }
+    }
+
+    message PaymentInviteMessage {
+        optional ServiceType serviceType     = 1;
+        optional int64       expiryTimestamp = 2;
+        enum ServiceType { UNKNOWN = 0; FBPAY = 1; NOVI = 2; UPI = 3; }
+    }
+
+    message PeerDataOperationRequestMessage {
+        optional PeerDataOperationRequestType peerDataOperationRequestType = 1;
+        repeated RequestStickerReupload       requestStickerReupload       = 2;
+        repeated RequestUrlPreview            requestUrlPreview            = 3;
+        optional HistorySyncOnDemandRequest   historySyncOnDemandRequest   = 4;
+        repeated PlaceholderMessageResendRequest placeholderMessageResendRequest = 5;
+
+        message HistorySyncOnDemandRequest {
+            optional string chatJid           = 1;
+            optional string oldestMsgId       = 2;
+            optional bool   oldestMsgFromMe   = 3;
+            optional int32  onDemandMsgCount  = 4;
+            optional int64  oldestMsgTimestampMs = 5;
+            optional string accountLid        = 6;
+        }
+        message PlaceholderMessageResendRequest { optional MessageKey messageKey = 1; }
+        message RequestStickerReupload          { optional string fileSha256 = 1; }
+        message RequestUrlPreview               { optional string url = 1; optional bool includeHqThumbnail = 2; }
+    }
+
+    enum PeerDataOperationRequestType {
+        UPLOAD_STICKER              = 0;
+        SEND_RECENT_STICKER_BOOTSTRAP = 1;
+        GENERATE_LINK_PREVIEW       = 2;
+        HISTORY_SYNC_ON_DEMAND      = 3;
+        PLACEHOLDER_MESSAGE_RESEND  = 4;
+        WAFFLE_LINKING_NONCE_FETCH  = 5;
+        FULL_HISTORY_SYNC_ON_DEMAND = 6;
+        COMPANION_META_NONCE_FETCH  = 7;
+        COMPANION_SYNCD_SNAPSHOT_FATAL_RECOVERY = 8;
+        COMPANION_CANONICAL_USER_NONCE_FETCH = 9;
+    }
+
+    message PinInChatMessage {
+        optional MessageKey key              = 1;
+        optional Type       type             = 2;
+        optional int64      senderTimestampMs = 3;
+        enum Type { UNKNOWN_TYPE = 0; PIN_FOR_ALL = 1; UNPIN_FOR_ALL = 2; }
+    }
+
+    message PlaceholderMessage {
+        optional PlaceholderType type = 1;
+        enum PlaceholderType { MASK_LINKED_DEVICES = 0; }
+    }
+
+    enum PollContentType { UNKNOWN = 0; TEXT = 1; IMAGE = 2; }
+
+    message PollCreationMessage {
+        optional bytes       encKey                = 1;
+        optional string      name                  = 2;
+        repeated Option      options               = 3;
+        optional uint32      selectableOptionsCount = 4;
+        optional ContextInfo contextInfo           = 5;
+        optional PollContentType pollContentType   = 6;
+        optional PollType    pollType              = 7;
+        optional Option      correctAnswer         = 8;
+        message Option       { optional string optionName = 1; optional string optionHash = 2; }
+        enum PollType        { POLL = 0; QUIZ = 1; }
+    }
+
+    message PollEncValue  { optional bytes encPayload = 1; optional bytes encIv = 2; }
+
+    message PollResultSnapshotMessage {
+        optional string      name        = 1;
+        repeated PollVote    pollVotes   = 2;
+        optional ContextInfo contextInfo = 3;
+        message PollVote { optional string optionName = 1; optional int64 optionVoteCount = 2; }
+    }
+
+    message PollUpdateMessage {
+        optional MessageKey             pollCreationMessageKey = 1;
+        optional PollEncValue           vote                   = 2;
+        optional PollUpdateMessageMetadata metadata            = 3;
+        optional int64                  senderTimestampMs      = 4;
+    }
+
+    message PollUpdateMessageMetadata {}
+    message PollVoteMessage { repeated bytes selectedOptions = 1; }
+
+    message ProductMessage {
+        optional ProductSnapshot productSnapshot = 1;
+        optional string          businessOwnerJid = 2;
+        optional CatalogSnapshot catalog          = 4;
+        optional string          body             = 5;
+        optional string          footer           = 6;
+        optional ContextInfo     contextInfo      = 17;
+
+        message CatalogSnapshot  { optional ImageMessage catalogImage = 1; optional string title = 2; optional string description = 3; }
+        message ProductSnapshot  {
+            optional ImageMessage productImage   = 1;
+            optional string       productId      = 2;
+            optional string       title          = 3;
+            optional string       description    = 4;
+            optional string       currencyCode   = 5;
+            optional int64        priceAmount1000 = 6;
+            optional string       retailerId     = 7;
+            optional string       url            = 8;
+            optional uint32       productImageCount = 9;
+        }
+    }
+
+    message ProtocolMessage {
+        optional MessageKey                  key                          = 1;
+        optional Type                        type                         = 2;
+        optional uint32                      ephemeralExpiration          = 4;
+        optional int64                       ephemeralSettingTimestamp    = 5;
+        optional HistorySyncNotification     historySyncNotification      = 6;
+        optional AppStateSyncKeyShare        appStateSyncKeyShare         = 7;
+        optional AppStateSyncKeyRequest      appStateSyncKeyRequest       = 8;
+        optional InitialSecurityNotificationSettingSync initialSecurityNotificationSettingSync = 9;
+        optional AppStateFatalExceptionNotification appStateFatalExceptionNotification = 10;
+        optional DisappearingMode            disappearingMode             = 11;
+        optional Message                     editedMessage                = 14;
+        optional int64                       timestampMs                  = 15;
+        optional PeerDataOperationRequestMessage peerDataOperationRequestMessage = 16;
+        optional BotFeedbackMessage          botFeedbackMessage           = 18;
+        optional string                      invokerJid                   = 19;
+        optional MediaNotifyMessage          mediaNotifyMessage           = 21;
+        optional LIDMigrationMappingSyncMessage lidMigrationMappingSyncMessage = 23;
+        optional LimitSharing                limitSharing                 = 24;
+        optional MemberLabel                 memberLabel                  = 27;
+
+        enum Type {
+            REVOKE                              = 0;
+            EPHEMERAL_SETTING                   = 3;
+            EPHEMERAL_SYNC_RESPONSE             = 4;
+            HISTORY_SYNC_NOTIFICATION           = 5;
+            APP_STATE_SYNC_KEY_SHARE            = 6;
+            APP_STATE_SYNC_KEY_REQUEST          = 7;
+            MSG_FANOUT_BACKFILL_REQUEST         = 8;
+            INITIAL_SECURITY_NOTIFICATION_SETTING_SYNC = 9;
+            APP_STATE_FATAL_EXCEPTION_NOTIFICATION = 10;
+            SHARE_PHONE_NUMBER                  = 11;
+            MESSAGE_EDIT                        = 14;
+            PEER_DATA_OPERATION_REQUEST_MESSAGE = 16;
+            PEER_DATA_OPERATION_REQUEST_RESPONSE_MESSAGE = 17;
+            REQUEST_WELCOME_MESSAGE             = 18;
+            BOT_FEEDBACK_MESSAGE                = 19;
+            MEDIA_NOTIFY_MESSAGE                = 20;
+            CLOUD_API_THREAD_CONTROL_NOTIFICATION = 21;
+            LID_MIGRATION_MAPPING_SYNC          = 22;
+            REMINDER_MESSAGE                    = 23;
+            STATUS_MENTION_MESSAGE              = 25;
+            STOP_GENERATION_MESSAGE             = 26;
+            LIMIT_SHARING                       = 27;
+            GROUP_MEMBER_LABEL_CHANGE           = 30;
+        }
+
+        message InitialSecurityNotificationSettingSync { optional bool securityNotificationEnabled = 1; }
+    }
+
+    message ReactionMessage {
+        optional MessageKey key              = 1;
+        optional string     text             = 2;
+        optional string     groupingKey      = 3;
+        optional int64      senderTimestampMs = 4;
+    }
+
+    message RequestPaymentMessage {
+        optional Message  noteMessage       = 4;
+        optional string   currencyCodeIso4217 = 1;
+        optional uint64   amount1000        = 2;
+        optional string   requestFrom       = 3;
+        optional int64    expiryTimestamp   = 5;
+        optional Money    amount            = 6;
+        optional PaymentBackground background = 7;
+    }
+
+    message RequestPhoneNumberMessage { optional ContextInfo contextInfo = 1; }
+
+    message ScheduledCallCreationMessage {
+        optional int64    scheduledTimestampMs = 1;
+        optional CallType callType             = 2;
+        optional string   title                = 3;
+        enum CallType { UNKNOWN = 0; VOICE = 1; VIDEO = 2; }
+    }
+
+    message ScheduledCallEditMessage {
+        optional MessageKey key      = 1;
+        optional EditType   editType = 2;
+        enum EditType { UNKNOWN = 0; CANCEL = 1; }
+    }
+
+    message SendPaymentMessage {
+        optional Message    noteMessage        = 2;
+        optional MessageKey requestMessageKey  = 3;
+        optional PaymentBackground background  = 4;
+    }
+
+    message SenderKeyDistributionMessage {
+        optional string groupId                             = 1;
+        optional bytes  axolotlSenderKeyDistributionMessage = 2;
+    }
+
+    message StatusNotificationMessage {
+        optional MessageKey           responseMessageKey = 1;
+        optional MessageKey           originalMessageKey = 2;
+        optional StatusNotificationType type             = 3;
+        enum StatusNotificationType { UNKNOWN = 0; STATUS_ADD_YOURS = 1; STATUS_RESHARE = 2; }
+    }
+
+    message StickerMessage {
+        optional string      url               = 1;
+        optional bytes       fileSha256        = 2;
+        optional bytes       fileEncSha256     = 3;
+        optional bytes       mediaKey          = 4;
+        optional string      mimetype          = 5;
+        optional uint32      height            = 6;
+        optional uint32      width             = 7;
+        optional string      directPath        = 8;
+        optional uint64      fileLength        = 9;
+        optional int64       mediaKeyTimestamp = 10;
+        optional uint32      firstFrameLength  = 11;
+        optional bytes       firstFrameSidecar = 12;
+        optional bool        isAnimated        = 13;
+        optional bytes       pngThumbnail      = 16;
+        optional ContextInfo contextInfo       = 17;
+        optional int64       stickerSentTs     = 18;
+        optional bool        isAvatar          = 19;
+        optional bool        isAiSticker       = 20;
+        optional bool        isLottie          = 21;
+        optional string      accessibilityLabel = 22;
+    }
+
+    message StickerPackMessage {
+        optional string      stickerPackId      = 1;
+        optional string      name               = 2;
+        optional string      publisher          = 3;
+        repeated Sticker     stickers           = 4;
+        optional uint64      fileLength         = 5;
+        optional bytes       fileSha256         = 6;
+        optional bytes       fileEncSha256      = 7;
+        optional bytes       mediaKey           = 8;
+        optional string      directPath         = 9;
+        optional string      caption            = 10;
+        optional ContextInfo contextInfo        = 11;
+        optional string      packDescription    = 12;
+        optional int64       mediaKeyTimestamp  = 13;
+
+        message Sticker {
+            optional string  fileName          = 1;
+            optional bool    isAnimated        = 2;
+            repeated string  emojis            = 3;
+            optional string  accessibilityLabel = 4;
+            optional bool    isLottie          = 5;
+            optional string  mimetype          = 6;
+        }
+
+        enum StickerPackOrigin { FIRST_PARTY = 0; THIRD_PARTY = 1; USER_CREATED = 2; }
+    }
+
+    message StickerSyncRMRMessage {
+        repeated string filehash         = 1;
+        optional string rmrSource        = 2;
+        optional int64  requestTimestamp = 3;
+    }
+
+    message TemplateButtonReplyMessage {
+        optional string      selectedId          = 1;
+        optional string      selectedDisplayText = 2;
+        optional ContextInfo contextInfo         = 3;
+        optional uint32      selectedIndex       = 4;
+    }
+
+    message TemplateMessage {
+        optional ContextInfo             contextInfo      = 3;
+        optional HydratedFourRowTemplate hydratedTemplate = 4;
+        optional string                  templateId       = 9;
+        oneof format {
+            FourRowTemplate         fourRowTemplate         = 1;
+            HydratedFourRowTemplate hydratedFourRowTemplate = 2;
+            InteractiveMessage      interactiveMessageTemplate = 5;
+        }
+
+        message FourRowTemplate {
+            optional HighlyStructuredMessage content = 6;
+            optional HighlyStructuredMessage footer  = 7;
+            repeated TemplateButton          buttons = 8;
+            oneof title {
+                DocumentMessage          documentMessage       = 1;
+                HighlyStructuredMessage  highlyStructuredMessage = 2;
+                ImageMessage             imageMessage          = 3;
+                VideoMessage             videoMessage          = 4;
+                LocationMessage          locationMessage       = 5;
+            }
+        }
+
+        message HydratedFourRowTemplate {
+            optional string                  hydratedContentText = 6;
+            optional string                  hydratedFooterText  = 7;
+            repeated HydratedTemplateButton  hydratedButtons     = 8;
+            optional string                  templateId          = 9;
+            optional bool                    maskLinkedDevices   = 10;
+            oneof title {
+                DocumentMessage documentMessage   = 1;
+                string          hydratedTitleText = 2;
+                ImageMessage    imageMessage      = 3;
+                VideoMessage    videoMessage      = 4;
+                LocationMessage locationMessage   = 5;
+            }
+        }
+    }
+
+    message VideoMessage {
+        optional string      url               = 1;
+        optional string      mimetype          = 2;
+        optional bytes       fileSha256        = 3;
+        optional uint64      fileLength        = 4;
+        optional uint32      seconds           = 5;
+        optional bytes       mediaKey          = 6;
+        optional string      caption           = 7;
+        optional bool        gifPlayback       = 8;
+        optional uint32      height            = 9;
+        optional uint32      width             = 10;
+        optional bytes       fileEncSha256     = 11;
+        repeated InteractiveAnnotation interactiveAnnotations = 12;
+        optional string      directPath        = 13;
+        optional int64       mediaKeyTimestamp = 14;
+        optional bytes       jpegThumbnail     = 16;
+        optional ContextInfo contextInfo       = 17;
+        optional bytes       streamingSidecar  = 18;
+        optional Attribution gifAttribution    = 19;
+        optional bool        viewOnce          = 20;
+        optional string      accessibilityLabel = 26;
+
+        enum Attribution    { NONE = 0; GIPHY = 1; TENOR = 2; }
+        enum VideoSourceType { USER_VIDEO = 0; AI_GENERATED = 1; }
+    }
+}
+
+
+// ─── MESSAGE ADD-ON ──────────────────────────────────────────
+
+message MessageAddOn {
+    optional MessageAddOnType        messageAddOnType  = 1;
+    optional Message                 messageAddOn      = 2;
+    optional int64                   senderTimestampMs = 3;
+    optional int64                   serverTimestampMs = 4;
+    optional WebMessageInfo.Status   status            = 5;
+    optional MessageAddOnContextInfo addOnContextInfo  = 6;
+    optional MessageKey              messageAddOnKey   = 7;
+
+    enum MessageAddOnType {
+        UNDEFINED    = 0;
+        REACTION     = 1;
+        EVENT_RESPONSE = 2;
+        POLL_UPDATE  = 3;
+        PIN_IN_CHAT  = 4;
+    }
+}
+
+message MessageAddOnContextInfo {
+    optional uint32 messageAddOnDurationInSecs = 1;
+    optional MessageContextInfo.MessageAddonExpiryType messageAddOnExpiryType = 2;
+}
+
+message MessageAssociation {
+    optional AssociationType associationType  = 1;
+    optional MessageKey      parentMessageKey = 2;
+    optional int32           messageIndex     = 3;
+
+    enum AssociationType {
+        UNKNOWN                = 0;
+        MEDIA_ALBUM            = 1;
+        BOT_PLUGIN             = 2;
+        EVENT_COVER_IMAGE      = 3;
+        STATUS_POLL            = 4;
+        HD_VIDEO_DUAL_UPLOAD   = 5;
+        STATUS_EXTERNAL_RESHARE = 6;
+        MEDIA_POLL             = 7;
+        STATUS_ADD_YOURS       = 8;
+        STATUS_NOTIFICATION    = 9;
+        HD_IMAGE_DUAL_UPLOAD   = 10;
+        STICKER_ANNOTATION     = 11;
+        MOTION_PHOTO           = 12;
+        STATUS_LINK_ACTION     = 13;
+        VIEW_ALL_REPLIES       = 14;
+    }
+}
+
+message MessageContextInfo {
+    optional DeviceListMetadata deviceListMetadata        = 1;
+    optional int32              deviceListMetadataVersion = 2;
+    optional bytes              messageSecret             = 3;
+    optional bytes              paddingBytes              = 4;
+    optional uint32             messageAddOnDurationInSecs = 5;
+    optional bytes              botMessageSecret          = 6;
+    optional BotMetadata        botMetadata               = 7;
+    optional int32              reportingTokenVersion     = 8;
+    optional MessageAddonExpiryType messageAddOnExpiryType = 9;
+    optional MessageAssociation messageAssociation        = 10;
+    optional bool               capiCreatedGroup          = 11;
+    optional string             supportPayload            = 12;
+    optional LimitSharing       limitSharing              = 13;
+    repeated ThreadID           threadId                  = 15;
+
+    enum MessageAddonExpiryType { STATIC = 1; DEPENDENT_ON_PARENT = 2; }
+}
+
+message MessageKey {
+    optional string remoteJid   = 1;
+    optional bool   fromMe      = 2;
+    optional string id          = 3;
+    optional string participant = 4;
+}
+
+
+message Money {
+    optional int64  value        = 1;
+    optional uint32 offset       = 2;
+    optional string currencyCode = 3;
+}
+
+// Tag all group members (@everyone / @all)
+message TagAllMessage {
+    optional string      text        = 1; // display text e.g. "@all" or "@everyone"
+    optional ContextInfo contextInfo = 2;
+    optional bool        silent      = 3; // true = notify without showing mention UI
+    optional TagScope    scope       = 4;
+
+    enum TagScope {
+        ALL_MEMBERS   = 0; // tag everyone in the group
+        ADMINS_ONLY   = 1; // tag admins only
+        NON_ADMINS    = 2; // tag non-admins only
+    }
+}
+
+message GroupStatusV2Message {
+    optional Message     statusMessage      = 1; // the actual status content
+    optional ContextInfo contextInfo        = 2;
+    optional string      groupJid           = 3;
+    optional int64       expiryTimestampMs  = 4;
+    optional bool        allowReply         = 5;
+    optional bool        allowReaction      = 6;
+    optional string      authorJid          = 7;
+    optional StatusVisibility visibility    = 8;
+
+    enum StatusVisibility {
+        ALL_MEMBERS   = 0;
+        ADMINS_ONLY   = 1;
+    }
+}
+
+message N4lyxMeta {
+    optional string libVersion   = 1; // e.g. "1.0.0"
+    optional string buildCommit  = 2; // git commit hash
+    optional int64  sentAtMs     = 3; // client send timestamp
+    optional string sessionId    = 4; // connection session id
+    optional bool   isForwarded  = 5;
+    optional string sourceJid    = 6;
+}
+
+// ─────────────────────────────────────────────────────────────
+
+
+// ─── NOTIFICATIONS ───────────────────────────────────────────
+
+message NotificationMessageInfo {
+    optional MessageKey key              = 1;
+    optional Message    message          = 2;
+    optional uint64     messageTimestamp = 3;
+    optional string     participant      = 4;
+}
+
+message NotificationSettings {
+    optional string messageVibrate   = 1;
+    optional string messagePopup     = 2;
+    optional string messageLight     = 3;
+    optional bool   lowPriorityNotifications = 4;
+    optional bool   reactionsMuted   = 5;
+    optional string callVibrate      = 6;
+}
+
+
+// ─── PAIRING ─────────────────────────────────────────────────
+
+message PairingRequest {
+    optional bytes companionPublicKey   = 1;
+    optional bytes companionIdentityKey = 2;
+    optional bytes advSecret            = 3;
+}
+
+message PastParticipant {
+    optional string      userJid     = 1;
+    optional LeaveReason leaveReason = 2;
+    optional uint64      leaveTs     = 3;
+    enum LeaveReason { LEFT = 0; REMOVED = 1; }
+}
+
+message PastParticipants {
+    optional string          groupJid         = 1;
+    repeated PastParticipant pastParticipants = 2;
+}
+
+message PaymentBackground {
+    optional string    id               = 1;
+    optional uint64    fileLength       = 2;
+    optional uint32    width            = 3;
+    optional uint32    height           = 4;
+    optional string    mimetype         = 5;
+    optional fixed32   placeholderArgb  = 6;
+    optional fixed32   textArgb         = 7;
+    optional fixed32   subtextArgb      = 8;
+    optional MediaData mediaData        = 9;
+    optional Type      type             = 10;
+
+    message MediaData {
+        optional bytes  mediaKey          = 1;
+        optional int64  mediaKeyTimestamp = 2;
+        optional bytes  fileSha256        = 3;
+        optional bytes  fileEncSha256     = 4;
+        optional string directPath        = 5;
+    }
+    enum Type { UNKNOWN = 0; DEFAULT = 1; }
+}
+
+message PaymentInfo {
+    optional uint64     amount1000            = 2;
+    optional string     receiverJid           = 3;
+    optional Status     status                = 4;
+    optional uint64     transactionTimestamp  = 5;
+    optional MessageKey requestMessageKey     = 6;
+    optional uint64     expiryTimestamp       = 7;
+    optional string     currency              = 9;
+    optional TxnStatus  txnStatus             = 10;
+    optional Money      primaryAmount         = 12;
+    optional Money      exchangeAmount        = 13;
+
+    enum Status {
+        UNKNOWN_STATUS      = 0;
+        PROCESSING          = 1;
+        SENT                = 2;
+        NEED_TO_ACCEPT      = 3;
+        COMPLETE            = 4;
+        COULD_NOT_COMPLETE  = 5;
+        REFUNDED            = 6;
+        EXPIRED             = 7;
+        REJECTED            = 8;
+        CANCELLED           = 9;
+        WAITING_FOR_PAYER   = 10;
+        WAITING             = 11;
+    }
+    enum TxnStatus {
+        UNKNOWN             = 0;
+        PENDING_SETUP       = 1;
+        INIT                = 3;
+        SUCCESS             = 4;
+        COMPLETED           = 5;
+        FAILED              = 6;
+        REFUNDED_TXN        = 12;
+        EXPIRED_TXN         = 16;
+        COLLECT_INIT        = 20;
+        COLLECT_SUCCESS     = 21;
+        COLLECT_FAILED      = 22;
+        COLLECT_REJECTED    = 24;
+        COLLECT_EXPIRED     = 25;
+        COLLECT_CANCELED    = 26;
+        IN_REVIEW           = 28;
+        REVERSAL_SUCCESS    = 29;
+        REFUND_PENDING      = 31;
+    }
+}
+
+message PhoneNumberToLIDMapping {
+    optional string pnJid  = 1;
+    optional string lidJid = 2;
+}
+
+message PhotoChange {
+    optional bytes  oldPhoto   = 1;
+    optional bytes  newPhoto   = 2;
+    optional uint32 newPhotoId = 3;
+}
+
+message Point {
+    optional double x = 3;
+    optional double y = 4;
+}
+
+message PollAdditionalMetadata { optional bool pollInvalidated = 1; }
+message PollEncValue           { optional bytes encPayload = 1; optional bytes encIv = 2; }
+
+message PollUpdate {
+    optional MessageKey pollUpdateMessageKey = 1;
+    optional Message.PollVoteMessage vote    = 2;
+    optional int64   senderTimestampMs       = 3;
+    optional int64   serverTimestampMs       = 4;
+    optional bool    unread                  = 5;
+}
+
+message PrimaryEphemeralIdentity {
+    optional bytes publicKey = 1;
+    optional bytes nonce     = 2;
+}
+
+message ProcessedVideo {
+    optional string      directPath = 1;
+    optional bytes       fileSha256 = 2;
+    optional uint32      height     = 3;
+    optional uint32      width      = 4;
+    optional uint64      fileLength = 5;
+    optional uint32      bitrate    = 6;
+    optional VideoQuality quality   = 7;
+    repeated string      capabilities = 8;
+    enum VideoQuality { UNDEFINED = 0; LOW = 1; MID = 2; HIGH = 3; }
+}
+
+message ProloguePayload {
+    optional bytes               companionEphemeralIdentity = 1;
+    optional CompanionCommitment commitment                  = 2;
+}
+
+message CompanionCommitment { optional bytes hash = 1; }
+
+message Pushname {
+    optional string id       = 1;
+    optional string pushname = 2;
+}
+
+
+// ─── REACTION ────────────────────────────────────────────────
+
+message Reaction {
+    optional MessageKey key              = 1;
+    optional string     text             = 2;
+    optional string     groupingKey      = 3;
+    optional int64      senderTimestampMs = 4;
+    optional bool       unread           = 5;
+}
+
+message RecentEmojiWeight {
+    optional string emoji  = 1;
+    optional float  weight = 2;
+}
+
+message RecordStructure {
+    optional SessionStructure        currentSession   = 1;
+    repeated SessionStructure        previousSessions = 2;
+}
+
+message ReportingTokenInfo { optional bytes reportingTag = 1; }
+
+
+// ─── SESSION ─────────────────────────────────────────────────
+
+message SessionStructure {
+    optional uint32 sessionVersion       = 1;
+    optional bytes  localIdentityPublic  = 2;
+    optional bytes  remoteIdentityPublic = 3;
+    optional bytes  rootKey              = 4;
+    optional uint32 previousCounter      = 5;
+    optional Chain  senderChain          = 6;
+    repeated Chain  receiverChains       = 7;
+    optional PendingKeyExchange pendingKeyExchange = 8;
+    optional PendingPreKey      pendingPreKey      = 9;
+    optional uint32 remoteRegistrationId = 10;
+    optional uint32 localRegistrationId  = 11;
+    optional bool   needsRefresh         = 12;
+    optional bytes  aliceBaseKey         = 13;
+
+    message Chain {
+        optional bytes    senderRatchetKey        = 1;
+        optional bytes    senderRatchetKeyPrivate = 2;
+        optional ChainKey chainKey                = 3;
+        repeated MessageKey messageKeys           = 4;
+
+        message ChainKey   { optional uint32 index = 1; optional bytes key = 2; }
+        message MessageKey { optional uint32 index = 1; optional bytes cipherKey = 2; optional bytes macKey = 3; optional bytes iv = 4; }
+    }
+
+    message PendingKeyExchange {
+        optional uint32 sequence                = 1;
+        optional bytes  localBaseKey            = 2;
+        optional bytes  localBaseKeyPrivate     = 3;
+        optional bytes  localRatchetKey         = 4;
+        optional bytes  localRatchetKeyPrivate  = 5;
+        optional bytes  localIdentityKey        = 7;
+        optional bytes  localIdentityKeyPrivate = 8;
+    }
+
+    message PendingPreKey {
+        optional uint32 preKeyId      = 1;
+        optional int32  signedPreKeyId = 3;
+        optional bytes  baseKey       = 2;
+    }
+}
+
+message ServerErrorReceipt { optional string stanzaId = 1; }
+
+
+// ─── STATUS ──────────────────────────────────────────────────
+
+message StatusAttribution {
+    optional Type   type      = 1;
+    optional string actionUrl = 2;
+    oneof attributionData {
+        StatusReshare statusReshare = 3;
+        ExternalShare externalShare = 4;
+        Music         music         = 5;
+        GroupStatus   groupStatus   = 6;
+    }
+
+    message ExternalShare {
+        optional string actionUrl        = 1;
+        optional Source source           = 2;
+        optional int32  duration         = 3;
+        optional string actionFallbackUrl = 4;
+        enum Source { UNKNOWN = 0; INSTAGRAM = 1; FACEBOOK = 2; MESSENGER = 3; SPOTIFY = 4; YOUTUBE = 5; PINTEREST = 6; }
+    }
+
+    message GroupStatus  { optional string authorJid = 1; }
+
+    message Music {
+        optional string authorName      = 1;
+        optional string songId          = 2;
+        optional string title           = 3;
+        optional string author          = 4;
+        optional string artistAttribution = 5;
+        optional bool   isExplicit      = 6;
+    }
+
+    message StatusReshare {
+        optional Source   source   = 1;
+        optional Metadata metadata = 2;
+
+        message Metadata {
+            optional int32  duration           = 1;
+            optional string channelJid         = 2;
+            optional int32  channelMessageId   = 3;
+            optional bool   hasMultipleReshares = 4;
+        }
+        enum Source { UNKNOWN = 0; INTERNAL_RESHARE = 1; MENTION_RESHARE = 2; CHANNEL_RESHARE = 3; }
+    }
+
+    enum Type { RESHARE = 0; EXTERNAL_SHARE = 1; MUSIC = 2; STATUS_MENTION = 3; GROUP_STATUS = 4; }
+}
+
+message StatusMentionMessage { optional Message quotedStatus = 1; }
+message StatusPSA {
+    optional uint64 campaignId                  = 44;
+    optional uint64 campaignExpirationTimestamp = 45;
+}
+
+
+// ─── STICKER ─────────────────────────────────────────────────
+
+message StickerMetadata {
+    optional string url            = 1;
+    optional bytes  fileSha256     = 2;
+    optional bytes  fileEncSha256  = 3;
+    optional bytes  mediaKey       = 4;
+    optional string mimetype       = 5;
+    optional uint32 height         = 6;
+    optional uint32 width          = 7;
+    optional string directPath     = 8;
+    optional uint64 fileLength     = 9;
+    optional float  weight         = 10;
+    optional int64  lastStickerSentTs = 11;
+    optional bool   isLottie       = 12;
+}
+
+
+// ─── SYNC ────────────────────────────────────────────────────
+
+message SyncActionData {
+    optional bytes           index   = 1;
+    optional SyncActionValue value   = 2;
+    optional bytes           padding = 3;
+    optional int32           version = 4;
+}
+
+message SyncActionValue {
+    optional int64         timestamp        = 1;
+    optional StarAction    starAction       = 2;
+    optional ContactAction contactAction   = 3;
+    optional MuteAction    muteAction      = 4;
+    optional PinAction     pinAction       = 5;
+    optional SecurityNotificationSetting securityNotificationSetting = 6;
+    optional PushNameSetting pushNameSetting = 7;
+    optional QuickReplyAction quickReplyAction = 8;
+    optional RecentEmojiWeightsAction recentEmojiWeightsAction = 11;
+    optional LabelEditAction labelEditAction = 14;
+    optional LabelAssociationAction labelAssociationAction = 15;
+    optional LocaleSetting localeSetting   = 16;
+    optional ArchiveChatAction archiveChatAction = 17;
+    optional DeleteMessageForMeAction deleteMessageForMeAction = 18;
+    optional MarkChatAsReadAction markChatAsReadAction = 20;
+    optional ClearChatAction clearChatAction = 21;
+    optional DeleteChatAction deleteChatAction = 22;
+    optional UnarchiveChatsSetting unarchiveChatsSetting = 23;
+    optional StickerAction stickerAction   = 33;
+    optional CallLogAction callLogAction   = 42;
+    optional LockChatAction lockChatAction = 50;
+    optional DeviceCapabilities deviceCapabilities = 54;
+
+    message ArchiveChatAction         { optional bool archived = 1; optional SyncActionMessageRange messageRange = 2; }
+    message CallLogAction             { optional CallLogRecord callLogRecord = 1; }
+    message ClearChatAction           { optional SyncActionMessageRange messageRange = 1; }
+    message ContactAction             { optional string fullName = 1; optional string firstName = 2; optional string lidJid = 3; optional bool saveOnPrimaryAddressbook = 4; optional string pnJid = 5; }
+    message DeleteChatAction          { optional SyncActionMessageRange messageRange = 1; }
+    message DeleteMessageForMeAction  { optional bool deleteMedia = 1; optional int64 messageTimestamp = 2; }
+    message LabelAssociationAction    { optional bool labeled = 1; }
+    message LabelEditAction           { optional string name = 1; optional int32 color = 2; optional int32 predefinedId = 3; optional bool deleted = 4; optional int32 orderIndex = 5; optional bool isActive = 6; }
+    message LocaleSetting             { optional string locale = 1; }
+    message LockChatAction            { optional bool locked = 1; }
+    message MarkChatAsReadAction      { optional bool read = 1; optional SyncActionMessageRange messageRange = 2; }
+    message MuteAction                { optional bool muted = 1; optional int64 muteEndTimestamp = 2; optional bool autoMuted = 3; }
+    message PinAction                 { optional bool pinned = 1; }
+    message PushNameSetting           { optional string name = 1; }
+    message QuickReplyAction          { optional string shortcut = 1; optional string message = 2; repeated string keywords = 3; optional int32 count = 4; optional bool deleted = 5; }
+    message RecentEmojiWeightsAction  { repeated RecentEmojiWeight weights = 1; }
+    message SecurityNotificationSetting { optional bool showNotification = 1; }
+    message StarAction                { optional bool starred = 1; }
+    message StickerAction             { optional string url = 1; optional bytes fileEncSha256 = 2; optional bytes mediaKey = 3; optional string mimetype = 4; optional uint32 height = 5; optional uint32 width = 6; optional string directPath = 7; optional uint64 fileLength = 8; optional bool isFavorite = 9; optional bool isLottie = 11; }
+    message UnarchiveChatsSetting     { optional bool unarchiveChats = 1; }
+
+    message SyncActionMessage      { optional MessageKey key = 1; optional int64 timestamp = 2; }
+    message SyncActionMessageRange { optional int64 lastMessageTimestamp = 1; optional int64 lastSystemMessageTimestamp = 2; repeated SyncActionMessage messages = 3; }
+}
+
+message SyncdIndex    { optional bytes blob = 1; }
+message SyncdMutation { optional SyncdOperation operation = 1; optional SyncdRecord record = 2; enum SyncdOperation { SET = 0; REMOVE = 1; } }
+message SyncdMutations { repeated SyncdMutation mutations = 1; }
+message SyncdPatch {
+    optional SyncdVersion version         = 1;
+    repeated SyncdMutation mutations      = 2;
+    optional ExternalBlobReference externalMutations = 3;
+    optional bytes snapshotMac            = 4;
+    optional bytes patchMac               = 5;
+    optional KeyId keyId                  = 6;
+    optional ExitCode exitCode            = 7;
+    optional uint32 deviceIndex           = 8;
+}
+message SyncdRecord   { optional SyncdIndex index = 1; optional SyncdValue value = 2; optional KeyId keyId = 3; }
+message SyncdSnapshot { optional SyncdVersion version = 1; repeated SyncdRecord records = 2; optional bytes mac = 3; optional KeyId keyId = 4; }
+message SyncdValue    { optional bytes blob = 1; }
+message SyncdVersion  { optional uint64 version = 1; }
+message ExitCode      { optional uint64 code = 1; optional string text = 2; }
+
+
+// ─── MISC ────────────────────────────────────────────────────
+
+message TapLinkAction {
+    optional string title  = 1;
+    optional string tapUrl = 2;
+}
+
+message TemplateButton {
+    optional uint32 index = 4;
+    oneof button {
+        QuickReplyButton quickReplyButton = 1;
+        URLButton        urlButton        = 2;
+        CallButton       callButton       = 3;
+    }
+
+    message CallButton      { optional HighlyStructuredMessage displayText = 1; optional HighlyStructuredMessage phoneNumber = 2; }
+    message QuickReplyButton { optional HighlyStructuredMessage displayText = 1; optional string id = 2; }
+    message URLButton       { optional HighlyStructuredMessage displayText = 1; optional HighlyStructuredMessage url = 2; }
+}
+
+message ThreadID {
+    optional ThreadType threadType = 1;
+    optional MessageKey threadKey  = 2;
+    enum ThreadType { UNKNOWN = 0; VIEW_REPLIES = 1; }
+}
+
+message UrlTrackingMap {
+    repeated UrlTrackingMapElement urlTrackingMapElements = 1;
+    message UrlTrackingMapElement {
+        optional string originalUrl        = 1;
+        optional string unconsentedUsersUrl = 2;
+        optional string consentedUsersUrl  = 3;
+        optional uint32 cardIndex          = 4;
+    }
+}
+
+message UserPassword {
+    optional Encoding        encoding        = 1;
+    optional Transformer     transformer     = 2;
+    repeated TransformerArg  transformerArg  = 3;
+    optional bytes           transformedData = 4;
+
+    enum Encoding    { UTF8 = 0; UTF8_BROKEN = 1; }
+    enum Transformer { NONE = 0; PBKDF2_HMAC_SHA512 = 1; PBKDF2_HMAC_SHA384 = 2; }
+    message TransformerArg {
+        optional string key   = 1;
+        optional Value  value = 2;
+        message Value { oneof value { bytes asBlob = 1; uint32 asUnsignedInteger = 2; } }
+    }
+}
+
+message UserReceipt {
+    optional string userJid              = 1;
+    optional int64  receiptTimestamp     = 2;
+    optional int64  readTimestamp        = 3;
+    optional int64  playedTimestamp      = 4;
+    repeated string pendingDeviceJid     = 5;
+    repeated string deliveredDeviceJid   = 6;
+}
+
+message VerifiedNameCertificate {
+    optional bytes details         = 1;
+    optional bytes signature       = 2;
+    optional bytes serverSignature = 3;
+
+    message Details {
+        optional uint64 serial       = 1;
+        optional string issuer       = 2;
+        optional string verifiedName = 4;
+        repeated LocalizedName localizedNames = 8;
+        optional uint64 issueTime    = 10;
+    }
+}
+
+message LocalizedName {
+    optional string lg           = 1;
+    optional string lc           = 2;
+    optional string verifiedName = 3;
+}
+
+message WallpaperSettings {
+    optional string filename = 1;
+    optional uint32 opacity  = 2;
+}
+
+
+// ─── WEB MESSAGE INFO ────────────────────────────────────────
+
+message WebMessageInfo {
+    optional MessageKey  key                       = 1;
+    optional Message     message                   = 2;
+    optional uint64      messageTimestamp           = 3;
+    optional Status      status                    = 4;
+    optional string      participant               = 5;
+    optional uint64      messageC2STimestamp       = 6;
+    optional bool        ignore                    = 16;
+    optional bool        starred                   = 17;
+    optional bool        broadcast                 = 18;
+    optional string      pushName                  = 19;
+    optional bool        multicast                 = 21;
+    optional bool        urlText                   = 22;
+    optional bool        urlNumber                 = 23;
+    optional StubType    messageStubType           = 24;
+    optional bool        clearMedia                = 25;
+    repeated string      messageStubParameters     = 26;
+    optional uint32      duration                  = 27;
+    repeated string      labels                    = 28;
+    optional PaymentInfo paymentInfo               = 29;
+    optional Message.LiveLocationMessage finalLiveLocation = 30;
+    optional PaymentInfo quotedPaymentInfo         = 31;
+    optional uint64      ephemeralStartTimestamp   = 32;
+    optional uint32      ephemeralDuration         = 33;
+    optional bool        ephemeralOffToOn          = 34;
+    optional bool        ephemeralOutOfSync        = 35;
+    optional BizPrivacyStatus bizPrivacyStatus     = 36;
+    optional string      verifiedBizName           = 37;
+    optional MediaData   mediaData                 = 38;
+    optional PhotoChange photoChange               = 39;
+    repeated UserReceipt userReceipt               = 40;
+    repeated Reaction    reactions                 = 41;
+    optional MediaData   quotedStickerData         = 42;
+    optional bytes       futureproofData           = 43;
+    optional StatusPSA   statusPsa                 = 44;
+    repeated PollUpdate  pollUpdates               = 45;
+    optional PollAdditionalMetadata pollAdditionalMetadata = 46;
+    optional string      agentId                   = 47;
+    optional bool        statusAlreadyViewed       = 48;
+    optional bytes       messageSecret             = 49;
+    optional KeepInChat  keepInChat                = 50;
+    optional string      originalSelfAuthorUserJidString = 51;
+    optional uint64      revokeMessageTimestamp    = 52;
+    optional PinInChat   pinInChat                 = 54;
+    optional bool        is1PBizBotMessage         = 56;
+    optional bool        isGroupHistoryMessage     = 57;
+    optional string      botMessageInvokerJid      = 58;
+    optional CommentMetadata commentMetadata       = 59;
+    repeated EventResponse eventResponses          = 61;
+    optional ReportingTokenInfo reportingTokenInfo = 62;
+    optional uint64      newsletterServerId        = 63;
+    optional bool        isMentionedInStatus       = 65;
+    repeated string      statusMentions            = 66;
+    optional MessageKey  targetMessageId           = 67;
+    repeated MessageAddOn messageAddOns            = 68;
+
+    enum BizPrivacyStatus { E2EE = 0; FB = 2; BSP = 1; BSP_AND_FB = 3; }
+
+    enum Status {
+        ERROR        = 0;
+        PENDING      = 1;
+        SERVER_ACK   = 2;
+        DELIVERY_ACK = 3;
+        READ         = 4;
+        PLAYED       = 5;
+    }
+
+    enum StubType {
+        UNKNOWN                            = 0;
+        REVOKE                             = 1;
+        CIPHERTEXT                         = 2;
+        FUTUREPROOF                        = 3;
+        NON_VERIFIED_TRANSITION            = 4;
+        UNVERIFIED_TRANSITION              = 5;
+        VERIFIED_TRANSITION                = 6;
+        VERIFIED_LOW_UNKNOWN               = 7;
+        VERIFIED_HIGH                      = 8;
+        VERIFIED_INITIAL_UNKNOWN           = 9;
+        VERIFIED_INITIAL_LOW               = 10;
+        VERIFIED_INITIAL_HIGH              = 11;
+        GROUP_CREATE                       = 20;
+        GROUP_CHANGE_SUBJECT               = 21;
+        GROUP_CHANGE_ICON                  = 22;
+        GROUP_CHANGE_INVITE_LINK           = 23;
+        GROUP_CHANGE_DESCRIPTION           = 24;
+        GROUP_CHANGE_RESTRICT              = 25;
+        GROUP_CHANGE_ANNOUNCE              = 26;
+        GROUP_PARTICIPANT_ADD              = 27;
+        GROUP_PARTICIPANT_REMOVE           = 28;
+        GROUP_PARTICIPANT_PROMOTE          = 29;
+        GROUP_PARTICIPANT_DEMOTE           = 30;
+        GROUP_PARTICIPANT_INVITE           = 31;
+        GROUP_PARTICIPANT_LEAVE            = 32;
+        GROUP_PARTICIPANT_CHANGE_NUMBER    = 33;
+        BROADCAST_CREATE                   = 34;
+        BROADCAST_ADD                      = 35;
+        BROADCAST_REMOVE                   = 36;
+        GENERIC_NOTIFICATION               = 37;
+        E2E_IDENTITY_CHANGED               = 38;
+        E2E_ENCRYPTED                      = 39;
+        CALL_MISSED_VOICE                  = 40;
+        CALL_MISSED_VIDEO                  = 41;
+        INDIVIDUAL_CHANGE_NUMBER           = 42;
+        GROUP_DELETE                       = 43;
+        GROUP_ANNOUNCE_MODE_MESSAGE_BOUNCE = 44;
+        CALL_MISSED_GROUP_VOICE            = 45;
+        CALL_MISSED_GROUP_VIDEO            = 46;
+        PAYMENT_CIPHERTEXT                 = 47;
+        PAYMENT_FUTUREPROOF                = 48;
+        CHANGE_EPHEMERAL_SETTING           = 72;
+        E2E_DEVICE_CHANGED                 = 73;
+        VIEWED_ONCE                        = 74;
+        E2E_ENCRYPTED_NOW                  = 75;
+        E2E_IDENTITY_UNAVAILABLE           = 118;
+        GROUP_CREATING                     = 119;
+        GROUP_CREATE_FAILED                = 120;
+        GROUP_BOUNCED                      = 121;
+        BLOCK_CONTACT                      = 122;
+        EPHEMERAL_SETTING_NOT_APPLIED      = 123;
+        SYNC_FAILED                        = 124;
+        SYNCING                            = 125;
+        DISAPPEARING_MODE                  = 130;
+        ADMIN_REVOKE                       = 132;
+        COMMUNITY_LINK_PARENT_GROUP        = 134;
+        COMMUNITY_LINK_SUB_GROUP           = 136;
+        COMMUNITY_UNLINK_PARENT_GROUP      = 137;
+        COMMUNITY_UNLINK_SUB_GROUP         = 139;
+        GROUP_PARTICIPANT_ACCEPT           = 140;
+        COMMUNITY_CREATE                   = 142;
+        EPHEMERAL_KEEP_IN_CHAT             = 143;
+        GROUP_MEMBERSHIP_JOIN_APPROVAL_REQUEST = 144;
+        GROUP_MEMBERSHIP_JOIN_APPROVAL_MODE = 145;
+        COMMUNITY_PARTICIPANT_PROMOTE      = 147;
+        COMMUNITY_PARTICIPANT_DEMOTE       = 148;
+        COMMUNITY_PARENT_GROUP_DELETED     = 149;
+        GROUP_PARTICIPANT_JOINED_GROUP_AND_PARENT_GROUP = 151;
+        MASKED_THREAD_CREATED              = 152;
+        MASKED_THREAD_UNMASKED             = 153;
+        BIZ_CHAT_ASSIGNMENT                = 154;
+        CHAT_PSA                           = 155;
+        CHAT_POLL_CREATION_MESSAGE         = 156;
+        COMMUNITY_PARENT_GROUP_SUBJECT_CHANGED = 158;
+        CAG_INVITE_AUTO_ADD                = 159;
+        BIZ_CHAT_ASSIGNMENT_UNASSIGN       = 160;
+        CAG_INVITE_AUTO_JOINED             = 161;
+        SCHEDULED_CALL_START_MESSAGE       = 162;
+        COMMUNITY_INVITE_RICH              = 163;
+        GROUP_MEMBER_ADD_MODE              = 171;
+        GROUP_MEMBERSHIP_JOIN_APPROVAL_REQUEST_NON_ADMIN_ADD = 172;
+        COMMUNITY_CHANGE_DESCRIPTION       = 173;
+        PINNED_MESSAGE_IN_CHAT             = 177;
+        LINKED_GROUP_CALL_START            = 181;
+        EMPTY_SUBGROUP_CREATE              = 183;
+        SCHEDULED_CALL_CANCEL              = 184;
+        GROUP_CHANGE_RECENT_HISTORY_SHARING = 186;
+        GENERAL_CHAT_CREATE                = 188;
+        GENERAL_CHAT_ADD                   = 189;
+        SUGGESTED_SUBGROUP_ANNOUNCE        = 191;
+        CHANGE_USERNAME                    = 193;
+        REMINDER_SETUP_MESSAGE             = 198;
+        REMINDER_SENT_MESSAGE              = 199;
+        REMINDER_CANCEL_MESSAGE            = 200;
+        GROUP_DEACTIVATED                  = 203;
+        EVENT_UPDATED                      = 205;
+        EVENT_CANCELED                     = 206;
+        COMMUNITY_OWNER_UPDATED            = 207;
+        STATUS_MENTION                     = 210;
+        CHANGE_LID                         = 213;
+        CHANGE_LIMIT_SHARING               = 216;
+        GROUP_MEMBER_LINK_MODE             = 217;
+    }
+}
+
+message WebNotificationsInfo {
+    optional uint64         timestamp        = 2;
+    optional uint32         unreadChats      = 3;
+    optional uint32         notifyMessageCount = 4;
+    repeated WebMessageInfo notifyMessages   = 5;
+}
+
+message CommentMetadata {
+    optional MessageKey commentParentKey = 1;
+    optional uint32     replyCount       = 2;
+}
+
+message EventAdditionalMetadata { optional bool isStale = 1; }
+
+message EventResponse {
+    optional MessageKey                  eventResponseMessageKey = 1;
+    optional int64                       timestampMs            = 2;
+    optional Message.EventResponseMessage eventResponseMessage  = 3;
+    optional bool                        unread                 = 4;
+}
+
+message LegacyMessage {
+    optional Message.EventResponseMessage eventResponseMessage = 1;
+    optional Message.PollVoteMessage      pollVote             = 2;
+}
+
+message MessageSecretMessage {
+    optional sfixed32 version    = 1;
+    optional bytes    encIv      = 2;
+    optional bytes    encPayload = 3;
+}
+
+message AIQueryFanout {
+    optional MessageKey messageKey = 1;
+    optional Message    message    = 2;
+    optional int64      timestamp  = 3;
+}
+
+message AIRichResponseMessage {
+    optional AIRichResponseMessageType type            = 1;
+    repeated AIRichResponseSubMessage  submessages     = 2;
+    optional AIRichResponseUnifiedResponse unifiedResponse = 3;
+    optional ContextInfo               contextInfo     = 4;
+
+    enum AIRichResponseMessageType { AI_RICH_RESPONSE_TYPE_UNKNOWN = 0; AI_RICH_RESPONSE_TYPE_STANDARD = 1; }
+
+    message AIRichResponseSubMessage {
+        optional AIRichResponseSubMessageType messageType = 1;
+        optional string                       messageText = 3;
+    }
+
+    enum AIRichResponseSubMessageType {
+        AI_RICH_RESPONSE_UNKNOWN       = 0;
+        AI_RICH_RESPONSE_GRID_IMAGE    = 1;
+        AI_RICH_RESPONSE_TEXT          = 2;
+        AI_RICH_RESPONSE_INLINE_IMAGE  = 3;
+        AI_RICH_RESPONSE_TABLE         = 4;
+        AI_RICH_RESPONSE_CODE          = 5;
+        AI_RICH_RESPONSE_DYNAMIC       = 6;
+        AI_RICH_RESPONSE_MAP           = 7;
+        AI_RICH_RESPONSE_LATEX         = 8;
+        AI_RICH_RESPONSE_CONTENT_ITEMS = 9;
+    }
+
+    message AIRichResponseUnifiedResponse { optional bytes data = 1; }
+}
+
+message HighlyStructuredMessage {}
+
+// Re-export for cross-reference
+message PremiumMessageInfo { optional string serverCampaignId = 1; }