PL jFdZddlZddlZddlZddlZddlZddlZddlmZm Z m Z m Z ej e ZddlmZmZmZmZddlmZddlmZmZdedefd Zd edefd ZGd d eZdefdZdefdZ d dZ!defdZ"dedzfdZ#dedefdZ$dedefdZ%dddddedede ede e edede eeff dZ&dZ'dS)!u IRC Platform Adapter for Hermes Agent. A plugin-based gateway adapter that connects to an IRC server and relays messages to/from the Hermes agent. Zero external dependencies — uses Python's stdlib asyncio for the IRC protocol. Configuration in config.yaml:: gateway: platforms: irc: enabled: true extra: server: irc.libera.chat port: 6697 nickname: hermes-bot channel: "#hermes" use_tls: true server_password: "" # optional server password nickserv_password: "" # optional NickServ identification allowed_users: [] # empty = allow all, or list of nicks max_message_length: 450 # IRC line limit (safe default) Or via environment variables (overrides config.yaml): IRC_SERVER, IRC_PORT, IRC_NICKNAME, IRC_CHANNEL, IRC_USE_TLS, IRC_SERVER_PASSWORD, IRC_NICKSERV_PASSWORD N)AnyDictListOptional)BasePlatformAdapter SendResult MessageEvent MessageType) SessionSource)PlatformConfigPlatformrawreturncd}d}|dr? |dddd\}}n#t$r|dd}d}YnwxYwd|vr|dd\}}|}|r|dnd}t|dkr |ddng}|r|||||dS) ziParse a raw IRC protocol line into components. Returns dict with keys: prefix, command, params. :N  :r)prefixcommandparams) startswithsplit ValueErrorlenappend)rrtrailingpartsrrs A/home/kuhnn/.hermes/hermes-agent/plugins/platforms/irc/adapter.py_parse_irc_messager!<s FH ~~c abb'--Q//KFCC   WFCCC  s{{ $** X IIKKE'eAhhRGe**q..U122YYbF  hF C CCs!=AArcDd|vr|ddn|S)z2Extract nickname from IRC prefix (nick!user@host).!r)r)rs r _extract_nickr$Ws&#&&==6<<  Q  f<c ReZdZdZfdZedefdZdefdZ ddZ dded ed e ed e e ee ffd Zddeddfd Zdede ee ffdZd ededeefdZededefdZdeddfdZddZdeddfdZdedededededdf dZxZS) IRCAdapterzAsync IRC adapter implementing the BasePlatformAdapter interface. This class is instantiated by the adapter_factory passed to register_platform(). c Ftd}t||t|dipi}t jdp|dd|_tt jdp|dd |_ t jd p|d d |_ t jd p|dd|_ t jdr)t jdd dvn|dd|_ t jdp|dd|_t jdp|dd|_|dg|_d|jD|_|d}|= ddlm}|d}|r|jr|j}n#t*$rYnwxYwt|pd|_d|_d|_d|_|j |_d|_t7j|_dS)Nirc)configplatformextra IRC_SERVERserverrIRC_PORTport) IRC_NICKNAMEnickname hermes-bot IRC_CHANNELchannel IRC_USE_TLS>1yestrueuse_tlsTIRC_SERVER_PASSWORDserver_passwordIRC_NICKSERV_PASSWORDnickserv_password allowed_usersc`h|]+}t|t|,S) isinstancestrlower).0us r z&IRCAdapter.__init__..}s2)f)f)fS]^_adSeSe)f!'')))f)f)fr%max_message_lengthr)platform_registryF)r super__init__getattrosgetenvgetr.intr0r3r6rEr;r=r?r@_allowed_users_lowergateway.platform_registryrJrI Exception_reader_writer _recv_task _current_nick _registeredasyncioEvent_registration_event) selfr*kwargsr+r,max_msgrJentry __class__s r rMzIRCAdapter.__init__gs|E?? :::,,2i --H8R1H1H  *--H641H1HII  .11XUYYz<5X5X y//K599Y3K3K y'' ,BImR ( ( . . 0 04H H H9d++ "y)>??c599M^`bCcCc!#+B!C!C!iuyyQdfhGiGi$)99_b#A#A)f)fT=O)f)f)f!))011 ? GGGGGG)--e447U57#6G    "%gn"5"58< 7; 26!] #*=??   s+H;; IIrcdS)NIRCrB)r^s r namezIRCAdapter.namesur%cK|jr|js4td|ddddS ddlm}m}|jd|j}|d |s@td |j|j|d d ddS||_ n#t$r d |_ YnwxYw d }|j rtj }tjtj|j|j|dd {V\|_|_nd#t($rW}td|j|j||dt+|dYd }~dSd }~wwxYw|jr#|d|jd {V|d|jd {V|d|jdd {Vtj||_ tj|jdd {Vnb#tj$rPtd|d {V|dddYdSwxYw|jr=|d|jd {Vtj dd {V|d|jd {V|!t"d|j|j|j#|jdS)z:Connect to the IRC server, register, and join the channel.z*IRC: server and channel must be configuredconfig_missingz&IRC_SERVER and IRC_CHANNEL must be setF retryabler)acquire_scoped_lockrelease_scoped_lockrr)z,IRC: %s@%s already in use by another profile lock_conflictz&IRC identity in use by another profileNsslg>@timeoutu&IRC: failed to connect to %s:%s — %sconnect_failedTPASS NICK USER z 0 * :Hermes AgentzIRC: registration timed outregistration_timeoutz#IRC server did not send RPL_WELCOMEPRIVMSG NickServ :IDENTIFY JOIN z(IRC: connected to %s:%s as %s, joined %s)$r.r6loggererror_set_fatal_errorgateway.statusrjrkr3 _lock_key ImportErrorr;rncreate_default_contextr[wait_foropen_connectionr0rVrWrUrDr= _send_raw create_task _receive_looprXr]wait TimeoutError disconnectr?sleep_mark_connectedinforY)r^rjrklock_keyssl_ctxes r connectzIRCAdapter.connectsB{ $,  LLE F F F  ! ! 8 "    5 " O O O O O O O O+77 77H&&uh77  KT]\`\ghhh%%o7_kp%qqqu%DNN " " "!DNNN " G| 7466/6/?' TYGLLL000****** &DL$,,    LLA4;PTPY[\ ] ] ]  ! !"2CFFd ! K K K55555    A..!?)=!?!?@@ @ @ @ @ @ @ @nn4T]44555555555nnFT]FFFGGGGGGGGG"-d.@.@.B.BCC "4#;#@#@#B#BDQQQ Q Q Q Q Q Q Q Q#    LL6 7 7 7//## # # # # # # #  ! !"8:_ko ! p p p55    ! #..!Wt?U!W!WXX X X X X X X X-"" " " " " " " "nn3T\33444444444  > TYX\XjlplxyyytsFA#B3+B33CC A$D00 F:A F  F13I%%AKKNcKt|ddr) ddlm}|d|jn#t$rYnwxYw||jr|js |dd{Vtj dd{Vn#t$rYnwxYw |j |j d{Vn#t$rYnwxYw|j rV|j s=|j  |j d{Vn#tj$rYnwxYwd|_d|_d|_|jdS) zQuit and close the connection.r}Nr)rkr)z QUIT :Hermes Agent shutting downg?F)rNr|rkr}rU_mark_disconnectedrW is_closingrr[rclose wait_closedrXdonecancelCancelledErrorrVrZr]clear)r^rks r rzIRCAdapter.disconnects 4d + +  >>>>>>##E4>::::     !!! <  7 7 9 9  nn%GHHHHHHHHHmC((((((((((      ""$$$l..0000000000     ? 4?#7#7#9#9  O " " $ $ $ o%%%%%%%%)         &&(((((sB- ::25B(( B54B598C22 C?>C?< E EEchat_idcontentreply_tometadatac K|jr|jrtddS|}|||}|D]u} |d|d|d{Vt jdd{V?#t$r*}tdt|cYd}~cSd}~wwxYwtdtttj dz S) NFz Not connected)successrzPRIVMSG r333333?Tr message_id) rWrr_split_messagerr[rrUrDrRtime) r^rrrrtargetlinesliners r sendzIRCAdapter.sendsA| Dt|6688 De?CCC C##GV44 ? ?D ?nn%@%@%@$%@%@AAAAAAAAAmC(((((((((( ? ? ?!%s1vv>>>>>>>>>>> ?$3s49;;;M7N7N3O3OPPPPs;B  CB<4C<Cc KdS)u&IRC has no typing indicator — no-op.NrB)r^rrs r send_typingzIRCAdapter.send_typings  r%clK|dp|d}||rdnddS)N#&groupdm)retype)r)r^r is_channels r get_chat_infozIRCAdapter.get_chat_infosJ'',,G0B0B30G0G )3GGt   r%rcr||}td|dddz}d|z }|j}g}|dD]N}|s |d}t ||} t|| kr*|r||ndt|} } d } | | krI| | zdz} t|d | d| kr| } | dz} n| dz } | | kI| }|d d |}||d zkr|}||d | ||d  }5P|r|nd gS)zSplit a long message into IRC-safe chunks. IRC has a ~512 byte line limit. After accounting for protocol overhead (``PRIVMSG :``), we split content into chunks. rrutf-8rw TrrNrr) _strip_markdownrencoderIrstripminrrfindrstriplstrip)r^rroverhead max_bytes user_limitr paragraph para_byteslimitlowhighbestmidsplit_atspaces r rzIRCAdapter._split_message$s&&w//,&,,,33G<<==A(N ,  t,, : :I??$$  :&--g66 J 22z??e++ ((0 Y///s9~~TTkk:!+C9TcT?11'::;;uDD"!Ag"Qw Tkk !Q998q=(($H Yyy188::;;;%hii07799 / : &'uuB4'r%textcftjdd|}tjdd|}tjdd|}tjdd|}tjdd|}tjdd|}tjd d |}tjd d |}|S) z-Convert basic markdown to plain text for IRC.z \*\*(.+?)\*\*z\1z __(.+?)__z \*(.+?)\*z(?> > > > > > > > F i  CKK1$4$4'H 66KAYF!9D  ""d&8&>&>&@&@@@}-- 7$--2G2G 76K66$qt*66v&&  **3//I63D3DS3I3IJ *;ff G#-74I ! "&"4777D>#CKKLL17799$( !F( [->->-@-@Ha-a-a NP[\\\((##% )        f  s8}!=!=!C!C!E!EI[IaIaIcIc!c!c /%+AY"""  !c!c / /r%rrrc fK|jsdS||||||}t|tj|t t tjdztdj }| |d{VdS)z;Build a MessageEvent and hand it to the base class handler.N)r chat_namerrrrdatetime)r message_typesourcer timestamp) _message_handler build_sourcer r TEXTrDrRr __import__rnowhandle_message)r^rrrrrrevents r rzIRCAdapter._dispatch_messages$  F"" #  $)3ty{{T12233 ,,599;;    !!%(((((((((((r%rN)NNN)__name__ __module__ __qualname____doc__rMpropertyrDreboolrrrrrrrrrr staticmethodrrrrr __classcell__)rbs@r r'r'`s[ *3*3*3*3*3XcX AtAAAAF ) ) ) )P#'-1 QQQQ3- Q 4S>* QQQQ.        3 4S>    *(c*(3*(49*(*(*(*(Xcc\(#C#D####11114W/cW/dW/W/W/W/r))) )  )  ) ))))))))r%r'cxtjdd}tjdd}t|o|S)uoCheck if IRC is configured. Only requires the server and channel — no external pip packages needed. r-rr5)rOrPrr.r6s r check_requirementsrs; Y|R ( (Fi r**G "7 # ##r%ct|dipi}tjdp|dd}tjdp|dd}t |o|S)z=Validate that the platform config has enough info to connect.r,r-r.rr5r6rNrOrPrQrr*r,r.r6s r validate_configro FGR ( ( .BE Y| $ $ ? (B(?(?Fi &&B%))Ir*B*BG "7 # ##r%c|ddlm}m}m}m}m}m}m}m}|d|d}|r|d|d|ddsd S|d |d t|d |pd } | s |dd S|d| |dd} |d| rdnd| rdnd} |d| d|dpd } | rF |dtt| n5#t$r|d| YnwxYw|dr |dd |d|dpd } | s |dd S|d| |d|dpd }|s |dd S|d| t|d |d!|d"dr|d#d$}|r |d%||d&dr|d'd$}|r |d(|t|d)|d*|d+|d,|d-d}|r$|d.d|d/d |d0ni|d.d|d1|d/pd }|r,|d/|d2d |d3n|d/d |d4t|d5|d6d S)7zInteractive `hermes gateway setup` flow for the IRC platform. Lazy-imports ``hermes_cli.setup`` helpers so the plugin stays importable in non-CLI contexts (gateway runtime, tests). r)prompt prompt_yes_nosave_env_value get_env_value print_header print_info print_warning print_successrdr-z!IRC: already configured (server: )zReconfigure IRC?FNuRConnect Hermes to an IRC network. Uses Python stdlib — no extra packages needed.z< Works with Libera.Chat, OFTC, your own ZNC/InspIRCd, etc.z*IRC server hostname (e.g. irc.libera.chat)r)defaultu)Server is required — skipping IRC setupzUse TLS (recommended)?Tr7r:false66976667zPort (default r/uInvalid port — using default zBot nickname (e.g. hermes-bot)r2u+Nickname is required — skipping IRC setupu>Channel to join (e.g. #hermes — comma-separate for multiple)r5u*Channel is required — skipping IRC setupu🔑 Optional authenticationz Leave blank to skip.z+Configure a server password (PASS command)?zServer password)passwordr<z"Identify with NickServ on connect?zNickServ passwordr>u5🔒 Access control: restrict who can message the botuA IRC nicks are not authenticated — anyone can claim any nick.zD For public channels, pair with NickServ-only mode on your networkz, if you want stronger identity guarantees.z2Allow all users in the channel to talk to the bot?IRC_ALLOW_ALL_USERSIRC_ALLOWED_USERSuD⚠️ Open access — any nick in the channel can command the bot.z=Allowed nicks (comma-separated, leave empty to deny everyone)rzAllowlist configureduJNo nicks allowed — the bot will ignore all messages until you add nicks.z)IRC configuration saved to ~/.hermes/.envzFRestart the gateway for changes to take effect: hermes gateway restart)hermes_cli.setupr"r#r$r%r&r'r(r)printrrDrRrr)r"r#r$r%r&r'r(r)existing_serverr.r; default_portr0r3r6r=nickserv allow_allalloweds r interactive_setupr9s9                    L#mL11O IIIIJJJ}/77  FJcdddJMNNN GGG V@/J_]_ ` ` `F  ABBBN<000m4d;;GN=G"@&&AAA$066&L 62<222MM*8>>#3#3444fH m,,2G  BCCCN='--//222 GGGJ-...J()))}BEJJC &!2TBBB  C N0/ B B B}95AA>6-===  > N2H = = = GGGJFGGGJRSSSJUVVVJ=>>> RTYZZIe,f555*B/// \]]]],g666& K!M"566<"     e N.R0H0H I I I M0 1 1 1 1 N. 3 3 3 Jc d d d GGGM=>>>JWXXXXXs+&DD-,D-ct|dipi}tjdp|dd}tjdp|dd}t |o|S)z5Check whether IRC is configured (env or config.yaml).r,r-r.rr5r6rrs r rrr r%cDtjdd}tjdd}|r|sdS||d}tjdd}|r$ t||d<n#t$rYnwxYwtjdd}|r||d <tjd d}|r|d v|d <tjd rtjd |d<tjdrtjd|d<tjdp|}|r|tjd|d|d<|S)uSeed ``PlatformConfig.extra`` from env vars during gateway config load. Called by the platform registry's env-enablement hook (landed in the generic-plugin-interface migration) BEFORE adapter construction, so ``gateway status`` and ``get_connected_platforms()`` reflect env-only configuration without instantiating the IRC client. Returns ``None`` when IRC isn't minimally configured; the caller skips auto-enabling. The special ``home_channel`` key in the returned dict is handled by the core hook — it becomes a proper ``HomeChannel`` dataclass on the ``PlatformConfig`` rather than being merged into ``extra``. r-rr5Nrr/r0r2r3r7>r8r9r:r;r<r=r>r?IRC_HOME_CHANNELIRC_HOME_CHANNEL_NAME)rre home_channel)rOrPrrRrrE)r.r6seedr0r3r;homes r _env_enablementrAsY|R ( ( . . 0 0Fi r**0022G wtD 9Z $ $ * * , ,D  t99DLL    D y,,2244H$#Zi r**002288::G:!%99Y y&''C"$),A"B"B  y())G$&I.E$F$F ! 9' ( ( 3GD  I5t<<  ^ KsB B$#B$rc~|ddddddS)a1Strip IRC line terminators and the NUL byte from ``text``. IRC commands are CRLF-delimited; a bare ``\r`` or ``\n`` in user content lets an attacker inject arbitrary IRC commands (CTCP, JOIN, KICK). ``\x00`` is a protocol-illegal byte. Everything else is valid in PRIVMSG payloads.  rrr)rrs r _strip_irc_control_charsrEs8 <<c " " * *4 5 5 = =fb I IIr%rc4t|o |ddvS)Nrz#&+!)r)rs r _is_irc_channelrGs << /F1I//r%F) thread_id media_filesforce_documentrmessagerHrIrJc B23Kt|dipi}tjdp|dd}tjdp|dd}|r|sddiStjd p|d d } t | } n#t t f$r dd | icYSwxYwtjd p|dd} tjd} | | dv} n#t|dd} tjdp|dd}tjdp|dd}|p|2t2fddDrddiS2}| dddpd}|ddd}t |}| rtjnd} tjtj|| | d!"d{V\}3n-#tj$rt&$r}dd#|icYd}~Sd}~wwxYwd$t(d%df3fd& }d'}d(} |r!|d)t+|d{V|d*|d{V|d+|d,d{Vtj}|d!z}d-}|s||z }|d'krcdd.i 3tj3d/"d{VS#tjt&f$rYSwxYw tj|d0|"d{V}n#tj$rfdd.icY 3tj3d/"d{VS#tjt&f$rYSwxYwtj$rfdd1icY 3tj3d/"d{VS#tjt&f$rYSwxYwwxYw|d2d34 d5}t=|} | d6}!|!d7kr.| d8r| d8d'nd}"|d9|"d{Vn |!d:krd}n|!d;vr|d|dd}|d*|d{Vnk|!d?vrgdd@|!dAi 3tj3d/"d{VS#tjt&f$rYSwxYw||r;|dBt+|d{VtjdCd{VtA|r|dD|d{V|d/z}#d-}$|$s]|#|z }|d'krn> tj|d0|"d{V}n!#tjtjf$rYnwxYw|d2d34 d5}t=|}%|%d6}&|&d7kr-|%d8r|%d8d'nd}"|d9|"d{Vnu|&dEvrd}$nn|&dFvrjddG|dH|&dAi 3tj3d/"d{VS#tjt&f$rYSwxYw|$]tCdI|dJ"d2dCz}'dK|'z }(d-})|#dLD]x}*t+|* }*|*s'|*rN|*"d2}+tC|+|(kr4|dI|dJ|*d{VtjdMd{Vd})ndr8r9r:r;Tr<r=r>r?c3 K|]}|vV dSrrB)rFch raw_targets r z#_standalone_send..s( @ @2  @ @ @ @ @ @r%)rCrrDrz._rawsQ dVm++G44555llnnr%rrrrsrtz 0 * :Hermes Agent (cron)Fz:IRC standalone send: registration timeout (no RPL_WELCOME)g@rzAIRC standalone send: server closed connection during registrationrrrrrrrrr>432rrz-IRC standalone send: too many nick collisionsz-cron->464465z-IRC standalone send: server rejected client (r*rvrwrx>366JOIN>403405471473474475zIRC standalone send: JOIN z rejected (rrrrrrrz2IRC standalone send: empty message after strippingzQUIT :deliveredig@rrzIRC standalone send raised)exc_infozIRC standalone send failed: ))rNrOrPrQrR TypeErrorrrEranyrr'rrnrr[rrrrUrDrEget_running_looprrrr readuntilIncompleteReadErrorrr!rrGrrrrrrryr)4pconfigrrKrHrIrJr,r.r6 port_valuer0r3 use_tls_envr;r=r?r nick_basestandalone_nickplainrreaderrrU nick_attemptsmax_nick_attemptsloopdeadline registered remainingraw_linerrcmdr join_deadlinejoinedjmsgjcmdrrsent_anyrrrrrrrrrOrTs4 @@r _standalone_sendr|s 6 GWb ) ) /RE Y| $ $ ? (B(?(?Fi &&B%))Ir*B*BG __]^^:&&A%))FD*A*AJN: z "NNNLjLLMMMMNy((OEIIj,,O,OH)M**K##%%)==uyyD1122i 566Z%))DUWY:Z:ZO "9::`eiiH[]_>`>`#GJ @ @ @ @&? @ @ @@@YWXX F //4D I")))#2#.O  & &w / /E.5?c(***4G@&/  #FDg > > >           ! @@@>1>>???????@M  L$J7HHJJKK K K K K K K Kd,?,,---------dE?EEEFFFFFFFFF'))99;;%  Y 499;;.IA~~!]^^  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D c f!(!1&2B2B72K2KU^!_!_!_______' _ _ _!]^^^V  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D [. f f f!deeeR  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D [ foogio@@GGOOG$W--Ci.Cf}}.1(mC#h-**d-G--..........! &&"  #444#%TUz  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D {&/"E"Em"E"Ecrc"Jd4?445555555555&&!WQT!W!W!WXn  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D k Y:  #$b5MN_5`5`bbcc c c c c c c c-"" " " " " " " " 6 " " ^$'v''(( ( ( ( ( ( ( ( IIKK#-MF ^)DIIKK7 >>%,%5f6F6Fw6O6OYb%c%c%cccccccHH,g.IJE"//')/DDKKFSS)'22I6>>37>Id8nQ//rG$1112222222222_,,!FFGGG#%\&%\%\UY%\%\%\]l  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D Y ^2,&,,,33G<<==A(N T** : :I0;;BBDDI  :#**733w<<9,,$?&??I??@@@@@@@@@!-,,,,,,,,,#H"#S^^Q4TTkk:!+C9TcT?11'::;;yHH"!Ag"Qw Tkk !Q998q=(($HdOfOO )8)0D0K0K0M0MOOPPPPPPPPPmC(((((((((%hii07799 / :2 SQR  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D !d$%%%%%%%%% "6;;t#4#4cBBB B B B B B B B B#    D  s3ty{{T7I3J3J/K/KLL  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D   ! === 1D AAA;;;<<<<<<  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D =  LLNNN"6#5#5#7#7EEE E E E E E E E E$i0    D sB//C  C 4II=,I82I=8I=Bl0AM33N  N /O?lR(lAPP10P14R(lAR  R$#R$'R((Bl=AVVV/l AXX('X(+Bl /[;:l;\l\B l&A_))``Gl Ahh)(h),l>/i.-l.j=l?j5l6Ak99lln:."n5n:n=Ann21n25n::n==p?Appppppc|dddtttgddtt dt ddd d d d d dS)z7Plugin entry point: called by the Hermes plugin system.r)rdc t|Sr)r')cfgs r zregister..s JsOOr%)r-r5r2z&No extra packages needed (stdlib only)r<r1r0rKu💬FTuYou are chatting via IRC. IRC does not support markdown formatting — use plain text only. Messages are limited to ~450 characters per line (long messages are automatically split). In channels, users address you by prefixing your nick. Keep responses concise and conversational.)relabeladapter_factorycheck_fnrr required_env install_hintsetup_fnenv_enablement_fncron_deliver_env_varstandalone_sender_fnallowed_users_env allow_all_envrIemojipii_safeallow_update_command platform_hintN)register_platformrrrr9rAr|)ctxs r registerrst 33#'!BBB="*0.-+! E(((((r%r)(rr[loggingrOrrnrtypingrrrr getLoggerrrygateway.platforms.baserrr r gateway.sessionr gateway.configr r rDdictr!r$r'rrrr9rrArErGr|rrBr%r rs: ,,,,,,,,,,,,  8 $ $ *)))))33333333DCDDDDDD6=#=#====\)\)\)\)\)$\)\)\)F $D $ $ $ $$t$$$$hYhYhYhYV$D$$$$00000fJ3J3JJJJ0C0D0000 $'+ OOO OO } O $s)$ OO #s(^OOOOd*****r%