$j%@$dZddlmZddlmZmZmZmZegdZ GddeZ GddeZ Gd d eZ Gd d eZ Gd deZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGddeZGdd eZGd!d"eZGd#d$eZGd%d&eZd'S)(a Core response models for Hindsight memory system. These models define the structure of data returned by the core MemoryEngine class. API response models should be kept separate and convert from these core models to maintain API stability even if internal models change. )Any) BaseModel ConfigDictFieldfield_validator)world experience observationceZdZUdZedZeed<edZeed<edZ e ee fed<ed d Z ed zed <d S) LLMToolCallz!A tool call requested by the LLM.z$Unique identifier for this tool call descriptionidzName of the tool to callnamezArguments to pass to the tool argumentsNz]Opaque token required by Gemini 3.1+ thinking models to preserve thought context across turnsdefaultrthought_signature) __name__ __module__ __qualname____doc__rrstr__annotations__rrdictrrl/home/rurouni/.hermes/hermes-agent/venv/lib/python3.11/site-packages/hindsight_api/engine/response_models.pyr r s++e FGGGBGGG"<===D#=== %2Q R R RItCH~RRR$)Es%%%sTzrr ceZdZUdZeddZedzed<eedZ ee ed<edd Z edzed <ed d Z e ed <ed dZe ed<dS)LLMToolCallResultz4Result from an LLM call that may include tool calls.NzText content if anyrcontentzTool calls requested by the LLMdefault_factoryr tool_callsz2Reason the LLM stopped: 'stop', 'tool_calls', etc. finish_reasonrzInput tokens used in this call input_tokenszOutput tokens used in this call output_tokens)rrrrrr!rrlistr$r r%r&intr'rrrr r s>>%:OPPPGS4ZPPP$)E$Lm$n$n$nJ[!nnn %d@t u u uM3:uuua5UVVVL#VVVq6WXXXM3XXXXXrr ceZdZUdZedZeed<eddZedzed<ed Z e ed <ed Z e ed <ed Z e ed<eddZe ed<dS) ToolCallTracez'A single tool call made during reflect.z(Tool name: lookup, recall, learn, expandr toolNz+Agent's reasoning for making this tool callrreasonzTool input parametersinputzTool output/resultoutputExecution time in milliseconds duration_msrz4Iteration number (1-based) when this tool was called iteration)rrrrrr,rrr-r.rr/r1r)r2rrrr+r+&s11"LMMMD#MMMt9fgggFC$Jggg%$;<<>e 0111B111"4555D#555"LMMMD#MMM5%YZZZGSZZZu)<===K===%:cdddGS4Zdddddrr7czeZdZUdZedZeed<edZeed<edZ eed<d S) DirectiveRefz9Reference to a directive that was applied during reflect.zDirective mental model IDr rzDirective namerzDirective contentr!N) rrrrrrrrrr!rrrr<r<CsrCCe ;<<r&r'rD)selfrGs r__add__zTokenUsage.__add__asC*U-??,u/BB*U-??    rN)rGr>rHr>) rrrrr model_configrr&r)rr'rDrKrrrr>r>Ks:  $!$ $ La5]^^^L#^^^q6deeeM3eeea5TUUUL#UUU      rr>ceZdZUdZedddZeed<edddZeed<eddd Z eed <e d d d d d iZ dS)DispositionTraitsaj Disposition traits for a memory bank. All traits are scored 1-5 where: - skepticism: 1=trusting, 5=skeptical (how much to doubt or question information) - literalism: 1=flexible interpretation, 5=literal interpretation (how strictly to interpret information) - empathy: 1=detached, 5=empathetic (how much to consider emotional context) z3How skeptical vs trusting (1=trusting, 5=skeptical))geler skepticismz>How literally to interpret information (1=flexible, 5=literal) literalismzAHow much to consider emotional context (1=detached, 5=empathetic)empathyr?)rSrTrUrEN) rrrrrrSr)rrTrUrrLrrrrNrNjseqQ4ijjjJjjjeqQ4tuuuJuuu5A!1tuuuGSuuu:1\]jk 94 a   ! KKK::a== rzVID of the chunk this fact was extracted from (format: bank_id_document_id_chunk_index)roz/Visibility scope tags associated with this factrqzkIDs of source facts this observation was derived from (observation type only, when source_facts is enabled)source_fact_ids)rrrrrrLrrrrrfrgrhr(rirjrkrlrmrnrr classmethodrrzrorqr{rrrrXrX{s: <>$$h/&"8 6 6/%w/6"!=1 L(e GHHHBHHH"IJJJD#JJJU'ijjjIsjjj!&t9^!_!_!_Hd3i$___%2UVVVGS4ZVVV!&t9k!l!l!lNC$Jlll$uT7ghhhL#*hhh$uT7lmmmL#*mmm#eD6abbbKtbbb&+eD>U&V&V&VHd38nt#VVV_Zh///stCH~'<[0/!5 rHcDj#U45fgggD$s)d ggg(- B)))OT#Y%rrXc|eZdZUdZedZeed<edZe ed<edd Z e ed <d S) ChunkInfozInformation about a chunk.zThe raw chunk textr chunk_textz&Index of the chunk within the document chunk_indexFz3Whether the chunk was truncated due to token limitsr truncatedN) rrrrrrrrrr)rboolrrrr~r~st$$e(<===J===u)QRRRKRRReE7lmmmItmmmmmrr~ceZdZUdZedZeed<edZeed<edZ e ed<ed d Z e ed <ed d Z eed zed<eedZeeed<d S)ObservationResultzRAn observation result from recall (consolidated knowledge synthesized from facts).zUnique observation IDr rThe observation textrfz+Number of facts supporting this observation proof_countRelevance score to the queryr relevanceNzTags for visibility scopingrqz0IDs of facts that contribute to this observationr"source_memory_ids)rrrrrrrrrfrr)rfloatrqr(rrrrrrs\\e 7888B888"8999D#999u)VWWWKWWWuS6TUUUIuUUU"U4=Z[[[D$s)d [[[#(5*\$$$tCyrrceZdZUdZedZeed<edZeed<edZ eed<ed d Z e ed <d S)MentalModelResultz???GS???uS6TUUUIuUUUUUrrc deZdZUdZeddddddddd gd d d d iZedZee e d<eddZ e e efdze d<eddZe e dfdze d<eddZe e efdze d<eddZe e e fdze d<dS) RecallResultz Result from a recall operation. Contains a list of matching memory facts and optional trace information for debugging and transparency. r?rYrZrr]r^rc)rrfrgrirjrkrpz*What did Alice say about machine learning?rO)query num_results)resultstracerEz'List of memory facts matching the queryr rNzTrace information for debuggingrzIEntity states for entities mentioned in results (keyed by canonical name) EntityStaterhz8Chunks for facts, keyed by '{document_id}_{chunk_index}'chunksz;Source facts for observation-type results, keyed by fact ID source_facts)rrrrrrLrrr(rXrrrrrrhrr~rrrrrrs: E F%,#.*@(>&* $P`abb   L&!&2[ \ \ \GT* \\\#(5;\#]#]#]E4S>D ]]]05 e111Hd3 %&-+0% T+++FDi 4 '27 W222L$sJ'$.rrc eZdZUdZeddddddddd ggggd d d gd gdddddddddiZedZee d<edZ e ee fe d<eddZ e ee fdze d <edd!Zedze d"<eed#$Zeee d%<eed&$Zeee d'<eed($Zeee d)<dS)* ReflectResulta  Result from a reflect operation. Contains the formulated answer, the facts it was based on (organized by type), any new opinions that were formed during the reflection process, and optionally structured output if a response schema was provided. r?zOBased on my knowledge, machine learning is being actively used in healthcare...rYz-Machine learning is used in medical diagnosisr healthcarer^)rrfrgrirjrkz directive-123zResponse StylezAlways be concise)rrrules)rr opinion mental_models directiveszML in healthcareg?)r: confidencer@rArBrC)rfbased_onstructured_outputusagerEzThe formulated answer textr rfzdFacts used to formulate the answer, organized by type (world, experience, mental_models, directives)rNzsStructured output parsed according to the provided response schema. Only present when response_schema was provided.rrzIToken usage metrics for the LLM calls made during this reflect operation.rz\Trace of tool calls made during reflection. Only present when include.tool_calls is enabled.r" tool_tracez[Trace of LLM calls made during reflection. Only present when include.tool_calls is enabled. llm_tracezADirective mental models that were applied during this reflection.directives_applied)rrrrrrLrrfrrrrrrrr>r(rr+rr4rr<rrrrrs$: i#I$S)0'3.D,B  #%!%'#2$4&9%:#,2DSV%W%W*.VZ[[3 L@">???D#???$uz   Hd38n05uJ000tCH~, %u_   E: ',er'''J]#%*Eq%%%ItL!.3UW...\*rrceZdZUdZeddddiZedZee d <ed d Z ed ze d <d S) EntityObservationz An observation about an entity. Observations are objective facts synthesized from multiple memory facts about an entity, without personality influence. r?z+John is detail-oriented and works at Googler^rfrlrErr rfNz1ISO format date when this observation was createdrl) rrrrrrLrrfrrrlrrrrrAs:  M_uvv L "8999D#999$uT7jkkkL#*kkkkkrrc eZdZUdZedddddddd dgd i Zed Zee d<ed Z ee d<ee dZ e e e d<dS)rzp Current mental model of an entity. Contains observations synthesized from facts about the entity. r?rYJohnzJohn is detail-orientedr^rz#John works at Google on the AI teamz2024-01-14T09:00:00Z) entity_idcanonical_name observationsrEz Unique identifier for the entityr rzCanonical name of the entityrz&List of observations about this entityr"rN)rrrrrrLrrrrrr(rrrrrrrSs : C"(6H^__BTjkk!     LU'IJJJIsJJJ%,JKKKNCKKK,1E*R---L$()rrc eZdZUdZedddddddd i Zed Zee d <ed Z ee d<ed Z ee d<edd Z edze d<edd Z edze d<ed Zee d<dS) MentalModelz A manually configured mental model for tracking specific topics/areas. Mental models are user-defined focus areas that the agent should track and maintain summaries for, unlike auto-extracted entities. r?z team-dynamicsz Team DynamicszSTrack how the team collaborates, communication patterns, conflicts, and resolutionsz$The team has strong collaboration...r^z2024-01-10T08:00:00Z)rrrr:summary_updated_at created_atrEz*Unique identifier (alphanumeric lowercase)r rz!Display name for the mental modelrz1Prompt/directions for what to track and summarizerNz)Generated summary based on relevant factsr:z-ISO format date when summary was last updatedrz1ISO format date when the mental model was createdr)rrrrrrLrrrrrrr:rrrrrrrns: %'tA&<4      Le LMMMBMMM"EFFFD#FFFu)\]]]K]]]%2]^^^GS4Z^^^%*U4=l%m%m%md mmme([\\\J\\\\\rrN)rtypingrpydanticrrrr frozensetVALID_RECALL_FACT_TYPESr r r+r4r7r<r>rNrXr~rrrrrrrrrrrsBBBBBBBBBBBB#)$J$J$JKK     )   YYYYY YYYjjjjjIjjjKKKKK9KKKeeeeeYeee:::::9:::        >ooooo ooo"::::::::znnnnn nnn        VVVVV VVV%%%%%9%%%P@@@@@I@@@Flllll lll$)6]]]]])]]]]]r