`gj*RdZddlmZddlZddlZddlZddlZddlmZmZddl m Z ddl m Z dZ ejdZd"d Zd"d Zd#d Zd$d Zd%d Zd&dZd'dZd(dZd)dZd'dZd*dZd+dZddd d,dZddd-dZd.dZd/dZd0dZ ddd d1d Z!d2d!Z"y)3aMarkdown/QMD export helpers for Hermes sessions. This module is intentionally filesystem-only: it formats already-exported SessionDB dictionaries and writes them to user-selected export directories. It must not mutate state.db or call delete/prune/archive APIs. ) annotationsN)datetimetimezone)Path)Anyz"hermes sessions export (md/qmd) v1z+- SHA256 of exported body: `([0-9a-f]{64})`c||dk(ry t|}t j |t jjjddS#ttf$rt|cYSwxYw)N)tzz+00:00Z) float TypeError ValueErrorstrr fromtimestamprutc isoformatreplace)valuetss O/root/.hermes/venv/lib/python3.12/site-packages/hermes_cli/session_export_md.py_iso_timestamprsn }  5\  ! !" 6 @ @ B J J8UX YY z "5zs AA54A5c<|yt|tr|rdSdSt|ttfr't|tst j |dSt|t rt j |dSt j t|dS)NnulltruefalseF) ensure_ascii) isinstanceboolintr jsondumpslistr)rs r_frontmatter_valuer# sy }%v+G+%#u&z%/Fzz%e44%zz%e44 ::c%ju 55c"|dt|S)Nz: )r#)keyrs r_frontmatter_liner',sU"'./ 00r$c8t|jdxsd}|j}|jdxs|jd}|dk(r|rd|}t|jdxs|jd}d ||rd |zSd S) Nrolemessagename tool_nametoolu Tool — created_at timestampz### u — r )rget capitalizer)r*r)labelr+r/s r_message_headingr30s w{{6"/i 0D OO E ;;v  :'++k":D v~$D6"w{{<8TGKK '3~~ G%J JW TTr$cD|sydtj|ddzdzS)Nr z ## Tool calls ```json Fr5r6r8)r r!) tool_callss r_render_tool_callsr>Bs(  +djjRW`a.b bel llr$cdt|jdxs|jdxsdS)Nid session_idzunknown-session)rr0sessions r _session_idrDHs* w{{4 RGKK $=RAR SSr$c|jd}t|tr#|r!|Dcgc]}t|ts|c}S|gScc}w)Nsegments)r0rr"dict)rCrFss r _segmentsrILsC{{:&H(D!h#;az!T':;; 9z!_message_count..Ts#L#s377:&,"-Ls(*)sumrIrBs r_message_countrRSs L79KL LLr$cdg}t|}t|}|dk(r3|jddj|j dzSt |dkD}|D]}|r|jdt |dt|jdxsgD]}|jt|dzt|jd}|r|j|dzt|jd }|r|j|dz|jd dj|j dzS) Nz ## Messages rz_No messages in this session._  z## Compression segment: rLr:r=r ) rIrRappendjoinr9rMrDr"r0r3r;r>) rCpartsrFtotal_messages multi_segmentsegmentr*rendered_contentr=s r_render_messagesr]Ws@'(E!H#G,N 78yy&&(4//MA%M   LL3K4H3IL MGKK 39r: G LL)'2T9 :.w{{9/EF  -45+GKK ,EFJ Z$./ LL    99U  " " $t ++r$ct|}|jdxs|}|jdxs|jd}t|jdxs|jd}t|jdxs|jd}t|jd}t|} t|} d t d |t d|jdt d |jd t d|t d|t d|t d |jd t d|t d |jd t dt |jdt d| t d|jdxsdg } |jdr*| j t d|jd| jt d|t d| t dtd dgdj| d|dg} | j d|d|jd r$| j d|jd d|jd r$| j d|jd d| j t|| j d| j d|d| j d | d| j d!|jd| d| j d"| d| j d#dj| jdzS)$Ntitlebilling_providerprovider started_atr. last_active updated_atended_atz---rAsourcemodelcwdarchived message_counttool_call_countrlineage_session_idsformat exported_atexporterr rTz# z Session ID: `z` z Source: `zWorking directory: `z## Export verification - Session id: ``- Exported messages: `z&- Source DB message count at export: `z- Exported at: `z3- SHA256 of exported body: `__SHA256_PLACEHOLDER__`) rDr0rrRr'rrVextendEXPORTER_VERSIONrWr]r9) rCfmtrnrAr_rarbrcre exported_isorj frontmatterrXs r_export_body_without_hashrxos W%J KK .JE{{-.I'++j2IH L 9 VW[[=VWJ ]!;!Xw{{+?sCD LL!'*+ LL+, LL?:,a01 LL)-:; LL9'++oWd:e9ffghi LL#L>34 LLFG 99U  " " $t ++r$c.tjd|S)Nz$- SHA256 of exported body: `pending`) _SHA_LINE_REsub)texts r_body_for_digestr}s   BD IIr$mdT)ruinclude_verificationcd|dvr tdtj}t|||}|jdd}t j |j dj}|r|jd|S|jdd d jd z}|S) z:Render a SessionDB export dictionary as Markdown/QMD text.>r~qmdfmt must be 'md' or 'qmd')rurnz`__SHA256_PLACEHOLDER__`z `pending`utf-8__SHA256_PLACEHOLDER__z ## Export verification rUrrT) rtimerxrhashlibsha256encode hexdigestsplitr9)rCrurrnbody digest_bodydigestbefore_verifications rrender_session_markdownrs -455))+K $W#; OD,,9;GK ^^K..w7 8 B B DF||4f==**%A1EaHOOQTXX r$ruc|dvr tdt|}t|jdxsd}t j dd|j dj}|sd}|dd }|d|d |S) z@Return a deterministic, path-safe filename for a session export.>r~rrr_rCz[^A-Za-z0-9._-]+-z.-_N<.)rrDrr0rer{striplower)rCrurAr_slugs rsafe_session_filenamers -455W%J  G$1 2E 66%sE 2 8 8 ? E E GD  9D\4&# ''r$cvtjt|jj S)N)rrr read_bytesr)paths r file_sha256rs' >>$t*//1 2 < < >>r$c|t|}|jsy|jd}tj |}|syt j t|jdj}||jdk7ryt|}d|d|vry d t|d|vry y ) N)Fz file missingrencoding)Fzsha256 marker missingrU)Fzsha256 mismatchrrrq)Fzmessage count mismatchrp)Fzsession id mismatch)Tok) rexists read_textrzsearchrrr}rrgrouprRrD)rrCpr|matchactualexpected_counts rverify_export_filers T A 88:$ ;;; (D    %E - ^^,T299'B C M M OF Q'#G,N /q1=. W-.a0<+ r$czddlmdfd t|}dD]}||vs||||||<|S)uReturn a deep copy of a session export dict with secrets redacted. Runs every message's content and tool-call arguments through the force-mode redaction pass (``agent.redact.redact_sensitive_text``), so API keys, tokens, and credentials that appeared in tool output never land in plaintext export files. Force mode ignores the user's global ``security.redact_secrets`` preference — an explicit ``--redact`` export must never emit raw secrets. r)redact_sensitive_textct|tr |dSt|tr|Dcgc] }| c}St|tr*|j Dcic]\}}||c}}S|Scc}wcc}}w)NT)force)rrr"rGitems)rvk_cleanrs rrz#redact_session_data.._cleanss eS !(d; ; eT "',-!F1I- - eT "-2[[];TQAvayL; ; .;s A>%B)rLrF)rrreturnr) agent.redactrrG)rCredactedr&rrs @@rredact_session_datarsP3G}H'2 (?x}8"8C=1HSM2 Or$F)rurct|j}|jdd|t||z }|j r|st t ||jt||d|S)zWrite a Markdown/QMD export file and return its path. Raises FileExistsError when the destination exists and force=False. Tparentsexist_okrrr) r expandusermkdirrrFileExistsErrorr write_textr)rC output_dirrurout_dirrs rwrite_session_markdownrsp:))+G MM$M. *7< rDrIrRr]rxr}rrrrrrrr$rrs# '7rzzHI Z 61DUm TM,01,hJ ,0d   %( GK   BF (?&:DHW\   )3 =@ PT    r$