+ lHjS"Rt^RIHt^RIt^RIt^RIHt^RIHt^RI H t ^RI H t H t ]P!]4t^R^R^R ^R /tR t]!0Rfm4t!R R ]4tRRltRtRtRRltRgRRlltRRltRRlt]!R4RRl4t]!R4RRl4t]!R 4R!R"l4t ]!R#4R$R%l4t!]!R&4R'R(l4t"R)t#R*R+R,R-R.R/R0R1R2R/R3R,R4//R5R2.//]R63R*R7R,R8R.R/R0R1R2R/R3R,R4/R9R/R3R:.RhOR,R;/R*R/R3R,RR,R?//R5R2R9.//]R@3R*RAR,RBR.R/R0R1R2R/R3R,RC/R*R/R3R,RD/RER/R3R,RF/RGR/R3R,RH/RIR/RJR,RKRLR/R0R1RMR/R3R,RN/ROR/R>R,RP//R5RM.///R5.//]"RQ3R*RRR,RSR.R/R0R1RTR/R3R,RU/RVR/RWR,RX//R5.//] RY3R*RZR,R[R.R/R0R1R\R/R3R,R]/R^R/R3R,R_/R`R/R3R,Ra//R5.//]!Rb33t$]$F'wt%t&t'] PP!]%R*,Rc]%]&]#Rd]'Re7K) R#)iuyuanbao_tools.py - 元宝平台工具集 (the "hermes-yuanbao" toolset). get_group_info / query_group_members / search_sticker / send_sticker / send_dm. Sticker flow mirrors chatbot-web's sticker-search/sticker-send: the LLM should search_sticker for a sticker_id (or pass the Chinese name), then send_sticker — never bare Unicode emoji. The active adapter singleton lives in ``plugins.platforms.yuanbao.adapter.YuanbaoAdapter.get_active``. ) annotationsN)suppress)Path)Tuple)registry tool_resultunknownuser yuanbao_aibotz\To @mention a user, you MUST use the format: space + @ + nickname + space (e.g. " @Alice ").c2a]tRt^ tRtRV3RlltRtV;t#)_YbErrorzLTool-level failure; ``payload`` is the error envelope returned to the model.cV^8dQhRR/#)msgstr)formats"8/home/ubuntu/.hermes/hermes-agent/tools/yuanbao_tools.py __annotate___YbError.__annotate__#sAACAc @<\SV`V4RRRV/VCVnR#)successFerrorN)super__init__payload)selfrextra __class__s&&,rr_YbError.__init__#s% !5'3@%@ r)r)__name__ __module__ __qualname____firstlineno____doc__r__static_attributes__ __classcell__)r s@rr r sVAArr cV^8dQhRR/#)rlabelrr)rs"rrr(s  C rcaV3RlpV#)ueHandler decorator: ``fn(args)`` → tool_result; ``_YbError`` → its envelope; else logged envelope.cJ<a\P!S4VV3Rl4pV#)c><"\S!V4GRjxL 4#L \d p\TP4uRp?#Rp?i\dHp\P RS4\\\ T44P4uRp?#Rp?ii;i5i)Nz[yuanbao_tools] %s error)rr r Exceptionlogger exceptionr)argskwexcfnr*s&, rhandler'_yb_tool..deco..handler+sp ?"D>22> 0"3;;// ?  !;UC"8CH#5#=#=>> ?sYB  B BABB BB.deco*s%   ?  ?rr)r*r9sf r_yb_toolr;(s  Krc\\4;_uu_4^RIHpVP 4uuRRR4# +'giR#;i)zOLazy import to avoid ImportError when plugins.platforms.yuanbao is unavailable.YuanbaoAdapterN)r ImportError!plugins.platforms.yuanbao.adapterr> get_activer=s r_get_active_adapterrB8s0 +  D((*     s 9 A c8\4;pf \R4hV#)Nz Yuanbao adapter is not connected)rBr )adapters r_adapterrE@s!&((19:: Nrc V^8dQhRRRR/#)rnamerreturnr)rs"rrrFsssrc\\4;_uu_4^RIHpV!VR4uuRRR4# +'giR#;i))get_session_envN)rr.gateway.session_contextrK)rGrKs& r _session_envrNFs. )  ;tR(     s 2 A c$V^8dQhRRRRRR/#)rmdictdefaultrrHr)rs"rrrMs!::T:C::rcFVPRVPRV44#)nickname nick_name)get)rPrRs&&r_nickrWMs 55QUU;8 99rc V^8dQhRRRR/#)r group_coderrHlistr)rs"rrrQs""""rc"VPV4GRjxL pVf \R4hVPR.4#L%5i)Nz#get_group_member_list returned Nonemembers)get_group_member_listr rV)rDrYraws&& r_membersr_Qs?--j9 9C {<== 779b !! :s ?=&?c$V^8dQhRRRRRR/#)rrYrrGrHztuple[str, str]r)rs"rrrXs!00S000rc "V'g \R4hV'g \R4hVP4P4p\W4GRjxL Uu.uFMpY4P R4;'gVP R4;'gRP49gKKVNKO ppV'g\RV RV R 24h\ V4^8d?\R V R 2VUu.uF"pR VP R R4R\ V4/NK$ upR 7hV^,pVP R R4\ WB43#Luupiuupi5i)zResolve ``name`` to (user_id, nickname) via the group member list; >1 partial match raises with ``candidates`` for disambiguation instead of guessing.z3group_code is required when user_id is not providedz-name is required when user_id is not providedNrTrUrLzNo member matching "z" found in group .zMultiple members match "z". Please specify which one.user_id) candidates)r striplowerr_rVlenrW)rDrYrGfiltrPmatcheds&&& r_resolve_dm_recipientrjXs? LMM FGG ::<   D ( ===S=Q55,HHk0BHHbOOQQq=GS -dV3DZLPQRSS 7|a&tf,H IY`aY`TUAEE)R$8*eAhOY`a    A 55B q //>SbsFE 7E D?E E9EE)E/:E )(E /E  E get_group_infocV^8dQhRR/#rrHrQr)rs"rrrns  $ rc\"VPRR4pV'g \R4h\4PV4GRjxL pVf \R4hRRRVRVPRR4R VPR ^4R R VPR R4R VPRR4/RR/#Le5i)u9查询群基本信息（群名、群主、成员数）。rYrLgroup_code is requiredNzquery_group_info returned NonerT group_name member_countownerrcowner_idrTowner_nicknamenoteu+The group is called "派 (Pai)" in the app.)rVr rEquery_group_info)r1rYgis& rrkrkms,+J /00z**:6 6B z7884z< VXAY~q1)RVVJ3ZHXZ\A]^=   7sAB,B*A&B,query_group_memberscV^8dQhRR/#rmr)rs"rrrs!O!Ot!Orca "VPRR4VPRR4r!VPRR4pV'g \R4h\\4V4GRjxL Uu.uFXpRVPRR4R \ V4R \ PVPR VPR ^44R 4/NKZ ppV'g \R 4hVPRR4'd R\ /M/o RV 3RllpVR8XdKVUu.uFqDR ,R9gKVNK ppV'g \R4hV!RR\V4 R2V4#VR8XdV'd}VP4P4pVUu.uF"qHVR ,P49gK VNK$ p pV 'dV!RR\V 4 RV R2V 4#V!RRV R2V4#V!RR\V4 R2V4#ELuupiuupiuupi5i)u统一的群成员查询（对齐 TS query_session_members）。 action: find (按昵称模糊搜索; 无 name 时等同 list_all) / list_bots / list_all (默认).rYrLrGactionlist_allroNrcrTrole user_typerzNo members found in this group.mentionF mention_hintc(V^8dQhRRRRRRRR/#) rokboolrrr\rZrHrQr)rs"rr)query_group_members..__annotate__s.GGTGGdGtGrc<RVRVRV/SC#)rrr\r)rrr\hints&&&r_listing%query_group_members.._listings2uc9gFFFr list_botszNo bots found in this group.TzFound z bot(s).findz member(s) matching "z".zNo match for "z". All members listed below.z member(s).>r r ) rVr r_rErW_USER_TYPE_LABEL MENTION_HINTrgrerf) r1rYrGr{rP all_membersrbotsrhrirs & @rrxrx~sxx b1488FB3G XXh +F /00  J7778A AEE)R(*eAh !%%aeeKvq9I&JIV X7 899-1XXi-G-GNL )RDGG&M;aF)7L*L;M9: :s4yk:DAA Dzz|!!#)KkQz]5H5H5J-J11kK DF3w<.8MdVSU"VX_` `v5QRT_`` DF3{#3"4K@+ NN/8NLsVA H #G;$H *AG>,H 5H H'H-:H ("H  H,H2A H >H search_stickercV^8dQhRR/#rmr)rs"rrrs$rc"^RIHpVPRR4VPR^ 4r2\^\ ^2V'd \ V4M^ 44pT!T;'gRVR7pRRRT;'gRR\V4R VUUu.uF%pR Uu/uFqwVPVR4bK upNK' upp/# \ \3d^ pLxi;iuupiuuppi5i) ue在内置贴纸表中按关键词模糊搜索，返回 Top-N 候选（空 query 返回前 N 条）。)search_stickersqueryrLlimit)rrTcountresults) sticker_idrG description package_id) )plugins.platforms.yuanbao.yuanbao_stickerrrVmaxminint TypeError ValueErrorrg)r1rrr safe_limitmatchessks& rrrsJ88GR($((7B*?5C%CJR@A ekkr" chat_id. Without ``user_id`` the member list is searched by ``name`` (partial, case-insensitive; >1 match returns candidates). media_files items are {"path", "is_voice"} dicts or (path, is_voice) pairs; ``MEDIA:`` tags in the text count too. Partial media failures are reported in ``note``, not as failure.rYrLrzgroup:: media_filespathis_voiceF)BasePlatformAdaptermessagez"message or media_files is requiredrGrcNzCould not resolve user_idzdirect:)rYztext send failedzmedia send failedz%No deliverable text or media remainedz; z DM sent to "z" successfully.z (partial failure: )rTrTrru)rVrN startswithsplit isinstancerQappendrrZtuplergrgateway.platforms.baser extract_mediafilter_media_delivery_pathsr rErerjrrrrsuffixrf _IMAGE_EXTSsend_image_file send_documentjoinr)r1rYrritemrembedded_mediarrDrGresolved_user_idresolved_nickname last_resulterrors media_path _is_voicesendrus& rrrs%,+J l3K&LL7XXYabb]]3*1- K'--2- dD ! !    4d488JPU;V6WX Y tUm , ,Ta   DG d47m< = . ;1??TV@WXN%AA+PTUcUiUigiPjBjkK ;;<<jG 88FB D+/88Ir+B+H+Hb*O*O*QSWS]S]S_' 4I'_c4d.d+ 233()*GKF7==??#OO,?? k)))tyy()) +,O  OO9OO%O&O<OAO9O:OO0!OO$'O 3OOOcF\R4R8H;'g \4RJ#)uNToolset availability check — True when running in a yuanbao gateway session.HERMES_SESSION_PLATFORMyuanbaoN)rNrBrrr_check_yuanbaors% 1 2i ? d dCVCX`dCddrrGyb_query_group_inforulQuery basic info about a group (called '派/Pai' in the app), including group name, owner, and member count. parameterstypeobject propertiesrYstringz)The unique group identifier (group_code).requiredu👥yb_query_group_membersu:Query members of a group (called '派/Pai' in the app). Use this tool when you need to @mention someone, find a user by name, list bots (including Yuanbao AI), or list all members. IMPORTANT: You MUST call this tool before @mentioning any user, because you need the exact nickname to construct the @mention format.r{enumufind — search a user by name (use when you need to @mention or look up someone); list_bots — list bots and Yuanbao AI assistants; list_all — list all members.zUser name to search (partial match, case-insensitive). Required for 'find'. Use the name the user mentioned in the conversation.rbooleanz{Set to true when you need to @mention/at someone in your reply. The response will include the exact @mention format to use.u📋 yb_send_dmu`Send a private/direct message (DM) to a user in a group, with optional media files. This tool automatically looks up the user by name in the group member list and sends the message. Use this when someone asks to privately message / 私信 / DM a user. Supports text, images, and file attachments. You can also provide user_id directly if already known.uThe group where the target user belongs. Extract from chat_id: 'group:328306697' → '328306697'. Required when user_id is not provided.zdTarget user's display name (partial match, case-insensitive). Required when user_id is not provided.rzEThe message text to send as a DM. Can be empty if only sending media.rcz}Target user's account ID. If provided, skips the member lookup. Usually obtained from a previous yb_query_group_members call.rarrayzOptional list of media files to send along with the DM. Images (.jpg/.png/.gif/.webp/.bmp) are sent as image messages; other files are sent as document attachments.itemsrz.Absolute local file path of the media to send.rz5Whether this file is a voice message (default false).u✉️yb_search_stickeruiSearch the built-in Yuanbao sticker (TIM face / 表情包) catalogue by keyword. Returns the top matching candidates with sticker_id, name, and description. Use this BEFORE yb_send_sticker to discover the right sticker_id. Sticker = 贴纸 = TIM face — NOT a message reaction. Prefer sending a sticker over bare Unicode emoji when reacting/expressing emotion.ruwSearch keyword (Chinese or English, e.g. '666', '比心', 'cool', '吃瓜'). Empty string returns the first N stickers.rintegerz8Max number of candidates to return (default 10, max 50).u🔍yb_send_stickeruSend a built-in sticker (TIMFaceElem / 贴纸表情) to the current Yuanbao chat. Call yb_search_sticker first if you don't know the sticker_id/name. Sticker = 贴纸 = TIM face — NOT a message reaction. CRITICAL: Whenever the user asks you to send a sticker / 贴纸 / 表情包, you MUST use this tool. DO NOT draw a PNG via execute_code / Pillow / matplotlib and then call send_image_file — that produces a fake 'sticker' image instead of a real TIM face and is the WRONG path. If no suitable sticker_id is known, call yb_search_sticker first. When the recent thread shows users sending stickers, prefer matching that tone by replying with a sticker instead of (or in addition to) text.ruSticker name (e.g. '六六六', '比心', 'ok') or numeric sticker_id (e.g. '278'). Empty string sends a random built-in sticker.rzvTarget chat. Defaults to the current session. Format: 'direct:{account_id}', 'group:{group_code}', or bare account_id.rz5Optional ref_msg_id to quote-reply (group chat only).u🎨zhermes-yuanbaoT)rGtoolsetschemar5check_fnis_asyncemoji>.bmp.gif.jpg.png.jpeg.webp)rL)rrr|))r& __future__rr7logging contextlibrpathlibrtypingrtools.registryrr getLoggerr"r/rr frozensetrr.r r;rBrErNrWr_rjrkrxrrrr_TOOLS_schema_handler_emojiregisterrrrrsO#0   8 $y!VQ aG6 JK AyA   :"0*      !O!!OH " .> )7@7@te ) A  %'R# \N   " '. , X  %'R# A%= %h %Z +:\84? * V [.b L J  %E#%E%'n %\ "%L "H( &$*H$13c)"!+$*I$13j-" +' "$71dBi5? @ ECL ' e %I %'a B 6 ;B %  % %Z %g %'^!(B-& N S*QS j"(GXv  V_&6wPX$f"(r