#jAUdZddlZddlZddlmZddlmZmZddlmZm Z ddl m Z ddl m Z ddlmZdd lmZmZdd lmZmZdd lmZdd lmZdd lmZddlmZddlmZe e eZ!e"hdZ#e"e$e%d<ej&e'Z(eGddZ)de)defdZ*de$dedzfdZ+ dOde$de$de$dzde e$dzde,e$e$fdzde$dzde$dzde$dzde-e,e$efe$dzffd Z.d!e d"ede)ddfd#Z/d!e d"ede)ddfd$Z0e"hd%Z1e"e$e%d&<d!e d"ede)ddfd'Z2d!e d"ede)ddfd(Z3d!e d"ede)ddfd)Z4d!e d"ede)ddfd*Z5d!e d"ede)ddfd+Z6d!e d"ede)ddfd,Z7d!e d"ede)ddfd-Z8 dPd.e$dzd/e$dzd0e9dzde$dzfd1Z:d!e d"ede)ddfd2Z;d!e d"ede)ddfd3Zd!e d"ede)ddfd6Z?d!e d"ede)ddfd7Z@d!e d"ede)ddfd8ZAd!e d"ede)ddfd9ZBd!e d"ede)ddfd:ZCd!e d"ede)ddfd;ZDd!e d"ede)ddfd<ZEd!e d"ede)ddfd=ZFd!e d"ede)ddfd>ZGd!e d"ede)ddfd?ZHd!e d"ede)ddfd@ZId!e d"ede)ddfdAZJd!e d"ede)ddfdBZKd!e d"ede)ddfdCZLd!e d"ede)ddfdDZMd!e d"ede)ddfdEZNddddFd"edGe$dHed.e$dzdIe$dzdJe,e$efdzde,e$effdKZOd!e d"ede)ddfdLZPd!e d"ede)ddfdMZQd!e d"ede)ddfdNZRdS)QzShared MCP tool implementations for Hindsight. This module provides the core tool logic used by both: - mcp_local.py (stdio transport for Claude Code) - api/mcp.py (HTTP transport for API server) N) dataclass)datetimetimezone)AnyCallable)FastMCP) TypeAdapter) MemoryEngine)DEFAULT_MCP_RECALL_DESCRIPTIONDEFAULT_MCP_RETAIN_DESCRIPTION) AuditEntry AuditLogger)Budget)VALID_RECALL_FACT_TYPES)TagGroup)OperationValidationError)RequestContext>recallretainreflectget_bank list_tags get_memory list_banks create_bank delete_bank sync_retain update_bank get_document get_operation list_memoriesclear_memoriesget_bank_statslist_documentsdelete_documentlist_directiveslist_operationscancel_operationcreate_directivedelete_directiveget_mental_modellist_mental_modelscreate_mental_modeldelete_mental_modelupdate_mental_modelrefresh_mental_model _ALL_TOOLSc,eZdZUdZegedzfed<dZegedzfdzed<dZegedzfdzed<dZ egedzfdzed<dZ ege fdzed<dZ e ed <dZ eedzed <dZedzed <dZedzed <dS) MCPToolsConfigz)Configuration for MCP tools registration.Nbank_id_resolverapi_key_resolvertenant_id_resolverapi_key_id_resolvermcp_authenticated_resolverFinclude_bank_id_paramtoolsretain_descriptionrecall_description)__name__ __module__ __qualname____doc__rstr__annotations__r5r6r7r8boolr9r:setr;r<_/home/rurouni/.hermes/hermes-agent/venv/lib/python3.11/site-packages/hindsight_api/mcp_tools.pyr3r3Fs33r3:~....9=hr3:~.5<<<;?S4Z047>>><@"cDj.1D8???=AT 2T 9@@@#(4'''"E3s8d?!!!&*d )))%)d )))))rFr3configreturnc|jr|nd}|jr|nd}|jr|nd}|jr|nd}t ||||S)zCreate RequestContext with auth details from resolvers. This enables tenant auth and usage metering to work with MCP tools by propagating the authentication results from the MCP middleware to the memory engine. NF)api_key tenant_id api_key_idmcp_authenticated)r5r6r7r8r)rHrKrLrMrNs rG_get_request_contextrOfs ,2+BLf%%'''G/5/HR))+++dI171KU++---QUJ?E?`k99;;;fk 9Wh   rF timestampc tj|ddS#t$r}td|d|d}~wwxYw)zParse an ISO format timestamp string. Args: timestamp: ISO format timestamp (e.g., '2024-01-15T10:30:00Z') Returns: Parsed datetime or None if invalid Raises: ValueError: If timestamp format is invalid Zz+00:00zInvalid timestamp format 'zK'. Expected ISO format like '2024-01-15T10:30:00' or '2024-01-15T10:30:00Z'N)r fromisoformatreplace ValueError)rPes rGparse_timestamprWusx%i&7&7X&F&FGGG  W W W W   s'* A AA contentcontexttagsmetadata document_idstrategy update_modect|tra tj|}t|tr|}n#tjt f$rYnwxYwt|tr|g}||d} |r> t|} | | d<n(#t$r} it| fcYd} ~ Sd} ~ wwxYw||| d<||| d<||| d<||| d<||| d<| dfS) aBuild a content dict for retain operations. Args: content: The memory content context: Category for the memory timestamp: Optional ISO timestamp tags: Optional tags for scoped visibility filtering metadata: Optional key-value metadata to attach to the memory document_id: Optional document ID to associate the memory with strategy: Optional named retain strategy override (e.g., 'exact', 'verbose') update_mode: How to handle existing documents ('replace' or 'append') Returns: Tuple of (content_dict, error_message). error_message is None if successful. )rXrY event_dateNrZr[r\r]r^) isinstancerAjsonloadslistJSONDecodeError TypeErrorrWrU) rXrYrPrZr[r\r]r^parsed content_dictparsed_timestamprVs rGbuild_content_dictrjsS8$ Z%%F&$'' $i0    D  dC  6D/67#K#KL .y99 )9L & &   s1vv:        # V#+ Z &1 ]##+ Z &1 ]#  s/+AAA?B B9B4.B94B9mcpmemoryc"|jphd}d|vrt|||d|vrt|||d|vrt|||d|vrt |||d|vrt |||d|vrt |||d|vrt|||d |vrt|||d |vrt|||d |vrt|||d |vrt|||d |vrt|||d|vrt|||d|vrt|||d|vrt|||d|vrt!|||d|vrt#|||d|vrt%|||d|vrt'|||d|vrt)|||d|vrt+|||d|vrt-|||d|vrt/|||d|vrt1|||d|vrt3|||d|vrt5|||d|vrt7|||d|vrt9|||d|vrt;|||t=|||t?|||dS) zRegister MCP tools on a FastMCP server. Args: mcp: FastMCP server instance memory: MemoryEngine instance config: Tool configuration >rrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,r-r.r/r0rrrrrrr,r+r-r/r.r0r&r)r*r!rr$rr%r'r r(rrr#rrr"N) r:_register_retain_register_sync_retain_register_recall_register_reflect_register_list_banks_register_create_bank_register_list_mental_models_register_get_mental_model_register_create_mental_model_register_update_mental_model_register_delete_mental_model_register_refresh_mental_model_register_list_directives_register_create_directive_register_delete_directive_register_list_memories_register_get_memory_register_list_documents_register_get_document_register_delete_document_register_list_operations_register_get_operation_register_cancel_operation_register_list_tags_register_get_bank_register_get_bank_stats_register_update_bank_register_delete_bank_register_clear_memories_apply_bank_tool_filtering_apply_audit_logging)rkrlrHtools_to_registers rGregister_mcp_toolsrs )))@$$$ff---)))c66222$$$ff---%%%#vv...(((S&&111)))c66222000$S&&999..."3777 111%c66::: 111%c66::: 111%c66:::!222&sFF;;;---!#vv666..."3777..."3777+++VV444(((S&&111,,, ff555***sFF333---!#vv666---!#vv666+++VV444..."3777'''C000&&&3///,,, ff555)))c66222)))c66222,,, ff555sFF333ff-----rFc dttdzffd t|drT|j|j fd} fd}t |d|t |d|dSt|dr |j}|j fd }t|d ||j D]1\}}|j } || f fd } t |d | 2dS#ttf$r(} td | Yd} ~ dSd} ~ wwxYwtddS)zFilter bank-level mcp_enabled_tools from both tools/list and tool invocation. Compatible with FastMCP 2.x (_tool_manager pattern) and 3.x (provider pattern). rINc6K}|sdSt} j||d{V}|d}|t |nd} j}||t|nt} | |||d{V}n.#t$r!t dd|cYSwxYw||kr1| t |t |z}nt |}|S)zJReturn the enabled tool set for the current bank, or None if unrestricted.Nmcp_enabled_toolsz3filter_mcp_tools raised, returning unfiltered toolsTexc_info) r4rO_config_resolverget_bank_configgetrD_operation_validator frozensetr1filter_mcp_tools Exceptionloggerwarning) bank_idrequest_contextbank_cfg bank_toolsenabled validator candidatefilteredrHrls rG_get_enabled_toolsz6_apply_bank_tool_filtering.._get_enabled_toolsZsT))++ 4.v66 0@@/ZZZZZZZZ'/||4G'H'H 6@6L3z???RV/  .5.A '***zI !*!;!;G_V_!`!```````   T_cddd 9$$)!(mmc*oo=GG!(mmGsB44(CC list_toolscjKdi|d{V}d{V|Sfd|DS)Nc&g|] }|jv |SrE)name).0t enabled_sets rG zL_apply_bank_tool_filtering.._filtered_list_tools..s%>>>!+(=(=A(=(=(=rFrErE)kwargsr:rroriginal_list_toolss @rG_filtered_list_toolsz8_apply_bank_tool_filtering.._filtered_list_tools}su--7777777777E 2 2 4 4444444K" >>>>u>>> >rFcVKd{V}|||vrdS|fi|d{VSNrE)rrrroriginal_get_tools rG_filtered_get_toolz6_apply_bank_tool_filtering.._filtered_get_toolsg 2 2 4 4444444K&4{+B+Bt**4::6:::::::: :rFget_tool _tool_managercKd{V}d{V|Sfd|DS)Nc$i|] \}}|v || SrErE)rkvrs rG zK_apply_bank_tool_filtering.._filtered_get_tools..s)OOOAa;>N>N1>N>N>NrF)items) all_toolsrroriginal_get_toolss @rG_filtered_get_toolsz7_apply_bank_tool_filtering.._filtered_get_toolssx"4"4"6"6666666 $6$6$8$8888888 &$$OOOO):):OOOOrF get_toolscKd{V}|,||vr(td|dd||d{VS)NzTool 'z' is not enabled for bank '')rUr4) arguments_name_origrrrHs rG _filtered_runz1_apply_bank_tool_filtering.._filtered_runs(:(:(<(<"<"<"<"<"<"????? o & &W M,L!-!7  P P P P P P L+/B C C C*17799 ? ? d#x 9=\2222222 ""4 >>>> ? ?) M M M NNKKK L L L L L L L L L M UVVVVVsA0D ED>>E>rrrrrrr"r%r(r)r*r-r.r/r0_AUDITABLE_MCP_TOOLSc N |jdtffd }t|dr |jjD]9\}}|t vr+t|d|||j :dS#ttf$r(}t d|Yd}~dSd}~wwxYwt|dr;t|dd r&d  fd }t|d|dSdSt d dS) z7Wrap auditable MCP tool run methods with audit logging. tool_namec||ffd }|S)z2Create an audited wrapper for a tool's run method.c K|s||d{VSd}t|tr3|dpjrnd}n%t |dr|d}t |d|tjtj t|trt|ndt|i} ||d{V}t|tr||_ n=t|tr d|i|_ nt|tr d|i|_ |tjtj |_|S#tjtj |_|wxYw)Nrrrkrawaction transportr started_atrequestrtext) is_enabledradictrr4rr rnowrutcrAresponserdended_atlog_fire_and_forget)rrrrentryresult audit_loggerrHs rG _audited_runzB_apply_audit_logging.._wrap_tool_run.._audited_runs**511 ."U9---------G)T** 3#-- 22vTZTk7uv7N7N7P7P7PquE** 3#-- 22#< 55+5i+F+FcYUTWXaTbTbLc E 8$uY////////fd++6%+ENN--6&-v%6ENN,,6&,f%5EN!)hl!;!;007777"*hl!;!;007777s =A,F"":GrE)rrrrrHs rG_wrap_tool_runz,_apply_audit_logging.._wrap_tool_runs51: 8 8 8 8 8 8 8>rFrrz(Could not apply MCP audit logging (v2): Nr call_toolc K|tvs|s||fi|d{VSd}t|tr2|dpjrnd}t |d|tjtj t|trt|ni} ||fi|d{V}dt|ddi|_ |tjtj |_ |S#tjtj |_ |wxYw)Nrrkrr)rrrarrr4r rrrrrArrr) rrrrrrrrHoriginal_call_tools rG_audited_call_toolz0_apply_audit_logging.._audited_call_tools333<;R;RSW;X;X3!3!3D)!N!Nv!N!NNNNNNNNi..'mmI665;5LV//111RV###'|HL99/9)T/J/JRDOOOPR <#5#5dI#P#P#P#PPPPPPPF&.F ETE0B%CEN!%-\(,%?%?EN 44U;;;;&.\(,%?%?EN 44U;;;;s /D88:E2z:Could not apply MCP audit logging: unknown FastMCP versionr)rrArrrrrrrrrrrrgetattr) rkrlrHrrrrVrrrs ` @@rGrrs & 3L"#"""""""HsO$$)U K!/6<<>> T T d///&&tUNN44R4RSSS T T) K K K NNIaII J J J J J J J J J K j ! !!U$S+t<<  E < < < < < < < <4   sK1C D D D D D9 E E< STTTTTsABB=B88B=cjpt}jr|| ddtdtdtdzdt tdzdt ttfdzd tdzd tdzd tdzd tdzd t ffd }dS|| ddtdtdtdzdt tdzdt ttfdzd tdzd tdzd tdzd t ffd }dS)zRegister the retain tool. descriptiongeneralNrXrYrPrZr[r\rr]r^rIc $K|p} | dddSt||||||||\} } | rd| dSt} | | g| d{V} dd| dd S#t $r9}t d |dt|dcYd}~Sd}~wt$r;}t d |d dt|dcYd}~Sd}~wwxYw)a< Args: content: The fact/memory to store (be specific and include relevant details) context: Category for the memory (e.g., 'preferences', 'work', 'hobbies', 'family'). Default: 'general' timestamp: When this event/fact occurred (ISO format, e.g., '2024-01-15T10:30:00Z'). Useful for timeline tracking. tags: Optional tags for scoped visibility filtering (e.g., ['project:alpha', 'user:123']) metadata: Optional key-value metadata to attach (e.g., {'source': 'slack', 'channel': 'general'}) document_id: Optional document ID to associate this memory with bank_id: Optional bank to store in (defaults to session bank). Use for cross-bank operations. strategy: Optional named retain strategy (e.g., 'exact' for verbatim storage). Strategies are defined in the bank config. update_mode: How to handle existing documents with the same document_id. 'replace' (default) or 'append' (concatenates new content to existing). NerrorNo bank_id configuredstatusmessagercontentsracceptedMemory storage initiated operation_idrrrRetain rejected: Error storing memory: Tr r4rjrOsubmit_async_retainrrrrrArr)rXrYrPrZr[r\rr]r^ target_bankrhrrrrVrHrls rGrz _register_retain..retains0">V%<%<%>%>K"")6MNNN"4)T8[(T_## L% =")e<<<26::O >%99'*^$3 :   )9$*JJ~$>$> , > > >6166777")c!ff======== > > > 9a99D III")c!ff======== >s07B D.CD D0D D Dc K}|dddSt||||||||\} } | rd| dSt} || g| d{V} dd| dd S#t $r9} t d | dt| dcYd} ~ Sd} ~ wt$r;} t d | d dt| dcYd} ~ Sd} ~ wwxYw)a Args: content: The fact/memory to store (be specific and include relevant details) context: Category for the memory (e.g., 'preferences', 'work', 'hobbies', 'family'). Default: 'general' timestamp: When this event/fact occurred (ISO format, e.g., '2024-01-15T10:30:00Z'). Useful for timeline tracking. tags: Optional tags for scoped visibility filtering (e.g., ['project:alpha', 'user:123']) metadata: Optional key-value metadata to attach (e.g., {'source': 'slack', 'channel': 'general'}) document_id: Optional document ID to associate this memory with strategy: Optional named retain strategy (e.g., 'exact' for verbatim storage). Strategies are defined in the bank config. update_mode: How to handle existing documents with the same document_id. 'replace' (default) or 'append' (concatenates new content to existing). NrrrrrrrrrrTrr)rXrYrPrZr[r\r]r^rrhrrrrVrHrls rGrz _register_retain..retainSs,!1133K"")6MNNN"4)T8[(T_## L% =")e<<<26::O >%99'*^$3 :   )9$*JJ~$>$> , > > >6166777")c!ff======== > > > 9a99D III")c!ff======== >s07B D .C?D  D 0DD D )rNNNNNNNrNNNNNN)r;r r9rrArdr)rkrlrHrrs `` rGrnrns+M/MK #l> k * *%$(%).2&*"&#'&*3 >3 >3 >3 >Tz3 >s)d" 3 > 38nt+ 3 > t 3 >4Z3 >Dj3 >t3 >3 >3 >3 >3 >3 >3 > + *3 >3 >3 >n k * *%$(%).2&*#'&*1 >1 >1 >1 >Tz1 >s)d" 1 > 38nt+ 1 > t 1 >Dj1 >t1 >1 >1 >1 >1 >1 >1 > + *1 >1 >1 >rFcbjr| ddtdtdtdzdttdzdtttfdzdtdzd tdzd tdzd tffd }dS| ddtdtdtdzdttdzdtttfdzdtdzd tdzd tffd }dS)zMRegister the sync_retain tool (synchronous retain that waits for completion).rNrXrYrPrZr[r\rr]rIc >K|p}|dddSt|||||||\} } | rd| dSt} || g| | ddd{V} d| D} dd | d S#t $r9}t d |dt|dcYd}~Sd}~wt$r;}t d |d dt|dcYd}~Sd}~wwxYw)arStore information to long-term memory and wait for completion. Unlike retain (which is asynchronous), this tool blocks until the memory is fully stored and immediately available for recall. Args: content: The fact/memory to store (be specific and include relevant details) context: Category for the memory (e.g., 'preferences', 'work', 'hobbies', 'family'). Default: 'general' timestamp: When this event/fact occurred (ISO format, e.g., '2024-01-15T10:30:00Z'). Useful for timeline tracking. tags: Optional tags for scoped visibility filtering (e.g., ['project:alpha', 'user:123']) metadata: Optional key-value metadata to attach (e.g., {'source': 'slack', 'channel': 'general'}) document_id: Optional document ID to associate this memory with bank_id: Optional bank to store in (defaults to session bank). Use for cross-bank operations. strategy: Optional named retain strategy (e.g., 'exact' for verbatim storage). Strategies are defined in the bank config. Nrrrr]rrrr]cg|] }|D]}| SrErErbatchuids rGrz>_register_sync_retain..sync_retain..%GGGeGG#cGGGGrF completedMemory stored successfullyrr memory_idsSync retain rejected: Error in sync retain: Tr r4rjrOretain_batch_asyncpoprrrrArr)rXrYrPrZr[r\rr]rrhrrrrrVrHrls rGrz*_register_sync_retain..sync_retains4">V%<%<%>%>K"")6MNNN"4WgyRVX`bmow"x"x L% =")e<<<26::O >%88'*^$3)--j$?? 9   HGvGGG );", , > > >;;;<<<")c!ff======== > > > 9a99D III")c!ff======== >s1AB D .CD D!0DDDc :K}|dddSt|||||||\}} | rd| dSt} ||g| |ddd{V} d| D} dd | d S#t $r9} t d | dt| dcYd} ~ Sd} ~ wt$r;} t d | d dt| dcYd} ~ Sd} ~ wwxYw)aStore information to long-term memory and wait for completion. Unlike retain (which is asynchronous), this tool blocks until the memory is fully stored and immediately available for recall. Args: content: The fact/memory to store (be specific and include relevant details) context: Category for the memory (e.g., 'preferences', 'work', 'hobbies', 'family'). Default: 'general' timestamp: When this event/fact occurred (ISO format, e.g., '2024-01-15T10:30:00Z'). Useful for timeline tracking. tags: Optional tags for scoped visibility filtering (e.g., ['project:alpha', 'user:123']) metadata: Optional key-value metadata to attach (e.g., {'source': 'slack', 'channel': 'general'}) document_id: Optional document ID to associate this memory with strategy: Optional named retain strategy (e.g., 'exact' for verbatim storage). Strategies are defined in the bank config. Nrrrr]r cg|] }|D]}| SrErEr s rGrz>_register_sync_retain..sync_retain..rrFrrrrrTrr)rXrYrPrZr[r\r]rrhrrrrrVrHrls rGrz*_register_sync_retain..sync_retains0!1133K"")6MNNN"4WgyRVX`bmow"x"x L% =")e<<<26::O >%88'*^$3)--j$?? 9   HGvGGG );", , > > >;;;<<<")c!ff======== > > > 9a99D III")c!ff======== >s1AB D.C D D0DDDr)rNNNNN)r9rrArdr)rkrlrHrs `` rGroros#p> %$(%).2&*"&#'5 >5 >5 >5 >Tz5 >s)d" 5 > 38nt+ 5 > t 5 >4Z5 >Dj5 >5 >5 >5 >5 >5 >5 > 5 >5 >5 >r %$(%).2&*#'3 >3 >3 >3 >Tz3 >s)d" 3 > 38nt+ 3 > t 3 >Dj3 >3 >3 >3 >3 >3 >3 > 3 >3 >3 >rFcjpt}jr|| ddtdt dtd t tdzd t tdzd td t tdzd tdzdtdzdttzffd }dS|| ddtdt dtd t tdzd t tdzd td t tdzd tdzdtffd }dS)zRegister the recall tool.rrhighNanyquery max_tokensbudgettypesrZ tags_match tag_groupsquery_timestamprrIc K |p} | dS||tdtjtjtjd} | |tj} ||ntt} | || | |td} | || d<|| d<|t || d<|t|| d <jdi| d{V}|d S#t $rK}t"d |t'jt+|gd cYd}~Sd}~wt$r}d|dcYd}~Sd}~wt,$r/}t"d|dd|dcYd}~Sd}~wwxYw)a> Args: query: Natural language search query (e.g., "user's food preferences", "what projects is user working on") max_tokens: Maximum tokens to return in results (default: 4096) budget: Search budget - 'low', 'mid', or 'high' (default: 'high'). Higher budgets search more thoroughly. types: Fact types to include (e.g., ['world', 'experience']). Default: all types. tags: Optional tags to filter results by (e.g., ['project:alpha']). Mutually exclusive with tag_groups. tags_match: How to match tags - 'any' (match any tag) or 'all' (match all tags). Default: 'any' tag_groups: Compound tag filter using boolean groups (AND-ed together). Each group is a leaf {"tags": [...], "match": "any_strict"} or compound {"and": [...]}, {"or": [...]}, {"not": {...}}. Example: [{"not": {"tags": ["closeout"], "match": "any_strict"}}] excludes memories tagged closeout. Mutually exclusive with tags. query_timestamp: Temporal context for the query (ISO format, e.g., '2024-01-15T10:30:00Z'). Helps retrieve time-relevant memories. bank_id: Optional bank to search in (defaults to session bank). Use for cross-bank operations. NError: No bank_id configuredX'tags' and 'tag_groups' are mutually exclusive. Use 'tag_groups' for compound filtering.lowmidrrr fact_typerrrrZr!r" question_dateindentRecall rejected: rresults {"error": "z", "results": []}Error searching: TrrE)r4rUrLOWMIDHIGHrlowerrdrrO_TAG_GROUP_LIST_ADAPTERvalidate_pythonrW recall_asyncmodel_dump_jsonrrrrbdumpsrArr)rrrr rZr!r"r#rr budget_map budget_enum fact_types recall_kwargs recall_resultrVrHrls rGrz _register_recall..recallsJ6( <%B)@)@)B)B &99# (>$r&,Z FKXX (nnV\\^^V[II &+&7UUTBY=Z=Z  +"!+)",';F'C'C 11 #,0M&)2>>+ D D D6166777zCFFr"B"BCCCCCCCC < < <;a;;;;;;;;; < < < 444t DDD;a;;;;;;;;; D G(AE.(G. G;FG G$F=7G=GcK }|dgdS||tdtjtjtjd} | |tj} ||ntt} ||| | |td} | || d<|| d<|t || d <|t|| d <jdi| d{V} | S#t $r9}t"d |t'|gdcYd}~Sd}~wt$r}t'|gdcYd}~Sd}~wt($r;}t"d |d t'|gdcYd}~Sd}~wwxYw)a Args: query: Natural language search query (e.g., "user's food preferences", "what projects is user working on") max_tokens: Maximum tokens to return in results (default: 4096) budget: Search budget - 'low', 'mid', or 'high' (default: 'high'). Higher budgets search more thoroughly. types: Fact types to include (e.g., ['world', 'experience']). Default: all types. tags: Optional tags to filter results by (e.g., ['project:alpha']). Mutually exclusive with tag_groups. tags_match: How to match tags - 'any' (match any tag) or 'all' (match all tags). Default: 'any' tag_groups: Compound tag filter using boolean groups (AND-ed together). Each group is a leaf {"tags": [...], "match": "any_strict"} or compound {"and": [...]}, {"or": [...]}, {"not": {...}}. Example: [{"not": {"tags": ["closeout"], "match": "any_strict"}}] excludes memories tagged closeout. Mutually exclusive with tags. query_timestamp: Temporal context for the query (ISO format, e.g., '2024-01-15T10:30:00Z'). Helps retrieve time-relevant memories. Nrr1r&r'r*rZr!r"r,r0r4TrrE)r4rUrr5r6r7rr8rdrrOr9r:rWr; model_dumprrrrArr)rrrr rZr!r"r#rr>r?r@rArBrVrHrls rGrz _register_recall..recallKsA2( 8$5577 &%<LLL# (>$r&,Z FKXX (nnV\\^^V[II &+&7UUTBY=Z=Z  +"!+)",';F'C'C 11 #,0M&)2r?reflect_kwargsreflect_result result_datarVrHrls rGrz"_register_reflect..reflectsP! 9%B)@)@)B)B &99%+Z FKXX (nnV\\^^VZHH  +")&",';F'C'C 22#.8GN#45#-1N6*3=N<0';v';'M'Mn'M'M!M!M!M!M!M!M"j)G)Gq)G)Q)QRR ".7>K^3_3_.7E7WK 34z+a8888+ 5 5 57A77888z7CFF"344444444 9 9 9 5!55 EEE8a888888888 9s5D C+D F?EF F'$F FFcK }|dddStjtjtjd}||tj} ||| ||td} ||| d<| || d<|| d <jdi| d{V} | } |t| d r | j | d <| S#t$r8} td | d t| icYd} ~ Sd} ~ wt $r;} td | dt| ddcYd} ~ Sd} ~ wwxYw)a~ Generate thoughtful analysis by synthesizing stored memories with the bank's personality. WHEN TO USE THIS TOOL: Use reflect when you need reasoned analysis, not just fact retrieval. This tool thinks through the question using everything the bank knows and its personality traits. EXAMPLES OF GOOD QUERIES: - "What patterns have emerged in how I approach debugging?" - "Based on my past decisions, what architectural style do I prefer?" - "What might be the best approach for this problem given what you know about me?" - "How should I prioritize these tasks based on my goals?" HOW IT DIFFERS FROM RECALL: - recall: Returns raw facts matching your search (fast lookup) - reflect: Reasons across memories to form a synthesized answer (deeper analysis) Use recall for "what did I say about X?" and reflect for "what should I do about X?" Args: query: The question or topic to reflect on context: Optional context about why this reflection is needed budget: Search budget - 'low', 'mid', or 'high' (default: 'low') max_tokens: Maximum tokens for the response (default: 4096) response_schema: Optional JSON schema for structured output. When provided, the response includes a 'structured_output' field. tags: Optional tags to filter memories by (e.g., ['project:alpha']) tags_match: How to match tags - 'any' (match any tag) or 'all' (match all tags). Default: 'any' Nr)rrr'rIrGrZr!rJrKrrLTrrE)r4rr5r6r7rr8rOrMrDrrJrrrrArr)rrYrrrGrZr!rr>r?rNrOrPrVrHrls rGrz"_register_reflect..reflectsL! 5$5577 &%K^3_3_.7E7WK 34""+ ) ) )7A77888Q((((((( 5 5 5 5!55 EEE!$Q44444444 5s5C$CC$$ E).-D!E)! E).0E$E)$E))Nr(rNNrN)Nr(rNNr)r9rrArErrd)rkrlrHrs `` rGrqrqs#V5 #'"+/%)#"&H 9H 9H 94ZH 9H 9 H 9 "D[ H 9 s)d" H 9H 94ZH 9H 9H 9H 9H 9H 9H 9 H 9H 9H 9X #'"+/%)#F 5F 5F 54ZF 5F 5 F 5 "D[ F 5 s)d" F 5F 5F 5F 5F 5F 5F 5F 5 F 5F 5F 5rFcZ|dtffd }dS)zRegister the list_banks tool.rIcK td{V}tjd|idS#t$rK}t d|tjt|gdcYd}~Sd}~wt$r/}t d|d d |d cYd}~Sd}~wwxYw) a) List all available memory banks. Use this tool to discover what memory banks exist in the system. Each bank is an isolated memory store (like a separate "brain"). Returns: JSON list of banks with their IDs, names, dispositions, and missions. rNbanksr-r.Operation rejected: )rrVzError listing banks: Trr3z", "banks": []}) rrOrbr=rrrrArr)rVrVrHrls rGrz(_register_list_banks..list_banks.s 6 ++ > > NN5!55 6 6 6:A<<== = = = = = = 6 6 6 LL444tL D D D5!555 5 5 5 5 5 5 6s1AA CABC C#$C C CNrrA)rkrlrHrs `` rGrrrr+sL XXZZ6c666666Z666rFc |ddtdtdzdtdzdtffd }dS)zRegister the create_bank tool.NrrmissionrIcK t}||d{V}||<||||d{V||d{V}d|vr3t|ddr|d|d<t j|dS#t$rJ}t d|t jd t|icYd}~Sd}~wt$r/}t d |d d |dcYd}~Sd}~wwxYw)a Create a new memory bank or get an existing one. Memory banks are isolated stores - each one is like a separate "brain" for a user/agent. Banks are auto-created with default settings if they don't exist. Args: bank_id: Unique identifier for the bank (e.g., 'user-123', 'agent-alpha') name: Optional human-friendly name for the bank mission: Optional mission describing who the agent is and what they're trying to accomplish rUN)rrZr dispositionrDr-r.rWrzError creating bank: Trr3"}) rOget_bank_profilerrrDrbr=rrrrArr)rrrZrprofilerVrHrls rGrz*_register_create_bank..create_bankGs )26::O"33G_3]]]]]]]]G7#6((#$3 )!' 7 7Q` 7 a aaaaaaa''GGM4JL,Y,Y')0)?)J)J)L)L &:ga000 0' 1 1 1 NN5!55 6 6 6:wA/00 0 0 0 0 0 0 ) ) ) LL444tL D D D(!((( ( ( ( ( ( ( )s0B8B>> E ?D E  E $E>E E NNrX)rkrlrHrs `` rGrsrsDsp XXZZ%)%)3%)cDj%)#PT*%)`c%)%)%)%)%)%)Z%)%)%)rFr source_queryrc||sdS||sdS||dks|dkrd|SdS)zJValidate mental model inputs, returning an error message or None if valid.Nzname cannot be emptyzsource_query cannot be emptyi z-max_tokens must be between 256 and 8192, got )striprrars rG_validate_mental_model_inputsrfpsg  %% (:(:(<(<--:#3#3zD7H7HKzKKK 4rFc NjrT| d dttdzdtdtdzdtffd }dS| d dttdzdtdtffd }dS) z%Register the list_mental_models tool.NfullrZdetailrrIcK |p}|dS|||td{V}tjd|idt S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d |d d |d cYd}~Sd}~wwxYw)a List mental models (pinned reflections) for a memory bank. Mental models are living documents that stay current by periodically re-running a source query through reflect. Use them to maintain up-to-date summaries, preferences, or synthesized knowledge. Args: tags: Optional tags to filter by (returns models matching any tag) detail: Detail level - 'metadata' (names/tags only), 'content' (adds content/config), 'full' (includes reflect_response). Default: 'full' bank_id: Optional bank to list from (defaults to session bank). Use for cross-bank operations. Nz/{"error": "No bank_id configured", "items": []}rrZrirrr-r/defaultrWrError listing mental models: Trr3", "items": []}) r4r,rOrbr=rArrrrr)rZrirrmodelsrVrHrls rGr,z8_register_list_mental_models..list_mental_modelssQ$ :%B)@)@)B)B &LL%88'!$8$@$@ 9   z7F"3AsKKKK+ 5 5 59a99:::z7CFF"344444444 : : : @Q@@4 PPP9a999999999 :5A)A A)) C43?B82C48 C4$C/)C4/C4cK }|dgdS|||td{V}d|iS#t$r8}td|dt |icYd}~Sd}~wt$r;}td|d t |gdcYd}~Sd}~wwxYw) a> List mental models (pinned reflections) for this memory bank. Mental models are living documents that stay current by periodically re-running a source query through reflect. Use them to maintain up-to-date summaries, preferences, or synthesized knowledge. Args: tags: Optional tags to filter by (returns models matching any tag) detail: Detail level - 'metadata' (names/tags only), 'content' (adds content/config), 'full' (includes reflect_response). Default: 'full' NrrrrkrrWrrnTr) r4r,rOrrrrArr)rZrirrprVrHrls rGr,z8_register_list_mental_models..list_mental_modelss<  6$5577 &%.get_mental_models{" -%B)@)@)B)B &??$55'$3!$8$@$@ 6 =:w0u0u0ugr0u0u0u&vwwwz%3????+ 5 5 59a99:::z7CFF"344444444 - - - ?A??$ OOO,a,,,,,,,,, -s;BA B*B D?CD D"$D D DcK }|ddiS|||td{V}| dd|d|diS|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td |d dt |icYd}~Sd}~wwxYw) a Get a specific mental model by ID. Returns the mental model with the requested detail level. Use list_mental_models first to discover available model IDs. Args: mental_model_id: The ID of the mental model to retrieve detail: Detail level - 'metadata' (names/tags only), 'content' (adds content/config), 'full' (includes reflect_response). Default: 'full' Nrrryrzr{rrWr|Tr) r4r+rOrrrrArr)rvrirr}rVrHrls rGr+z4_register_get_mental_model..get_mental_modelsV )$5577 &#%<==$55'$3!$8$@$@ 6 =#%jo%j%j\g%j%j%jkk + ) ) )9a99:::Q((((((( ) ) ) ?A??$ OOOQ((((((( )s:A8AA C$-BC C$/CCC)rhN)rhr9rrAr)rkrlrHr+s `` rGrurus#L) !"&# -# - # -# -4Z# - # -# -# -# -# -# - # -# -# -N !! )! ) ! )! )! )! )! )! )! )! ) ! )! )! )rFcjru| ddtdtdtdzdttdzdtd t d tdzd tffd }dS| ddtdtdtdzdttdzdtd t d t ffd }dS)z&Register the create_mental_model tool.NFrrarvrZr#trigger_refresh_after_consolidationrrIc K |p}|dSt|||}|rtjd|iSt } d|i} |||d|||| |  d{V} || d| d{V} tj| d| d d d |d dS#t$rJ} t d| tjdt| icYd} ~ Sd} ~ wt$r-} tjdt| icYd} ~ Sd} ~ wt$r/} t d| dd| dcYd} ~ Sd} ~ wwxYw)a& Create a new mental model (pinned reflection). A mental model is a living document generated by running the source_query through reflect. The content is auto-generated asynchronously - use the returned operation_id to track progress. EXAMPLES: - name="Coding Preferences", source_query="What coding patterns and tools does the user prefer?" - name="Project Goals", source_query="What are the user's current project goals and priorities?" - name="Communication Style", source_query="How does the user prefer to communicate?" Args: name: Human-readable name for the mental model source_query: The query to run through reflect to generate content mental_model_id: Optional custom ID (alphanumeric lowercase with hyphens). Auto-generated if not provided. tags: Optional tags for scoped visibility filtering max_tokens: Maximum tokens for generated content (256-8192, default: 2048) trigger_refresh_after_consolidation: If True, automatically refresh this model after memory consolidation. Default: False bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. Nrxrerrefresh_after_consolidationGenerating content... rrrarXrvrZrtriggerridrrvrrcreatedrz5' created. Content is being generated asynchronously.rvrrrrWError creating mental model: Trr3r])r4rfrbr=rOr-!submit_async_refresh_mental_modelrrrrArUrr)rrarvrZrrrrvalidation_errorrrr}rrVrHrls rGr-z:_register_create_mental_model..create_mental_model)s[>1 -%B)@)@)B)B &??#@LZ$$$ $C:w0@&ABBB"6v">">8:]^%88'!-3$3)#$39         &GG'$)$K$3 H   z+0;(.~(>"+#oD#o#o#o , 5 5 59a99:::z7CFF"344444444 5 5 5z7CFF"344444444 - - - @Q@@4 PPP,a,,,,,,,,, -sMC )C BC F ?DF  F )"E F  F $FF F c K }|ddiSt|||}|rd|iSt }d|i} |||d|||| | d{V} || d| d{V} | d| d d d |d dS#t $r8} t d| dt| icYd} ~ Sd} ~ wt$r} dt| icYd} ~ Sd} ~ wt$r:} t d| ddt| icYd} ~ Sd} ~ wwxYw)a Create a new mental model (pinned reflection). A mental model is a living document generated by running the source_query through reflect. The content is auto-generated asynchronously - use the returned operation_id to track progress. EXAMPLES: - name="Coding Preferences", source_query="What coding patterns and tools does the user prefer?" - name="Project Goals", source_query="What are the user's current project goals and priorities?" - name="Communication Style", source_query="How does the user prefer to communicate?" Args: name: Human-readable name for the mental model source_query: The query to run through reflect to generate content mental_model_id: Optional custom ID (alphanumeric lowercase with hyphens). Auto-generated if not provided. tags: Optional tags for scoped visibility filtering max_tokens: Maximum tokens for generated content (256-8192, default: 2048) trigger_refresh_after_consolidation: If True, automatically refresh this model after memory consolidation. Default: False NrrrerrrrrrrrzrrrWrTr) r4rfrOr-rrrrrArUrr)rrarvrZrrrrrrr}rrVrHrls rGr-z:_register_create_mental_model..create_mental_model}s,:- )$5577 &#%<==#@LZ$$$ $7#%566"6v">">8:]^$88'!-3$3)#$39         &GG'$)$K$3 H  (-T{$*>$:'kkkk  , ) ) )9a99:::Q((((((( ) ) )Q((((((( ) ) ) @Q@@4 PPPQ((((((( )sLB)B)A1B)) E3-C& E& E3D E E/E E E)NNrFN)NNrF)r9rrArdrErCr)rkrlrHr-s `` rGrvrv$s#`) +/%)"8="&O -O -O -O -!4ZO -s)d" O -  O - 26 O -4ZO -O -O -O -O -O -O - O -O -O -f +/%)"8= I )I )I )I )!4ZI )s)d" I )  I ) 26 I )I )I )I )I )I )I ) I )I )I )rFcjr| d dtdtdzdtdzdtdzdttdzdt dzdtdzd tffd }dS| d dtdtdzdtdzdtdzdttdzdt dzd t ffd }dS)z&Register the update_mental_model tool.NrvrrarrZrrrIc K |p }|dSt|||}|rtjd|iS||||||t d} |d|i| d< jdi| d{V} | tjdd|d |d iStj| d t S#t$rJ} t d | tjdt | icYd} ~ Sd} ~ wt$r/} t d| dd| dcYd} ~ Sd} ~ wwxYw)aP Update a mental model's metadata. Changes the name, source query, or tags of an existing mental model. To regenerate the content, use refresh_mental_model after updating the source query. Args: mental_model_id: The ID of the mental model to update name: New name (leave None to keep current) source_query: New source query (leave None to keep current) max_tokens: New max tokens for content generation (256-8192, leave None to keep current) tags: New tags (leave None to keep current) trigger_refresh_after_consolidation: If set, update whether this model auto-refreshes after consolidation bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrerrrvrrarrZrrrrzr{rr-rlrWError updating mental model: Trr3r]rE) r4rfrbr=rOr/rArrrrr)rvrrarrZrrrr update_kwargsr}rVrHrls rGr/z:_register_update_mental_model..update_mental_models2 -%B)@)@)B)B &??#@LZ$$$ $C:w0@&ABBB +'6 $0", ';F'C'C11 7B0MOr/sM),8f8II=IIIIIIII=:w0u0u0ugr0u0u0u&vwwwz%3????+ 5 5 59a99:::z7CFF"344444444 - - - @Q@@4 PPP,a,,,,,,,,, -sAB7)B7 AB7B77 E?DE E$D=7E=Ec K }|ddiSt|||}|rd|iS||||||t d}|d|i|d< jdi|d{V} | dd|d |d iS| S#t$r8} t d | dt| icYd} ~ Sd} ~ wt$r:} t d | d dt| icYd} ~ Sd} ~ wwxYw)a Update a mental model's metadata. Changes the name, source query, or tags of an existing mental model. To regenerate the content, use refresh_mental_model after updating the source query. Args: mental_model_id: The ID of the mental model to update name: New name (leave None to keep current) source_query: New source query (leave None to keep current) max_tokens: New max tokens for content generation (256-8192, leave None to keep current) tags: New tags (leave None to keep current) trigger_refresh_after_consolidation: If set, update whether this model auto-refreshes after consolidation Nrrrerrrrzr{rrWrTrrE) r4rfrOr/rrrrArr) rvrrarrZrrrrr}rVrHrls rGr/z:_register_update_mental_model..update_mental_model s. )$5577 &#%<==#@LZ$$$ $7#%566 +'6 $0", ';F'C'C11 7B0MOr/sM),8f8II=IIIIIIII=#%jo%j%j\g%j%j%jkk + ) ) )9a99:::Q((((((( ) ) ) @Q@@4 PPPQ((((((( )s?A9A9?A97A99 C=-B60C=6 C=/C82C=8C=NNNNNN)NNNNN)r9rrArErdrCr)rkrlrHr/s `` rGrwrws#v)  $'+%)%)?C"&8 -8 - 8 -*8 -*8 -d 8 - s)d" 8 - 26 8 -4Z8 -8 -8 -8 -8 -8 -8 - 8 -8 -8 -x  $'+%)%)?C 6 )6 ) 6 )*6 )*6 )d 6 ) s)d" 6 ) 26 6 )6 )6 )6 )6 )6 )6 ) 6 )6 )6 )rFcjr=| ddtdtdzdtffd }dS|dtdtffd }dS)z&Register the delete_mental_model tool.NrvrrIcK |p}|dS||td{V}|stjdd|d|diStjd|d S#t $rJ}t d |tjdt|icYd}~Sd}~wt$r/}t d |d d|dcYd}~Sd}~wwxYw)a6 Delete a mental model. Permanently removes a mental model and its generated content. Args: mental_model_id: The ID of the mental model to delete bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. Nrxrrrzr{rdeletedrrvrWError deleting mental model: Trr3r]) r4r.rOrbr=rrrrArr)rvrrrrVrHrls rGr.z:_register_delete_mental_model..delete_mental_modelKs} -%B)@)@)B)B &?? & : :'$3$8$@$@!;!! x:w0u0u0ugr0u0u0u&vwwwzY?"["[\\\+ 5 5 59a99:::z7CFF"344444444 - - - @Q@@4 PPP,a,,,,,,,,, -s;BA B)B D  ?C D  D $DD D cK }|ddiS||td{V}|s dd|d|diSd|d S#t$r8}td |dt |icYd}~Sd}~wt$r:}td |d dt |icYd}~Sd}~wwxYw)z Delete a mental model. Permanently removes a mental model and its generated content. Args: mental_model_id: The ID of the mental model to delete Nrrrrzr{rrrrWrTr) r4r.rOrrrrArr)rvrrrVrHrls rGr.z:_register_delete_mental_model..delete_mental_modelos` )$5577 &#%<== & : :'$3$8$@$@!;!! l#%jo%j%j\g%j%j%jkk"+PPP+ ) ) )9a99:::Q((((((( ) ) ) @Q@@4 PPPQ((((((( )s:A7AA C &-BC  C &/CC C rr)rkrlrHr.s `` rGrxrxFs#D) #' - -  -4Z - - - - - - -  - - -F  )  )  ) ) ) ) ) )  ) ) )rFcjr=| ddtdtdzdtffd }dS|dtdtffd }dS)z'Register the refresh_mental_model tool.NrvrrIc^K |p}|dS||td{V}tj|ddd|ddS#t $rJ}t d |tjd t|icYd}~Sd}~wt$r-}tjd t|icYd}~Sd}~wt$r/}t d |d d|dcYd}~Sd}~wwxYw)a Refresh a mental model by re-running its source query. Schedules an async task to re-run the source query through reflect and update the mental model's content with fresh results. Use this after adding new memories or when the mental model's content may be stale. Args: mental_model_id: The ID of the mental model to refresh bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. Nrxrrqueued!Refresh queued for mental model ''.rrrrWrError refreshing mental model: Trr3r]) r4rrOrbr=rrrrArUrr)rvrrrrVrHrls rGr0z<_register_refresh_mental_model..refresh_mental_models  -%B)@)@)B)B &??%GG'$3$8$@$@ H   z(.~(>"*#Z#Z#Z#Z, 5 5 59a99:::z7CFF"344444444 5 5 5z7CFF"344444444 - - - BqBBT RRR,a,,,,,,,,, -sGA,A A,, D,6?B;5D,; D,"C0*D,0 D,=$D'!D,'D,cK }|ddiS||td{V}|ddd|dd S#t$r8}td |dt |icYd}~Sd}~wt$r}dt |icYd}~Sd}~wt$r:}t d |d dt |icYd}~Sd}~wwxYw)a Refresh a mental model by re-running its source query. Schedules an async task to re-run the source query through reflect and update the mental model's content with fresh results. Use this after adding new memories or when the mental model's content may be stale. Args: mental_model_id: The ID of the mental model to refresh NrrrrrrrrrWrTr) r4rrOrrrrArUrr)rvrrrVrHrls rGr0z<_register_refresh_mental_model..refresh_mental_models )$5577 &#%<==%GG'$3$8$@$@ H   %+>$:&V?VVV , ) ) )9a99:::Q((((((( ) ) )Q((((((( ) ) ) BqBBT RRRQ((((((( )sFA:A D$-BD D$B:4D: D/C<6D<Drr)rkrlrHr0s `` rGryrys#R) #'' -' - ' -4Z' -' -' -' -' -' -' - ' -' -' -V # ) # ) # )# )# )# )# )# ) # )# )# )rFc NjrT| d dttdzdtdtdzdtffd }dS| d dttdzdtdt ffd }dS) z"Register the list_directives tool.NTrZ active_onlyrrIcK |p}|dS|||td{V}tjd|idt S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d |d d |d cYd}~Sd}~wwxYw)a List directives for a memory bank. Directives are instructions that guide how the memory engine processes and responds to queries. They influence reflect behavior and memory organization. Args: tags: Optional tags to filter by active_only: If True, only return active directives (default: True) bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrZrrrr-rlrWrError listing directives: Trr3ro) r4r&rOrbr=rArrrrr)rZrrr directivesrVrHrls rGr&z2_register_list_directives..list_directivessQ" :%B)@)@)B)B &??#)#9#9 +$8$@$@ $:$$ z7J"73OOOO+ 5 5 59a99:::z7CFF"344444444 : : : =!== MMM9a999999999 :rqcK }|dgdS|||td{V}d|iS#t$r8}td|dt |icYd}~Sd}~wt$r;}td|d t |gdcYd}~Sd}~wwxYw) a List directives for this memory bank. Directives are instructions that guide how the memory engine processes and responds to queries. They influence reflect behavior and memory organization. Args: tags: Optional tags to filter by active_only: If True, only return active directives (default: True) NrrsrrrWrrTr) r4r&rOrrrrArr)rZrrrrVrHrls rGr&z2_register_list_directives..list_directivess< 6$5577 &%.create_directive@sU, -%B)@)@)B)B &??"("9"9#%'$8$@$@#:## z)AsCCCC+ 5 5 59a99:::z7CFF"344444444 - - - =!== MMM,a,,,,,,,,, -5A*A A** C54?B93C59 C5$C0*C50C5c K }|ddiS ||||||td{V}|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|ddt |icYd}~Sd}~wwxYw) a Create a new directive for this memory bank. Directives guide how the memory engine processes queries and generates reflections. Args: name: Human-readable name for the directive content: The directive content/instructions priority: Priority level (higher = more important, default: 0) is_active: Whether the directive is active (default: True) tags: Optional tags for filtering NrrrrWrTr) r4r)rOrrrrArr) rrXrrrZrrrVrHrls rGr)z4_register_create_directive..create_directivens;( )$5577 &#%<=="("9"9#%'$8$@$@#:## ! + ) ) )9a99:::Q((((((( ) ) ) =!== MMMQ((((((( )4A0A C-B C C/C CC)rTNN)rTN)r9rrArErCrdr)rkrlrHr)s `` rGr{r{;sF#X) "%)"& ) -) -) -) -) - ) - s)d" ) - 4Z ) -) -) -) -) -) -) - ) -) -) -Z "%) ' )' )' )' )' ) ' ) s)d" ' )  ' )' )' )' )' )' ) ' )' )' )rFcjr=| ddtdtdzdtffd }dS|dtdtffd }dS)z#Register the delete_directive tool.N directive_idrrIcK |p}|dS||td{V}|stjdd|diStjd|dS#t $rJ}t d |tjdt|icYd}~Sd}~wt$r/}t d |d d |dcYd}~Sd}~wwxYw)a% Delete a directive. Permanently removes a directive from the memory bank. Args: directive_id: The ID of the directive to delete bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrUr Directive ' ' not foundrrrrWError deleting directive: Trr3r]) r4r*rOrbr=rrrrArr)rrrrrVrHrls rGr*z4_register_delete_directive..delete_directivest -%B)@)@)B)B &?? & 7 7 $8$@$@!8!! Z:w0Wl0W0W0W&XYYYzY "U"UVVV+ 5 5 59a99:::z7CFF"344444444 - - - =!== MMM,a,,,,,,,,, -s;A=AA=&A== D?C D D$D=DDcK }|ddiS||td{V}|sdd|diSd|dS#t$r8}td |dt |icYd}~Sd}~wt$r:}td |d dt |icYd}~Sd}~wwxYw) z Delete a directive. Permanently removes a directive from this memory bank. Args: directive_id: The ID of the directive to delete NrrrUrrrrrWrTr) r4r*rOrrrrArr)rrrrVrHrls rGr*z4_register_delete_directive..delete_directivesW )$5577 &#%<== & 7 7 $8$@$@!8!! N#%L<%L%L%LMM"+\JJJ+ ) ) )9a99:::Q((((((( ) ) ) =!== MMMQ((((((( )s:A4AA C#-BC C#/CCCrr)rkrlrHr*s `` rGr|r|s#D) #' - - -4Z - - - - - - -  - - -F  ) )  ) ) ) ) ) )  ) ) )rFcnjr\| d dtdzdtdzdtdtdtdzd tf fd }dS| d dtdzdtdzdtdtd tf fd }dS)z Register the list_memories tool.NdrtypeqlimitoffsetrrIc K |p}|dS |||||td{V}tj|dt S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d|d d |d cYd}~Sd}~wwxYw) aV Browse stored memories with optional filtering. Lists memory units (facts) stored in the bank. Unlike recall, this is a direct browse/search without relevance ranking. Args: type: Filter by fact type: 'world', 'experience', or 'opinion' q: Optional text search query to filter memories limit: Maximum number of results (default: 100) offset: Pagination offset (default: 0) bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. Nrxr+ search_queryrrrr-rlrWrError listing memories: Trr3r]) r4list_memory_unitsrOrbr=rArrrrr) rrrrrrrrVrHrls rGr!z._register_list_memories..list_memoriessR* -%B)@)@)B)B &??%77"!"!$8$@$@ 8  z&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - ;;;d KKK,a,,,,,,,,, -rqc K }|ddiS|||||td{V}|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|ddt |icYd}~Sd}~wwxYw) a Browse stored memories with optional filtering. Lists memory units (facts) stored in the bank. Unlike recall, this is a direct browse/search without relevance ranking. Args: type: Filter by fact type: 'world', 'experience', or 'opinion' q: Optional text search query to filter memories limit: Maximum number of results (default: 100) offset: Pagination offset (default: 0) NrrrrWrTr) r4rrOrrrrArr) rrrrrrrVrHrls rGr!z._register_list_memories..list_memoriess7& )$5577 &#%<==%77"!"!$8$@$@ 8   + ) ) )9a99:::Q((((((( ) ) ) ;;;d KKKQ((((((( )s4A/A C-B C C/CCC)NNrrN)NNrrr9rrArEr)rkrlrHr!s `` rGr}r}s2#T) # "& ' -' -*' -Tz' -' - ' - 4Z ' -  ' -' -' -' -' -' - ' -' -' -V #  % )% )*% )Tz% )% ) % )  % )% )% )% )% )% ) % )% )% )rFcjr=| ddtdtdzdtffd }dS|dtdtffd }dS)zRegister the get_memory tool.N memory_idrrIc K |p}|dS||td{V}|tjdd|diStj|dt S#t $rJ}td |tjdt |icYd}~Sd}~wt$r/}t d |d d |dcYd}~Sd}~wwxYw)a> Get a specific memory by ID. Returns the full memory unit including content, metadata, and timestamps. Args: memory_id: The ID of the memory to retrieve bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrUrMemory 'rr-rlrWError getting memory: Trr3r]) r4get_memory_unitrOrbr=rArrrrr)rrrrrVrHrls rGrz(_register_get_memory..get_memoryGso -%B)@)@)B)B &??%55$8$@$@ 6   >:w0Q90Q0Q0Q&RSSSz&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - 9a99D III,a,,,,,,,,, -;BAB&B D  ?C D  D $DD D cK }|ddiS||td{V}|dd|diS|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|d dt |icYd}~Sd}~wwxYw) z Get a specific memory by ID. Returns the full memory unit including content, metadata, and timestamps. Args: memory_id: The ID of the memory to retrieve NrrrUrrrWrTr) r4rrOrrrrArr)rrrrVrHrls rGrz(_register_get_memory..get_memoryksJ )$5577 &#%<==%55$8$@$@ 6   >#%F %F%F%FGG + ) ) )9a99:::Q((((((( ) ) ) 9a99D IIIQ((((((( ):A4AA C -B C C /CCCrr)rkrlrHrs `` rGr~r~Bs#D) #' - - -4Z - - - - - - -  - - -F  ) )  ) ) ) ) ) )  ) ) )rFc "jrI| d dtdzdtdtdzdtffd }dS| d dtdzdtdtffd }dS) z!Register the list_documents tool.NrrrrrIcK |p}|dS|||td{V}tj|dt S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d|d d |d cYd}~Sd}~wwxYw) a List documents in a memory bank. Documents are containers for related memories (e.g., a conversation transcript, a meeting notes file). Memories created with a document_id are grouped under that document. Args: q: Optional search query to filter documents limit: Maximum number of results (default: 100) bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. Nrxrrrr-rlrWrError listing documents: Trr3r]) r4r$rOrbr=rArrrrrrrrrrrVrHrls rGr$z0_register_list_documents..list_documentssL" -%B)@)@)B)B &??%44!"$8$@$@ 5   z&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - <<.list_documentss1 )$5577 &#%<==%44!"$8$@$@ 5    + ) ) )9a99:::Q((((((( ) ) ) <<.get_documentso -%B)@)@)B)B &??%22$8$@$@ 3   >:w0U[0U0U0U&VWWWz&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - ;;;d KKK,a,,,,,,,,, -rcK }|ddiS||td{V}|dd|diS|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|d dt |icYd}~Sd}~wwxYw) z Get a specific document by ID. Returns document metadata and associated memory information. Args: document_id: The ID of the document to retrieve NrrrUrrrWrTr) r4rrOrrrrArrr\rrrVrHrls rGrz,_register_get_document..get_document sJ )$5577 &#%<==%22$8$@$@ 3   >#%J+%J%J%JKK + ) ) )9a99:::Q((((((( ) ) ) ;;;d KKKQ((((((( )rrr)rkrlrHrs `` rGrrs#D) #' - - -4Z - - - - - - -  - - -F  ) )  ) ) ) ) ) )  ) ) )rFcjr=| ddtdtdzdtffd }dS|dtdtffd }dS)z"Register the delete_document tool.Nr\rrIcK |p}|dS||td{V}tjd|d|t S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d |d d |d cYd}~Sd}~wwxYw)aF Delete a document and its associated memories. Permanently removes a document and all memories linked to it. Args: document_id: The ID of the document to delete bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrUrrr\rmrWrError deleting document: Trr3r]) r4r%rOrbr=rArrrrrrs rGr%z2_register_delete_document..delete_document. sV -%B)@)@)B)B &??%55$8$@$@ 6   zY{"]"]V\"]gjkkkk+ 5 5 59a99:::z7CFF"344444444 - - - <<.delete_documentP s< )$5577 &#%<==%55$8$@$@ 6   #,KRR6RR+ ) ) )9a99:::Q((((((( ) ) ) <<.list_operationsy sL  -%B)@)@)B)B &??%55!$8$@$@ 6   z&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - =!== MMM,a,,,,,,,,, -rcK }|ddiS|||td{V}|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|ddt |icYd}~Sd}~wwxYw) a\ List async operations for this memory bank. Operations track background tasks like retain processing, mental model refresh, etc. Args: status: Filter by status: 'pending', 'running', 'completed', 'failed', 'cancelled' limit: Maximum number of results (default: 20) NrrrrWrTr) r4r'rOrrrrArr)rrrrrVrHrls rGr'z2_register_list_operations..list_operations s1 )$5577 &#%<==%55!$8$@$@ 6    + ) ) )9a99:::Q((((((( ) ) ) =!== MMMQ((((((( )r)NrN)Nrr)rkrlrHr's `` rGrrt s#F) !%"& - -$J - -4Z - - - - - - -  - - -H !% ) )$J ) ) ) ) ) ) ) )  ) ) )rFcjr=| ddtdtdzdtffd }dS|dtdtffd }dS)z Register the get_operation tool.NrrrIcK |p}|dS||td{V}tj|dt S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d|d d |d cYd}~Sd}~wwxYw) aS Get the status of an async operation. Check progress of background tasks like retain processing or mental model refresh. Args: operation_id: The ID of the operation to check bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrUr-rlrWrError getting operation: Trr3r]) r4get_operation_statusrOrbr=rArrrrrrrrrrVrHrls rGr z._register_get_operation..get_operation sI -%B)@)@)B)B &??%:: $8$@$@ ;   z&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - <<.get_operation s. )$5577 &#%<==%:: $8$@$@ ;    + ) ) )9a99:::Q((((((( ) ) ) <<.cancel_operation sI -%B)@)@)B)B &??%66 $8$@$@ 7   z&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - ?A??$ OOO,a,,,,,,,,, -rcK }|ddiS||td{V}|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|ddt |icYd}~Sd}~wwxYw) z Cancel a pending or running async operation. Args: operation_id: The ID of the operation to cancel NrrrUrWrTr) r4r(rOrrrrArrrs rGr(z4_register_cancel_operation..cancel_operation+ s. )$5577 &#%<==%66 $8$@$@ 7    + ) ) )9a99:::Q((((((( ) ) ) ?A??$ OOOQ((((((( )rrr)rkrlrHr(s `` rGrr s#<) #' - - -4Z - - - - - - -  - - ->  ) )  ) ) ) ) ) )  ) ) )rFc "jrI| d dtdzdtdtdzdtffd }dS| d dtdzdtdtffd }dS) zRegister the list_tags tool.NrrrrrIcK |p}|dS|||td{V}tj|dt S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d|d d |d cYd}~Sd}~wwxYw) a List tags used in a memory bank. Tags are used to organize and filter memories, directives, and mental models. Args: q: Optional pattern to filter tags (e.g., 'project:*') limit: Maximum number of results (default: 100) bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. Nrxpatternrrr-rlrWrError listing tags: Trr3r]) r4rrOrbr=rArrrrrrs rGrz&_register_list_tags..list_tagsR sL  -%B)@)@)B)B &??%//$8$@$@ 0   z&C@@@@+ 5 5 59a99:::z7CFF"344444444 - - - 7A77$ GGG,a,,,,,,,,, -rcK }|ddiS|||td{V}|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|ddt |icYd}~Sd}~wwxYw) a2 List tags used in this memory bank. Tags are used to organize and filter memories, directives, and mental models. Args: q: Optional pattern to filter tags (e.g., 'project:*') limit: Maximum number of results (default: 100) NrrrrWrTr) r4rrOrrrrArrrs rGrz&_register_list_tags..list_tagsw s1 )$5577 &#%<==%//$8$@$@ 0    + ) ) )9a99:::Q((((((( ) ) ) 7A77$ GGGQ((((((( )rrrr)rkrlrHrs `` rGrrM s#F)  "& - -Tz - -4Z - - - - - - -  - - -H   ) )Tz ) ) ) ) ) ) ) )  ) ) )rFcjr6| ddtdzdtffd }dS|dtffd }dS)zRegister the get_bank tool.NrrIcTK |p}|dS|td{V}d|vr3t|ddr|d|d<t j|dtS#t$rJ}t d|t jd t|icYd}~Sd}~wt$r/}t d |d d |dcYd}~Sd}~wwxYw)z Get the profile of a memory bank. Returns bank metadata including name, disposition, and mission. Args: bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrUr\rDr-rlrWrError getting bank: Trr3r]) r4r^rOrrDrbr=rArrrrr)rrr_rVrHrls rGrz$_register_get_bank..get_bank s -%B)@)@)B)B &?? & 7 7$8$@$@!8!!!G++ 8NP\0]0]+-4]-C-N-N-P-PGM*z'!SAAAA+ 5 5 59a99:::z7CFF"344444444 - - - 7A77$ GGG,a,,,,,,,,, -s5BA.get_bank sf )$5577 &#%<== & 7 7$8$@$@!8!!!G++ 8NP\0]0]+-4]-C-N-N-P-PGM*+ ) ) )9a99:::Q((((((( ) ) ) 7A77$ GGGQ((((((( )s5BA"B D -B?9D? D /D;DDrr)rkrlrHrs `` rGrr s#;) "& - -4Z -  - - - - - -  - - -@  ) ) ) ) ) ) )  ) ) )rFcr| ddtdzdtffd }dS)z3Register the get_bank_stats tool (multi-bank only).NrrIcK |p}|dS|td{V}tj|dt S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d|d d |d cYd}~Sd}~wwxYw) z Get statistics for a memory bank. Returns counts of nodes, links, and other metrics. Args: bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrUr-rlrWrzError getting bank stats: Trr3r]) r4r#rOrbr=rArrrrrrrrrVrHrls rGr#z0_register_get_bank_stats..get_bank_stats sF )!>V%<%<%>%>K";;!00 4V < <1F:fQ<<< <' 1 1 1 NN5!55 6 6 6:wA/00 0 0 0 0 0 0 ) ) ) LL9a99DL I I I(!((( ( ( ( ( ( ( )s5A%AA%% C0/?B4.C04 C0$C+%C0+C0rrX)rkrlrHr#s `` rGrr sa XXZZ"))t) ))))))Z)))rFrrZconfig_updatesrrrZrcK|||||d{V|rt|ni}| d|vr||d<|r"|j|||d{V|||d{VS)uShared implementation for update_bank MCP tool variants. Args: name: Display name (stored in banks table). mission: Deprecated alias for reflect_mission — mapped into config_updates. config_updates: Arbitrary config overrides passed to config_resolver.update_bank_config(). Supports all configurable fields (retain_mission, disposition_*, etc.). The config resolver validates keys and rejects non-configurable/credential fields. N)rrreflect_missionrU)rrrupdate_bank_configr^)rlrrrrZreffective_configs rG_do_update_bankr s&   +!         @N'UtN';';';SU08HHH.5*+i%88FVXghhhhhhhhh((o(VV V V V V V VVrFc jri| d dtdzdtdzdtttfdzdtdzdtf fd }dS| d dtdzdtdzdtttfdzdtffd }dS) zRegister the update_bank tool.NrrZrrrIcK |p}|dSt|t|||d{V}tj|dt S#t tf$rJ}t d|tjdt |icYd}~Sd}~wt$r/}t d|d d |d cYd}~Sd}~wwxYw) a Update a memory bank's configuration. Updates the bank's name and/or any bank-level configuration fields. Only provided fields will be updated; omitted fields remain unchanged. Args: name: Human-friendly display name for the bank. mission: Deprecated alias for config_updates.reflect_mission. config_updates: Dictionary of configuration fields to update. Supports all bank-configurable fields including: - reflect_mission: Mission/context for Reflect operations. - retain_mission: Steers what gets extracted during retain(). - retain_extraction_mode: 'concise' (default), 'verbose', or 'custom'. - retain_custom_instructions: Custom extraction prompt (active when mode is 'custom'). - retain_chunk_size: Maximum token size for each content chunk. - retain_chunk_batch_size: Number of chunks to process in parallel. - enable_observations: Toggle observation consolidation after retain(). - observations_mission: Controls observation synthesis rules. - disposition_skepticism: Critical evaluation level (1-5). - disposition_literalism: Literal vs. abstract interpretation (1-5). - disposition_empathy: Emotional context consideration (1-5). - entity_labels: Controlled vocabulary for entity classification. - entities_allow_free_form: Allow labels outside entity_labels. - recall_include_chunks: Include raw chunks in recall results. - recall_max_tokens: Max tokens for recall results. - mcp_enabled_tools: Tool allowlist for this bank. Any configurable field name is accepted (use Python field names). bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. Nrxr r-rlrWrError updating bank: Trr3r]) r4rrOrbr=rArrUrrrr) rrZrrrrrVrHrls rGrz*_register_update_bank..update_bank& sRJ -%B)@)@)B)B &??.(00##1    z&C@@@@,j9 5 5 59a99:::z7CFF"344444444 - - - 8Q884 HHH,a,,,,,,,,, -s5A#AA##C54?B93C59 C5$C0*C50C5cK }|ddiSt|t|||d{V}|S#ttf$r8}t d|dt|icYd}~Sd}~wt$r:}t d|ddt|icYd}~Sd}~wwxYw) a Update this memory bank's configuration. Updates the bank's name and/or any bank-level configuration fields. Only provided fields will be updated; omitted fields remain unchanged. Args: name: Human-friendly display name for the bank. mission: Deprecated alias for config_updates.reflect_mission. config_updates: Dictionary of configuration fields to update. Supports all bank-configurable fields including: - reflect_mission: Mission/context for Reflect operations. - retain_mission: Steers what gets extracted during retain(). - retain_extraction_mode: 'concise' (default), 'verbose', or 'custom'. - retain_custom_instructions: Custom extraction prompt (active when mode is 'custom'). - retain_chunk_size: Maximum token size for each content chunk. - retain_chunk_batch_size: Number of chunks to process in parallel. - enable_observations: Toggle observation consolidation after retain(). - observations_mission: Controls observation synthesis rules. - disposition_skepticism: Critical evaluation level (1-5). - disposition_literalism: Literal vs. abstract interpretation (1-5). - disposition_empathy: Emotional context consideration (1-5). - entity_labels: Controlled vocabulary for entity classification. - entities_allow_free_form: Allow labels outside entity_labels. - recall_include_chunks: Include raw chunks in recall results. - recall_max_tokens: Max tokens for recall results. - mcp_enabled_tools: Tool allowlist for this bank. Any configurable field name is accepted (use Python field names). Nrrr rWrTr) r4rrOrrUrrrArr)rrZrrrrVrHrls rGrz*_register_update_bank..update_bankb s7F )$5577 &#%<==.(00##1     ,j9 ) ) )9a99:::Q((((((( ) ) ) 8Q884 HHHQ((((((( )s4A )A C-B C C/C CC)NNNNNNN)r9rrArr)rkrlrHrs `` rGrr! s2#t) #"&48"& 7 -7 -*7 -4Z7 -!cNT17 -4Z 7 -  7 -7 -7 -7 -7 -7 - 7 -7 -7 -v #"&485 )5 )*5 )4Z5 )!cNT15 ) 5 )5 )5 )5 )5 )5 ) 5 )5 )5 )rFcjr6| ddtdzdtffd }dS|dtffd }dS)zRegister the delete_bank tool.NrrIcK |p}|dS|td{V}tjd|d|t S#t $rJ}td|tjdt |icYd}~Sd}~wt$r/}t d |d d |d cYd}~Sd}~wwxYw)ac Delete a memory bank and all its data. WARNING: This permanently deletes the bank and all its memories, documents, mental models, directives, and other data. This action cannot be undone. Args: bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxrUrrrrrWrError deleting bank: Trr3r] r4rrOrbr=rArrrrrr s rGrz*_register_delete_bank..delete_bank sS -%B)@)@)B)B &??%11$8$@$@ 2  zY;"Y"YRX"Ycfgggg+ 5 5 59a99:::z7CFF"344444444 - - - 8Q884 HHH,a,,,,,,,,, -rqcK }|ddiS|td{V}d|d|S#t$r8}td|dt |icYd}~Sd}~wt$r:}td|d dt |icYd}~Sd}~wwxYw) z Delete this memory bank and all its data. WARNING: This permanently deletes the bank and all its memories, documents, mental models, directives, and other data. This action cannot be undone. NrrrUrrrWrTr r4rrOrrrrArr)rrrVrHrls rGrz*_register_delete_bank..delete_bank s9 )$5577 &#%<==%11$8$@$@ 2  #, NNvNN+ ) ) )9a99:::Q((((((( ) ) ) 8Q884 HHHQ((((((( )rrr)rkrlrHrs `` rGrr s#9) "& - -4Z -  - - - - - -  - - ->  )4 ) ) ) ) ) )  ) ) )rFcjrA| ddtdzdtdzdtffd }dS| ddtdzdtffd }dS) z!Register the clear_memories tool.NrrrIcK |p}|dS||dtd{V}tjd|d|t S#t $rJ}td|tjd t |icYd}~Sd}~wt$r/}t d |d d |dcYd}~Sd}~wwxYw)a Clear all memories from a bank without deleting the bank itself. Optionally filter by fact type to only clear specific kinds of memories. Args: type: Optional fact type filter: 'world', 'experience', or 'opinion'. If not specified, clears all. bank_id: Optional bank (defaults to session bank). Use for cross-bank operations. NrxFr+delete_bank_profilerclearedrrrWrError clearing memories: Trr3r]r)rrrrrVrHrls rGr"z0_register_clear_memories..clear_memories sY -%B)@)@)B)B &??%11"(-$8$@$@ 2   zY;"Y"YRX"Ycfgggg+ 5 5 59a99:::z7CFF"344444444 - - - <<.clear_memories s? )$5577 &#%<==%11"(-$8$@$@ 2   #, NNvNN+ ) ) )9a99:::Q((((((( ) ) ) <<r6s(  !!!!!!''''''''  &&&&&&?>>>>>>>555555HHHHHH555555======//////%+d8n55'Y   IcN   D  8 $ $ ******* *>  N    sx$0!!&*"":: : :Tz: s)d  : 38nt# : t :Dj:t: 4S>3: %&::::zJ. J. J. J. J.J.J.J.ZUWGUW\UW>UW^bUWUWUWUWp(1y((in*QUgQU|QU^QUX\QUQUQUQUhp>'p><p>p>TXp>p>p>p>fs>ws> s>ns>Y]s>s>s>s>lN8'N8<N8N8TXN8N8N8N8bY57Y5LY5.Y5UYY5Y5Y5Y5x6g6|6^6X\66662))w)) ))n))Y]))))))))ZX\   * +.: JMPT* 4Z    $M6gM6|M6^M6`dM6M6M6M6`O)GO)\O)>O)^bO)O)O)O)dc)wc) c)nc)aec)c)c)c)Ly)wy) y)ny)aey)y)y)y)xG)wG) G)nG)aeG)G)G)G)TU)U)U)~U)bfU)U)U)U)zK67K6LK6.K6]aK6K6K6K6\[)G[)\[)>[)^b[)[)[)[)|G)GG)\G)>G)^bG)G)G)G)^W)W),W)W)[_W)W)W)W)tG)gG)|G)^G)X\G)G)G)G)^K)'K)<K)K)\`K)K)K)K)\G)G)G)~G)Z^G)G)G)G)TC)7C)LC).C)]aC)C)C)C)VI)7I)LI).I)]aI)I)I)I)XC)C),C)C)[_C)C)C)C)L?)G?)\?)>?)^b?)?)?)?)NI)WI)lI)NI)W[I)I)I)I)X>)G>)\>)>>)VZ>)>)>)>)B)')<))\`))))L,0#W#W#W #W#W$#W * #W 4Z #WcNT)#W #s(^#W#W#W#WLw)ww) w)nw)Y]w)w)w)w)t<)w<) <)n<)Y]<)<)<)<)~E)'E)<E)E)\`E)E)E)E)E)E)rF