+ DWjNa0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt ^RI H t ^RI H t RRltRRltR R ltR R ltR Rlt]!]P(P+RR44tRtRt^t^t]!0RkRkRkRkRkRkRkRkRkRkRkRkRkRkR kR!kR"kR#kR$kR%kR&kR'kR(kR)kR*kR+kR,kR-kR.kR/kR0kR1kR2kR3kR4kR5kR6kR7kR8kR9kR:kR;kRkR?kR@kRAkRBkRCkRDkREkRFkRGkRHkRIkRJkRKkRLkRMkRNkROkRPkRQkRRkRSkRTkRUkRVkRWkRXkRYkRZkR[kR\kR]k4t]P:!4tR^/R_RR`RaRbRc/tRd] Re&/t!Rd] Rf&RgRhlt"RiRjlt#RkRllt$RmRnlt%RoRplt&R{Uu.uFp]POV]PP4NK! upR|Uu.uFp]POV4NK up,t)]PN!Rq]PP4t*RrRslt+RtRult,RvRwlt-RxRylt.Rzt/R#uupiuupi)}uEntity Dossier — put a profile card of a person/company/concept on the HUD. Two ways in: 1. The brain's ``show_entity(name)`` tool (mcp__entity__show_entity) — Jarvis calls it when Ahmed says "show me Saud" / "who is X / tell me about X". 2. AUTO-SHOW — main.py's listen loop calls ``maybe_autoshow(text)`` on every addressed utterance. When Ahmed names exactly ONE known entity (word- boundary match against a name set refreshed ~every 10 min) and that entity's per-entity cooldown is clear, its card pops on its own. The card is delivered to the HUD as an ``entity_profile`` event: emit("entity_profile", profile={...}) The HUD renders the dossier from that JSON and can send back-channel actions (control/entity_action.json → voice/control.py: drill-down, note, summary edit). SERVER CONTRACT (memory service, GET /profile?name=X → dossier JSON with keys entity, summary, read, quick, relations, timeline, facts_by_kind, tasks, counts, also_matched): - a KNOWN-ABSENT entity comes back HTTP 200 with ``{"entity": null, ...}`` — that is "nothing known", NOT an error: we speak "I don't have anything on X yet" and do NOT emit the event. - an AMBIGUOUS name returns the best entity plus ``also_matched: [names]`` — we name the runner-up in the spoken confirmation so Ahmed can drill down. Everything here degrades gracefully. The network may hang or the route may not exist yet — every call has a hard timeout, swallows errors to a log line, and NEVER blocks the voice loop (the name-set refresh and the auto-show fetch both run on daemon threads; the brain tool wraps the fetch in asyncio.to_thread). ) annotationsN)memory_control)emitc V^8dQhRRRR/#namestrreturnz dict | None)formats"voice/entity_show.py __annotate__r/s222 2c T;'gRP4pV'd\P!4'gR#\PP RVR\P /4p\P!RRV 2^R7p\T\4'dT#R# \d.p\RT: R \T4R , 24Rp?R#Rp?ii;i) u&GET /profile?name=X — the dossier JSON. Hard 3s ceiling. Returns None only on a network/timeout error or when memory isn't configured. A known-absent entity is NOT an error (the server answers 200 with {"entity": null}); that dict is returned as-is and the caller checks the ``entity`` field.NrgroupGETz /profile?timeoutz$ [entity] profile fetch failed for : NdN) striprenabledurllibparse urlencode_GROUP_req Exceptionprintr isinstancedict)rqsoutes& r fetch_profiler'/s JJB   D ~--// \\ # # T7N$9$9 :<!!%9RD)91ES$''31T1  4THBs1vd|nMNsA B(( C 3"CC c V^8dQhRRRR/#rr )r s"r rrAs<<< composing=False``; on failure/timeout/ null it carries ``composed=None composing=False`` so the HUD drops the "composing…" spinner and falls back to rendering the raw profile. Never raises, never blocks a turn. One RETRY after a short wait: a slow first composition can outlive our timeout while still finishing (and caching) server-side — the second POST then returns the cached result instantly.Nentity_profileFr0r+ composingz! [entity] composed emit failed: r)r-timesleep_COMPOSE_RETRY_Srr r!r )r/r0r+r&s&& r _compose_and_emitr9Yspe$H #$!%(B w% 1 B 1#a&,@AABsA A;A66A;c V^8dQhRRRR/#)rrr r ztuple[str, str, list]r )r s"r rros " " "- "rc6T;'gRP4pV'gRV.3#\V4pVfRV.3#VPR4'gRV.3#VPR4;'g/p\VPR4;'gT4P4;'gTpVPR4;'g.Uu.uF=p\V4P4'gK$\V4P4NK? pp\ RVRR R 7\T4\P!\Y13R R 7P4RY53#uupi \ d-p\ R \T4R , 24RY53uRp?#Rp?ii;i)uThe TRUTHFUL core every entry point shares. STAGE 1: fetch /profile (≤3s) and emit the card with ``composed=None composing=True`` — it pops instantly. STAGE 2: a daemon thread POSTs /dossier and a second emit swaps the composed narrative in. Returns (status, shown_name, also_matched): 'shown' — the card IS on the HUD 'unknown' — no such entity in memory; NO card was emitted 'error' — memory unreachable / emit failed; NO card on screen Callers must only claim a card is visible when status == 'shown' — the old fire-and-forget version let the brain say "on your HUD, sir" while nothing showed (Ahmed asked for "reval clients", not an entity, and got gaslit).rerrorNentityunknownr also_matchedr3Tr4z [entity] emit failed: rtargetargsdaemonr/) rr'r,r rr r! _mark_shown threadingThreadr9start)rr0entr/aalsor&s& r _showrKosn JJB   D r""D!Gr"" ;;x 4$$ ++h  % %2C ''4 ( . . 0 8 8DE%,[[%@%F%FB%F %Fq1v||~ CFLLN%FD & wN -U4D ""'%' U !!  & (Q78%%&s* !E2EE!! F,!F FFc V^8dQhRRRR/#)rrr r r )r s"r rrs..c.c.rcT;'gRP4pV'gR#\V4wrpVR8XdRV R2#VR8XdRV R2#V'd/\V4^8Xd V^,M V^, R 2pR V R V R 2#R V R 2#)u Brain-tool / control-file entry: run ``_show`` and return a short SPOKEN confirmation string (plain prose, TTS-safe) the MOMENT the card is up — it NEVER waits for composition. Callers on the event loop wrap it in asyncio.to_thread / a daemon thread. Never raises.rzI need a name to show, sir.r>zI don't have anything on z yet, sir.r<zI couldn't reach memory for u, sir — no card, I'm afraid.z and otherszShowing u, sir — I also know a .z's profile, sir.)rrKlen)rstatusr/rJextras& r show_entityrRs JJB   D ,+F4 *5'<< -eW4RSS t9>Q$q'+/F% 8qAA eW, --rENTITY_COMPOSE_RETRY_S8g@theandforyouyourarewaswerenewnowwhowhyhowwhatwhenwherethisthatthesethoseheretherewithfromintosomeanyallonetwor,gotseeletyesyeahyepnopeokaypleasethankstodaytomorrowtonightworkhometeamtaskemailphonecalltexthimherthemtheyshehisourr%notbutcanwilljustlikewantneedhavehashaddiddoesjarvisahmedsirmappatternat refreshingFr#_NAMES _COOLDOWNc V^8dQhRRRR/#)rrr r r1r )r s"r rrs33c3d3rc\;_uu_4\P!4\VP 4&RRR4R# +'giR#;iN) _names_lockr6 monotonicrlower)rs&r rDrDs* "&.."2 $**, s +A A cV^8dQhRR/#rr r1r )r s"r rrs")")")rc \PPR\P/4p\P !RRV 2^R7p/pVP R4;'g.Fp\VP R4;'gR4PR4'gK>\VP R 4;'gR4P4p\V4\8gVP4\9dKWBVP4&K R pV'dM\R V4\R R 7p\P !RRP#V4,R,4p\$;_uu_4V\&R&V\&R&\(P(!4\&R&R R R 4\+R\V4 R24\$;_uu_4R\&R&R R R 4R # +'giLJ;i \,dtp\+R\T4R, 24\$;_uu_4\(P(!4\&R&R R R 4R p?K +'giR p?L;iR p?ii;i +'giR #;i \$;_uu_4R\&R&R R R 4i +'gii;i;i)uLRebuild the known-entity matcher from GET /graph — the lightest endpoint that enumerates entities (/export is a full dump). Entity nodes come back as ``{"id": "ent:", "text": , "kind": "entity:"}``. Runs on a daemon thread with a bounded timeout; on any failure the last good matcher stays in place. Never raises.rrz/graph?rnodeskindrzentity:rNc3N"TFp\P!V4xK R#5ir)reescape).0ts& r !_refresh_names..s6A299Q<<s#%T)keyreversez (?I)J#J) I= 4J8J=JJJ J K+ J> 5 K> K KcV^8dQhRR/#rr )r s"r rrs A A Arc\P!4'gR#\;_uu_4\P!4\R,, \ 8pV'g\R,'d RRR4R#R\R&RRR4\ P!\RR7P4R# +'giL<;i)uKick a background refresh if the matcher is stale and none is in flight. Non-blocking — returns at once; the daemon thread does the network.NrrT)rArC) rrrr6r _REFRESH_SrErFrrG)recents r _maybe_refreshrs  ! ! # # ))+t , : VL))   $|  N48>>@ sA B>6B> B>> C c V^8dQhRRRR/#)rrr r z list[str]r )r s"r rrsSYrc\4T;'gRP4pV'g.#\;_uu_4\R,p\R,pRRR4Xf.#.p\ 4pVP V4F]pXP VP^4VP^44pWu9gK;VPV4VPV4K_ V# +'giL;i)u%Known entity display-names named in ``text``, by Unicode word-boundary match against the cached name set (2+ chars, generic words skipped). Does NO network on the hot path — it only kicks a background refresh — and returns [] until the set is first populated. Safe to call every utterance.rrrN) rrrrsetfinditerr,raddappend)rrrmappinghitsseenmdisps& r mentioned_entitiesrs  A  #-  DD   a {{1771:qwwqz2   HHTN KK  ! K s C&& C6 cV^8dQhRR/#)rr boolr )r s"r rrsdrc^RIHp\\VRR4;'dVPP 4# \ dR#i;i)uTrue while a background worker is running — auto-show stays out of the way during an active task dispatch (best-effort, never raises). agent_poolpoolNF)voicerrgetattrr_runningr rs r _agents_busyrsK$GJ511"002 2 s<< A  A zV^(?:the|a|his|her|their|this|that|please|profile of|about)\s+|\s+(?:please|now|again)$c V^8dQhRRRR/#rrr r z tuple | Noner )r s"r rr2ss|rc\EFApTPT;'gR4pV'gK)VP^4;'gRP4pRpV'd.W48wd(T\P RV4P4r4K5\ V4^8dK\V4pV'd\V\ R7MTp\P!4pV\PRVP4,R4, R8dRV3u#V\RVP4,&\V4wrp W3u# R# \d*p \!R\#T 4R , 24Rp ? R#Rp ? ii;i) uIf the utterance is an explicit profile ask, show the card INLINE (≤3s fetch — truth beats speed here) and return (status, name): ('shown', X) — the card IS on the HUD ('unknown', X) — no such entity; nothing was shown ('error', X) — memory unreachable; nothing was shown Returns None when the utterance isn't a profile ask. Prefers a KNOWN entity named in the tail; otherwise sends the tail itself — the server resolves fuzzily.rNrq:rg$@r/z! [entity] explicit_ask skipped: r) _EXPLICIT_RESsearchrr _TAIL_STRIPsubrOrmaxr6rrr,rrKr r!r ) rrxrtailprevknownrr^rPr/_alsor&s & r explicit_askr2s6B-B $**"%AGGAJ$$"++-DD4<!;??2t#<#B#B#Dd4y1}&t,E*/3u#&TD.."CY]]4$**,#6<@Tr@z# [entity] show_for_query skipped: r)rrrOr6rrr,rrErFrRrGr r!r )rnamesrr^r&s& r show_for_queryrbs D"5) 5c"nn tdjjl2C8 84 ? ), $%&"% $**, 4'$GMMO D 3CF4L>BCCDs$CAC6A!C D $DD c V^8dQhRRRR/#)rrr r r1r )r s"r rrys????rc \PPRR4R8XdR#\4'dR#\ V4Uu.uFp\ V4\ 8gKVNK pp\ V4^8wdR#V^,p\P!4p\;_uu_4V\PVP4R4, \8d RRR4R#V\VP4&RRR4\P!\V3RR7P!4R#uupi +'giLC;i \"d*p\%R\'T4R , 24Rp?R#Rp?ii;i) uMAUTO-SHOW entry point for main.py's listen loop — ONE line of integration. If Ahmed named exactly ONE strong, known entity and its 10-min cooldown is clear, pop its card. Gated by env ENTITY_AUTOSHOW (default on) and suppressed while a background agent is running. Never blocks (the fetch runs on a daemon thread) and never raises.ENTITY_AUTOSHOW10NrTr@z [entity] auto-show skipped: r)osenvironr,rrrO _STRONG_LENr6rrrr _COOLDOWN_SrErFrRrGr r!r )rhstrongrr^r&s& r rrys ? ::>>+S 1S 8  >> /5O5Q;9N!!5O v;!  aynn [Y]]4::<55 C['*Idjjl #  4'$GMMOP [ ? .s1vd|n=>>?sc%EE ED6#D6)E=,E)6D;E)D;4E6E; E E FE==Fc|aa^RIo^RIHpHpRRloV!RRR\/4RVV3R ll4pV!R R V.R 7#) uThe in-process ``entity`` MCP server — ONE brain tool, show_entity. Follows the memory/agent-pool pattern; dict-shorthand marks ``name`` required.N)create_sdk_mcp_servertoolc V^8dQhRRRR/#)rmsgr r r#r )r s"r r"build_server..__annotate__s<<3<4._textsVVVS9:;;rrRuGShow a full profile card (dossier) of a person/company/project/concept on Ahmed's screen: summary, contacts, relations, timeline of every interaction. ALWAYS call this when he says 'show me X', 'pull up X', 'pull up everything about X', 'who is X', or 'tell me about X' — the card is the answer; speak only a brief highlight.rc V^8dQhRRRR/#)rrBr#r r )r s"r rr sTdrc6<"\VPRR44P4pV'g S!R4#SP\V4GRjxL pS!T4#L \ d&pS!R\T4R, 24uRp?#Rp?ii;i5i)rrz"show_entity failed: no name given.Nzshow_entity failed: :NN)r r,r to_threadrRr )rBrr r&rasyncios& r show_entity_tool&build_server..show_entity_tools488FB'(..0=> > @))+t<? ? @sF:BA&A$A&B$A&& B1B B BBBr=z1.0.0)rversiontools)rclaude_agent_sdkrrr )rrrrrs @@r build_serverrsY<< - O 3-  ! w/?.@ r)z\b(?:pull up|bring up|show me|open up)\s+(?:everything\s+(?:we|you)\s+know\s+about\s+|everything\s+about\s+|the\s+profile\s+(?:of|for|on)\s+|a\s+profile\s+(?:of|for|on)\s+)?(.{2,60}?)[\s.!?]*$z\b(?:who\s+is|who's|tell me (?:everything )?about|what do (?:we|you) know about|everything (?:we|you) know about)\s+(.{2,60}?)[\s.!?]*$)uN(?:من هو|مين هو|وريني|ورني|اعرض)\s+(.{2,60}?)[\s.!?؟]*$uF(?:كل (?:شي|شيء) (?:نعرفه? )?عن)\s+(.{2,60}?)[\s.!?؟]*$)0__conditional_annotations____doc__ __future__rrrrEr6 urllib.parserrr voice.eventsrr'r-r9rKrRfloatrr,r8rrrr frozensetrLockrr__annotations__rrDrrrrr IGNORECASErrrrrrr)prs0@r r'sO<#   2$<0B, "F..(@#FG            & (- /4 6< >C EJ       !' )0 28 :@ BI     % '- /5 7= ?D FK      !& (- /4 6< >C EK        !(  *4  6?  AG        $  &-  /5  7=  ?D  FK      ! #( */ 16 8= ?D FL      # %+ -2 49 ;@ BH      nn r9dD#|UKK 43 ")J A0 88!Ar}}-8 bjjm  jj !#0 B D.?<i s %G& G+