iA' @dZddlZddlmZmZmZmZhdZGddZ d&deeee efd e d eed e fd Z d e fd Z dddddddddddddgddddgdddddddd gdd!Z dd"lmZmZejdde d#e d$%dS)'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)DictAnyListOptional>pending cancelled completed in_progressc JeZdZdZdZddeeeefde deeeeffdZ deeeeffdZ de fd Z de efd Zed eeefdeeeffd Zedeeeefdeeeeffd ZdS) 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 cg|_dS)N_itemsselfs 4/home/ubuntu/.hermes/hermes-agent/tools/todo_tool.py__init__zTodoStore.__init__#s ,. Ftodosmergereturnc|s(fd|D_ndjD}|D]}t|dd}|s;||vrd|vr8|dr0t|d||d<d|vrU|drMt|d}|t vr |||d<Չ|}|||d<j|t}g} jD]X} || d| } | d|vr0| | | | dY| _ S)a 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. c:g|]}|S) _validate).0trs r z#TodoStore.write..1s%PPP4>>!,,PPPrc i|] }|d| S)idrritems r z#TodoStore.write..4sAAATT DAAArr contentstatus) _dedupe_by_idrstrgetstriplowerVALID_STATUSESrappendsetaddread) rrrexistingritem_idr& validatedseenrebuiltr"currents ` rwritezTodoStore.write&s "PPPPd6H6H6O6OPPPDKKBAT[AAAH''.. 2 2aeeD"oo..4466h&& A~~!I,~7:1Y<7H7H7N7N7P7P))41}}8}!$Qx[!1!1!7!7!9!9!?!?!A!A!^33:@HW-h7!%q 1 1I09HYt_-K&&y111155DG  , ,",,tDz4884=,,NN7+++HHWT]+++!DKyy{{rc$d|jDS)z"Return a copy of the current list.c6g|]}|Sr)copyr!s rrz"TodoStore.read..Ts 444 444rrrs rr0zTodoStore.readRs44 4444rc*t|jS)z)Check if there are any items in the list.)boolrrs r has_itemszTodoStore.has_itemsVsDK   rc &|jsdSddddd}d|jD}|sdSdg}|D]R}||d d }|d |d |d d|dd|d d Sd|S)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. Nz[x]z[>]z[ ]z[~])r r rrc&g|]}|ddv |S)r&)rr rr!s rrz2TodoStore.format_for_injection..ns2   H~!;;; ;;;rz@[Your active task list was preserved across context compression]r&z[?]z-  r z. r%z () )rr)r-join)rmarkers active_itemslinesr"markers rformat_for_injectionzTodoStore.format_for_injectionZs{ 4      ![    4ST  [ [D[[h77F LLYfYYtDzYYT)_YYXYYY Z Z Z Zyyrr"ct|dd}|sd}t|dd}|sd}t|dd}|tvrd}|||dS) z Validate and normalize a todo item. Ensures required fields exist and status is valid. Returns a clean dict with only {id, content, status}. r r$?r%z(no description)r&rr r%r&)r(r)r*r+r,)r"r2r%r&s rrzTodoStore._validate|sdhhtR(())//11 Gdhhy"--..4466 )(GTXXh 223399;;AACC  ' 'F'VDDDrci}tD]A\}}t|ddpd}|||<Bfdt |DS)zDCollapse duplicate ids, keeping the last occurrence in its position.r r$rJc g|] }| Srr)rirs rrz+TodoStore._dedupe_by_id..s>>>Qa>>>r) enumerater(r)r*sortedvalues)r last_indexrNr"r2s` rr'zTodoStore._dedupe_by_ids&(  '' $ $GAt$((4,,--3355<G"#Jw  >>>>&):):)<)<"="=>>>>rN)F)__name__ __module__ __qualname____doc__rrrr(rr<r7r0r=rrH staticmethodrr'rrrr r sh///**4S#X/**dSVX[S[nI]****X5d4S>*5555!4!!!!  hsm     DES#XE4S>EEE\E*?T$sCx.1?d4S>6J???\???rr Frrstorerc |tdS||||}n|}td|D}td|D}td|D}td|D}t j|t |||||ddd S) a 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. NzTodoStore not initializedc32K|]}|ddkdVdS)r&rNrrrNs r ztodo_tool..s0??akY&>&>!&>&>&>&>??rc32K|]}|ddkdVdS)r&r r[Nrr\s rr]ztodo_tool..s0GGA!H+*F*Fa*F*F*F*FGGrc32K|]}|ddkdVdS)r&r r[Nrr\s rr]ztodo_tool..0CC!( {(B(BA(B(B(B(BCCrc32K|]}|ddkdVdS)r&rr[Nrr\s rr]ztodo_tool..r`r)totalrr r r)rsummaryF) ensure_ascii) tool_errorr7r0sumjsondumpslen)rrrXitemsrr r rs r todo_toolrks  }5666  E5)) ??U?????GGGGGGGGKCCuCCCCCICCuCCCCCI :ZZ&""         rcdS)z;Todo tool has no external requirements -- always available.Trrrrcheck_todo_requirementsrms 4rtodoaManage 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.objectarrayz/Task items to write. Omit to read current list.stringzUnique item identifier)type descriptionzTask description)rr r rzCurrent status)rrenumrsrK)rr propertiesrequired)rrrsrjbooleanzZtrue: update existing items by id, add new ones. false (default): replace the entire list.)rrrsdefault)rr)namers parameters)registryrec t|d|dd|dS)NrrFrX)rrrX)rkr))argskws rrsCyhhwtxx'?'?rvvg X X Xru📋)rytoolsetschemahandlercheck_fnemoji)NFN)rVrgtypingrrrrr,r r(r<rkrm TODO_SCHEMAtools.registryr{reregisterrrrrs   ,,,,,,,,,,,,FEE@?@?@?@?@?@?@?@?H-1!%'' Dc3h( )' ' I ' ''''T  0 P$%-+C %-+=$$ %-$X$X$X+;####!< ; ;#0"@! 1   BG$$#66 t0///////    X X $ r