߲jS8UdZddlZddlZddlZddlmZddlmZddlm Z ddl m Z m Z m Z mZmZddlmZddlmZdZ ddlZej.eZed d Zeeeeefed <d efd ZddlmZm Z m!Z!m"Z"dSdZ#de$de$de e$e fd ee$fdZ%ddfddfddfdZ&de e$e fd e$fdZ' dTde$de$d ee$d!ee$d"ee e e$e fd ee$f d#Z(d ee$fd$Z)d%Z*dUd ee$fd'Z+ dVde$de$d e$d!e$d(e$d"ee e e$e fd)ee!d e$fd*Z,dTd+ee e$e fd e e$e ffd,Z-dTd+ee e$e fd eeeffd-Z.ed efd.Z/d)dde$d ee e$e ffd/Z0de e$e fd)dd e e$e ffd0Z1d&d1d2d3gdd4d5d3d&d6gd7d5d3d8d9d3d:d9d3d;d9dd3d?d9d3d@d9d3dAd9dBdgdCdDdEdgdCdFZ2dGdHdIZ3d e e$e ffdJZ4ddKlm5Z5m6Z6e5jnd&d&e2dLe/dMe4NddOl8m9Z9ddl:Z:dPdQiZ;dRZrXSsUYYvw5Orcd||xsdfS)Nzadd to rlabelrVrWs rrXrXTsw.?B-Orc(|j|||SrR)replacerTs rrXrXUsvxY`9arcd|d|d|fS)Nz replace in zentry matching: z whole entry becomes: rr[s rrXrXVs&Kw2G4DXJNefmen2o2qrc&|j||SrR)removerTs rrXrXXs VX8Vrcd||xsdfS)Nz remove from rZrr[s rrXrXYs<w1GUW0Xr)rSr^raopc|xsi}|jdd|jdxs|jdxsd|jdd}}}|dk(rd|S|d k(rd |d |Sd |d |S)Naction?rVnew_textrZrWraz - remove: r^z- replace entry matching 'z' -> whole entry becomes: z- r9)r()rcactrVolds r_batch_op_linerj\s rBx-rvvi/@/\BFF:DV/\Z\^`^d^deoqs^t#C hC5!!UX\eUe(-Gy Q(cU"WI&(rrerUrVrW operationsc|dk(rdnd}|6tdt|d|djd|Dd||d Stgt|d |||||||d S) zMGate one mutating op, or (``operations`` set) a whole batch as a single unit.userz user profilememoryzapply z op(s) to  c32K|]}t|ywrRrj.0rcs r z$_apply_write_gate..ls'Prr(:'PbatchrerUrkrerUrVrW)rPlenjoin_STORE_ACTIONS)rerUrVrWrkr\s r_apply_write_gater}fs%.NHEs:&7z%I"ii'PZ'PP)0FR\]_ _  j>&1!4UGXN j%+v'_gh jjrc |dk(r|s tddS|dvrQ|sO|dk(rdnd}tjdd |d |d |d ||j||j |d dS|dk(r|s tddSy)uValidate BEFORE the gate so an invalid write is rejected now, not at approve time. Missing ``old_text`` is recoverable (it can't be schema-required — needs a combinator the Codex backend rejects): return the inventory plus a retry instruction.rSz%Content is required for 'add' action.Fr7r^rar^zx For 'replace', content is the COMPLETE new entry -- the whole matched entry is overwritten, not just the old_text span.rZ'z=' needs old_text -- a short unique substring of the entry to z!. None was provided. Reissue the z? with old_text set to part of one of the current_entries below.)r8errorcurrent_entriesusagerAz)content is required for 'replace' action.N)rHrKrL _entries_for_usage)r-rerUrVrW replace_hints r_validate_single_oprrswA5QQ &&x"Y.T46 zz&""8#DVHMIIUX %11&9ELLQWDX Z in o o 7EuUU rrrnc ddlm}|sy|tvxstd|xsgD}|sy|d||dn||||d}|dj d |Dnt |||d } dd lm} | j| j|d |dn|d |d|dd| j} tjddd| dd|dn|dddS#t$r'tjddt!ddcYSwxYw)uFail-closed operation gate for unattended background-review forks (#105921): ``add`` stays available (it is all any review prompt asks for), while ``replace``/``remove`` — single or inside a batch — are never applied unattended. The op is staged in the pending store instead of merely denied: the fork's own review summary is never published back, so a plain denial would drop the consolidation request with no surfacing path at all. A staging failure fails closed to a plain denial.r)is_unattended_reviewNc3nK|]-}t|txr|jdtv/yw)reN) isinstancedictr(_BG_DELETE_ACTIONSrrs rrtz*_background_delete_gate..s5.fLN 2tG!15G!GG.fs35rvrwryz; c32K|]}t|ywrRrqrrs rrtz*_background_delete_gate..s@rr*@ru)rerVrWr3z!background review consolidation (z on z): r;Tr=zIBackground review may not delete memory entries unattended. The proposed ue was staged for your approval — review it with /memory pending (approve to apply, discard to drop).)r8r>proposal_stagedr?r@FrAz8Failed to stage background-review consolidation; denyingexc_infozuBackground review may not delete memory entries ('replace'/'remove', including in a batch); 'add' is still available.r7)tools.skill_provenancerranyr{rjrCr4rIrErJrKrLr)loggerwarningrH) rerkrUrVrWrhitr1r0rMrOs r_background_delete_gaters<  ! & & f#.fS]Scac.f+fC ("V:N FwT\] EODZdii@Z@@!VU]"^_ @. IIw8JDZ`f8gh!(#fX/046$$&  ( zztTZ[_T`c&0&<7&IJ^^    @Q\`a 09>@ @@s+A*C-DDrgr-c>| tddS|||}|dn|}t||}|tj|S|rht |t s tddSt |||}||Std|dd|} | | Stj|j||dS|tvrtd |d dSt|||||xst |d|||xst||||} | | Stjt|d ||||dS) a-Tool entry point; returns a JSON string. Single op (action + content/old_text) or batch (``operations``, atomic against the final budget). ``new_text`` aliases ``content`` -- for 'replace' both mean the COMPLETE new entry (the whole matched entry is overwritten; old_text only locates it).NzJMemory is not available. It may be disabled in config or this environment.Fr7rnzCoperations must be a list of {action, content?, old_text?} objects.rvrAzUnknown action 'z'. Use: add, replace, remover) rH_memory_target_errorrKrLrlistrr} apply_batchr|r) rerUrVrWrgrkr- target_errordenied gate_resultinvalids r memory_toolrsX }fpuvv8/XVF'v6Lzz,''*d+cmrs s(VD  M'tZP  " zz%++FJ?eTT ^#,VH4PQ[`aa"5&&'8LG)&$RG#FFGXF  ::nV,Q/vwQ`e ffrr+c| ddlm}|}t |t r|jdnd}t |t r|SiS#t$rtj ddicYSwxYw)uNormalized ``memory`` config section ({} when missing/malformed → flags default to enabled). ``agent_init`` reads the same section so availability and store cannot diverge.Nr)load_config_readonlyz-Could not read memory config for availabilityTrrn)r$rr)rdebugrrr()r+rsections rr%r%sp~  >)+F'1&>fjj"DG $/77R7   LLHSWL XI s A"A-,A-cBt|tfddDS)zGReturn ``(memory_enabled, user_profile_enabled)`` from resolved config.c3VK|] }tj|d"yw)TrN)r r()rskrs rrtz1get_builtin_memory_store_flags..s#s1Q>>ss&)r!)r%tuple)r+rs @rr&r&s'/G sHrs ssrctjdt}tj||dxs|dS)zGSnapshot store flags and report whether the built-in tool is available.Nrrx)rsetr&)flagss rcheck_memory_requirementsrs;d# * ,Ee$ 8 uQxrc~|dvrddlm}d|d|ddS|j|ry|d k(rd nd }dd |d |dS)zCReturn a shared validation error for an invalid or disabled target.>rmrnr)_bound_error_textFzInvalid memory target 'z'. Use 'memory' or 'user'.r8rNrmzUSER.mdz MEMORY.mdz Built-in z& writes are disabled in memory config.)r8rrU)tools.registryrtarget_enabled)r-rUrr\s rrrsg ''4 *-DVHLf+ghj j F#6)I{E5'9_'`lr ssrcR|jd|jdd}}t||}||S|dk(r%|j||jdxsgS|tvr dd|dd St|d |||jd xsd |jd xsd S)zNReplay a staged write against the store, bypassing the gate (/memory approve).rerUrnrvrkFzUnknown staged action 'z'.rrrVrZrW)r(rrr|)r1r-rerUrs rapply_memory_pendingrs[[*GKK(,KFF'v6L   \)B)HbII ^# -DVHB+OPP & !! $UFGKK 4J4PbRYR]R]^hRiRomo ppru<Save durable facts to persistent memory that survive across sessions. Memory is injected into every future turn, so keep entries compact and high-signal. HOW: make ALL your changes in ONE call via an 'operations' array (each item: {action, content?, old_text?}). The batch applies atomically and the char limit is checked only on the FINAL result — so a single call can remove/replace stale entries to free room AND add new ones, even when an add alone would overflow. The response reports current/limit chars and confirms completion; one batch call finishes the update, so don't repeat it. Use the bare action/content/old_text fields only for a single lone change. WHEN: only for facts that apply to EVERY session regardless of task: who the user is, stable environment facts, standing conventions with no task home. Anything learned while doing a task (procedures, pitfalls, and the user's preferences and corrections for that kind of work) belongs in the task's skill via skill_manage, where it loads only when relevant; memory is injected into every turn and must stay small. IF FULL: an add is rejected with the current entries shown. Reissue as ONE batch that removes or shortens enough stale entries and adds the new one together. TARGETS: 'user' = who the user is (name, role, preferences, style). 'memory' = your notes (environment, conventions, tool quirks, lessons). SKIP: trivial/obvious info, easily re-discovered facts, raw data dumps, task progress, completed-work logs, temporary TODO state (use session_search for those). Reusable procedures belong in a skill, not memory.objectstringzFThe action to perform (single-op shape). Omit when using 'operations'.)typeenum descriptionrmzIWhich memory store: 'memory' for personal notes, 'user' for user profile.zThe entry content. Required for 'add' and 'replace'. For 'replace' it is the COMPLETE new entry text: the whole matched entry is overwritten, so include everything you want to keep. Alias: 'new_text' is also accepted (same full-entry meaning).)rrzREQUIRED for 'replace' and 'remove' (single-op shape): a short unique substring IDENTIFYING the existing entry to modify -- it locates the entry, it is not spliced out. Omit only for 'add'.zAlias for 'content' (single-op shape): the COMPLETE new entry for 'replace', not a patch of old_text. If both are set, 'content' wins.arrayzBatch shape: a list of operations applied atomically in one call against the final char budget. Preferred when making multiple changes or consolidating to make room. Each item is {action, content?, old_text?}.)rrzsEntry content for add/replace. For replace, the COMPLETE new entry (whole entry is overwritten). Alias: 'new_text'.z"Alias for 'content' in a batch op.z3Substring identifying the entry for replace/remove.)rerVrgrW)r propertiesrequired)rritems)rerUrVrWrgrk)namer parameters)z8The enabled built-in store: 'memory' for personal notes.zeTARGET: only 'memory' is enabled for personal notes (environment, conventions, tool quirks, lessons).)z4The enabled built-in store: 'user' for user profile.zWTARGET: only 'user' is enabled for user profile facts (name, role, preferences, style).))rn)rmctjxs t}tjdt d|Dcgc] \}}|s | }}}t j td}|ddtd}}||d<tjt|x}r|\|d<}|jd|}||d Scc}}w) zENarrow the advertised target surface using the availability snapshot.N)rnrmrrrUrrzTARGETS: 'user' = who the user is (name, role, preferences, style). 'memory' = your notes (environment, conventions, tool quirks, lessons).)rr) rr(r&rzipcopydeepcopy MEMORY_SCHEMA_SINGLE_TARGET_TEXTrr^) rtontargetsr target_schemarnarrowed replacements r_build_memory_schema_overridesras ! % % ' K+I+KEd#!"4e<CUQqCGC}\:;J!+L!9(!C]S`Ea;M#M&&**5>::x:4<1 m$k!)) FGRT 'j AADs  CC)registryrHc td|jdd|jdd|jdddDcic]}||j|c}Scc}w) NrerZrUrnr-)rerUr-)rVrWrgrkr)rr()argskwrs rrXrXws_{ Wxx"%dhhx.JRTRXRXY`Ra W#T Ua1dhhqk> U W UsA u🧠)rtoolsetschemahandlercheck_fnemojidynamic_schema_overrides)contextmanageratomic_write_text)utilsrctj|}|tdtd|ddl}ddlm}|t|g|t|j|d|dS)Nzmodule z has no attribute r) warn_oncerx) _PLUGIN_COMPAT_LAZYr(AttributeError__name__ importlibhermes_cli.plugin_compatrgetattr import_module)rrUrrs r __getattr__rse $ $T *F ~wxl2DTHMNN2 h&v& 9**6!95vay AAr)rrrR)rnNN)NrnNNNNN)=__doc__rrKlogging contextvarsrpathlibrhermes_constantsrtypingrrr r r rr rr msvcrtfcntl ImportError getLoggerrrrbool__annotations__rtools.memory_tool_storerrrrr.strrPr|rjr}rrrrr%r&rrrrrrrrHregister contextlibrtimerrrrrrs\J  ",33!,     8 $ BLLblpAqz(5t+<"=>q** NN"*C**tCH~*(SV-*& P O QaqrWXZ [(tCH~(#(DH jc j3 j# jRZ[^R_ j"*4S#X+?"@ jLTUXM jXc]*+%@aijman%@PbfSW/3"g"gC"gS"g[^"g"g2:4S#X;O2P"g ,"g8;"gJ 8htCH~&> 8$sTWx. 8t8DcN+CtuUY[_U_O`t  4   t ts txSRUX?W t q$sCx. q q4PSUXPX> q  40!4g !!6*j ! U ! _ ! h  a %+3=Y"Z,4F{$|-5Fj$k-5F{$| # "*  /) TJY-5H Z,k l BS#X B 0    W' ; = & 7 Bk  E      s5G==HH  H HHHHH