`gjPdZddlmZddlZddlZddlZddlZddlmZm Z m Z eje Z GddZddZy) u Transport-agnostic WhatsApp behavior shared by the Baileys bridge adapter and the official WhatsApp Cloud API adapter. The mixin provides: - Allow-list / DM / group gating - Mention detection (explicit @-mentions + configurable regex patterns) - Quoted-reply-to-bot detection - Broadcast / Channel / Newsletter filtering - WhatsApp-flavored markdown conversion - Outgoing chunk length budgeting It is the *behavior layer*. Transport-specific concerns (subprocess management, HTTP webhooks, Graph API calls, media upload protocols) live in each adapter. Mixin contract — the adapter must set these on ``self`` before any of the mixin's methods are called (typically in ``__init__``): self.config # gateway.config.PlatformConfig self.name # str — adapter name (used in log lines) self._dm_policy # str: "open" | "allowlist" | "disabled" self._allow_from # set[str] self._group_policy # str: "open" | "allowlist" | "disabled" self._group_allow_from # set[str] self._mention_patterns # list[re.Pattern] self._reply_prefix # Optional[str] Class attributes ``MAX_MESSAGE_LENGTH`` and ``DEFAULT_REPLY_PREFIX`` are defined on the mixin and may be overridden per-adapter if needed. ) annotationsN)AnyDictOptionalcdeZdZUdZdZded<dZdZded<ejd Z ejd Z e d"d Z ed#d Zd$d Zd%dZd#dZd&dZed&dZed'dZed(dZd#dZed)dZd*dZd*dZd(dZdZd+dZd,dZd,dZ d,dZ!d-dZ"d,dZ#d"d Z$y!).WhatsAppBehaviorMixinu"Shared behavior for all WhatsApp adapters (Baileys + Cloud API). See module docstring for the attribute contract the host adapter must satisfy. This mixin owns no state of its own — every value it touches is either a class attribute or set by the adapter's ``__init__``. iintMAX_MESSAGE_LENGTHTu8⚕ *Hermes Agent* ──────────── strDEFAULT_REPLY_PREFIXz[\u200b\u2060\u2063\ufeff]z3[\u00a0\u1680\u180e\u2000-\u200a\u202f\u205f\u3000]cz|s|S|jjd|}|jjd|S)uRemove invisible formatting chars that leak badly in WhatsApp. Some provider/gateway formatting paths can emit unicode like WORD JOINER (U+2060) plus NARROW NO-BREAK SPACE (U+202F). WhatsApp may render those as mojibake-looking prefixes (``⁠ text``) instead of invisible spacing. Keep normal text and emoji joiners intact, but strip known zero-width format chars and normalize odd unicode spaces.  )_OUTBOUND_INVISIBLE_CHARS_REsub_OUTBOUND_ODD_SPACE_RE)clscontents T/root/.hermes/venv/lib/python3.12/site-packages/gateway/platforms/whatsapp_common.py_sanitize_outbound_textz-WhatsAppBehaviorMixin._sanitize_outbound_text>s=N2266r7C))--c7;;cy)zDWhatsApp gates DM/group access at intake via dm_policy/group_policy.Tselfs renforces_own_access_policyz0WhatsAppBehaviorMixin.enforces_own_access_policyMsrctjdd}|dk7ry|j|jjddStjd}||jddS|jS)zReturn the prefix to add to outgoing replies in self-chat mode. Subclasses that don't have a self-chat concept (the Cloud API adapter) can override this to always return ``""`` or apply a different policy. WHATSAPP_MODEz self-chatrz\n WHATSAPP_REPLY_PREFIX)osgetenv _reply_prefixreplacer )r whatsapp_mode env_prefixs r_effective_reply_prefixz-WhatsAppBehaviorMixin._effective_reply_prefixSsx /;? K '    )%%--eT: :YY67  !%%eT2 2(((rcft|j}td|j|z S)z>rc|jjjd}|-t|tr|j dvSt |Stjddj dvS)Nrequire_mention>1onyestrueWHATSAPP_REQUIRE_MENTIONfalse) configextraget isinstancer lowerboolr!r")r configureds r_whatsapp_require_mentionz/WhatsAppBehaviorMixin._whatsapp_require_mentionksu[[&&**+<=  !*c*!'')-GGG # #yy3W=CCEJ   rc|jjjd}|tjdd}t |t rA|Dchc]5}t|jst|j7c}St|jdDchc]#}|js|j%c}Scc}wcc}w)Nfree_response_chatsWHATSAPP_FREE_RESPONSE_CHATSr,) r5r6r7r!r"r8listr stripsplit)rrawparts r_whatsapp_free_response_chatsz3WhatsAppBehaviorMixin._whatsapp_free_response_chatsxskk##$9: ;)):B?C c4 25K$T9JCIOO%K K),S)<M  MMLMsC1C+CCc^| tSt|trA|Dchc]5}t|j st|j 7c}St|j dDchc]#}|j s|j %c}Scc}wcc}w)z;Parse allow_from / group_allow_from from config or env var.r@)setr8rAr rBrC)rDrEs r_coerce_allow_listz(WhatsAppBehaviorMixin._coerce_allow_listsx ;5L c4 25K$T9JCIOO%K K),S)<M  MMLMsB%B%:B*B*ct|syt|j}d|vrd|vr|jddd}|S)Nr:@)r rBr$)value normalizeds r_normalize_whatsapp_idz,WhatsAppBehaviorMixin._normalize_whatsapp_idsCZ%%' *  !2#++Ca8Jrc|sy|jj}|dk(ry|jds|jdryy)upTrue for WhatsApp pseudo-chats that aren't real conversations. Covers Status updates (Stories) and Channel/Newsletter broadcasts. These show up as inbound messages on Baileys but the agent should never reply — answering a Story update spams the contact's status feed, and Channel posts aren't addressable in the first place. Fzstatus@broadcastTz @broadcastz @newsletter)rBr9endswith)chat_idcids r_is_broadcast_chatz(WhatsAppBehaviorMixin._is_broadcast_chatsImmo##% $ $ << %m)DrctjddjdvrytjddjdvS)NGATEWAY_ALLOW_ALL_USERSr>r/r1r2TWHATSAPP_ALLOW_ALL_USERS)r!r"r9rs r_open_dm_opted_inz'WhatsAppBehaviorMixin._open_dm_opted_insD 99. 3 9 9 ;?S Syy3R8>>@DXXXrc|sy||vryddlm}m}||}|sy|D]"}|dk(ry|||vry|||zs"yy)amMatch a WhatsApp identifier against an allowlist across phone/LID forms. WhatsApp delivers inbound senders in LID form (``@lid``) while operators usually configure allowlists with phone numbers, and vice versa. A raw set-membership check therefore never matches a known contact. Resolve both the candidate and each allowlist entry through the bridge's ``lid-mapping-*.json`` files (the shared ``gateway.whatsapp_identity`` helper that the gateway authz and session-key paths already use) so either configured form resolves to the inbound form. FTr)expand_whatsapp_aliasesnormalize_whatsapp_identifier*)gateway.whatsapp_identityr[r\) candidate allow_fromr[r\candidate_aliasesentrys r_matches_whatsapp_allowlistz1WhatsAppBehaviorMixin._matches_whatsapp_allowlistsq  " 4I>  E|,U37HH'u-0AA rc|jdk(ry|jdk(r|j||jS|jdk(r|jSy)u:Strict DM authorization — pairing does not imply access.disabledF allowlistopen) _dm_policyrc _allow_fromrY)r sender_ids r_is_dm_allowedz$WhatsAppBehaviorMixin._is_dm_allowedsT ??j ( ??k )33It?O?OP P ??f $))+ +rct|xsdj}|sy|jdk(ry|jdk(r|j||jS|jdk(ry|jdk(r|j Sy)zCWhether a DM may reach the gateway intake (pairing handshake path).rFrerfpairingTrg)r rBrhrcrirY)rrj principals r_is_dm_intake_allowedz+WhatsAppBehaviorMixin._is_dm_intake_alloweds R(..0  ??j ( ??k )33It?O?OP P ??i ' ??f $))+ +rc|jdk(ry|jdk(r|j||jS|jdk(ry|jdk(ryy)z/Check whether a group chat should be processed.reFrfrmrgT) _group_policyrc_group_allow_from)rrSs r_is_group_allowedz'WhatsAppBehaviorMixin._is_group_alloweds_    +    ,33GT=S=ST T    *    'rcN|jjjd}|FG!-GGG! G!$H$7"HH$ct}|jdxsgD]'}|j|}|s|j|)|S)NbotIds)rHr7rPadd)rdatabot_idsr_rOs r_bot_ids_from_messagez+WhatsAppBehaviorMixin._bot_ids_from_message'sL%(+1r (I44Y?J J' (rcn|j|jd}|sy||j|vS)NquotedParticipantF)rPr7r)rrquoted_participants r_message_is_reply_to_botz.WhatsAppBehaviorMixin._message_is_reply_to_bot/s9!88BU9VW!!T%?%?%EEErc||j|}|sy|jdxsgDchc]}|j|x}r|}}||zryt|jdxsd}|j }|D]5}|j dddj } | s)d| |vs| |vs5yycc}w) NF mentionedIdsTbodyrrLrMr)rr7rPr r9rC) rrrr_nid mentioned_idsr lower_bodybot_idbare_ids r_message_mentions_botz+WhatsAppBehaviorMixin._message_mentions_bot5s,,T2#hh~6<" 229===   7 "488F#)r*ZZ\  Fll3*1-335GayMZ77j;P  sB9c|jsyt|jdxsdtfd|jDS)NFrrc3@K|]}|jyw)N)search).0rrs r zJWhatsAppBehaviorMixin._message_matches_mention_patterns..MsNG7>>$'Ns)_mention_patternsr r7any)rrrs @r!_message_matches_mention_patternsz7WhatsAppBehaviorMixin._message_matches_mention_patternsIs>%%488F#)r*Nt7M7MNNNrc|s|S|j|}|}|D]H}|jddd}|stjdtj|dd|}J|j xs|S)NrLrMrz \b[,:\-]*\s*r)rrCrrescaperB)rtextrrcleanedrrs r_clean_bot_mention_textz-WhatsAppBehaviorMixin._clean_bot_mention_textOsK,,T2 Fll3*1-G&&7+,L92w  }}&$&rct|jdxsd}|j|ry|jdd}|r|}|j|sEyt|jdxs|jdxsd}|j |syyt|jdxsd}||j vry|j syt|jdxsdj}|jd ry|j|ry|j|ry|j|S) NchatIdrFisGroupsenderIdfromTr/) r r7rUrsrorFr<rB startswithrrr)rr chat_id_rawis_grouprSrjrs r_should_process_messagez-WhatsAppBehaviorMixin._should_process_message\s.$((8,23  " "; /88Iu- !G))'2DHHZ0JDHHV4DJKI--i8dhhx(.B/ d88: :--/488F#)r*002 ??3   ( ( .  % %d +55d;;rc |s|S|j|}d g d fd }tjd||}d g d fd }tjd||}tjdd|}tjd d |}tjd d |}tjd d |}dd}tjd||tj}tjdd|}t D]\}}|j |d|}t D]\}}|j |d|}|S)aConvert standard markdown to WhatsApp-compatible formatting. WhatsApp supports: *bold*, _italic_, ~strikethrough~, ```code```, and monospaced `inline`. Standard markdown uses different syntax for bold/italic/strikethrough, so we convert here. Code blocks (``` fenced) and inline code (`) are protected from conversion via placeholder substitution. zFENCEcjj|jdtdz dSNrrMrgroupr))m _FENCE_PHfencess r _save_fencez9WhatsAppBehaviorMixin.format_message.._save_fences1 MM!''!* %[Vq 16 6rz```[\s\S]*?```zCODEcjj|jdtdz dSrr)r_CODE_PHcodess r _save_codez8WhatsAppBehaviorMixin.format_message.._save_codes1 LL $ZE Q/t4 4rz `[^`\n]+`z.(?._header_to_boldsGGAJ$$&Ee*q.U%5%5c%:u~~c?Ra ))+e*q.U%5%5c%:u~~c?RugQ< rz^#{1,6}\s+(.+)$)flagsz\[([^\]]+)\]\(([^)]+)\)z\1 (\2)r)rzre.Matchreturnr )rrr MULTILINE enumerater$) rrrresultrrifencecoderrrrs @@@@rformat_messagez$WhatsAppBehaviorMixin.format_messagesdN..w7  7);@ 5 j&9  =    ('6: gv6 gv6  r||  2JG"&) BHAu^^yk!D$95AF B ' @GAt^^xj4$8$?F @ rN)rr rr )rr:)rr )rr )rset[str])rNz Optional[str]rr )rSr rr:)r_r rr:)rjr rr:)rDict[str, Any]rr)rrrr:)rr rrrr )%r __module__ __qualname____doc__r __annotations__supports_code_blocksr rrrr classmethodrpropertyrr'r,r<rF staticmethodrIrPrUrYrcrkrorsrrrrrrrrrrrrr,s#" \#\#-2::.K#L 'RZZ(^_ < < )"?  NNN(Y $$L  ,\F (O ' rsG>#  &&   8 $]]H .r