+ lHja0t$Rt^RIHt^RIt^RIt^RIt^RIt^RIt^RI t ^RI H t ^RI H t ^RIHtHtHt^RIHtR'tR(tR)t^tRt/tR]R &] P6!4tR*R R lltR R ltRRltRRlt RRlt!RRlt"RRlt#RRlt$RRlt%]PL!R]PN4t(] !R])!4R7t*R]R &R!R"lt+]PXR#R$l4t-R%R&lt.R#)+aHistory-reuse budgets for native vision embeds (config section ``vision``). A native ``vision_analyze`` result bakes the image into conversation history, where it is re-sent on every later API call. Two knobs bound that cost: ``vision.embed_target_bytes`` (how large one embed may be) and ``vision.max_calls_per_image`` (how often the same image may be embedded per session). See #112095: a delegated subagent re-loaded five screenshots 158 times in 15 minutes because nothing refused the repeat. ) annotationsN) ContextVar)Path)AnyIteratorOptional) tool_errorizdict[tuple[str, str], int]_repeat_countscV^8dQhRR/#)keystr)formats"F/home/ubuntu/.hermes/hermes-agent/tools/vision_tools_history_budget.py __annotate__r&sScZ^RIHpHpV!V!4RWR7# \dTu#i;i)zJ``vision.`` from config.yaml; ``default`` when config is unavailable.)cfg_get load_configvisiondefault)hermes_cli.configrr Exception)r rrrs&& r _cfg_visionr&s/:{}hEE s  **cV^8dQhRR/#r returnintr)rs"rrr/s N NC Nrc\R\R7p\V\4'd \ R4h\ V4p\\T\4\4# \ \\3d \u#i;i)zZ``vision.embed_target_bytes`` clamped to 64 KiB..4 MiB; the 256 KB default on a bad value.embed_target_bytesrzboolean is not a byte budget) r_DEFAULT_EMBED_TARGET_BYTES isinstancebool ValueErrorr TypeError OverflowErrorminmax_MIN_EMBED_TARGET_BYTES_MAX_EMBED_TARGET_BYTES)rawtargets rresolve_embed_target_bytesr./sm *4O PC+ c4 ;< <S s6235L MM z= 1+**+s,AA<;A<cV^8dQhRR/#rr)rs"rrr;s O OC Orc\R4pVe3VR8wd,\V\4'g\\ V4^4#^RIHpT!4'd\#^# \ \ 3dL.i;i)uPer-image embed cap for this session; 0 = unlimited. ``vision.max_calls_per_image`` unset (or unparseable) → ``_SUBAGENT_REPEAT_CAP`` inside a delegated subagent, unlimited for the main agent. An explicit value applies everywhere. max_calls_per_image)"is_delegated_child_process_context) rr#r$r)rr&r%agent.delegation_contextr3_SUBAGENT_REPEAT_CAP)r,r3s rresolve_repeat_capr6;so + ,C ?sbyC1F1Fs3x# #L#E#G#G NQN z "   s5AA21A2c V^8dQhRRRR/#)r image_urlr rr)rs"rrrKs G G# G# GrcVPR4'dCR\P!VPRR44P 4R,,#VP R^4^,P R4pRV9d RV,#R \\\PPV44P44,#) u Stable identity for an image source: local paths resolve (symlinks, ``~``, ``file://``), URLs drop their fragment, data URLs hash. Region crops are NOT part of the key — the incident loop alternated full loads and crops of the same files, and both re-embed the image.zdata:zutf-8ignore:N N#zfile://z://zurl:zfile:) startswithhashlibsha256encode hexdigestsplit removeprefixr rospath expanduserresolve)r8strippeds& r _image_keyrIKsG$$ (8(8((KLVVXY\]]]sA&q)66yAH   Sbgg00:;CCEF FFrc V^8dQhRRRR/#)r r8r rtuple[str, str]r)rs"rrrWsKK#K/Krc6^RIHpV!RR4\V43#))get_session_envHERMES_SESSION_IDr2)gateway.session_contextrNrI)r8rNs& r _count_keyrQWs7 . 3Z 5J JJrc V^8dQhRRRR/#)r r8r r Optional[str]r)rs"rrr\scmrc \4pV^8:dR#\V4p\;_uu_4\P V^4pW18d\ V4RRR4R#RRR4\ RX RV R2RR7# +'giL$;i)apReserve one native embed of ``image_url`` for the current session; tool-error JSON when the per-session cap is already spent, else ``None``. Check and count are ONE lock section: a parallel tool batch on the same image (the incident's 4 concurrent calls) must not all pass a check taken before any of them recorded. Callers ``release_embed`` when the embed then fails.NzHvision_analyze refused: this image has already been loaded into context z time(s) in this session (region crops of the same file count too), and every native load re-sends the full image on each later API call. Answer from what you can already see, or ask the user. (vision.max_calls_per_image = z; 0 = unlimited)F)success)r6rQ _repeat_lockr get_record_embed_lockedr)r8capr counts& rrepeat_refusalr[\s  C ax Y C ""3* ;  %     RSXRYZ/03e3C E   s )A== B c V^8dQhRRRR/#)r r rKrNoner)rs"rrrss77o7$7rc\PV^4^,\V&\\4\8d.\P \ \ \444KER#)rMN)r rWlen_REPEAT_COUNTS_MAX_KEYSpopnextiter)r s&rrXrXssI(,,S!4q8N3 n  7 74^ 456 8rc V^8dQhRRRR/#r r8r rr]r)rs"rrrzs44C4D4rc\;_uu_4\\V44RRR4R# +'giR#;i)uCount one successful native embed of ``image_url`` for the current session (uncapped sessions only — capped ones are counted by the reservation in :func:`repeat_refusal`).N)rVrXrQ)r8s&r record_embedrgzs" Z 23 s. ? c V^8dQhRRRR/#rer)rs"rrrs**S*T*rc\V4p\;_uu_4\PV^4pV^8dV^, \V&M\P VR4RRR4R# +'giR#;i)zRGive back a slot reserved by :func:`repeat_refusal` when the embed did not happen.N)rQrVr rWra)r8r rZs& r release_embedrjsT Y C ""3* 19"'!)N3    sD ) s AA)) A: z&^\[Image attached(?: at)?: (.+?)\]\s*$vision_native_turn_imagesrzContextVar[frozenset[str]]_native_turn_imagesc V^8dQhRRRR/#)r user_messagerrzfrozenset[str]r)rs"rrrsbbCbNbrc0\V\4'd;\;QJdRV4F 'gK RM RM !RV44'g \4#RP RV44p\R\ P V444#)c3z"TF1p\V\4;'dVPR4R8HxK3 R#5i)typer8Nr#dictrW.0ps& r $_native_turn_keys..s25FR 1d<<f  <rrDre threading contextvarsrpathlibrtypingrrrtools.registryrr"r*r+r5r`r __annotations__LockrVrr.r6rIrQr[rXrgrjcompile MULTILINErrrlrcontextmanagerrr)rs@rrs# "**%)#)-/*/~~  N O GK .74* JJH",,W2<=Xbkbm2n/nb )) r