+ lHj <Rt^RIt^RIHtHtHtHt0R9mtRtRt R t R t R t RR RR RRRR/t RR0t!RR4tR:RRlltRRltRRRRRRRRRRR RR!R"RRRR#RR$/R%RR$RR&/R'RR$R(.R;O/R)RR$RR*//R+.RafTodo tool: in-memory, revisioned task list for multi-step work. State lives on the AIAgent (one per session), is re-injected after context compression, and every write bumps a monotonic revision so UI clients can reject stale updates. One ``todo_list`` tool: pass ``todos`` to write, omit to read; every call returns the full list. No system-prompt mutation.N)AnyDictListOptionalpending in_progress completed cancellediiu… [truncated]z@[Your active task list was preserved across context compression]z[x]z[>]z[ ]z[~]cRa]tRt^toRtRtV3RlRltR V3RlRlltV3RlRltV3R lR lt V3R lR lt V3R lRlt R^/V3RlRllt V3RlRlt ]V3RlRl4t]V3RlRl4t]V3RlRl4t]V3RlRl4t]V3RlRl4tRtVtR#)! TodoStoreuIn-memory todo list, one per AIAgent. List position is priority; items are ``{id, content, status, parent?}`` — ``parent`` nests a subtask.c".Vn^VnR#)N_items _revisionselfs&4/home/ubuntu/.hermes/hermes-agent/tools/todo_tool.py__init__TodoStore.__init__s,. cr<V^8dQhRS[S[S[S[3,,RS[S[S[S[3,,/#todosreturnlistdictstrr)format __classdict__s"r __annotate__TodoStore.__annotate__"s9]]$tCH~"6]4S#X;O]rc TPVPV4Uu.uFq PV4NK up4#uupi)z@Validate, dedupe and order a whole new list (replace / restore).)_normalize_order _dedupe_by_id _validate)rrts&& r _fresh_itemsTodoStore._fresh_items"s:$$ASASTYAZ%[AZAnnQ&7AZ%[\\%[s?c x<V^8dQhRS[S[S[S[3,,RS[RS[S[S[S[3,,/#)rrmerger)rrr rbool)r!r"s"rr#r$&s?4S#X/dSVX[S[nI]rc VP4pV'dVPV4MVPV4VnVP\ R1VP VP4VPV8wdV;P^, unVP4# \d Y0nhi;i)zReplace the list (default) or merge by id; returns the full list after writing. Raises ValueError (leaving the list untouched) if any item is invalid.N)read_merger*r ValueErrorMAX_TODO_ITEMS_sanitize_parentsr)rrr-befores&&& rwriteTodoStore.write&s  E""//6  KK ( t{{+ ;;& NNa Nyy{  K  sB+B+B++B>cJ<V^8dQhRS[S[S[S[3,,RR/#)rrrNr)r!r"s"rr#r$8s,DDDc3h0DTDrc VPUu/uF q"R,VbK ppVPV4EFp\VPRR44P 4pV'gK7VPV4pVf:VP V4pWsVR,&VPP V4KVPR4'd3VP\VR,4P 44VR&VPR4'di\VR,4P 4P4\9d2\VR,4P 4P4VR&RV9gEKW\VR,;'gR4P 4pV'dWR&EKVPRR4EK VPUu/uF#q"R,VPVR,V4bK% p pVP\V P444VnR#uupiuupi)zOUpdate existing items only in the fields provided; append new ones (validated).idNcontentstatusparent)rr'r getstripr(append _cap_contentlowerVALID_STATUSESpopr&rvalues) rritemexistingr)item_idcur validatedr>rebuilts && rr1TodoStore._merge8s15=J$=##E*A!%%b/*002G,,w'C{ NN1- ,54) ""9-uuY!%!2!23q|3D3J3J3L!MIuuX3q{#3#9#9#;#A#A#C~#U #AhK 0 6 6 8 > > @H 1}Qx[..B/557$*MGGHd+'+*KO++V+$:x||DJ==+V++D1A,BC />,Ws I))IcF<V^8dQhRS[S[S[S[3,,/#rrrrr )r!r"s"rr#r$Ss!55d4S>*5rc^VPUu.uFqP4NK up#uupiN)rcopy)rrGs& rr0TodoStore.readSs"(, 4  444s*c <V^8dQhRS[/#rOr.)r!r"s"rr#r$Vs!!4!rc,\VP4#rR)r.rrs&r has_itemsTodoStore.has_itemsVsDKK  rc6<V^8dQhRS[S[S[3,/#rOrr r)r!r"s"rr#r$YsBB$sCx.Brc >RVP4RVP/#)z,Full state clients can reconcile atomically.rrevision)r0rrs&rsnapshotTodoStore.snapshotYsj$..AArr]c x<V^8dQhRS[S[S[S[3,,RS[RS[S[S[S[3,,/#)rrr]rr)r!r"s"rr#r$]sAT$sCx.1DQUVY[^V^Q_L`rc VPV4R\Vn\^\ T;'g^44VnVP4# \ \3d^TnTP4#i;i)z@Restore a trusted snapshot without manufacturing a new revision.N) r*r3rmaxintr TypeErrorr2r0)rrr]s&&$rrestoreTodoStore.restore]sp''.?   C A$67DNyy{:& DNyy{ sAAA=<A=c0<V^8dQhRS[S[,/#rO)rr )r!r"s"rr#r$fs<cV^8dQhR\\\3,R\R\\,R\/#)rrGdepthoutr)rr rcrr.)r!s"rr#4TodoStore.format_for_injection..__annotate__rs4  c3h  $s)  rc <.pRpSPVR,.4FpVS !WQ^,V4,pK VR,\9;'gTpV'dk\PVR,R4pVPRV, RV RVR, RVR, R VR, R 2 4VP V4V#) Fr:r=z[?]z z-  z. r<z ())r?_ACTIVE_STATUSES_STATUS_MARKERSrAextend) rGrjrk kid_lineshas_active_kidkidkeepmarkerchildrenrenders &&& rry.TodoStore.format_for_injection..renderrs#%I"N||DJ3&ai"CC4>%55GGD(,,T(^UC dUl^2fXQtDzl""9o.bh0@CD 9%Kr )rr? setdefaultrATODO_INJECTION_HEADERlenjoin)rrGlinesrxrys& @@rformat_for_injectionTodoStore.format_for_injectionfs {{{46KKDxx!!##DNB7>>tD   ''KKD88H%%tQ& $'u:>tyy;t;rc&<V^8dQhRS[RS[/#)rr<r)r )r!r"s"rr#r$sccrc ~\V4\8d)VR\\\4, \,#V#)zSTruncate to MAX_TODO_CONTENT_CHARS keeping the head (the actionable part) + marker.N)r~MAX_TODO_CONTENT_CHARS_TRUNCATION_MARKER)r<s&rrBTodoStore._cap_contents6 w<0 0L2S9K5LLMPbb brcR<V^8dQhRS[S[S[3,RS[S[S[3,/#)rrGrr[)r!r"s"rr#r$s+S#X4S>rc n\V\4'g RRRRRR/#\VPRR44P 4;'gRp\VPRR44P 4pV'g\ RV R 24h\VPRR44P 4P 4pRTR\PV4RV\9dTMR/p\VPR 4;'gR4P 4pV'd WQ8wdWTR &V#) zUNormalize one item to ``{id, content, status, parent?}`` (placeholders when missing).r:?r<z(invalid item)r=rr;z Todo item 'zL' has empty or missing content. Each item must have a non-empty description.r>) isinstancerr r?r@r2rCr rBrD)rGrIr<r=resultr>s& rr(TodoStore._validates$%%#y*:HiP PdhhtR()//188Sdhhy"-.446gY'?? TXXh 2399;AACY33G<f&>FIOTXXh'--2.446 f'%8  rcJ<V^8dQhRS[S[S[S[3,,RR/#)ritemsrNrP)r!r"s"rr#r$s( - -d38n!5 -$ -rc VUu/uF qR,VbK ppVF>pVPR4'gKVR,V9gK,VPRR4K@ VFppVR,0TrCVPR4'gK'VR,V9dVPRR4KIVPVR,4W$R,,pKd R#uupi)zNDrop dangling parent refs and break cycles in place (such items become roots).r:r>N)r?rEadd)rrGby_idseennodes& rr4TodoStore._sanitize_parentss/44eddT!e4Dxx!!d8nE&A4(Dt*t$((8$$>T)HHXt,h((^, 5sCcr<V^8dQhRS[S[S[S[3,,RS[S[S[S[3,,/#rr)r!r"s"rr#r$s5??T$sCx.1?d4S>6J?rc :/p\V4FWwr#\V\4'd*\VP RR44P 4MRV 2pY!T;'gR&KY \ VP44Uu.uF q V,NK up#uupi)zDCollapse duplicate ids, keeping the last occurrence in its position.r:r; __invalid_r) enumeraterrr r?r@sortedrF)r last_indexirGkeys& rr'TodoStore._dedupe_by_ids&(  'GA5?d5K5K#dhhtR()//1S]^_]`QaC%&szzc "(#)):):)<"=>"=Qa"=>>>sBcr<V^8dQhRS[S[S[S[3,,RS[S[S[S[3,,/#)rrrrP)r!r"s"rr#r$s5  T#s(^ 4 d38n9M rc ~VUu.uF qR,NK pp\;QJdRV4F 'gK RM RM !RV44'gRV9dV#VPR4pRVRV9dV#VP4pVPVPR4VP V44V#uupi)uLift the in_progress step ahead of any earlier pending placeholder. Nested lists keep authored order — reordering would tear a subtask from its siblings.r=c3B"TFqPR4xK R#5i)r>N)r?).0rGs& r -TodoStore._normalize_order..s4edxx!!esTFrrN)anyindexrSinsertrE)rrGstatuses active_index normalizeds& rr&TodoStore._normalize_orders055utNNu5 34e43334e4 4 4 X8UL~~m4 H]l3 3LZZ\ (..3Z^^L5QR6sB:rN)F)__name__ __module__ __qualname____firstlineno____doc__rr*r6r1r0rXr^rer staticmethodrBr(r4r'r&__static_attributes____classdictcell__)r"s@rr r sJ]]$DD655!!BBa<<> ( - -??  rr FcV^8dQhR\\\\\3,,,R\ R\\ ,R\/#)rrr-storer)rrrr rr.r )r!s"rr#r#sG@@Xd4S>23@4@i(@47@rcaVf \R4#VfVP4pMI\V\4'g"\R\ V4P 24#VP W4pR\V4/pR Fo\V3RlV44VS&K \P!RVRVP4R,RV/R R 7# \dp\\T44uRp?#Rp?ii;i) zWWrite ``todos`` (replace, or ``merge`` by id) or read when None -> list + summary JSON.NzTodoStore not initializedztodos must be a list, got totalc3F<"TFqR,S8XgK^xK R#5i)r=N)rrr=s& rrtodo_tool..sHAH+2Gaas! !rr]summaryF) ensure_asciirrrr ) tool_errorr0rrtyperr6r2r r~sumjsondumpsr^)rr-rrerr=s&&& @r todo_toolrs }566 } %&& :4;;O;O:PQR R &KK-EE #GFHHHG ::wz5>>3CJ3O '+9> @@  &c!f% % &sC C9C4.C94C9c$V^8dQhR\/#rOrV)r!s"rr#r#srcR#)z;Todo tool has no external requirements -- always available.Trrrrcheck_todo_requirementsrs rname todo_list descriptiona5Track a task list for multi-step work (3+ steps). Use for complex tasks with 3+ steps or when the user provides multiple tasks. For 'all N items' tasks, enumerate every instance as its own checklist item so none are silently dropped. Call with no parameters to read the current list. List order is priority. Only ONE item in_progress at a time. Break large phases into subtasks via parent. Mark an item completed only after the work is verified done, never based on intent. If something fails, cancel it and add a revised item. Always returns the full current list. parametersrobject propertiesrarrayzTask items to write.rr:stringr<zTask descriptionr=enumr>zNOptional id of another item, making this a nested subtask. Omit for top-level.requiredr-booleanzltrue: update existing items by id, add new ones. false (default): replace the entire list with a fresh plan.defaulttodoc0V^8dQhR\R\/#)rrrrr.)r!s"rr#r##s==C=D=rcD\V\4;'d V\9#)z]True for the Todo tool's current name or a legacy alias (an already-unwrapped dispatch name).)rr TODO_TOOL_NAMES)rs&ris_todo_tool_namer#s dC < rNs-yhhwtxx'?rvvg Xru📋)rtoolsetschemacheck_fnhandleremoji>rr rr)NFNr)r:r<r=)r)rrtypingrrrrrDrr3MAX_TODO_RESULT_CHARSrr}rqrpr rr TODO_SCHEMATODO_LEGACY_ALIASES frozensetrrrtools.registryrrregisterrrrrsb  ,,E &[}eY{\ab}-ll^@* K 6 5H "H""H)+=$!"H"$X#!"H)+{##" ;'2  R5 5" F BK&6 t [0G3FGH= UD0 f[CZ X  r