idZddlZddlZejeZddlZddlZddlZddl m Z m Z ddl m Z mZmZmZddlmZegdZehdZedejDZd d eDZd Zd Zd efdZdZdZ gdZ!d e"fdZ# dRddde$dee$dee$d e$fdZ%d ee$fdZ&dee$d ee$fdZ'dSdeded ee(fdZ) dTdede$dee$deee$dee$d ed!ee$d"ee$d#ee$d$ee$d%ee$d&eee$fd'Z* dUdede$d ee$e ffd(Z+ dVdee$dee$deee$d)eeee$e fd eed*ee$d+eee$d e$fd,Z,d-ee$fd.Z-d/e.d e.fd0Z/d e.fd1Z0d2d3d4d5d6d7d5d8d7d9d:d5id;ed<d=d9d4d5d>d7d5d?d7d9d:d5id@edAd=d5dBd7d9d:d5idCd=dDdgdEdFd=dGdHd7d5dId7d9d:d5idJd=dKgdEdLZ1ddMl2m3Z3m4Z4e3j5d2dNe1dOe#dPQdS)Wa 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 as_completed)AnyDictListOptional)TOOLSETS) delegate_taskclarifymemory send_message execute_code>rlmoasafe debugging delegationc#K|]T\}}|tv|d#td|dgDP|VUdS)zhermes-c3(K|] }|tvVdSN)DELEGATE_BLOCKED_TOOLS.0ts ;/home/agentuser/.hermes/hermes-agent/tools/delegate_tool.py z.0s(KK++KKKKKKtoolsN)_EXCLUDED_TOOLSET_NAMES startswithallget)rnamedefns rrr,s T4 *** OOI & &+ KKTXXgr5J5JKKK K K+ ****r, c#"K|] }d|dV dS)'N)rns rrr2s*CC1h!hhhCCCCCCrreturnct}|d}|V tdt|S#tt f$r$t d|tYnwxYwtj d}|r5 tdt|S#tt f$rYnwxYwtS)a)Read delegation.max_concurrent_children from config, falling back to DELEGATION_MAX_CONCURRENT_CHILDREN env var, then the default (3). Uses the same ``_load_config()`` path that the rest of ``delegate_task`` uses, keeping config priority consistent (config.yaml > env > default). max_concurrent_childrenNzNdelegation.max_concurrent_children=%r is not a valid integer; using default %d"DELEGATION_MAX_CONCURRENT_CHILDREN) _load_configr"maxint TypeError ValueErrorloggerwarning _DEFAULT_MAX_CONCURRENT_CHILDRENosgetenv)cfgvalenv_vals r_get_max_concurrent_childrenr>8s ..C ''+ , ,C  q#c((## #:&    NN#$')I       i<==G q#g,,'' ':&    D  ++s#A2A98A9B00CC2)terminalfilewebcdS)zr r rcode_executioncg|]}|v| Sr(r()rrblocked_toolset_namess r z(_strip_blocked_tools..s$ B B B!1,A#A#AA#A#A#Arr()reris @r_strip_blocked_toolsrks2 C B B Bx B B BBrr/ task_index task_countc t|dd t|dd ssdS|dkr d|dzdnddgdd td td tf fd }fd }||_|S)aBuild 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 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_callbackr/[] rK event_type tool_namepreviewc|dvr||p|pd}rrt|dkr |dddzn|} dd|dn2#t$r%}td|Yd}~nd}~wwxYwdS|d krdSr|r t|d kr |dd dzn|pd}d d lm}||pd} dd | d|} |r | d|dz } | n2#t$r%}td|Yd}~nd}~wwxYwr |pdt  krrd } dd| n2#t$r%}td|Yd}~nd}~wwxYw dSdSdS)N) _thinkingzreasoning.availablerK7z... u ├─ 💭 ""zSpinner print_above failed: %sztool.completed#r)get_tool_emojiu├─ z "r%subagent_progress🔀 zParent callback failed: %s) len print_abover]r6debug agent.displayr}rNrPclear)rtrurvargskwargsrcshorter}emojilinesummary _BATCH_SIZE_batch parent_cbprefixspinners r _callbackz1_build_child_progress_callback.._callbacks = = =-i-2D F/24yy2~~crcU**4F''(KF(K(K%(K(K(KLLLL FFFLL!A1EEEEEEEEF F ) ) ) F  B.5`#g,,:K:KWSbS\E))RYR_]_E 4 4 4 4 4 4"N9?33E9v99e99i99D )(u(((( B##D)))) B B B =qAAAAAAAA B   MM)/r * * *6{{k))))F++BI13L63L73L3LMMMM BBBLL!=qAAAAAAAAB   ))sGA A=A88A=C22 D!<DD!&E88 F'F""F'crrrrd} dd|n2#t$r%}td|Yd}~nd}~wwxYwdSdSdS)z._flushs   ii''G D -/Hv/Hw/H/HIIII D D D ?CCCCCCCC D LLNNNNN     s. AAA)NNN)rYrOr) rlr`rmrrrrrrrs @@@@@r_build_child_progress_callbackrsl$7>>G &>EEI 9t(2A~~ #a # # # #2FKF))c)c)3))))))))))VI rmodelmax_iterationsoverride_provideroverride_base_urloverride_api_keyoverride_api_modeoverride_acp_commandoverride_acp_argsc &'()ddlm} t|dd}|t|(n?|r)t |drddl'')fd|jD(ntt(|rt(fd|D}nG|r|t|}n3(rtt(}ntt}t|}t|||}t|d d}|s*t |d r|j d }t||&d}&rd td df&fd }|}|p|j}|pt|dd}|p|j}| p|}| pt|dd}| pt|dd}t%| | nt|dgpg}t|dd}|} t'}t| dpd}|r1ddlm} | |}!|!|!}nt.d|n2#t2$r%}"t.d|"Yd}"~"nd}"~"wwxYw| d7id|d |d|d|d|d|d|d|dt|ddd|dt|ddd|ddd|d d!|d"d#|jd$dd%dd&dd'|d(t|d)dd*t|d+dd,|jd-|jd.|jd/|jd0&d1d}#t|d2d|#_ t|d3dd4z|#_!tE||}$|$|$|#_#t |d5rbt|d6d}%|%r5|%5|j$%|#dddn #1swxYwYn|j$%|#|#S)8a 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)AIAgentenabled_toolsetsNvalid_tool_namescBh|]}|xSr)get_toolset_for_tool)rr# model_toolstss r z%_build_child_agent..s<   !66t<<<I IIIrcg|]}|v| Sr(r()rrparent_toolsetss rrjz&_build_child_agent..s#.[.[.[Qa?FZFZqFZFZFZrrFapi_key_client_kwargsrcr,c|sdS d|dS#t$r&}td|Yd}~dSd}~wwxYw)Nrxz(Child thinking callback relay failed: %s)r]r6r)rcrchild_progress_cbs r_child_thinkingz+_build_child_agent.._child_thinking6sy  L!!+t44444 L L L GKKKKKKKKK Ls  AAAproviderapi_mode acp_commandacp_argsreasoning_configreasoning_effortrK)parse_reasoning_effortzAUnknown delegation.reasoning_effort '%s', inheriting parent levelz.Could not load delegation reasoning_effort: %sbase_urlrr max_tokensprefill_messages quiet_modeTephemeral_system_prompt log_prefix [subagent-]platformskip_context_files skip_memoryclarify_callbackthinking_callback session_db _session_dbparent_session_id session_idproviders_allowedproviders_ignoredproviders_order provider_sortrpiteration_budget _print_fn_delegate_depthr/_active_children_active_children_lockr()& run_agentrrYsethasattrrrDEFAULT_TOOLSETSrksortedrdrRrr"rrOrrlistr1rMhermes_constantsrr6r7r]rrrrrrrr_resolve_child_credential_pool_credential_poolrrN)*rlrHrIrerrr`rrrrrrrparent_enabledchild_toolsetsworkspace_hint child_promptparent_api_keychild_thinking_cbreffective_modeleffective_providereffective_base_urleffective_api_keyeffective_api_modeeffective_acp_commandeffective_acp_argsparent_reasoningchild_reasoningdelegation_cfgdelegation_effortrparsedexcchild child_poollockrrrrs* @@@@r_build_child_agentrsX4"!!!!! \+=tDDN!n-- 0',0BCC0     '8    .//@-.[.[.[.[(.[.[.[\\ @.4-n== @-f_.E.EFF-.>??,\::N-dGN[[[L\9d;;N D 6F G GD%488CC7z<PP , L# L$ L L L L L L,1|1O*UglJPT.U.U*Cl.C(:N*UglJPT.U.U0^GL-Y]4^4^3D3P//W^_kmwy{W|W|XCACEE|-?FF&OL% 2 23E F F L"MMSSUU   ? ? ? ? ? ?++,=>>F!"(W% LLL EsKKKKKKKKL G   ## !! o $#   $#   *)  $# &~ <t<<< ) !/A4HHH ( 4 !-  . ----  &&! " 4# $D% &' (,+) *<===+ ,", dCCC- .'88/ 0'881 2%443 4#005 6 107 89 E<lK>>EO#L2CQGG!KE00BLQQJ!+|/008|%>J&O  OOc *tj}tdd}ddl}tdt |j}tdd} d} | | } | o | } | %tdr | n2#t$r%} t d| Yd} ~ nd} ~ wwxYwtj**fd} tj| d }| | }|rXt|d rH |n2#t$r%}t d |Yd}~nd}~wwxYwt'tj|z d}|dpd}|dd}|dd}|dd}|rd}n|rd}nd}g}i}|dpg}t+|tr|D]}t+|t,s|ddkr|dpgD]}|di}|ddt/|ddd}|||d}|r|||<|dd kr|d!d}t3|od"|dd#v} t/|| rd"nd$d%}!|d&}|r||nd}"|"|"|!|r|d'|!|rd}#n|rd}#nd(}#td)d}$td*d}%td+d}&||||t+|&t8r|&nd|#t+|$t:t<fr|$ndt+|%t:t<fr|%ndd,|d- }'|dkr|d"d.|'d"<|'*| d/0| K| I | !| n2#t$r%} t d1| Yd} ~ nd} ~ wwxYwddl}tdd}(t+|(trt |(|_td2r td3d})|)r5|)5j"#dddn #1swxYwYnj"#n9#tHtJf$r%}t d4|Yd}~nd}~wwxYw td5r&SS#t$rt d6YSwxYw#t$r} t'tj|z d}tOj(d7d8d"dt9| d|d9cYd} ~ *| d/0| K| I | !| n2#t$r%} t d1| Yd} ~ nd} ~ wwxYwddl}tdd}(t+|(trt |(|_td2r td3d})|)r5|)5j"#dddn #1swxYwYnj"#n9#tHtJf$r%}t d4|Yd}~nd}~wwxYw td5r&SS#t$rt d6YSwxYwd} ~ wwxYw#*| d/0| K| I | !| n2#t$r%} t d1| Yd} ~ nd} ~ wwxYwddl}tdd}(t+|(trt |(|_td2r td3d})|)r5|)5j"#dddn #1swxYwYnj"#n9#tHtJf$r%}t d4|Yd}~nd}~wwxYw td5r&ww#t$rt d6YwwxYwxYw):zi Run a pre-built child agent. Called from within a thread. Returns a structured result dict. rpNr_delegate_saved_tool_namesr_swap_credentialz-Failed to bind child to leased credential: %scts t dd}|s1d d} }|d}|dd}|dd}|r d|d |d |d }n$|d d }|r d|d |d |d }n#t $rYnwxYw ||n#t $rYnwxYwtdSdS)N_touch_activityzdelegate_task: subagent z working current_toolapi_call_countrrz delegate_task: subagent running z (iteration /)last_activity_descrK)wait_HEARTBEAT_INTERVALrYget_activity_summaryr"r]) touchdesc child_summary child_tool child_iter child_max child_desc_heartbeat_stoprr`rls r_heartbeat_loopz*_run_single_child.._heartbeat_loops!&&':;; #L*;TBBE BjBBBD  % : : < < *..~>> *../?CC )--.>BB IDzDD*4DD7@DDDDD"/!2!23G!L!LJ!I!H:!H!H.8!H!H;D!H!H!H     d     3"&&':;;     s$BC CC C C-,C-T)targetdaemon) user_messagerz"Progress callback flush failed: %sr+final_responserK completedF interrupted api_callsfailedmessagesrole assistant tool_callsfunctionr#unknown arguments)tool args_bytesidrcontenterrorPok) result_bytesstatus tool_call_idrsession_prompt_tokenssession_completion_tokensr)inputoutput) rlrrr duration_secondsr exit_reasontokens tool_tracez$Subagent did not produce a response.rs)timeoutz&Failed to release credential lease: %srrz/Could not remove child from active_children: %sclosez,Failed to close child agent after delegationrz] failedrlrrrr r"))time monotonicrYrr_last_resolved_tool_names acquire_leasecurrentrrr]r6r threadingEventThreadstartrun_conversationrroundr" isinstancedictrrNboollowerupdaterOr3floatrrP release_leaserremover5UnboundLocalErrorr'logging exception)+rlrHrr`_kwargs child_startrr_saved_tool_namesrleased_cred_id leased_entryrr_heartbeat_threadresultrdurationrrr r rr% trace_by_idr msgtcfnentry_ttc_idris_error result_metarr# _input_tokens_output_tokens_modelentrysaved_tool_namesrrs+` `` @r_run_single_childrTsv .""K '?FF'C $[%J K KMM 2D99JN#1133  % S)1133 +?Q0R0R+**<888 S S S LcRRRRRRRR S o''O:"(MMMVI''T'::  F):H!E!E F F!((**** F F F A1EEEEEEEE F))K7;;**-..4"JJ{E22 jj66 JJ{A..  "FF  !FFF,. 13 ::j))/R h % % ; ; ;!#t,,776??k11"ww|44: 9 9VVJ33$&FF69$=$=*-bff[".E.E*F*F###))'222 "t  918K. 9WWV__..!ggi44G#CGwss|/A/A/C/C$C  H),G -5"?''4##K  GGN33E7<F[__U333$F) k2222#;"2--k:::  +'KK  +%KK*K '>BB  (CQGG..%" ()&#66@VVD&*4]S%L*Q*QXWX,6~U|,T,T[..Z[% ! !  X  #ZZ1WXXE'N" q)))  !n&@ L((8888 L L L EsKKKKKKKK L "5*FMM & - - K489I4J4JK 1 $r } |%ddt| ddd%}&Yd} ~ nd} ~ wwxYw|%d&dd'ddd%}&||&|dz }ndd(l m!}'m"}(|'|#d)|(*\})}#|)D]}" |"}&n5#t>$r(} |!|"}%|%ddt| ddd%}&Yd} ~ nd} ~ wwxYw||&|dz }|&d+}%|%t|kr||%nd|%}*|&d,d}+|&d-d.},|,d/krd0nd1}-||z }.|-d2|%dzd3|d4|*d5|+d6 }/|r9 |#|/n4#t>$rtId7|/YnwxYwtId7|/|r`|.dkrZ |%d8|.d9|.dkrd:ndd;[#t>$r&}0tL'd<|0Yd}0~0d}0~0wwxYw|#Jdddn #1swxYwY|(d=>|rtS|d?r|j*r|D]}& |&d+t|kr||&d+dnd}1|j*+|1|&d@dpd|&d+t|kr#t||&d+dAdBdndC#t>$rYwxYwtYt#j|z dA}2tj||2dDd#ES)Fa Spawn one or more child agents to handle delegated tasks. Supports two modes: - Single: provide goal (+ optional context, toolsets) - Batch: provide tasks array [{goal, context, toolsets}, ...] Returns JSON with results array, one entry per task. Nz.delegate_task requires a parent agent context.rrrz Delegation depth limit reached (z,). Subagents cannot spawn further subagents.rzToo many tasks: z* provided, but max_concurrent_children is z. Either reduce the task count, split into multiple delegate_task calls, or increase delegation.max_concurrent_children in config.yaml.)rHrIrez7Provide either 'goal' (single task) or 'tasks' (batch).zNo tasks provided.rHrKzTask z is missing a 'goal'.c.g|]}|dddS)rHN(r(rs rrjz!delegate_task..s$555a1V9SbS>555rrIrerrrrrrr) rlrHrIrerrr`rrrrrrr/ro) max_workers)rlrHrr`_interrupt_requestedFTr(r u9Parent agent interrupted — child did not finish in time)rFIRST_COMPLETEDg?)r& return_whenrlr"r?ru✓u✗z [rrrz (zs)z rz tasksz remainingzSpinner update_text failed: %sc|dS)Nrlr()rs rzdelegate_task..As 1\?r)key_memory_managerrr+r)taskrEchild_session_id)resultstotal_duration_seconds) ensure_ascii)- tool_errorrY MAX_DEPTHjsondumpsr1r"DEFAULT_MAX_ITERATIONS_resolve_delegation_credentialsr5rOr>r4rrrM enumerater)r*rr+rrrNrTrsubmitrkeysdonerEr]concurrent.futuresrr[rprint update_textr6rsortrrc on_delegationr3)3rHrIrerUrrrr`depthr;default_max_itereffective_max_itercredsr max_children task_listird overall_startrfn_tasks task_labels _model_tools_parent_tool_nameschildrenrr_i_trEcompleted_count spinner_refexecutorfuturesfuturependingfidxrR_cf_waitr[rrlabeldurricon remainingcompletion_liner _task_goaltotal_durations3 rr r os &JKKK L"3Q 7 7E z <9<<<     ..Cww/1GHH';+;$/\BB $$$#c((########$011L UE4(( U u:: $ $F3u::FF.:FFF  U*T3''UDJJLLU"wHMMN STTT 0.///Y''@@4xx##))++ @>a>>>?? ? ? ? @N$$MG)nnG559555K '&&&lDEE HDi(( + +DAq&1V9aeeI6F6Fz**6heGn1 "' "3uZGX!&y!1"' "3%&UU=%9%9%H["#%% "3"3"?x   E0BE , OOQ5M * * * * + 2D ..1C .CCCC!||  B"1bj%FFvl,?FF L 9 9 9Y NXG' $ $ 1e!% 6!- )#$',,..))GG N<)?GG4OO%--%aj6688 "() #,"""25.5/3-0XX1289 )")""/2*7+/)d-.45 %%E u---'1,PPPPPPPP (#? [ [ [ g"%N%NF  & $   %fo*-&-'+%(XX)*01 !! NN5)))#q(O -C03c+6F6F0F0FK,,MTWMME))$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'334uI4u4uS\`aSaSaCCgi4u4u4uvvvv(NNN"LL)I1MMMMMMMMNMG N%Y NY NY NY NY NY NY NY NY NY NY NY NY NY NY Nx  22 333  .?@@ \Ea   E GL\GZ]`aj]k]kGkGkYu\':;FCCqs ,::# 99Y339rdijvdwz}G{H{HeHeHWXeL6I-J1-M|]_%`%`%`NP;     4>++m;Q??N :"0   s;B B<B71B<7B< CK K% B W<O/.W</ P9PW<PAW<!Q65W<6 R(R#W<#R((BW<?UW<U41W<3U44W<$V86W<8 W(W#W<#W((W<<XX 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. rNrrKr) load_poolz:Could not load credential pool for child provider '%s': %s)rYagent.credential_poolrhas_credentialsr]r6r)rr`parent_provider parent_poolrpoolrs rrrXs ?|%7>>>lJ==CO,(:DAAK#5#H#H  333333y+,,   4 4 6 6 K     H           4s(A-- B7BBr;c pt|dpdpd}t|dpdpd}t|dpdpd}t|dpdpd}|rk|p&tjdd}|st d|}d }d } d |vrd }d } nd|vrd}d} ||||| dS|s|dddddS ddlm} | |} n)#t$r} t d|d| d| d} ~ wwxYw| dd}|st d|d|| d| d|| d| dt| dpgdS)uResolve credentials for subagent delegation. If ``delegation.base_url`` is configured, subagents use that direct OpenAI-compatible endpoint. 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. rrKNrrrOPENAI_API_KEYzeDelegation base_url is configured but no API key was found. Set delegation.api_key or OPENAI_API_KEY.customchat_completionszchatgpt.com/backend-api/codexz openai-codexcodex_responseszapi.anthropic.com anthropicanthropic_messages)rrrrrr)resolve_runtime_provider) requestedz$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'.rcommandr)rrrrrrr) rOr"rMr9r:r5r7hermes_cli.runtime_providerrr]r) r;r`configured_modelconfigured_providerconfigured_base_urlconfigured_api_keyr base_lowerrrrruntimers rrnrnxs3777++1r2288::Bdcggj117R88>>@@HDcggj117R88>>@@HDSWWY//5266<<>>F$  7y)2..4466  <  )..00 % *j 8 8%H(HH J . ."H+H& +      &     HHHHHH**5HIII  Q3F Q Q3 Q Q Q    kk)R((G   N$7 N N N   "KK ++KK ++KK ++;;y))W[[((.B//  sE,, F6F  Fc ddlm}|di}|r|Sn#t$rYnwxYw ddlm}|}|diS#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_CONFIGr) load_config)clirr"r]hermes_cli.configr)rr;rfulls rr1r1s """"""nn\2..  J       111111{}}xx b)))  s# 00%A A)(A)r aSpawn one or more subagents to work on tasks in isolated contexts. Each subagent gets its own conversation, terminal session, and toolset. Only the final summary is returned -- intermediate tool results never enter your context window. TWO MODES (one of 'goal' or 'tasks' is required): 1. Single task: provide 'goal' (+ optional context, toolsets) 2. Batch (parallel): provide 'tasks' array with up to 3 items. All run concurrently and results are returned together. WHEN TO USE delegate_task: - Reasoning-heavy subtasks (debugging, code review, research synthesis) - Tasks that would flood your context with intermediate data - Parallel independent workstreams (research A and B simultaneously) WHEN NOT TO USE (use these instead): - Mechanical multi-step work with no reasoning needed -> use execute_code - Single tool call -> just call the tool directly - Tasks needing user interaction -> subagents cannot use clarify IMPORTANT: - Subagents have NO memory of your conversation. Pass all relevant info (file paths, error messages, constraints) via the 'context' field. - Subagents CANNOT call: delegate_task, clarify, memory, send_message, execute_code. - Each subagent gets its own terminal session (separate working directory and state). - Results are always returned as an array, one entry per task.objectstringzWhat the subagent should accomplish. Be specific and self-contained -- the subagent knows nothing about your conversation history.)type descriptionzBackground information the subagent needs: file paths, error messages, project structure, constraints. The more specific you are, the better the subagent performs.arrayrzcToolsets to enable for this subagent. Default: inherits your enabled toolsets. Available toolsets: z. Common patterns: ['terminal', 'file'] for code work, ['web'] for research, ['browser'] for web interaction, ['terminal', 'file', 'web'] for full-stack tasks.)ritemsrz Task goalzTask-specific contextz,Toolsets for this specific task. Available: zT. Use 'web' for network access, 'terminal' for shell, 'browser' for web interaction.zfPer-task ACP command override (e.g. 'claude'). Overrides the top-level acp_command for this task only.zPer-task ACP args override.)rHrIrerr)r propertiesrequiredzBatch mode: tasks to run in parallel (limit configurable via delegation.max_concurrent_children, default 3). Each gets its own subagent with isolated context and terminal session. When provided, top-level goal/context/toolsets are ignored.integerzSMax tool-calling turns per subagent (default: 50). Only set lower for simple tasks.a Override ACP command for child agents (e.g. 'claude', 'copilot'). When set, children use ACP subprocess transport instead of inheriting the parent's transport. Enables spawning Claude Code (claude --acp --stdio) or other ACP-capable agents from any parent, including Discord/Telegram/CLI.zArguments for the ACP command (default: ['--acp', '--stdio']). Only used when acp_command is set. Example: ['--acp', '--stdio', '--model', 'claude-opus-4-6'])rHrIrerUrrr)r#r parameters)registryrirc `t|d|d|d|d|d|d|d|d S) NrHrIrerUrrrr`)rHrIrerUrrrr`)r r")rkws rrarals} XXf  ##*%%hhwxx 011HH]++*%%VVN++ - - -ru🔀)r#toolsetschemahandlercheck_fnrr)r/)NNNNNN)NN)NNNNNNNN)6__doc__rkr= getLogger__name__r6r9r.r)rsrrtypingrrrrrer frozensetrrrr_SUBAGENT_TOOLSETSrP_TOOLSET_LIST_STRr8rjr3r>rmrrr6rErOrRrdrkcallablerrrTr rr5rnr1DELEGATE_TASK_SCHEMAtools.registryrriregisterr(rrrs"   8 $ $  ????????,,,,,,,,,,,,#$$$$)$T$T$TUUV)8>++ IICC0BCCCCC#$ ,c,,,,0...T" %)      c] SM      FXc]2C49CcCCCCMMsMcMZbckZlMMMMr(,'+&*'+*.-1___ _c]_tCy! _ C= _  _ }_ }_sm_ }_#3-_ S *____H  ^I^I^I ^I  #s(^ ^I^I^I^IB!$(,0$(!%$(ff 3-f c]ftCy!f Dc3h( ) f SM f # ftCy!f ffffRx}@VVVVVVrd8  I2!,!J  (+H+<HHH   $)1+ N N,4E\#]#]$+&,h%7,BZk,B,B,B%% %-,T(( %,&,h%7+H%%##$"()4R9  D"7!c  (+u ]V V nsZZ7vvt0///////    - -) r