PL j)R UdZddlZddlZddlZejeZddlZddlZddl Z ddl m Z m Z ddlmZmZmZmZddlmZdZddlmZddlmZdd lmZmZegd Zd e d e d e fdZ!d e d e d e fdZ"dZ#ehdZ$e%dej&DZ'd(de'DZ)dZ*dZ+dZ,dZ-ej.Z/da0e1e2d<ej.Z3iZ4ee ee effe2d<de1d e1fdZ5d e1fdZ6dee efd dfdZ7de d dfd Z8de d e1fd!Z9d eee effd"Z:d#d$d%d&ee efd'e;d(e;d eee effd)Zd e;fd.Z?d e@fd/ZAd e;fd0ZBd e1fd1ZCd e1fd2ZDd3e d e1fd4ZEd5eFd eFfd6ZGd7ee d5eFe d ee fd8ZHd9ZId:ZJd;ZKdZNGd?d@e ejOZPePjQePjQePjRePjSePjTdAZUee ePfe2dB<d e1fdCZV dddDdEddFdGe dHee dIee dJe dKe;dLe;d e fdMZWd ee fdNZXdOee d ee fdPZY dddddddQdRe;dGe dSe;dee dTee dUee;dVee dOeee d eeZfdWZ[ ddRe;dGe dHee dOeee dVee dXe;dSe;dYee dZee d[ee d\ee d]ee d^eee dJe fd_Z\d`edRe;dae@dbe@dceej]dGe d ee fddZ^ ddRe;dGe d ee effdeZ_dfed e`eeee efee ffdgZa ddGee dHee dOeee dfeeee efdXee;dhee dieee dJee d e fdjZbdkee fdlZcdmedd edfdnZed edfdoZfd e fdpZgd e fdqZhd e fdrZid edfdsZjdtdudvdwdxdydwdzdyd{d|dwid}e)d~dd{dvdwddydwddyd{d|dwide)dddwddyd{d|dwidddwdDdgddddGgddddwdDdgdddwddyd{d|dwidddgddZkddllmmZmmnZnemjodtdekdeVdejdS)a Delegate Tool -- Subagent Architecture Spawns child AIAgent instances with isolated context, restricted toolsets, and their own terminal sessions. Supports single-task and batch (parallel) modes. The parent blocks until all children complete. Each child gets: - A fresh conversation (no parent history) - Its own task_id (own terminal session, file ops cache) - A restricted toolset (configurable, with blocked tools always stripped) - A focused system prompt built from the delegated goal + context The parent's context only sees the delegation call and the summary result, never the child's intermediate tool calls or reasoning. N)ThreadPoolExecutor TimeoutError)AnyDictListOptional)TOOLSETScustom) file_state)set_approval_callback)base_url_hostnameis_truthy_value) delegate_taskclarifymemory send_message execute_codecommand descriptionreturnc >td||dS)zAuto-deny dangerous commands in subagent threads (safe default). Returns 'deny' so the subagent sees a refusal it can recover from, and never calls input() (which would deadlock the parent TUI). zeSubagent auto-denied dangerous command: %s (%s). Set delegation.subagent_auto_approve: true to allow.denyloggerwarningrrkwargss 7/home/kuhnn/.hermes/hermes-agent/tools/delegate_tool.py_subagent_auto_denyrIs+  NN ? 6c >td||dS)zAuto-approve dangerous commands in subagent threads (opt-in YOLO). Only installed when delegation.subagent_auto_approve=true. Returns 'once' so the subagent proceeds without blocking the parent UI. z1Subagent auto-approved dangerous command: %s (%s)oncerrs r_subagent_auto_approver#Ws)  NN; 6r ct}|dd}t|rtStS)aReturn the callback to install into subagent worker threads. Config key: delegation.subagent_auto_approve (bool, default False). Reads via the same _load_config() path as the rest of delegate_task so priority is config.yaml > (no env override for this knob) > default. subagent_auto_approveF) _load_configgetrr#rcfgvals r_get_subagent_approval_callbackr+ds= ..C '')5 1 1Cs&%% r >rlmoasafe debugging delegationc#K|]T\}}|tv|d#td|dgDP|VUdS)zhermes-c3(K|] }|tvVdSN)DELEGATE_BLOCKED_TOOLS.0ts r z.s(KK++KKKKKKr toolsN)_EXCLUDED_TOOLSET_NAMES startswithallr')r6namedefns rr8r8{sd *** OOI & &+ KKTXXgr5J5JKKK K K+ ****r , c#"K|] }d|dV dS)'N)r6ns rr8r8s*CC1h!hhhCCCCCCr F _spawn_paused_active_subagentspausedcpt5t|atcdddS#1swxYwYdS)zGlobally block/unblock new delegate_task spawns. Active children keep running; only NEW calls to delegate_task fail fast with a "spawning paused" error until unblocked. Returns the new state. N)_spawn_pause_lockboolrF)rHs rset_spawn_pausedrLs| V s +//cRt5tcdddS#1swxYwYdSr3)rJrFrBr ris_spawn_pausedrNso s   recordc|d}|sdSt5|t|<ddddS#1swxYwYdS)N subagent_id)r'_active_subagents_lockrG)rOsids r_register_subagentrTs **] # #C  ((!'#((((((((((((((((((s 9==rQc|t5t|dddddS#1swxYwYdSr3)rRrGpop)rQs r_unregister_subagentrWs 11k4000111111111111111111s 155cPt5t|}dddn #1swxYwY|sdS|d}|dS |d|dn4#t$r'}t d||Yd}~dSd}~wwxYwdS)aCRequest that a single running subagent stop at its next iteration boundary. Does not hard-kill the worker thread (Python can't); sets the child's interrupt flag which propagates to in-flight tools and recurses into grandchildren via AIAgent.interrupt(). Returns True if a matching subagent was found. NFagentzInterrupted via TUI ()z!interrupt_subagent(%s) failed: %sT)rRrGr' interrupt Exceptionrdebug)rQrOrYexcs rinterrupt_subagentr_s  44"&&{33444444444444444 u JJw  E }u > >>>????  8+sKKKuuuuu 4s$/33A22 B#<BB#ct5dtDcdddS#1swxYwYdS)uSnapshot of the currently running subagent tree. Each record: {subagent_id, parent_id, depth, goal, model, started_at, tool_count, status}. Safe to call from any thread — returns a copy. cJg|] }d|D!S)c&i|]\}}|dk ||S)rYrBr6kvs r z4list_active_subagents...s# 8 8 8da1<z)list_active_subagents..s>    9 8aggii 8 8 8   r N)rRrGvaluesrBr rlist_active_subagentsrks     &--//                     s #8<< i@ max_entries max_charsresultrnroct|tr|dnd}t|tsgSg}i}|D]}t|ts|ddkro|dpgD]W}|d}|dpi} |r't | dpd ||<Xt |D]}t ||krnt|tr|dd krF|d pd } t| tst | } t| } ||d pd d } | d|} || | | d | |S)u8Pull the last N tool-call results from a child's conversation. Powers the overlay's "Output" section — the cc-swarm-parity feature. We reuse the same messages list the trajectory saver walks, taking only the tail to keep event payloads small. Each entry is ``{tool, preview, is_error}``. messagesNrole assistant tool_callsidfunctionr=toolcontent tool_call_id)rxpreviewis_error) isinstancedictr'liststrreversedlen_looks_like_error_outputappendreverse)rprnrorrtailpending_call_by_idmsgtctc_idfnryr} tool_namer|s r_extract_output_tailrs*4FD)A)AKvzz*%%%tH h % % "$D)+NN#t$$   776??k ) )ggl++1r N Nt VVJ''-2N03BFF6NN4Lf0M0M&u-!!SS t99 # # E#t$$ 6(A(A '')$$*'3'' #'llG+G44&**377>+B+B+Hb&QQ *9*% Y7QQRRRRLLNNN Kr ryc|sdS|}|ds|dr tj|}t |t re|drdSt|dpd }|dvrdSn#t$rYnwxYw| r>| d  nd}|d p>|d p)|d p|d S)aConservative stderr/error detector for tool-result previews. The old heuristic flagged any preview containing the substring "error", which painted perfectly normal terminal/json output red. We now only mark output as an error when there is stronger evidence: - structured JSON with an ``error`` key - structured JSON with ``status`` of error/failed - first line starts with a classic error marker F{[errorTstatusrz>rfailedfailuretimeoutrzerror:zfailed:z traceback z exception:) lstripr;jsonloadsr~rr'rstriplowerr\ splitlines)ryheadparsedrfirsts rrrs u >>  D s ts33  Z((F&$'' ::g&& 4VZZ117R88>>@@FFHHFFF4    D 8?7I7I7K7K SG    # ) ) + + 1 1 3 3 3QSE "" *   I & & *   L ) ) *   L ) ) s>CA C C C rhc||sdSt|}|dvr|Std|dS)a/Normalise a caller-provided role to 'leaf' or 'orchestrator'. None/empty -> 'leaf'. Unknown strings coerce to 'leaf' with a warning log (matches the silent-degrade pattern of _get_orchestrator_enabled). _build_child_agent adds a second degrade layer for depth/kill-switch bounds. Nleaf>r orchestratorz1Unknown delegate_task role=%r, coercing to 'leaf')rrrrr)rhr_norms r_normalize_roler8s\ yyv VV\\^^ ! ! # #F )))  NNFJJJ 6r ct}|d}| tdt|}|dkrtd||S#t tf$r+td|ttcYSwxYwtj d}|r< tdt|S#t tf$r tcYSwxYwtS)ayRead delegation.max_concurrent_children from config, falling back to DELEGATION_MAX_CONCURRENT_CHILDREN env var, then the default (3). Users can raise this as high as they want; only the floor (1) is enforced. Uses the same ``_load_config()`` path that the rest of ``delegate_task`` uses, keeping config priority consistent (config.yaml > env > default). max_concurrent_childrenNrE zxdelegation.max_concurrent_children=%d: each child consumes API tokens independently. High values multiply cost linearly.zNdelegation.max_concurrent_children=%r is not a valid integer; using default %d"DELEGATION_MAX_CONCURRENT_CHILDREN) r&r'maxintrr TypeError ValueError _DEFAULT_MAX_CONCURRENT_CHILDRENosgetenv)r)r*rpenv_vals r_get_max_concurrent_childrenrIs# ..C ''+ , ,C  4CHH%%F{{I M:& 4 4 4 NN#0     4 3 3 3 4i<==G4 4q#g,,'' ':& 4 4 43 3 3 3 4 ++s#?A''9B#"B#=CC54C5ct}|d}|V tdt|S#tt f$r$t d|tYnwxYwtj d}|r5 tdt|S#tt f$rYnwxYwttS)zRead delegation.child_timeout_seconds from config. Returns the number of seconds a single child agent is allowed to run before being considered stuck. Default: 600 s (10 minutes). child_timeout_secondsNg>@zKdelegation.child_timeout_seconds=%r is not a valid number; using default %d DELEGATION_CHILD_TIMEOUT_SECONDS) r&r'rfloatrrrrDEFAULT_CHILD_TIMEOUTrr)r)r*rs r_get_child_timeoutros ..C '') * *C  tU3ZZ(( (:&    NN#%       i:;;G tU7^^,, ,:&    D  & ' ''s#A2A98A9B00CCct}|d}|tS t|}n?#tt f$r+t d|ttcYSwxYwtttt|}||kr(t d|tt||S)aLRead delegation.max_spawn_depth from config, clamped to [1, 3]. depth 0 = parent agent. max_spawn_depth = N means agents at depths 0..N-1 can spawn; depth N is the leaf floor. Default 1 is flat: parent spawns children (depth 1), depth-1 children cannot spawn (blocked by this guard AND, for leaf children, by the delegation toolset strip in _strip_blocked_tools). Raise to 2 or 3 to unlock nested orchestration. role="orchestrator" removes the toolset strip for depth-1 children when max_spawn_depth >= 2, enabling them to spawn their own workers. max_spawn_depthNzFdelegation.max_spawn_depth=%r is not a valid integer; using default %dzCdelegation.max_spawn_depth=%d out of range [%d, %d]; clamping to %d) r&r' MAX_DEPTHrrrrrr_MIN_SPAWN_DEPTHmin_MAX_SPAWN_DEPTH_CAP)r)r*ivalclampeds r_get_max_spawn_depthrs ..C ''# $ $C {3xx z " W      "C(9A:9A:ct}|dd}t|tr|St|tr(|dvSdS)aGlobal kill switch for the orchestrator role. When False, role="orchestrator" is silently forced to "leaf" in _build_child_agent and the delegation toolset is stripped as before. Lets an operator disable the feature without a code revert. orchestrator_enabledT>1onyestrue)r&r'r~rKrrrr(s r_get_orchestrator_enabledrsp ..C ''($ / /C#t #sAyy{{  ""&@@@ 4r cft}t|ddS)zFWhether narrowed child toolsets should keep the parent's MCP toolsets.inherit_mcp_toolsetsTdefault)r&rr')r)s r_get_inherit_mcp_toolsetsrs+ ..C 377#9::D I I IIr r=c"|sdSt|drdS ddlm}|jt|}n#t $rd}YnwxYwt |o!t|dS)zDReturn True for canonical MCP toolsets and their registered aliases.Fzmcp-Tr)registryN)rr;tools.registryrget_toolset_alias_targetr\rK)r=rtargets r_is_mcp_toolset_namers u 4yyF##t++++++223t99==  93v;;11&99 : ::s#A AAparent_toolsetsct}|D]A}tj|}|r)||dgB|st|St|}tjD]Y\}}||vr |dg}|r7t||r||Z|S)a@Expand composite toolsets so individual toolset names are recognized. When a parent uses a composite toolset like ``hermes-cli`` (which bundles all core tools), the child may request individual toolsets such as ``web`` or ``terminal``. A simple name-based intersection would reject them because ``"web" != "hermes-cli"``. This helper collects the tool names from each parent toolset, then adds the names of any individual toolsets whose tools are a *subset* of the parent's available tools. The original parent toolset names are preserved. r9)setr r'updatergissubsetadd)rparent_tool_namests_namets_defexpandedts_toolss r_expand_parent_toolsetsrs!UU">>g&&  >  $ $VZZ%<%< = = = $?###?##H#>++"" h   ::gr**  "H ../@AA " LL ! ! ! Or child_toolsetsct|}t|D]*}t|r||vr||+|S)zFAppend any parent MCP toolsets that are missing from a narrowed child.)rsortedrr)rr preserved toolset_names r_preserve_parent_mcp_toolsetsrs]^$$I//++  - - +,i2O2O   \ * * * r 2X()terminalfilewebc.eZdZdZdZdZdZdZdZdZ dZ d S) DelegateEventuFormal event types emitted during delegation progress. _build_child_progress_callback normalises incoming legacy strings (``tool.started``, ``_thinking``, …) to these enum values via ``_LEGACY_EVENT_MAP``. External consumers (gateway SSE, ACP adapter, CLI) still receive the legacy strings during the deprecation window. TASK_SPAWNED / TASK_COMPLETED / TASK_FAILED are reserved for future orchestrator lifecycle events and are not currently emitted. zdelegate.task_spawnedzdelegate.task_progresszdelegate.task_completedzdelegate.task_failedzdelegate.task_thinkingzdelegate.tool_startedzdelegate.tool_completedN) __name__ __module__ __qualname____doc__ TASK_SPAWNED TASK_PROGRESSTASK_COMPLETED TASK_FAILED TASK_THINKINGTASK_TOOL_STARTEDTASK_TOOL_COMPLETEDrBr rrrsA  +L,M.N(K,M/3r r) _thinkingzreasoning.availablez tool.startedztool.completedsubagent_progress_LEGACY_EVENT_MAPcdS)z > t    nd33 eT** J     7??27#5#5c)nn#E#EFFDD    H  7==   27==#6#6 KKK 4sA B'' B43B4toolsetsc(hdfd|DS)z0Remove toolsets that contain only blocked tools.>rrr0code_executioncg|]}|v| SrBrB)r6r7blocked_toolset_namess rriz(_strip_blocked_tools..s$ B B B!1,A#A#AA#A#A#Ar rB)rr s @r_strip_blocked_toolsr!s2 C B B Bx B B BBr rQ parent_iddepthmodelr task_index task_countr#r$r%c  t|ddt|ddssdSdkr ddzdnd|pdd g d gd tttfff d dd td tdtf fd  dd tdtf f d } fd} | | _| S)uBuild a callback that relays child agent tool calls to the parent display. Two display paths: CLI: prints tree-view lines above the parent's delegation spinner Gateway: batches tool names and relays to parent's progress callback The identity kwargs (``subagent_id``, ``parent_id``, ``depth``, ``model``, ``toolsets``) are threaded into every relayed event so the TUI can reconstruct the live spawn tree and route per-branch controls (kill, pause) back by ``subagent_id``. All are optional for backward compat — older callers that ignore them still produce a flat list on the TUI. Returns None if no display mechanism is available, in which case the child agent runs with no progress callback (identical to current behavior). _delegate_spinnerNtool_progress_callbackrEr] rzrrc d}|d<|d<|d<|d< t |d<d|d<|S) N)r&r'rrQr#r$r%rr tool_count)r) kw _tool_countr$ goal_labelr%r#rQr'r&rs r_identity_kwargsz8_build_child_progress_callback.._identity_kwargss$$    " +B}   'B{O  BwK  BwK  !(^^BzN&q>< r event_typerr|csdS}|| ||||fi|dS#t$r&}td|Yd}~dSd}~wwxYw)NzParent callback failed: %s)rr\rr]) r3rr|argsrpayloader2 parent_cbs r_relayz._build_child_progress_callback.._relays  F""$$v : Ij)Wd F Fg F F F F F : : : LL5q 9 9 9 9 9 9 9 9 9 :s 4 A$AA$c |dkrrsrqtdkr dddzn} dd|n2#t$r%}td|Yd}~nd}~wwxYwdd|ppdi|dS|d kr dd|i|dSt |t r|}nEt|}|) t |}n#ttf$rYdSwxYw|t j kr|p|pd}rrt|dkr |dddzn|} dd |d n2#t$r%}td|Yd}~nd}~wwxYwd | dS|t j krdS|t j kr|p|pd} rQ| rO dd| n2#t$r%}td|Yd}~nd}~wwxYwrD d| n2#t$r%}td|Yd}~nd}~wwxYwdSdxxdz cc<Mt5t} | d| d<|pd| d<dddn #1swxYwYr|r t|dkr |dddzn|pd}ddlm} | |pd} dd| d|} |r | d|d z } | n2#t$r%}td|Yd}~nd}~wwxYwrud||||pdtkr?d}dd| dSdSdS)Nsubagent.start7z... u ├─ 🔀 zSpinner print_above failed: %sr|rzsubagent.completeu ├─ 💭 ""zsubagent.thinkingr|rz Parent callback relay failed: %srrEr. last_tool#)get_tool_emojiu├─ z "z subagent.toolr?subagent.progress🔀 )r;r>)r print_abover\rr]r~rrr'rrrrrrRrG agent.displayrCrrclear)r3rr|r5rshortr7eventr summary_textrecrCemojilinesummary _BATCH_SIZE_batchr9r0r1r8prefixspinnerrQs r _callbackz1_build_child_progress_callback.._callbacks ) ) ) F: F14Z21E1EZ_u,,:F''(GF(G(G(G(GHHHH FFFLL!A1EEEEEEEEF F S SW-H -Hb SF S S S F , , , F B B B6 B B B F j- 0 0 EE%))*55E})*55EE"I.FF M/ / /-i-2D F/24yy2~~crcU**4F''(IF(I(I(I(I(IJJJJ FFFLL!A1EEEEEEEEF F& 5 5 5 5 F M5 5 5 F M/ / /%552L F< FF''(NF(N(N (N(NOOOO FFFLL!A1EEEEEEEEF HHI1f3Ll3L3LMMMM HHHLL!CQGGGGGGGGH F A!  "' 7 7'++K88?(3AC %'0BC $  7 7 7 7 7 7 7 7 7 7 7 7 7 7 7  B%"7||b00"%%m  5 4 4 4 4 4"N9?33E9v99e99i99D 'e& B##D)))) B B B =qAAAAAAAA B   F?Iw = = = MM)/r * * *6{{k))))F++*4MF4MG4M4MNNNN    *)sA A:A55A:C$$C98C97E FE>>FG H (HH H$$ I.II1/J,,J03J0 L M)M  Mcr?r?d}dd|dSdSdS)z._flush[sl   ii''G F&0I0I0I0I J J J J LLNNNNN    r )NNN)rrrrrrW)r&rrr'rQr#r$r%rrUrWrQrRr2r9r0r1r8rSrTs` `````` @@@@@@@@@r_build_child_progress_callbackrXs6l$7>>G &>EEI 9t(2A~~ #a # # # #2F*"##%%JKF#Kd38n(KO : : :$' :9< : : : : : : :FJee"e47eeeeeeeeeeeeeeNI r max_iterationsoverride_provideroverride_base_urloverride_api_keyoverride_api_modeoverride_acp_commandoverride_acp_argsc  9:;<ddlm}ddl}t|dddz}t }t o||k}|dkr|r|nd}d|d |jdd }t|d d}td|dz }t}t|d d}|t|}n?|r)t|d rddl ;;dd&|1d'|2d(|3d)|4d*|5d?9d@d}6t|dAd|6_&||6_'||6_(||6_)||6_*||6_+tY|#|}7|7|7|6_-t|dBrbt|dCd}8|8r5|85|j.|6dddn #1swxYwYn|j.|69rA 9dD|En2#tF$r%}/tB$dF|/Yd}/~/nd}/~/wwxYw|6S)Ha Build a child AIAgent on the main thread (thread-safe construction). Returns the constructed child agent without running it. When override_* params are set (from delegation config), the child uses those credentials instead of inheriting from the parent. This enables routing subagents to a different provider:model pair (e.g. cheap/fast model on OpenRouter while the parent runs on Nous Portal). r)AIAgentN_delegate_depthrErrzsa-- _subagent_idenabled_toolsetsvalid_tool_namescBh|]}|xSr3)get_toolset_for_tool)r6r= model_toolstss r z%_build_child_agent..s<   !66t<<<I IIIr cg|]}|v| SrBrB)r6r7expanded_parents rriz&_build_child_agent..s#FFFo1E1E!1E1E1Er r0rapi_key_client_kwargsr%r"rrc|sdS d|dS#t$r&}td|Yd}~dSd}~wwxYw)Nrz(Child thinking callback relay failed: %s)r\rr])rr7child_progress_cbs r_child_thinkingz+_build_child_agent.._child_thinkingsy  L!!+t44444 L L L GKKKKKKKKK Ls  AAAproviderrzapi_mode acp_commandacp_argsz copilot-acpchat_completionsreasoning_configreasoning_effort)parse_reasoning_effortzAUnknown delegation.reasoning_effort '%s', inheriting parent levelz.Could not load delegation reasoning_effort: %s_fallback_chainproviders_allowedproviders_ignoredproviders_order provider_sortopenrouter_min_coding_scorebase_urlrY max_tokensprefill_messagesfallback_model quiet_modeTephemeral_system_prompt log_prefix [subagent-]platformskip_context_files skip_memoryclarify_callbackthinking_callback session_db _session_dbparent_session_id session_idr*iteration_budget _print_fn_active_children_active_children_lockzsubagent.spawn_requestedr@z spawn_requested relay failed: %srB)/ run_agentrauuidrrruuid4hexrr&rhasattrrjrgDEFAULT_TOOLSETSrrrr!rrrr rpr'rXrr%rrrhermes_constantsr{rrr\r]rrrb_delegate_rolere_parent_subagent_id_subagent_goal_resolve_child_credential_pool_credential_poolr)=r&rrrr%rYr'rrZr[r\r]r^r_rsra_uuidr max_spawnorchestrator_okeffective_rolerQparent_subagent_id tui_depthdelegation_cfgparent_enabledrrworkspace_hint child_promptparent_api_keyeffective_model_for_cbchild_thinking_cbrseffective_modeleffective_providereffective_base_urleffective_api_key_parent_providereffective_api_modeeffective_acp_commandeffective_acp_argsparent_reasoningchild_reasoningdelegation_effortr{rr^parent_fallbackchild_providers_allowedchild_providers_ignoredchild_providers_orderchild_provider_sort!child_openrouter_min_coding_scorechild child_poollockrrrnrjrks= @@@@r_build_child_agentrfsJ >"!!!!!,(91==AK$&&I/11MkI6MO"n444TTvN= <?? ''L,N,Nl+++,\::N- % ! L\9d;;N D 6F G GD%488CC#JglGT&J&J 7 $$   " , L# L$ L L L L L L,1|1O*UglJPT.U.U*Cl.C(:N |Z>>D"$. / / /!$\:tDD0GmT55  ( lJ339r !5 $0+/|-?FF&OL 2 23E F F L"MMSSUU   ? ? ? ? ? ?++,=>>F!"(W% LLL EsKKKKKKKKLl,=tDDLO&l4GNN%l4GNN#L2CTJJ!,FF(/ >[]a(b(b%#"&"& $" G   ## !! o $#   $#   *)  $# &~ <t<<< ) !/A4HHH ' ( 4 !-   . ----! "&&# $ 4% &D' () *,++ ,<===- .", dCCC/ 0211 2213 4.-5 6*)7 8%F$E9 : 10; <= E@lK>>EO'E*E%E 2EE00BLQQJ!+|/008|%> N-N((N->U%%U),U) V W &WW rtimeout_secondsduration_seconds worker_threadc4 ! ddlm}ddl}ddl}ddl} |} | dz } | ddn#t $rYdSwxYwt|ddpd|} |j d } | d | d | d z }g!dFdtddf!fd }|d|d|j |d |d|d||d| |d|d|d|dd|d |d|pd }t|dkr |dddz}||pd|d |ddD]`} t||d}t|tr|d kr |d!|d"|B#t $r|d!|d#Y]wxYw|d |d$t|d%d}|d&|t|d'd}|rH|d(t| |d)t|n#t $rYnwxYw|d |d* t|d+dpt|d,dpd }|d-t|tr"t|d.nd/|d0t|trt|nd/n&#t $r}|d1|d2Yd}~nd}~wwxYw t|d3d}|dt#j|t4}|d5t||d6t|d.n&#t $r}|d7|d2Yd}~nd}~wwxYw|d |d8 |}|D]\}}|d!|d"|n&#t $r}|d9|d2Yd}~nd}~wwxYw|d |d:||r|}||j}|S| |}|D]:}|d;D]} |d!| ;n%|d<n| |d=n |d>|d |d?|d@|dA|dB|dC|d;!d.Dt|S#t $r&}t<dE|Yd}~dSd}~wwxYw)Ga,Write a structured diagnostic dump for a subagent that timed out before making any API call. See issue #14726: users hit "subagent timed out after 300s with no response" with zero API calls and no way to inspect what happened. This helper writes a dedicated log under ``~/.hermes/logs/subagent--.log`` capturing the child's config, system-prompt / tool-schema sizes, activity tracker snapshot, and the worker thread's Python stack at timeout. Returns the absolute path to the diagnostic file, or None on failure. r)get_hermes_homeNlogsT)parentsexist_okreidxz %Y%m%d_%H%M%Szsubagent-timeout-rcz.logrzrOrc2|dSr3)r)rOliness r_wz-_dump_subagent_timeout_diagnostic.._ws LL     r u.# Subagent timeout diagnostic — issue #14726z # Generated: z ## Timeoutz task_index: z subagent_id: z configured_timeout: sz actual_duration: z.2fz## Goalz ...[truncated]z(empty)z## Child config) r%rtrurrYrrrrrrbr z: z: z ## Toolsetsrfz enabled_toolsets: rgz loaded tool count: z loaded tools: z## Prompt / schema sizesr system_promptz system_prompt_bytes: zutf-8zn/az system_prompt_chars: z system_prompt: r9rz tool_schema_count: z tool_schema_bytes: z tool_schema: z z z## NoteszG This file is written ONLY when a subagent times out with 0 API calls.zI 0-API-call timeouts mean the child never reached its first LLM request.zG Common causes: oversized prompt rejected by provider, transport hang,z< credential resolution stuck. See issue #14726 for context.)encodingz+Subagent timeout diagnostic dump failed: %s)rz) rrdatetimesys tracebackmkdirr\rnowstrftimer isoformatrrr~rencoderdumpsget_activity_summaryrgis_alive_current_framesr'ident format_stackrstripsplit write_textrrr)"rr&rrrrr_dt_sys _traceback hermes_homelogs_dirrQrk dump_pathr _goal_previewattrr*enabled tool_names sys_promptr^ tools_schema _schema_jsonrPrdreframes worker_framestack frame_linesubrs" @r!_dump_subagent_timeout_diagnosticrsw(y444444&&&&%o'' '  NN4$N 7 7 7 7   44 e^T::P>PJ>P>P \     ( ( 9 9I;IIIIII   S $        <===  ;3<++--7799 ; ;<<< 2 <  /: / /000  0; 0 0111  6O 6 6 6777  :#3 : : : :;;; 2 9 **,, }   $ $)%4%03DDM = %I&&& 2   . .D  .eT400c3''DJ,>,>'''''(((( . . .,,,,----- . 2 =%!3T::  .7 . .///U$6==   B8s:88 9 9 9 ?6*+=+=??@@@@     2  %&&& 3 (A4HH5/488  BtJWacfLgLg)rZ->->w-G-G)H)H)Hmrtt u u u BdJzSV3|+<+<>>???N3|/B/B7/K/K+L+LNNOOO 1 1 1 B//// 0 0 0 0 0 0 0 0 1 2  !!! :0022G  $ $1???Q??#### $ : : : B8#888 9 9 9 9 9 9 9 9 : 2  .///  $)?)?)A)A $))++F!::m&9::L'"// =="'''J)002288>>'':::''34444  " B, - - - - B1 2 2 2 2 :  TUUU  VWWW  TUUU  IJJJTYYu--@@@9~~ DcJJJttttts!W'=W' A W' A  E)W'5>G43W'4H W'HA&W'7JW' J W'J  W':BMW' M9 M4/W'4M99W'=A7O54W'5 P?PW'PW'2?Q21W'2 R<R W'REW'' X1XXc T)GHIJKLtj}tdd}ddl}tdt |j}tdd} d} | | } | o | } | %tdr | n2#t$r%} t d| Yd} ~ nd} ~ wwxYwtjGdgHdgIdgJGHIJfd} tj| d }td d}t!|t"r|nd}|rtd d }t!|t$rt'd|d z nd}tdd}t)|t!|t"r|nd|t!tddt"rtddndtjddd  ||rA |dn2#t$r%}t d|Yd}~nd}~wwxYwddl}|p&dd|jddLtdd}tj}|r!t t3j|ng}t7}t9d t:t=f}ddiKKLfd}||} | |}n#t$r} tdr!ntdrd _"n#t$rYnwxYwt!|tFtHf}tKtj|z d} t&d |rd!nd"tO|j(| d}!d}" )}#t%|#*d#dpd}"n#t$rYnwxYw|rf|"dkr`tWtY|tY| K*d$}!|!rt&d%|!|r; |d&|rd'| d(nt#||rd)nd*| d+,n#t$rYnwxYw|r!|"dkrd-|d.}$|!r|$d/|!z }$nd-|d0|"d1}$nt#|}$|rd)nd*d|$|rd)nd*|"| td2d|!d3 cYd}~|-d45G.|j/|0d6|rtc|| K| I | 2| n2#t$r%} t d7| Yd} ~ nd} ~ wwxYwddl}tdd}%t!|%trt |%|_td8r td9d}&|&r5|&5j34dddn #1swxYwYnj34n9#tjtlf$r%}t d:|Yd}~nd}~wwxYw td;r7SS#t$rt d<YSwxYwd}~wwxYw |-d45n#|-d45wxYw|rXt|d=rH |8n2#t$r%}t d>|Yd}~nd}~wwxYwtKtj|z d} |*d?pd+}'|*d@d4}(|*dAd4})|*dBd}*|)rdA}+n|'rd@}+ndC}+g},i}-|*dDpg}.t!|.tr|.D]}/t!|/trs|/*dEdFkr|/*dGpgD]}0|0*dHi}1|1*dIdJtu|1*dKd+dL}2|,;|2|0*dM}3|3r|2|-|3<|/*dEdNkr|/*dOd+}4ty|4}5tu|4|5rd*ndPdQ}6|/*dR}3|3r|-*|3nd}7|7|7=|6i|,r|,dS=|6|)rdA}8n|(rd@}8ndT}8tdUd}9tdVd}:tdd};|+|'|*| t!|;t"r|;nd|8t!|9t$tXfr|9ndt!|:t$tXfr|:nddW|,td2dt!tdXdYt$tXfr tYtdXdYpdYndYdZ }<|+dCkr|*d*d[||||}=|=rtd\|=@D}>|>rxd]d^0|>ddztu|>dkrd_tu|>dz d`nd+zdaz}?|<*dbr||d+|g}Cn#t$ri}CYnwxYwtLfdh|CADddg}Dt|ddij}E|'r |'ddkn|<*d*d+|+| |'r |'ddln|<*d*d+t!|9t$tXfrt%|9ndt!|:t$tXfrt%|:ndt!|At$tXfrt%|Andt!|*t$tXfrt%|*nd|B|D|Edm }F|@+ tY|@|Fdn<n#ttjf$rYnwxYw|r< |dti|Fn2#t$r%}t do|Yd}~nd}~wwxYw|z delegate_task: subagent running z (iteration /rZlast_activity_descrz) wait_HEARTBEAT_INTERVALrrr'_HEARTBEAT_STALE_CYCLES_IN_TOOL_HEARTBEAT_STALE_CYCLES_IDLErrr\)touchdesc child_summary child_tool child_iter child_max iter_advanced tool_changed stale_limit child_desc_heartbeat_stop_last_seen_iter_last_seen_tool _stale_countrrr&s r_heartbeat_loopz*_run_single_child.._heartbeat_loopYs!&&':;;B #L*;TBBE BjBBBD6  % : : < < *..~>> *../?CC )--.>BB !+_Q-? ? )_Q-??  )L))3OA&)3OA&&'LOO OOOq(OOO"6335  ?k11NNL"$Q".h E @:@@&0@@3<@@@D "/!2!23G!L!LJ!DzDD*4DD7@DDD     d     C"&&':;;B B B B B s*CE3E EE E E-,E-T)rdaemonrerbrErr%running) rQr#r$rr% started_atrr.rYr;r@z"Progress callback start failed: %sz subagent-rcrd_current_task_id) max_workers initializerinitargsr7c^tjd<S)Nr7) user_messagetask_id) threadingcurrent_threadrun_conversation)_worker_thread_holderr child_task_idrsr_run_with_thread_capturez3_run_single_child.._run_with_thread_captures:)2)A)C)C !# &))!%* r )rr[_interrupt_requestedrzSubagent %d %s after %.1fsz timed outzraised r)rr&rrrru;Subagent %d 0-API-call timeout — diagnostic written to %sr>zTimed out after rrrrz)r|rrrPzSubagent timed out after us without making any API call — the child never reached its first LLM request (prompt construction, credential resolution, or transport may be stuck).z Diagnostic: zs with u[ API call(s) completed — likely stuck on a slow API call or unresponsive network request.r) r&rrPr exit_reason api_callsr _child_rolediagnostic_pathF)rr,z&Failed to release credential lease: %srrz/Could not remove child from active_children: %sclosez,Failed to close child agent after delegationrWz"Progress callback flush failed: %sfinal_response completed interruptedr*rrrrsrtrurwr=unknown arguments)rx args_bytesrvrxryok) result_bytesrr{rYsession_prompt_tokenssession_completion_tokens)inputoutputsession_estimated_cost_usd) r&rrPr*rr%r)tokens tool_tracer+_child_cost_usdz$Subagent did not produce a response.ch|] }|D]}| SrBrB)r6pathsps rrlz$_run_single_child..s%OOOuOOAOOOOr uX [NOTE: subagent modified files the parent previously read — re-read before editing: r?z (+z more)rrP stale_pathsz%file_state sibling-write check failedexc_infosession_reasoning_tokensrc0h|]\}}|k |D]}|SrBrB)r6tidrArBr&s rrlz$_run_single_child..sC   C-''('''''r rrmi) r|rrrP input_tokens output_tokensreasoning_tokensr* files_read files_written output_tailcost_usdz'Progress callback completion failed: %srz] failedz*Progress callback failure relay failed: %sr&rrPrr*rr+rF)Ftime monotonicrrjr_last_resolved_tool_names acquire_leasecurrentrrr\rr]r"EventThreadr~rrrrTstartrrrr known_readsrr_set_subagent_approval_cbr+submitrpr[r(FuturesTimeoutErrorrroundrtyperrr'rrshutdownrrrrW release_leaserremoverUnboundLocalErrorr-rWrrrrr writes_sincerrjrgrrlogging exception)Mr&rrr_kwargs child_startrrrj_saved_tool_namesrleased_cred_id leased_entryr^r_heartbeat_thread_raw_sidre _raw_depth _tui_depth _parent_sidr7rparent_task_id wall_startparent_reads_snapshot child_timeout_timeout_executorr' _child_futurerp _timeout_exc is_timeoutdurationr,child_api_calls_summary_errsaved_tool_namesrrPr/r0r*rr> trace_by_idrrrrrentry_trryr} result_metarr) _input_tokens_output_tokens_modelentrysibling_writes mod_pathsreminder _cost_usd_reasoning_tokens _files_read_files_written_map_files_written _output_tailcomplete_kwargsrrrrr%r&sM```` @@@@@@r_run_single_childr)s.""K '?FF +T+2W-X-X 2D99JN#1133  % S)1133 +?Q0R0R+**<888 S S S LcRRRRRRRR S o''OcOfO3LCCCCCCCCCCCJ"(MMM und33H)(C88B88dL U$5q99 /9*c/J/JQSJN+++PQ e%:DAA +,6{C,H,HR[[d#"'%$"?"?EEGE7D111"ikk#     $hI!!!  F F!!"2DAAAAA F F F A1EEEEEEEE F $X(XJ(X(XARSUTUSUAV(X(X  /A4HHY[[ ))w,6CyyG,$,&u.>EE#2         & &E & 2 2 2^   " .  " "1 " - - -  /  . . .  !n&@ L((8888 L L L EsKKKKKKKK L "5*FMM & - - K489I4J4JK 1 BB  (CQGG..%" ()&#66@VVD&&0 U|%L%LSMMRS'1#u&N&NUNNTU %#5*:DAAE#?EE%Lge%A3GGN3OOO A"! "! F X  #ZZ1WXXE'N Q ="7 =!+!8"J0E"""= &OO(=(=(?(?OOO!!I!=K"ii "1" 667 $'y>>A#5#5!Ac)nnq&8 @ @ @ @%' ""!!99Y//=/4Y/?(/JE),,3>%&&&+5i#u+N+NUYTU%+''+ + *   .3I.>.> ++z*      K K!!IIIIII K K K FJJJJJJJJ K@   " .  " "1 " - - -  /  . . .  !n&@ L((8888 L L L EsKKKKKKKK L "5*FMM & - - K489I4J4JK 1 > C-C((C-A@73 IA@7 I0 I+&A@7+I00C A@7=M]2 ]![99[>$\(($]]]]2A@72^  A@7 ^54A@75 _$?_A@7_$$M#A@7Cp A@7 &p30A@72p33%A@7)rA@7 rA@7rA@7r-,A@7- r<9A@7;r<#'$A@ @ $A@4@3A@4@7 AKA>AKB*AB,B+AKB, ACB6ACCAKCACC(AKDAKDAKEAE%E% AFE/AFFAFG&AI G;AH"H AI H"AH& H&AI H)AH& H*AI I AI?IAI:I:AI?J$AJ)J)$AKKAKKAKKAKKAAR'L#AL9L8AR'L9 AM(MAM#MAR'M#AM(M(AAR'N:APOAO6O* APO6AO: O:APO=AO: O>APPAR'PAQP.AQQ AR'QAQQAR'Q$AQ=Q;AR'Q=$AR$R!AR'R#AR$R$AR'taskscDt|tsdS|}|sdS tj|}n)#tj$r}dd|jdfcYd}~Sd}~wwxYwt|tsddt|j dfS|dfS)NNN)N7Provide either 'goal' (single task) or 'tasks' (batch).z`tasks must be a JSON array of task objects; received a string that could not be parsed as JSON ().z3tasks must be a JSON array of task objects; parsed z instead.) r~rrrrJSONDecodeErrorrrr_r)rrawrr^s r_recover_tasks_from_json_stringrgs eS ! !z ++--C ONN C      =14 = = =        fd # #  0F||$ 0 0 0   4<sAA, A'!A,'A,rvrwc |tdStrtdSt|} t|dd} t } | | kr%t jdd| d| d td iSt} | d t} |"|| krt d || | } t| |}n3#t$r&}tt|cYd}~Sd}~wwxYwt!}t#|\}}|rt|S||}|rNt%|t&r9t)||kr#td t)|d|dS|}nC|r2t%|tr|r |||| dg}ntdS|stdSt-|D]\}}t%|t.s*td|dt1|jdcS| ddstd|dcSt5j}g}t)|}d|D}ddl}t'|j}g} t-|D]\}}d|vr| dnd}t| dp| } t=||d| d| dp||d||||d|d |d!|d"| d#p|p| d$||n||n| d%| &}!||!_| |||!f ||_n #||_wxYw|d'kr;|d\}"}#}!tCd|#d|!|}$| |$njd}%t|d(d}&tE|)5}'i}(|D]0\}}}!|'#tB||d|!|*})||(|)<1d+|D}*tI|(%}+|+rt|d,d-d.ur|+D]},|(|,}-|,&rf |,'}.n|#tP$rC}|-ddt|ddt|* |-d/dd0}.Yd}~n4d}~wwxYw|-d1dd2ddt|* |-d/dd0}.| |.|%d'z }%ːndd3l)m*}/m+}0|/|+d4|05\}1}+|1D]}) |)'}.nX#tP$rK}|(|)}-|-ddt|ddt|* |-d/dd0}.Yd}~nd}~wwxYw| |.|%d'z }%|.d6}-|-t)|kr||-nd|-}2|. d7d}3|. d8d9}4|4d:krd;nd<}5||%z }6|5d=|-d'zd>|d?|2d@|3dA }7|&r9 |&,|7n4#tP$rt[dB|7YnwxYwt[dB|7|&r`|6dkrZ |&.dC|6dD|6d'krdEnddF~#tP$r&}8t dG|8Yd}8~8d}8~8wwxYw|+dddn #1swxYwY|/dHI|rta|dJr|j1r|D]}. |.d6t)|kr||.d6dnd}9|j12|9|. dKdpd|.d6t)|kr#t||.d6dLdMdndN#tP$rYwxYwt|dMd}: ddOl3m4};n#tP$rd};YnwxYwdP}<|D]}.|.5dQd}=|.5dRdP}> |>r|z }.s$555a1V9SbS>555r rwrsrrr%rtrrorurvrr5)r&rrrr%rYr'rrZr[r\r]r^r_rsrEr))r)r&rrrci|] \}}}|| SrBrB)r6i_rs rrfz!delegate_task..Hs FFFMQ5q%FFFr r(FTrrQr0u9Parent agent interrupted — child did not finish in time)rFIRST_COMPLETEDg?)r return_whenr&rr?r/u✓u✗z [rr+z (zs)rrEz taskrz remainingzSpinner update_text failed: %sc|dS)Nr&rB)rhs rzdelegate_task..s 1\?r )key_memory_managerrPrr)taskrpchild_session_id) invoke_hookr<r+r? subagent_stopr)r child_roler  child_status duration_msz$subagent_stop hook invocation failedrDr;session_cost_sourcenone>Nrzrsubagentsession_cost_statusr1>Nrzr1 estimatedzSubagent cost rollup failed)resultstotal_duration_seconds) ensure_ascii)= tool_errorrNrrrrrrr&r'DEFAULT_MAX_ITERATIONSrr]_resolve_delegation_credentialsrrrrr~rrr enumeraterr_rrRrSrjrTrrrrrr\rkeysdonerpr\concurrent.futuresrrrGprint update_textsortrr on_delegationhermes_cli.pluginsrrVrrrr;rrr^)ArrrrrYrvrwrsrtop_roler$rr)default_max_itereffective_max_itercredsr^ max_childrenrecovered_tasks tasks_error task_listrr overall_startrn_tasks task_labels _model_tools_parent_tool_nameschildrenr7 task_acp_argsrr_i_trpcompleted_count spinner_refexecutorfuturesfuture_child_by_indexpendingfrr_cf_waitrrlabeldurricon remainingcompletion_liner7 _task_goal_parent_session_id _invoke_hook_children_cost_totalr child_costrVtotal_durationsA rrr~sV2JKKK   N   t$$H L"3Q 7 7E$&&I zJUJJ'0JJ2FJJJ     ..Cww/1GHH !n8H&H&H  = ,   *$/\BB $$$#c((########$011L#B5#I#I O['+&&&" UE4((U u:: $ $F3u::FF.:FFF  U*T3''UDJJLLUg8X V V STTT 0.///Y''@@4$%% III4::3FIII   xx##))++ @>a>>>?? ? ? ? @N$$MG)nnG559555K '&&&lDEE H"Di(( + +DAq1;qAEE*---dM-QUU6]]-FhGGN&vYi((z**6hGn1")"' "3"' "3!&y!1"' "3%&UU=%9%9&(&(99Y''%0"M&.&:(( &@Q@Q#+E00BE , OOQ5M * * * *= +B2D ..1C .CCCC!||  B"1bj%FFvl,?FF L 9 9 9m NXG' $ $ 1e!% 6!- )#$GFXFFFO',,..))GW N<)?GG4OO%--%aj6688 "() #, " " "25.5/3-0XX12893:(7(;(;C(@(@BRTX4&4& )" )" "/2*7+/)d-.45/6$3$7$7$<$<>NPT0"0" % %E u---'1,PPPPPPPP (So!!! g#,N,NF & $   %fo*-&-'+%(XX)*01+2 / 3 3C 8 8:JD,, ! ! NN5)))#q(O -C,/#k2B2B,B,B C(( PS  ))$6::C"YYx55F$*k$9$955uD '/ 9I)-&U&UQ&U&U&U&UE&U&Uc&U&U&UO"6:'33ODDDD(:::!"8"8"899999:4?44555#Ny1}}N'33 a a ayA~~SU a a a )NNN"LL)I1MMMMMMMMNmW N-m Nm Nm Nm Nm Nm Nm Nm Nm Nm Nm Nm Nm Nm Nm N`  22 333  L"3 4 4  (   E \*S^^;;eL126:: ,::# 99Y339r!.X>> |)< =a @,PRSSS ;    !|TBBBBBBBBB  PPYY}d33 YY0#66   :$j(9(99$:&    D     P L"4%#ii 22"YYx00+=!>!>!C!t KLL       P P P LL?$L O O O O O Pc!! GGL2NPSTT[X[\\G6=@T6TL 3 |%:FCCGYYY3= 0|%:IFFJ___3> 0 G G G LL6L F F F F F G4>++m;Q??N :&4      s@C)) D3DDDD$O>> P.B^T^ U*'9U% ^%U**A*^W*)^* X?4AX:5^:X??B^[,+^,\ ^ \  ^)$] ^ ]?]:4^:]??^^^Ba22 a?>a?b b*)b* c55d d Ae--&ff Ag??&h('h(rcD|st|ddSt|ddpd}t|dd}|||kr|S ddlm}||}||r|Sn3#t$r&}t d||Yd}~nd}~wwxYwdS)ahResolve a credential pool for the child agent. Rules: 1. Same provider as the parent -> share the parent's pool so cooldown state and rotation stay synchronized. 2. Different provider -> try to load that provider's own pool. 3. No pool available -> return None and let the child keep the inherited fixed credential behavior. rNrtrzr) load_poolz:Could not load credential pool for child provider '%s': %s)ragent.credential_poolrhas_credentialsr\rr])rrparent_provider parent_poolrpoolr^s rrr s ?|%7>>>lJ==CO,(:DAAK#5#H#H  333333y+,,   4 4 6 6 K     H           4s(A-- B7BBr)c t|dpdpd}t|dpdpd}t|dpdpd}t|dpdpd}t|dpdpd}|ru|}dd lm}|} d } ||pd } t |d kr d | vrd} d} n t |dkrd} d} nd| vrd } d} |dvr|} || ||| dS|s|dddddS ddlm} | ||} n)#t$r}td|d|d|d}~wwxYw| dd}|std|d|p| dpd| dtkr|n| d| d|| d| dt| dpgdS) uResolve credentials for subagent delegation. If ``delegation.base_url`` is configured, subagents use that direct OpenAI-compatible endpoint. ``delegation.api_key`` overrides the key; when omitted, ``api_key`` is returned as ``None`` so ``_build_child_agent`` inherits the parent agent's key (``effective_api_key = override_api_key or parent_api_key``). This lets providers that store their key outside ``OPENAI_API_KEY`` (e.g. ``MINIMAX_API_KEY``, ``DASHSCOPE_API_KEY``) work without a duplicate config entry. Otherwise, if ``delegation.provider`` is configured, the full credential bundle (base_url, api_key, api_mode, provider) is resolved via the runtime provider system — the same path used by CLI/gateway startup. This lets subagents run on a completely different provider:model pair. If neither base_url nor provider is configured, returns None values so the child inherits everything from the parent agent. Raises ValueError with a user-friendly message on credential failure. r%rzNrtrrorur)_detect_api_mode_for_urlr rxz chatgpt.comz/backend-api/codexz openai-codexcodex_responseszapi.anthropic.com anthropicanthropic_messageszapi.kimi.com/coding>rrxr)r%rtrroru)resolve_runtime_provider) requested target_modelz$Cannot resolve delegation provider 'z': z. Check that the provider is configured (API key set, valid provider name), or set delegation.base_url/delegation.api_key for a direct endpoint. Available providers: openrouter, nous, zai, kimi-coding, minimax.zDelegation provider 'z]' resolved but has no API key. Set the appropriate environment variable or run 'hermes auth'.rr5)r%rtrrorurr5) rr'rrhermes_cli.runtime_providerrr rr\r_RUNTIME_PROVIDER_CUSTOMr)r)rconfigured_modelconfigured_providerconfigured_base_urlconfigured_api_keyconfigured_api_moderor base_lowerrtrurruntimer^s rrr) s*3777++1r2288::Bdcggj117R88>>@@HDcggj117R88>>@@HDSWWY//5266<<>>F$cggj117R88>>@@FFHHPD, % IHHHHH(..00 ++,?@@VDV 1 2 2m C C$ 22%H(HH 2 3 37J J J"H+HH "j 0 0H+H "_ _ _*H& +      &     HHHHHH**5HWghhh  Q3F Q Q3 Q Q Q    kk)R((G   N$7 N N N   "AW[[%9%9AT+2;;z+B+BF^+^+^''dkdodopzd{d{KK ++KK ++;;y))W[[((.B//  s-G G' G""G'c ddlm}|dpi}|r|Sn#t$rYnwxYw ddlm}|}|dpiS#t$ricYSwxYw)aNLoad delegation config from CLI_CONFIG or persistent config. Checks the runtime config (cli.py CLI_CONFIG) first, then falls back to the persistent config (hermes_cli/config.py load_config()) so that ``delegation.model`` / ``delegation.provider`` are picked up regardless of the entry point (CLI, gateway, cron). r) CLI_CONFIGr0) load_config)clirr'r\hermes_cli.configr)rr)rfulls rr&r& s """"""nn\**0b  J       111111{}}xx %%++  s $ 11&A A+*A+cN t}n#t$r t}YnwxYw t}n#t$r t}YnwxYw t }n#t$rd}YnwxYw|dkr|r d|d|dz d}n|dkr |sd|d}nd |d }d |d |d |dS)aCompose the delegate_task tool description with current runtime limits. The model needs to know its actual ceilings (not the framework defaults), otherwise it self-caps at "default 3" / "default 2" even when the user has raised delegation.max_concurrent_children / max_spawn_depth. Called both at module import (to seed DELEGATE_TASK_SCHEMA) and on every get_definitions() call via dynamic_schema_overrides. Trz use execute_code - Single tool call -> just call the tool directly - Tasks needing user interaction -> subagents cannot use clarify - Durable long-running work that must outlive the current turn -> use cronjob (action='create') or terminal(background=True, notify_on_complete=True) instead. delegate_task runs SYNCHRONOUSLY inside the parent turn: if the parent is interrupted (user sends a new message, /stop, /new) the child is cancelled with status='interrupted' and its work is discarded. Children cannot continue in the background. IMPORTANT: - Subagents have NO memory of your conversation. Pass all relevant info (file paths, error messages, constraints) via the 'context' field. - If the user is writing in a non-English language, or asked for output in a specific language / tone / style, say so in 'context' (e.g. "respond in Chinese", "return output in Japanese"). Otherwise subagents default to English and their summaries will contaminate your final reply with the wrong language. - Subagent summaries are SELF-REPORTS, not verified facts. A subagent that claims "uploaded successfully" or "file written" may be wrong. For operations with external side-effects (HTTP POST/PUT, remote writes, file creation at shared paths, publishing), require the subagent to return a verifiable handle (URL, ID, absolute path, HTTP status) and verify it yourself — fetch the URL, stat the file, read back the content — before telling the user the operation succeeded. - Leaf subagents (role='leaf', the default) CANNOT call: delegate_task, clarify, memory, send_message, execute_code. - Orchestrator subagents (role='orchestrator') retain delegate_task so they can spawn their own workers, but still cannot use clarify, memory, send_message, or execute_code. Orchestrators are bounded by max_spawn_depth=z for this user and can be disabled globally via delegation.orchestrator_enabled=false. - Each subagent gets its own terminal session (separate working directory and state). - Results are always returned as an array, one entry per task.)rr\rrrr)r max_depthorchestrator_onnesting_clauses r_build_top_level_descriptionr sv8355 8887 8(**  355 A~~/~ ) ) ) ).Y s1&&&q!477&&&r propertiesrrrs)rr)DELEGATE_TASK_SCHEMArgr r r)overrides_paramss r_build_dynamic_schema_overridesrN s | ,&&3LA,OUUWW&&&\">\=]=]\"7+M:r,s "   8 $ $  -,,,,,,,,,,, $RRRRRR44444444#8  3 S     C c        ,$)$T$T$TUUV$hn&&IICC0BCCCCC#$ #IN$$ t'))024T#s(^+,111 T d     (tCH~($((((1c1d1111 CD.  tDcN3      222 cN22 2  $sCx. 2222j c d    Fx}"#,c#,#,#,#,L(E((((6#c####L4"J4JJJJ ;s ;t ; ; ; ;SS>I03C #Y ""$...44444C4440,(6!3#7&4 //4]*+T"I%)III I c]ISM I  I  II IIIIXXc]6C49CcCCCC x "&#$(xxxx x x # x}x C=x C=xtCy!xhxxxxJ(,'+&*'+*.-1)ppp pc]ptCy! p C= p  pp }p }psmp }p#3-p  S *!p( )ppppf M MM M  M I,- M Mc]MMMMf  {I{I{I {I  #s(^ {I{I{I{I|  8Dc3h( )8C= 890!$(,0$(!%$(GG 3-G c]GtCy!G Dc3h( ) G SM G # GtCy!G 3-G GGGGT x}Boooooodd<_c____D     "s""""J.  0 !,!J  (+H+<HHH   $)1+ N N$,+B$$ %,&,h%7,BZk,B,B,B%% %-!j((%,&,h%7+o%% %-%+^$<+h!!1##<"(A!!J EO((T!0D !\    (+M qa a DIeeuur0///////     ) <#r