iUdZddlZddlZddlZddlZddlZddlZddlm Z m Z m Z m Z m Z ddlmZejeZdZdZdZdZd Zd e efd Z dxd ededede e eefde e ee fded e fdZGddeZddddddddddd Zd!ed efd"Zia e ee ee ffe!d#<d$d%ded&e"d e ee ffd'Z#dyd(Z$ded)e d efd*Z%ded+ed)e d efd,Z&ded+ed)e d efd-Z'ded.ed)e d efd/Z(ded+ed)e d efd0Z)ded+ed1ed)e d ef d2Z*dzded+ed4ed5ed)e d ef d6Z+ d{ded.ed5ed8e ed9e ed)e d efd:Z,ded.ed)e d efd;Z-ded.edZ/ d|ded.ed@eddRe ee fdSe e ed e efdTZ? d}dVe edRe e ee fdWed e e ee ffdXZ@dYe ee fdWed e e ee ffdZZAd e e ee ffd[ZBd e e ee ffd\ZCd e e ee ffd]ZDd^d_d`dadbdcdcdddedfdg ZEdheded efdiZFd e"fdjZG d~dhedle ee fdmed+ed.ed1edCedf>>>>?????r)__name__ __module__ __qualname____doc__intstrr@ __classcell__)rBs@rr5r5ds]//@s@#@@@@@@@@@@rr5textvoicecategory announcementannouncement_thread public_threadprivate_threadstageforummedia) r rtype_idc@t|d|dS)Nzunknown())_CHANNEL_TYPE_NAMESget)r\s r_channel_type_namera~s$  " "7,Aw,A,A,A B BBr_capability_cacheF)forcercc|tvr|s t|Sdddd} tdd|d}t|dd pd }t |t t zz|d <t |ttzz|d <d|d <n2#t$r%}t d |Yd}~nd}~wwxYw|t|<|S)aDetect the bot's app-wide capabilities via GET /applications/@me. Returns a dict with keys: - ``has_members_intent``: GUILD_MEMBERS intent is enabled - ``has_message_content``: MESSAGE_CONTENT intent is enabled - ``detected``: detection succeeded (False means exposing everything and letting runtime errors handle it) Cached in a module-global. Pass ``force=True`` to re-fetch. TF)has_members_intenthas_message_contentdetectedGETz/applications/@merVr flagsrrerfrgz?Discord capability detection failed (%s); exposing all actions.N) rbr<rGr`bool_FLAG_GATEWAY_GUILD_MEMBERS#_FLAG_GATEWAY_GUILD_MEMBERS_LIMITED_FLAG_GATEWAY_MESSAGE_CONTENT%_FLAG_GATEWAY_MESSAGE_CONTENT_LIMITEDr4loggerinfo)rrccapsappriexcs r_detect_capabilitiesrts1 !!!%! ''##D  u&95!LLLCGGGQ'',1--%) 03VV W& &  !"'+ 25ZZ [' '  "# Z     Ms         $e KsBB"" C,C  Cc iadS)z%Test hook: clear the detection cache.N)rbrrr_reset_capability_cachervsr_kwargsc <tdd|}g}|D]c}||d|d|d|dd|dd dtj|t |d S) z'List all guilds the bot is a member of.rhz/users/@me/guildsidnameiconownerF permissions)ryrzr{r|r})guildscount)r<appendr`r(r)len)rrwr~resultgs r _list_guildsrs e%8% @ @F F    D'fIEE&MMUU7E**55//        :#f++>> ? ??rguild_idc tdd||ddi}tj|d|d|d|d |d |d |d |d g|d|d|dd S)z'Get detailed information about a guild.rh/guilds/ with_countstruerryrz descriptionr{owner_idapproximate_member_countapproximate_presence_countfeatures premium_tierpremium_subscription_countverification_level) ryrzrr{r member_count online_countrrrrr<r(r)r`)rrrwrs r _server_infors 58 5 5umU[E\]]]A :g& uu]++f EE*%%899:;;EE*b))n--&'ee,H&I&Iee$899     rc tdd|d|}i}g}|D]>}|ddkr0|d|d|dd gd ||d<?|D]}|ddkr|d|dd t|d|dd |d |d dd}|d}|r&||vr"||d|||t |d} | D]} | dd |dg} |r| d|d| D]/} | | d| dd| dd0td| D} tj | | dS)z4List all channels in a guild, organized by category.rhrz /channelstyperUryrzpositionr)ryrzrchannelsr topicnsfwF)ryrzrrrr parent_idrc|dSNrrcs rz _list_channels..s AjMr)keyc|dSrrrs rrz _list_channels..s 1Z=rc|dSrrrs rrz _list_channels..s Qz]rN)rLr)ryrzc3@K|]}t|dVdS)rN)r).0groups r z!_list_channels..s/;;5E*%&&;;;;;;r)channel_groupstotal_channels) r<r`rarsortedvaluessortsumr(r)) rrrwr categories uncategorizedchentryparent sorted_catscatrtotals r_list_channelsrs}'E('E'E'EuMMH79J*,M f:??h6 FF:q11 $$Jr$x (( f:?? T(FF62&&&r&z22z1--VVG__FF65))    $$  (f ** v z * 1 1% 8 8 8 8   ' ' ' '**,,2I2IJJJK:: J!8!8999922333#%FE 4]CCDDD   "4y#f+>>J      ;;F;;; ; ;E :5II J JJr channel_idc tdd||}tj|d|dt |d|d|d|dd |d |d |d d |dd S)z+Get detailed info about a specific channel.rh /channels/ryrzrrrrFrrrate_limit_per_userrlast_message_id) ryrzrrrrrrrr)r<r(r)r`ra)rrrwrs r _channel_infors %!:j!:!:E B BB :hv"2f:..FF:&&vu%%FF:&&VVK((!vv&;Q??66"344     rc tdd|d|}g}t|ddD]}||d|d|d rd |d d d nd |dd |dd|dd|d|dddt j|t |dS)zList all roles in a guild.rhrz/rolesc.|ddS)Nrrr`)rs rrz_list_roles..*sz1)=)=rT)rreverseryrzcolor#r06xNr mentionableFmanagedrhoist)ryrzrrrrrr)rolesr)r<rrr`r(r)r)rrrwrrrs r _list_rolesr&s U$?x$?$?$? G GE F E==t L L L    D'fI45EE'NNL0w**0000j!,,5566uuY..EE.11UU7E**    :V== > >>ruser_idc tdd|d||}|di}tj|d|d|d|d|d |d d |d g|d |dd S)z'Get info about a specific guild member.rhr /members/userryusername global_namenickavatarbotFr joined_at premium_since) rr display_namenicknamerrrrr)r<r`r(r))rrrrwmrs r _member_infor8s G8 G Gg G GOOA 55  D :88D>>HHZ((//EE&MM((8$$xxu%%w##UU;''//     rquerylimitc f t|}n#ttf$rd}YnwxYw|tt |dd}t dd|d||}g}|D]}|di} || d | d | d |d | d d|dgdtj |t|dS)z!Search for guild members by name.rd)rrrhrz/members/searchrrryrrrrFr)rrrrrr)membersr rG TypeError ValueErrorrHminr<r`rr(r)r) rrrrrwrrrrrs r_search_membersrIsCE  z "s3uc??';'; < z#_fetch_messages..}sSUU:..quuU||QUUSY]][[r attachments reactionscg|]B}|did|dddCS)emojirzrr)rrr)rrs rrz#_fetch_messages..s[%%,,0088155RSCTCTUUrpinned)ryrrrrrrr)messagesrr) rrrrrrwrrrmsgrs r_fetch_messagesr_s E  z "%s3uc??';';r)r%r$c,i|]\}}|tv||Sr)_CORE_ACTION_NAMESrkvs r r1s)NNN$!Qa;M6M6MA6M6M6Mrc,i|]\}}|tv||Sr)_ADMIN_ACTION_NAMESr.s rr1r1s)PPP41aq.,s-@@@qaggii@@@@r,cg|]D}t|#t|ESr)rHrr?s rrz0_load_allowed_actions_config...s9???AA ?Q???rz5discord.server_actions: unexpected type %s; ignoring.c$g|] }|tv |Sr_ACTIONSr?s rrz0_load_allowed_actions_config..5s / / /1hQrc$g|] }|tv |SrrDr?s rrz0_load_allowed_actions_config..6s"555Q1H#4#4q#4#4#4rz@discord.server_actions: unknown action(s) ignored: %s. Known: %s, )hermes_cli.configr;r4rodebugr` isinstancerHsplitlisttuplewarningrrCjoinrEkeys)r;cfgrsrawnamesvalidinvalids r_load_allowed_actions_configrVs111111kmm  QSVWWWttttt 779   # ( ()9 : :C {cRiit#s@@CIIcNN@@@ C$ ' '????? CT#YYEW   t / / / / /E55%555G   IIg   (--// : :   Ls A>Arq allowlistcg}tD]>}|dds |tvr"|||vr)||?|S)zCompute the visible action list from intents + config allowlist. Preserves the canonical order from :data:`_ACTIONS`. reT)rEr`_INTENT_GATED_MEMBERSr)rqrWactionsrzs r_available_actionsr[@sjGxx,d33 @U8U8U   T%:%: t Nrr<rZ tool_namec|pi}sdSfdtD}d|}d}ddhtz}|rT|dr?|dd ur(d t |}d |d }|d kr d|d|}nd|d|}dddddddddddddddddddddddddddd dd!ddd"ddgd#d$d%d& } ||d'| d(gd)d*S)+uBuild the tool schema for the given filtered action list. Returns ``None`` when *actions* is empty — callers should drop the tool from registration in that case. Nc4g|]\}}}|v d||d|S)z u — r)rrzsigdescrZs rrz!_build_schema..gsE D#t 7?? %T$3$$d$$ ??r r r%r&rgrfFz and zA NOTE: Bot does NOT have the MESSAGE_CONTENT privileged intent. z will return message metadata (author, timestamps, attachments, reactions, pin state) but `content` will be empty for messages not sent as a direct mention to the bot or in DMs. Enable the intent in the Discord Developer Portal to see all content. discord_adminz>Manage a Discord server via the REST API. Available actions: z Call list_guilds first to discover guild_ids, then list_channels for channel_ids. Runtime errors will tell you if the bot lacks a specific per-guild permission (e.g. MANAGE_ROLES for add_role).z>Read and participate in a Discord server. Available actions: zr Use the channel_id from the current conversation context. Use search_members to look up user IDs by name prefix.string)renumzDiscord server (guild) ID.)rrzDiscord channel ID.zDiscord user ID.zDiscord role ID.zDiscord message ID.z2Member name prefix to search for (search_members).z New thread name (create_thread).integerrzDMax results (default 50). Applies to fetch_messages, search_members.)rminimummaximumrz5Snowflake ID for reverse pagination (fetch_messages).z5Snowflake ID for forward pagination (fetch_messages).)<rii`'zAThread archive duration in minutes (create_thread, default 1440).)rrdr actionrrrrrrrzrrrrobjectrk)r propertiesrequired)rzr parameters)r8rOsetr`r) rZrqr\manifest_linesmanifest_block content_noteaffected_actionsrSrrms ` r _build_schemaruXsZ :2D t/N YY~..NL(+6WE DHHZ00 TXX>S5T5TX]5]5] V$45566 T T T T O##                   7  0  -  -  0  O  =  a   R  R  +++^" " _4"4"Jn"$!     r action_subsetct}|sdSt|}t}fdt||D}|sdSt |||S)zHBuild a dynamic schema for *action_subset* filtered by intents + config.Ncg|]}|v| Srr)rrrvs rrz'_get_dynamic_schema..s#TTTQmASASqASASASr)r\)rrtrVr[ru)rvr\rrqrWrZs` r_get_dynamic_schemarys{   E t  & &D,..ITTTT,T9==TTTG t $) < < <Tool is available only when a Discord bot token is configured.)rjrrrrcheck_discord_tool_requirementsr&s   ! !!rr valid_actions tool_labelc t}|stjddiS||}|s9tjd|t |dSt }|7||vr3tjdd|d|rd|nd iS||||||| d fd t|gD}|r/tjdd |d d|iS ||||||||| | | | |  S#t$r}t d||||j dkr.tjdt||jicYd}~Stjdt|icYd}~Sd}~wt $r?}td||tjdd|icYd}~Sd}~wwxYw)z,Shared handler logic for both discord tools.r2z!DISCORD_BOT_TOKEN not configured.zUnknown action: )r2available_actionsNzAction 'z;' is disabled by config (discord.server_actions). Allowed: rGz)rrrrrrrzc>g|]}||Srr)rp local_varss rrz'_run_discord_action..as+TTTQ*..QRBSBSTqTTTrz!Missing required parameters for 'z': ) rrrrrrrrzrrrrz'Discord API error in %s action '%s': %siz"Unexpected error in %s action '%s'zUnexpected error: )rr(r)r`rLrPrVrOr9r5rorNr.rrrHr4 exception)rkrrrrrrrrrzrrrrr action_fnrWmissingr:rs @r_run_discord_actionr/s"   E Jz7$GHIII!!&))I  z000!%m&8&8&:&:!;!;     -..Iy!8!8z N6NN4=KDIIi0008NN      JUTTT*..vr::TTTG z XXXDIIgDVDVXX    ?y!!"7     ---@*fVWXXX 8s??:w FAF(C(CDEE E E E E E Ez7CFF+,,,,,,,, ???=z6RRRz7$<$<$<=>>>>>>>>?s="D99 H AGH "G;H  H 4HH H c *t|tdfi|S)zNExecute a core Discord action (fetch_messages, search_members, create_thread).r<)rr|rkkwargss r discord_corers v}i J J6 J JJrc *t|tdfi|S)z3Execute a Discord admin action (server management).rb)rrrs rdiscord_admin_handlerrs v~ Q Q& Q QQrrjcfdS)zBCreate a registry-compatible handler lambda for a discord handler.c\difdtDS)NcDi|]\}}|||Srr)rr/r0argss rr1z3_make_handler....s+ C C CA1dhhq!nn C C Crr)_HANDLER_DEFAULTSitems)rkw handler_fns` rrz_make_handler..sBjj C C C C):)@)@)B)B C C Crr)rs`r _make_handlerrs    rrg)rqr\rbr )rztoolsetschemahandlercheck_fn requires_env)NNr)r N)r)rNN)Nrr{) r r r r r r r rr r r)QrFr(loggingr urllib.errorr% urllib.parseurllib.requesttypingrrrrrtools.registryr getLoggerrCror$rkrlrmrnrHrrGr<r4r5r_rarb__annotations__rjrtrvrrrrrrrrrr r rrrrE frozensetr-rPr3rr|rr8rYr9rVr[ruryr}rrrrrrrrrrrL_STATIC_CORE_SCHEMA_STATIC_ADMIN_SCHEMAregisterrrrrs 6  33333333333333######  8 $ $0&&-# '(/% > >>>>(,%) '9'9 '9 '9 '9 T#s(^ $ '9 4S> " '9  '9 '9'9'9'9T@@@@@i@@@  CCCCCC024T#s(^+,1117<&&&&t&S#X&&&&R @ @ @ @ @ @ @sss$4K#4K4K4K4K4K4K4Kn###"?s?c?c?c????$sSSS"AA3A#AcA#AWZA_bAAAA./19=(B(B (B(B(+(B SM(B)1#(B(B (B(B(B(BV Ic Is Is Is I I I IUUU#U#URUUUUU W#W3WCWCWTWWWWW!%!% '*    <`S`C`#``PS`X[```` ddsdSd3dSVd[^dddd #!%%##  "YTTTUUi 003EENN(.."2"2NNN PP8>>#3#3PPP 000$uS#s]+,$" =2B"CDD< \, *!7+!N#n ,/"L1"F+222555**$sDI~&*&htCy&9&&&&R sCx.S " #Y4&*tt #Yt 4S> "ttd38n ttttn =S> = =d38n = = = = 9$sCx.!99999@(4S>":@@@@%HT#s(^4%%%% & @ N 4  ' W W ? > %G&&R##3#3####"""""!%N?N? N?S>N?N? N?  N?  N?N?N? N? N? N? N? N?N? N?N?N?N?bKK3KKKK R#RCRRRRbrb" 2T$mD    j%%8I%}D    z5&9_    M, ' ' ,%&     M/ 0 0 ,%& r