(Gj9LjdZddlmZddlZddlmZmZmZmZm Z dZ dZ dZ dZ d Zd ZeeefZejd Zejd Zejd ZejdZejdZejdZejdZdd!Z!d?d#Z"d@d$Z#d?d%Z$dAd(Z%dBd+Z&d?d,Z'dCd.Z(dDd0Z)dEd2Z*dFd5Z+dGd6Z, dHdId9Z-dJd;Z.dS)Ku Render agent markdown into Slack Block Kit blocks. Opt-in (``slack.extra.rich_blocks: true``) alternative to the flat mrkdwn ``text`` payload produced by :meth:`SlackAdapter.format_message`. Block Kit gives us real structural primitives — section headers, dividers, and true *nested* lists via ``rich_text`` — that plain mrkdwn can only approximate. Design constraints (why this module is deliberately conservative): * **Markdown pipe-tables render as native ``table`` blocks** — real grid cells with per-column alignment and inline-formatted ``rich_text`` content. A table that exceeds Slack's limits (100 rows / 20 cols / 10k aggregate cell chars) or won't parse falls back to aligned monospace ``rich_text_preformatted`` so a large table never breaks the message. * **Slack caps a message at 50 blocks** and a ``section``/text object at 3000 characters. :func:`render_blocks` enforces both and, if the content simply cannot be expressed within them, returns ``None`` so the caller falls back to the plain-text path. A rich render is a nice-to-have; it must never lose a message. * **Every blocks payload MUST ship a ``text`` fallback.** Slack uses it for notifications, screen readers, and old clients. This module only builds the ``blocks`` list; the adapter pairs it with the existing mrkdwn string. The renderer never raises: any unexpected input degrades to ``None`` (caller uses plain text). It is a pure function of its input — no Slack client, no adapter state — so it is trivially unit-testable. ) annotationsN)AnyDictListOptionalTuple2i di'z ^\s{0,3}([-*_])(?:\s*\1){2,}\s*$z!^\s{0,3}(#{1,6})\s+(.+?)\s*#*\s*$z^\s*(`{3,}|~{3,})(.*)$z^(\s*)(\d+)[.)]\s+(.*)$z^(\s*)[-*+]\s+(.*)$z^\s{0,3}>\s?(.*)$z1^\s*\|?\s*:?-{1,}:?\s*(\|\s*:?-{1,}:?\s*)+\|?\s*$linestrreturnboolctt|pt|S)z=True if ``line`` is a markdown list item (bullet or ordered).)r _BULLET_REmatch _ORDERED_RE)r s G/home/rurouni/.hermes/hermes-agent/plugins/platforms/slack/block_kit.py _is_list_liner:s1    &&A+*;*;D*A*A B BBspacesintcPd}|D]}||dkrdndz }t|dzdS)zHMap leading whitespace to a nesting level (2 spaces or 1 tab per level).r )min)rwidthchs r _indent_levelr#?sB E(( bDjja' uz1  rz `([^`]+)`z7(?.emit_text\sF  F&,a88  BwKrDict[str, bool]cLd}t|D]q}||||t|}d|d<|d|pd|}r||d|dS)NrTcoder)_INLINE_CODE_REfinditerstartdictgroupend)r'r(posm code_style _walk_linksr1s rwalkz_inline_elements..walkgs ))!,,  A K#aggii-(% 0 0 0eJ!%Jv  Iaggajj*"4 5 5 5%%''CC AcddGU#####rcd}t|D]}||||d|d|dd}|rt ||d<||}||d|dS)Nrlinkrr)r-urlr$r()_LINK_REr6r7r9r8r.r:)r'r(r;r<link_el_walk_emphasisr0s rr>z%_inline_elements.._walk_linksrs""1%%  A N1S]+U 3 3 3/5aggajjRSRYRYZ[R\R\&]&]G /#';; OOG $ $ $%%''CCqw&&&&&rc|sdStdftdftdffD]\}}||}|r|d||t |}d||<|d|||d|dS||rt |nddS)NboldstrikeitalicTr)_BOLD_RE _STRIKE_RE _ITALIC_REsearchr7r8r9r:)r'r(rxkeyr< inner_stylerEr1s rrEz(_inline_elements.._walk_emphasis}s  F!6*Z,BZQYDZ[  GB ! A q!''))}e444"5kk #' C qwwqzz;777q{E222    !E3T%[[[t44444rr$r,N)r'rr(r)rr*)r'rr(r2rr*)r$r?rEr>r0r1s @@@@r_inline_elementsrSSs&(H $ $ $ $ $ $ $ ' ' ' ' ' ' ' 5 5 5 5 5 5 5 DrNNN  76677rBlockctjdd|}t|tkr|dtdz dz}dd|ddd S) Nz[*_~`]ru…header plain_textT)r-r$emojir,)resubstriplenMAX_HEADER_TEXT)r$cleans r _header_blockr`se F9b$ ' ' - - / /E 5zzO##+!++,u4|UUY&Z&Z [ [[rc ddiS)Nr-dividerrRrRrr_divider_blockrcs I rcBddd|ddgdgdS)N rich_textrich_text_preformattedr$ r,r-r0)rstripr$s r_preformatted_blockrksD1&,dkk$6G6GHHI     rlines List[str]cg}t|D]A\}}|r|ddd|t|Bdd|dgdS)Nr$rgr,rerich_text_quoterh) enumerater.extendrS)rlsection_childrenilns r _quote_blockrus-/5!!662  D  # #VT$B$B C C C 0 4 45555/=MNNO  ritemsList[Tuple[int, bool, str]]cg}d}d}|D]a\}}}||f}||kr"d|rdnd|gd}|||}|J|ddt|dbd |dS) a0Build ONE rich_text block from consecutive list items. ``items`` is a list of ``(indent, ordered, text)``. Each contiguous run sharing the same (indent, ordered) becomes a ``rich_text_list`` element; indentation changes start a new element, which is how Slack renders true nesting. Nrich_text_listorderedbullet)r-r(indentr0r0rich_text_sectionrhre)r.rS)rvr0curcur_keyr|rzr$rOs r _list_blockrs&(H$(C*.G!&  w '>>(&-;8  C OOC G J(6Ft6L6L M M     X 6 66rcdd|ddS)Nsectionmrkdwnr,rRrjs r_section_blockrs$'G'G H HHrsep_linecg}|ddD]}|}|d}|d}|r|r|dZ|r|dr|d|S)zParse a markdown separator row (``|:--|:-:|--:|``) into column aligns. Returns a list of ``"left"``/``"center"``/``"right"`` per column. |:centerrightleft)r\split startswithendswithr.)ralignscellcrrs r_parse_alignmentrs F  &&s++11#66 " " JJLL||C   3  "E " MM( # # # #  " MM' " " " " MM& ! ! ! ! Mrrowc|ddd}d|dDS)zSplit a markdown table row into trimmed cell strings. Respects backslash-escaped pipes (``\|``) so they aren't treated as column separators. rz\|PIPEc^g|]*}|dd+S)rr)r\replace).0rs r z_split_row..s0 Q Q QqAGGII  nc 2 2 Q Q Qr)r\rr)r protecteds r _split_rowrsO !!#&&..unEEI Q QIOOC}|t|kr||nd} | | dkrd| ind?dd |Dd } td |Dr|| d <| S) uBuild a native Slack ``table`` block from markdown pipe-table rows. ``rows`` includes the header row (index 0) and body rows; ``sep_line`` is the ``|---|`` alignment row (already consumed by the caller). Returns ``None`` when the table exceeds Slack's limits (100 rows / 20 cols / 10,000 aggregate cell chars) or parses to nothing — the caller then falls back to the monospace preformatted rendering. cTg|]%}|t|&SrR)r\rrrs rrz _table_block..s+ 7 7 7QWWYY 7jmm 7 7 7rNc34K|]}t|VdSrQr]rs r z_table_block..(''1A''''''rrVc3>K|]}|D]}t|VdSrQrrrrs rrz_table_block..s588a88c!ff8888888rraligntablec&g|]}d|DS)c,g|]}t|SrR)r)rrs rrz+_table_block...)s 888D/$''888rrR)rrs rrz _table_block..)s'KKKS88C888KKKr)r-rc3K|]}|duV dSrQrR)rcss rrz_table_block..+s& 4 4b2T> 4 4 4 4 4 4rcolumn_settings) maxr]MAX_TABLE_ROWSMAX_TABLE_COLSrqsumMAX_TABLE_CHARSrranger r.any) rrparsedncolsr total_charsrrrrblocks r _table_blockrs8 7T 7 7 7F t ''''' ' 'E 6{{^##u~'='=t ** "Q())))88f88888K_$$t h ' 'F68O 3un-- . .NNV__q & 5F??//MMMMKKFKKKE 4 4O 4 4 4443#2 Lrc g|D]&t}|'sd|StdD}D]+dg|t z z,fdt |Dg}tD]\}dfdt |D}|||dkrA|dfd t |Dd|S) zERender markdown pipe-table rows as aligned monospace text (fallback).rgc34K|]}t|VdSrQrrs rrz _render_table..8rrrVcHg|]tfdDS)c3BK|]}t|VdSrQrrs rrz+_render_table...;s-,,#ad)),,,,,,r)r)rrrs @rrz!_render_table..;s7 C C Cc,,,,V,,,,, C C Crz | c3ZK|]%}||V&dSrQ)ljust)rrrwidthss rrz _render_table..>s7FFA!A$**VAY//FFFFFFrrz-+-c3.K|]}d|zVdS)-NrR)rrrs rrz _render_table..As+'N'NAfQi'N'N'N'N'N'Nr) rr.joinrrqr]rrpri) rcellsr out_linesrir rrrs @@@r _render_tabler0s F 1  e yy ''''' ' 'E ** "Q()))) C C C CeEll C C CFI6""PPAzzFFFFFuFFFFF''' 77   UZZ'N'N'N'Nu'N'N'NNN O O O 99Y  rmarkdownOptional[List[Block]]c. |r|sdS|pd g|ddd}d}t|}gdfd }||kr||}|s||d z }3t|}|r||d }g} |d z }||kr|||sS| |||d z }||kr-|||S|d z } td | 7t|r2| t|d z }t|} | rF| t| d |d z }d |vr|d z|krt ||d zr||} ||d z} | g} |d z }||krnd ||vrd||rJ| |||d z }||kr$d ||vr||Jt#| | }| |n/ tt%| t&|r|g}||krVt&||}|sn3| |d |d z }||kV t)|t+|r|g}||krt,||}t.||}|rR| t1|d d |d f|d z }nH|rQ| t1|d d |df|d z }n||rU||dr:|r8|d\}}}|||dz||zf|d<|d z }n||sk|ri|d z}||kr?||s%|d z }||kr||%||krt+||r|}nnn||k t3|Ӊ ||d z }||k|sdStt4krdSS#t6$rYdSwxYw)ucConvert agent markdown to a Slack Block Kit ``blocks`` list. Args: markdown: The agent's response text (standard markdown). mrkdwn_fn: Optional callable converting a markdown paragraph to Slack mrkdwn for ``section`` blocks (the adapter passes ``format_message``). When ``None``, the raw paragraph text is used. Returns: A list of Block Kit block dicts, or ``None`` when the content is empty, exceeds Slack's structural limits, or hits an unexpected shape — the caller then falls back to the flat ``text`` payload. Never raises. Nc|SrQrR)r's rzrender_blocks..^s!rz rgrrr*csdSd}|sdS|}t|tD]$}t |%dS)Nrg)rr\clear _split_textMAX_SECTION_TEXTr.r)r$renderedchunkblocksfmtparas r flush_paraz!render_blocks..flush_parags 99T??((**D JJLLL s4yyH$X/?@@ 5 5 nU334444 5 5rrrrFT) rr)rr*)r\rrr] _FENCE_RErr9lstriprr.rkr_HR_RErc _HEADER_REr` _TABLE_SEP_RErr _QUOTE_RErurrrr#r MAX_BLOCKS Exception)r mrkdwn_fnrlrsnrr fencemarkerbodyhm header_rowrtrowsrqlinesqmrvbmomr|rztxtjrrrs @@@r render_blocksrJs" 8>>++t  $ CO   ..44T::  JJ 5 5 5 5 5 5 5 5!ee8D::<<  QOOD))E  Q"$Q!eeE!HOO$5$5$@$@$H$HeKKa)))FA!eeE!HOO$5$5$@$@$H$HeQ 1$))D//BBCCC||D!!   n..///Q!!$''B   mBHHQKK88999Qd{{q1uqyy]-@-@q1u-N-Ny !  Q<# Q!eeuQxE!HNN4D4DLLq***FA!eeuQxE!HNN4D4D %UH55$MM%((((MM"5mE6J6J"K"KLLLt$$  $&!ee"q22BMM"((1++...FA !ee  l622333T""$  57!ee#))%(33B$**5844B mBHHQKK&@&@%RS%UVVVQ mBHHQKK&@&@$QR %TUUUQq))eAh.A.A+.N.NSX/4Ry,%+WcCi%(..BRBR6R$Sb Q"1X^^--%E!eeE!HNN,<,rs8#""""" 33333333333333  S#X 7 8 8 RZ< = = BJ0 1 1 bj344 RZ. / / BJ+ , ,  OPP CCCC "*\** 2:P Q Q 2:4 5 5 RZZ [ [ RZ % % :8:8:8:8D\\\\        7777:IIII&RRRR%%%%P    8eeeeePr