+ i%Rt^RIt^RIHtHtHtHt0R'mt!RR4tR(RRllt RR lt R R R R RRRRRRRR RRRRRRRRR R/RRRR R/RRRR.R)OR R//R.R*O//RRR R R!R"R//R.//t ^R#I H t ] P!R R ] R$] R%R&7R#)+a4 Todo Tool Module - Planning & Task Management Provides an in-memory task list the agent uses to decompose complex tasks, track progress, and maintain focus across long conversations. The state lives on the AIAgent instance (one per session) and is re-injected into the conversation after context compression events. Design: - Single `todo` tool: provide `todos` param to write, omit to read - Every call returns the full current list - No system prompt mutation, no tool response modification - Behavioral guidance lives entirely in the tool schema description N)DictAnyListOptionalca]tRt^toRtRtRV3RlRlltV3RlRltV3RlRltV3R lR lt ] V3R lR l4t R t Vt R#) TodoStorea  In-memory todo list. One instance per AIAgent (one per session). Items are ordered -- list position is priority. Each item has: - id: unique string identifier (agent-chosen) - content: task description - status: pending | in_progress | completed | cancelled c.VnR#)N_itemsselfs&,/home/ubuntu/hermes-agent/tools/todo_tool.py__init__TodoStore.__init__#s ,. c x<V^8dQhRS[S[S[S[3,,RS[RS[S[S[S[3,,/#)todosmergereturn)rrstrrbool)format __classdict__s"r __annotate__TodoStore.__annotate__&s?**4S#X/**dSVX[S[nI]*rc V'g6VUu.uFq0PV4NK upVnVP4#VPUu/uF qDR,VbK ppVEFp\VPRR44P 4pV'gK7We9dRV9d9VR,'d*\VR,4P 4WV,R&RV9dZVR,'dI\VR,4P 4P 4pV\ 9dWuV,R&KKKKVPV4pWVR,&VPPV4EK \4p .p VPFUpVPVR,V4p V R,V 9gK,V PV 4V PV R,4KW WnVP4#uupiuupi)z Write todos. Returns the full current list after writing. Args: todos: list of {id, content, status} dicts merge: if False, replace the entire list. If True, update existing items by id and append new ones. idcontentstatus) _validater rgetstriplowerVALID_STATUSESappendsetaddread) r rrtitemexistingitem_idr validatedseenrebuiltcurrents &&& r writeTodoStore.write&s6;>!,eyy{96:[[A[TT D([HAaeeD"o.446& A~!I,,7:1Y<7H7N7N7P))41}8!$Qx[!1!7!7!9!?!?!A!^3:@W-h74*5} !%q 1I09Yt_-KK&&y1#&5DG ",,tDz484=,NN7+HHWT]+ $ "Kyy{?=Bs H HcF<V^8dQhRS[S[S[S[3,,/#rr)rrr)rrs"r rrRs!55d4S>*5rc ^VPUu.uFqP4NK up#uupi)z"Return a copy of the current list.)r copy)r r+s& r r)TodoStore.readRs"(, 4  444s*c <V^8dQhRS[/#r5r)rrs"r rrVs$$4$rc 2\VP4^8#)z)Check if there are any items in the list.)lenr r s&r has_itemsTodoStore.has_itemsVs4;;!##rc0<V^8dQhRS[S[,/#r5)rr)rrs"r rrZs   hsm  rc  VP'gR#RRRRRRRR /pVPUu.uFpVR ,R9gKVNK ppV'gR#R .pVFOpVPVR ,R 4pVPR V RVR, RVR, RVR , R2 4KQ RPV4#uupi)z Render the todo list for post-compression injection. Returns a human-readable string to append to the compressed message history, or None if the list is empty. N completedz[x] in_progressz[>]pendingz[ ] cancelledz[~]r z@[Your active task list was preserved across context compression]z[?]z-  rz. rz () )rCrB)r r"r&join)r markersr+ active_itemslinesmarkers& r format_for_injectionTodoStore.format_for_injectionZs{{{  5 u   "[[ (TH~!;; D[  ST D[[h7F LL2fXQtDzl"T)_4ERXGWWXY Z!yy s B=B=cR<V^8dQhRS[S[S[3,RS[S[S[3,/#)rr+r)rrr)rrs"r rr}s/EES#XE4S>Erc f\VPRR44P4pV'gRp\VPRR44P4pV'gRp\VPRR44P4P4pV\9dRpRVRVRV/#)z Validate and normalize a todo item. Ensures required fields exist and status is valid. Returns a clean dict with only {id, content, status}. rr?rz(no description)r rC)rr"r#r$r%)r+r-rr s& r r!TodoStore._validate|sdhhtR()//1Gdhhy"-.446(GTXXh 2399;AAC  'Fgy'8VDDrr N)F)__name__ __module__ __qualname____firstlineno____doc__rr2r)r=rM staticmethodr!__static_attributes____classdictcell__)rs@r rrsO/**X55$$   DEErrFcV^8dQhR\\\\\3,,,R\ R\\ ,R\/#)rrrstorer)rrrrrrr)rs"r rrsG'' Dc3h( )' ' I ' 'rcxVf\P!RR/RR7#VeVPW4pMVP4p\ RV44p\ RV44p\ RV44p\ RV44p\P!R VR R \ V4R VR VRVRV//RR7#)ad Single entry point for the todo tool. Reads or writes depending on params. Args: todos: if provided, write these items. If None, read current list. merge: if True, update by id. If False (default), replace entire list. store: the TodoStore instance from the AIAgent. Returns: JSON string with the full current list and summary metadata. errorzTodoStore not initializedF) ensure_asciic3D"TFqR,R8XgK^xK R#5i)r rCN.0is& r todo_tool..s?UkY&>!!U  c3D"TFqR,R8XgK^xK R#5i)r rBNrarbs& r rerfsGAH+*Faargc3D"TFqR,R8XgK^xK R#5i)r rANrarbs& r rerfCu!( {(BAAurgc3D"TFqR,R8XgK^xK R#5i)r rDNrarbs& r rerfrjrgrsummarytotalrCrBrArD)jsondumpsr2r)sumr<)rrr\itemsrCrBrArDs&&& r todo_toolrrs  }zz7$?@uUU  E) ?U??GGGGKCuCCICuCCI :: SZ w ;       rc$V^8dQhR\/#r5r:)rs"r rrsrcR#)z;Todo tool has no external requirements -- always available.Trararr check_todo_requirementsrus rnametodo descriptionaManage your task list for the current session. Use for complex tasks with 3+ steps or when the user provides multiple tasks. Call with no parameters to read the current list. Writing: - Provide 'todos' array to create/update items - merge=false (default): replace the entire list with a fresh plan - merge=true: update existing items by id, add any new ones Each item: {id: string, content: string, status: pending|in_progress|completed|cancelled} List order is priority. Only ONE item in_progress at a time. Mark items completed immediately when done. If something fails, cancel it and add a revised item. Always returns the full current list. parameterstypeobject propertiesrarrayz/Task items to write. Omit to read current list.rqrstringzUnique item identifierrzTask descriptionr enumzCurrent statusrequiredrbooleanzZtrue: update existing items by id, add new ones. false (default): replace the entire list.default)registryc z\VPR4VPRR4VPR4R7#)rrFr\)rrr\)rrr")argskws&,r rs-yhhwtxx'?rvvg Xru📋)rvtoolsetschemahandlercheck_fnemoji>rCrDrArB)NFN)rCrBrArD)rrr )rWrntypingrrrrr%rrrru TODO_SCHEMAtools.registryrregisterrarr rs(  ,,FwEwEt'T F 0 PH "H)+C""H)+=$!"H"$X)+;## ;#.  @5 1  B BG$#6 t$    X $ r