@duckmind/dm-windows-x64 0.60.6 → 0.60.9

package/extensions/dm-subagents/src/runs/shared/nested-events.js

@@ -1,8 +1,851 @@
-import{randomUUID as M$}from"node:crypto";import*as Y from"node:fs";import*as O from"node:path";import*as S from"node:os";import*as y from"node:path";function N($){return $.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function z$($){let J=$?.env??process.env,j=$&&Object.hasOwn($,"getuid")?$.getuid:process.getuid?.bind(process);if(typeof j==="function")return`uid-${j()}`;for(let X of["USERNAME","USER","LOGNAME"]){let K=J[X];if(K)return`user-${N(K)}`}let Z=$&&Object.hasOwn($,"userInfo")?$.userInfo:S.userInfo;try{let X=Z?.().username;if(X)return`user-${N(X)}`}catch{}let Q=J.USERPROFILE??J.HOME;if(Q)return`home-${N(Q)}`;let f=$&&Object.hasOwn($,"homedir")?$.homedir:S.homedir;try{let X=f?.();if(X)return`home-${N(X)}`}catch{}return"shared"}var L=y.join(S.tmpdir(),`dm-subagents-${z$()}`),t=y.join(L,"async-subagent-results"),e=y.join(L,"async-subagent-runs"),C$=y.join(L,"chain-runs"),t$=y.join(L,"artifacts");import*as J$ from"node:path";var _$=128,E$=4;function g($){return typeof $==="string"&&$.length>0&&$.length<=_$&&!J$.isAbsolute($)&&!$.includes("/")&&!$.includes("\\")&&!$.includes("..")}function $$($){return typeof $==="number"&&Number.isFinite($)?$:void 0}function j$($,J){return typeof $==="string"&&$.length>0?$.slice(0,J):void 0}function h($){if(!Array.isArray($))return[];return $.map((J)=>{if(!J||typeof J!=="object")return;let j=J;if(!g(j.runId))return;return{runId:j.runId,...$$(j.stepIndex)!==void 0?{stepIndex:$$(j.stepIndex)}:{},...j$(j.agent,128)?{agent:j$(j.agent,128)}:{}}}).filter((J)=>Boolean(J)).slice(0,E$)}function m($){if(!$)return[];try{return h(JSON.parse($))}catch{return[]}}import*as M from"node:path";import{fileURLToPath as Z$}from"node:url";import*as V from"node:os";import*as U from"node:path";var _j=U.join(V.homedir(),".config","mcp","mcp.json"),Ej={cursor:[U.join(V.homedir(),".cursor","mcp.json")],"claude-code":[U.join(V.homedir(),".claude","mcp.json"),U.join(V.homedir(),".claude.json"),U.join(V.homedir(),".claude","claude_desktop_config.json")],"claude-desktop":[U.join(V.homedir(),"Library","Application Support","Claude","claude_desktop_config.json")],codex:[U.join(V.homedir(),".codex","config.json")],windsurf:[U.join(V.homedir(),".windsurf","mcp.json")],vscode:[".vscode/mcp.json"]};import{Compile as Rj}from"typebox/compile";function Q$($,J){let j=Z$($),Z=M.extname(j),Q=[".js",".mjs",".cjs",".ts",".mts",".cts"].includes(Z)?Z:".ts";return M.join(M.dirname(j),`${J}${Q}`)}function f$($){return M.basename(Z$($)).startsWith("dm-args.")}function R$($=import.meta.url){let J=f$($)?"subagent-prompt-runtime":M.join("..","runs","shared","subagent-prompt-runtime");return Q$($,J)}function b$($=import.meta.url){let J=f$($)?M.join("..","..","extension","fanout-child"):"fanout-child";return Q$($,J)}var dj=R$(),oj=b$();var n="DM_SUBAGENT_PARENT_EVENT_SINK",d="DM_SUBAGENT_PARENT_CONTROL_INBOX",o="DM_SUBAGENT_PARENT_ROOT_RUN_ID",W$="DM_SUBAGENT_PARENT_RUN_ID",O$="DM_SUBAGENT_PARENT_CHILD_INDEX",X$="DM_SUBAGENT_PARENT_DEPTH",B$="DM_SUBAGENT_PARENT_PATH",p="DM_SUBAGENT_PARENT_CAPABILITY_TOKEN";import*as D$ from"node:fs";import*as C from"node:path";var I$=[10,25,50,100,200,500,1000,2000,4000],N$=new Set(["EACCES","EBUSY","EPERM"]),K$=typeof SharedArrayBuffer<"u"?new SharedArrayBuffer(4):void 0,Y$=K$?new Int32Array(K$):void 0;function x$($){if($<=0)return;if(Y$)try{Atomics.wait(Y$,0,0,$);return}catch{}let J=Date.now()+$;while(Date.now()<J);}function P$($){let J=$?.code;return typeof J==="string"&&N$.has(J)}function w$($,J,j,Z,Q){for(let f=0;;f++)try{$.renameSync(J,j);return}catch(X){let K=Z[f];if(K===void 0||!P$(X))throw X;Q(K)}}function v$($={}){let J=$.fs??D$,j=$.now??Date.now,Z=$.pid??process.pid,Q=$.random??Math.random,X=$.retryRenameErrors??process.platform==="win32"?$.retryDelaysMs??I$:[],K=$.wait??x$;return(q,z)=>{J.mkdirSync(C.dirname(q),{recursive:!0});let T=C.join(C.dirname(q),`.${C.basename(q)}.${Z}.${j()}.${Q().toString(36).slice(2)}.tmp`);try{J.writeFileSync(T,JSON.stringify(z,null,2),"utf-8"),w$(J,T,q,X,K)}finally{J.rmSync(T,{force:!0})}}}var q$=v$();var F=O.join(L,"nested-subagent-events"),D="route.json",k$="registry.json",E=65536,u=12,b=16,x=3;function A($){return g($)}function c$($,J){if(!A(J))throw Error(`${$} must be a non-empty safe id token.`)}function G($,J){c$($,J)}function _($,J){let j=O.resolve($),Z=O.resolve(J);return Z===j||Z.startsWith(`${j}${O.sep}`)}function i($){return O.dirname(O.resolve($.eventSink))}function H($){if(G("rootRunId",$.rootRunId),G("capabilityToken",$.capabilityToken),!_(F,$.eventSink))throw Error("Nested event sink is outside the subagent nested event root.");if(!_(F,$.controlInbox))throw Error("Nested control inbox is outside the subagent nested event root.");if(i($)!==O.dirname(O.resolve($.controlInbox)))throw Error("Nested event sink and control inbox must share one route root.")}function tj($){G("rootRunId",$);let J=M$(),j=O.join(F,`${$}-${J}`),Z=O.join(j,"events"),Q=O.join(j,"controls");return Y.mkdirSync(Z,{recursive:!0,mode:448}),Y.mkdirSync(Q,{recursive:!0,mode:448}),Y.writeFileSync(O.join(j,D),`${JSON.stringify({rootRunId:$,capabilityToken:J,createdAt:Date.now()})}
-`,{mode:384}),{rootRunId:$,eventSink:Z,controlInbox:Q,capabilityToken:J}}function g$($=process.env){let J=$[o],j=$[n],Z=$[d],Q=$[p];if(!J||!j||!Z||!Q)return;let f={rootRunId:J,eventSink:j,controlInbox:Z,capabilityToken:Q};H(f);let X=O.join(i(f),D),K=JSON.parse(Y.readFileSync(X,"utf-8"));if(K.rootRunId!==J||K.capabilityToken!==Q)throw Error("Nested event route metadata does not match the provided root id and capability token.");return f}function ej($=process.env){try{return g$($)}catch(J){console.error("Ignoring invalid nested subagent event route:",J);return}}function $J($=process.env){let J=$[W$];if(!A(J))return;let j=$[O$],Z=j&&/^\d+$/.test(j)?Number(j):void 0,Q=Math.min(Math.max(1,W(Number($[X$]))??1),x),f=m($[B$]),X=f.length?f:[{runId:J,...Z!==void 0?{stepIndex:Z}:{}}];return{parentRunId:J,...Z!==void 0?{parentStepIndex:Z}:{},depth:Q,path:X}}function jJ($,J){if(!J.asyncDir)return;let j=O.resolve(J.asyncDir),Z=O.resolve(L,"nested-subagent-runs",$,J.id),Q=O.relative(Z,j);return j===Z||!Q.startsWith("..")&&!O.isAbsolute(Q)?j:void 0}function W($){return typeof $==="number"&&Number.isFinite($)?$:void 0}function B($,J=512){return typeof $==="string"&&$.length>0?$.slice(0,J):void 0}function h$($){if(!$||typeof $!=="object")return;let J=$,j=W(J.input),Z=W(J.output),Q=W(J.total);return j!==void 0&&Z!==void 0&&Q!==void 0?{input:j,output:Z,total:Q}:void 0}function m$($){if(!$||typeof $!=="object")return;let J=$,j=W(J.inputTokens),Z=W(J.outputTokens),Q=W(J.costUsd);return j!==void 0&&Z!==void 0&&Q!==void 0?{inputTokens:j,outputTokens:Z,costUsd:Q}:void 0}function P($){if(!$||typeof $!=="object")return;let J=$,j=W(J.maxTurns),Z=W(J.graceTurns),Q=W(J.turnCount),f=J.outcome==="within-budget"||J.outcome==="wrap-up-requested"||J.outcome==="exceeded"?J.outcome:void 0;if(j===void 0||Z===void 0||Q===void 0||!f)return;return{maxTurns:j,graceTurns:Z,turnCount:Q,outcome:f,...W(J.wrapUpRequestedAtTurn)!==void 0?{wrapUpRequestedAtTurn:W(J.wrapUpRequestedAtTurn)}:{},...W(J.exceededAtTurn)!==void 0?{exceededAtTurn:W(J.exceededAtTurn)}:{}}}function n$($,J){return $==="queued"||$==="running"||$==="complete"||$==="failed"||$==="paused"?$:J}function d$($,J){if(!$||typeof $!=="object")return;let j=$,Z=B(j.agent,128);if(!Z)return;let Q=j.status==="pending"||j.status==="running"||j.status==="complete"||j.status==="completed"||j.status==="failed"||j.status==="paused"?j.status:"pending";return{agent:Z,status:Q,...B(j.sessionFile,2048)?{sessionFile:B(j.sessionFile,2048)}:{},...j.activityState==="active_long_running"||j.activityState==="needs_attention"?{activityState:j.activityState}:{},...W(j.lastActivityAt)!==void 0?{lastActivityAt:W(j.lastActivityAt)}:{},...B(j.currentTool,128)?{currentTool:B(j.currentTool,128)}:{},...W(j.currentToolStartedAt)!==void 0?{currentToolStartedAt:W(j.currentToolStartedAt)}:{},...B(j.currentPath,2048)?{currentPath:B(j.currentPath,2048)}:{},...W(j.turnCount)!==void 0?{turnCount:W(j.turnCount)}:{},...W(j.toolCount)!==void 0?{toolCount:W(j.toolCount)}:{},...W(j.startedAt)!==void 0?{startedAt:W(j.startedAt)}:{},...W(j.endedAt)!==void 0?{endedAt:W(j.endedAt)}:{},...B(j.error,1024)?{error:B(j.error,1024)}:{},...j.timedOut===!0?{timedOut:!0}:{},...P(j.turnBudget)?{turnBudget:P(j.turnBudget)}:{},...j.turnBudgetExceeded===!0?{turnBudgetExceeded:!0}:{},...j.wrapUpRequested===!0?{wrapUpRequested:!0}:{},...J<x&&Array.isArray(j.children)?{children:j.children.map((f)=>v(f,J+1)).filter((f)=>Boolean(f)).slice(0,b)}:{}}}function v($,J=0){if(!$||typeof $!=="object")return;let j=$;if(!A(j.id)||!A(j.parentRunId))return;let Z=h(j.path),Q=Array.isArray(j.steps)?j.steps.map((K)=>d$(K,J+1)).filter((K)=>Boolean(K)).slice(0,u):void 0,f=h$(j.totalTokens),X=m$(j.totalCost);return{id:j.id,parentRunId:j.parentRunId,...W(j.parentStepIndex)!==void 0?{parentStepIndex:W(j.parentStepIndex)}:{},...B(j.parentAgent,128)?{parentAgent:B(j.parentAgent,128)}:{},depth:Math.min(Math.max(0,W(j.depth)??0),x),path:Z,state:n$(j.state,"running"),...B(j.asyncDir,2048)?{asyncDir:B(j.asyncDir,2048)}:{},...W(j.pid)!==void 0&&W(j.pid)>0&&Number.isInteger(W(j.pid))?{pid:W(j.pid)}:{},...B(j.sessionId,256)?{sessionId:B(j.sessionId,256)}:{},...B(j.sessionFile,2048)?{sessionFile:B(j.sessionFile,2048)}:{},...B(j.intercomTarget,256)?{intercomTarget:B(j.intercomTarget,256)}:{},...B(j.ownerIntercomTarget,256)?{ownerIntercomTarget:B(j.ownerIntercomTarget,256)}:{},...B(j.leafIntercomTarget,256)?{leafIntercomTarget:B(j.leafIntercomTarget,256)}:{},...j.ownerState==="live"||j.ownerState==="gone"||j.ownerState==="unknown"?{ownerState:j.ownerState}:{},...B(j.controlInbox,2048)?{controlInbox:B(j.controlInbox,2048)}:{},...B(j.capabilityToken,128)?{capabilityToken:B(j.capabilityToken,128)}:{},...j.mode==="single"||j.mode==="parallel"||j.mode==="chain"?{mode:j.mode}:{},...B(j.agent,128)?{agent:B(j.agent,128)}:{},...Array.isArray(j.agents)?{agents:j.agents.map((K)=>B(K,128)).filter((K)=>Boolean(K)).slice(0,u)}:{},...W(j.currentStep)!==void 0?{currentStep:W(j.currentStep)}:{},...W(j.chainStepCount)!==void 0?{chainStepCount:W(j.chainStepCount)}:{},...j.activityState==="active_long_running"||j.activityState==="needs_attention"?{activityState:j.activityState}:{},...W(j.lastActivityAt)!==void 0?{lastActivityAt:W(j.lastActivityAt)}:{},...B(j.currentTool,128)?{currentTool:B(j.currentTool,128)}:{},...W(j.currentToolStartedAt)!==void 0?{currentToolStartedAt:W(j.currentToolStartedAt)}:{},...B(j.currentPath,2048)?{currentPath:B(j.currentPath,2048)}:{},...W(j.turnCount)!==void 0?{turnCount:W(j.turnCount)}:{},...W(j.toolCount)!==void 0?{toolCount:W(j.toolCount)}:{},...f?{totalTokens:f}:{},...X?{totalCost:X}:{},...W(j.startedAt)!==void 0?{startedAt:W(j.startedAt)}:{},...W(j.endedAt)!==void 0?{endedAt:W(j.endedAt)}:{},...W(j.lastUpdate)!==void 0?{lastUpdate:W(j.lastUpdate)}:{},...W(j.timeoutMs)!==void 0?{timeoutMs:W(j.timeoutMs)}:{},...W(j.deadlineAt)!==void 0?{deadlineAt:W(j.deadlineAt)}:{},...j.timedOut===!0?{timedOut:!0}:{},...P(j.turnBudget)?{turnBudget:P(j.turnBudget)}:{},...j.turnBudgetExceeded===!0?{turnBudgetExceeded:!0}:{},...j.wrapUpRequested===!0?{wrapUpRequested:!0}:{},...B(j.error,1024)?{error:B(j.error,1024)}:{},...Q&&Q.length>0?{steps:Q}:{},...J<x&&Array.isArray(j.children)?{children:j.children.map((K)=>v(K,J+1)).filter((K)=>Boolean(K)).slice(0,b)}:{}}}function r($,J){if(Buffer.byteLength($,"utf-8")>E)return;let j;try{j=JSON.parse($)}catch{return}if(!j||typeof j!=="object")return;let Z=j;if(Z.type!=="subagent.nested.started"&&Z.type!=="subagent.nested.updated"&&Z.type!=="subagent.nested.completed")return;if(Z.rootRunId!==J.rootRunId||Z.capabilityToken!==J.capabilityToken)return;if(!A(Z.parentRunId))return;let Q=W(Z.ts);if(Q===void 0)return;let f=v(Z.child);if(!f||f.id===J.rootRunId)return;let X={...f,controlInbox:J.controlInbox,capabilityToken:J.capabilityToken,ownerState:f.ownerState??"unknown"};return{type:Z.type,ts:Q,rootRunId:J.rootRunId,parentRunId:Z.parentRunId,...W(Z.parentStepIndex)!==void 0?{parentStepIndex:W(Z.parentStepIndex)}:{},capabilityToken:J.capabilityToken,child:X}}function o$($,J){if(!$.includes(`
-`)){let j=r($.trim(),J);return j?[j]:[]}return $.split(`
-`).slice(0,$.endsWith(`
-`)?void 0:-1).map((j)=>j.trim()?r(j,J):void 0).filter((j)=>Boolean(j))}function R($){return $==="complete"||$==="failed"||$==="paused"}function G$($,J){let j=J.type==="subagent.nested.completed"&&J.child.state==="running"?"complete":J.child.state,Z={...J.child,state:j,lastUpdate:J.child.lastUpdate??J.ts};if(!$)return Z;let Q=$.lastUpdate??0,f=Z.lastUpdate??J.ts;if(f<Q)return $;if(R($.state)&&!R(Z.state))return $;if(R($.state)&&R(Z.state)&&f===Q)return $;return{...$,...Z,state:Z.state,lastUpdate:Math.max(Q,f)}}function p$($,J){let j=!1,Z=(K)=>K.map((q)=>{if(q.id===J.parentRunId){let T=q.children??[],I=T.findIndex((c)=>c.id===J.child.id),a=G$(I>=0?T[I]:void 0,J),A$=I>=0?T.map((c,T$)=>T$===I?a:c):[...T,a];return j=!0,{...q,children:A$.slice(0,b),lastUpdate:Math.max(q.lastUpdate??0,J.ts)}}if(!q.children?.length)return q;let z=Z(q.children);return z===q.children?q:{...q,children:z}}),Q=Z($);if(j)return Q;let f=Q.findIndex((K)=>K.id===J.child.id),X=G$(f>=0?Q[f]:void 0,J);return f>=0?Q.map((K,q)=>q===f?X:K):[...Q,X].slice(0,b)}function u$($,J){return{...$,updatedAt:Math.max($.updatedAt,J.ts),children:p$($.children,J)}}function L$($){return O.join(i($),k$)}function r$($){G("rootRunId",$);let J;try{J=Y.readdirSync(F)}catch(j){if(j.code==="ENOENT")return;throw j}for(let j of J){if(!j.startsWith(`${$}-`))continue;let Z=O.join(F,j);try{let Q=JSON.parse(Y.readFileSync(O.join(Z,D),"utf-8"));if(Q.rootRunId!==$||typeof Q.capabilityToken!=="string")continue;let f={rootRunId:$,eventSink:O.join(Z,"events"),controlInbox:O.join(Z,"controls"),capabilityToken:Q.capabilityToken};return H(f),f}catch{continue}}return}function JJ(){let $;try{$=Y.readdirSync(F)}catch(j){if(j.code==="ENOENT")return new Map;throw j}let J=new Map;for(let j of $){let Z=O.join(F,j);try{let Q=JSON.parse(Y.readFileSync(O.join(Z,D),"utf-8"));if(typeof Q.rootRunId!=="string"||typeof Q.capabilityToken!=="string")continue;if(J.has(Q.rootRunId))continue;let f={rootRunId:Q.rootRunId,eventSink:O.join(Z,"events"),controlInbox:O.join(Z,"controls"),capabilityToken:Q.capabilityToken};H(f),J.set(Q.rootRunId,f)}catch{continue}}return J}function ZJ($){let J=r$($);return J?k(J):void 0}function H$($,J){if(!$?.length)return;for(let j of $){if(j.id===J)return j;let Z=H$(j.children,J)??H$(j.steps?.flatMap((Q)=>Q.children??[]),J);if(Z)return Z}return}function w($,J=[]){for(let j of $??[])J.push(j),w(j.children,J),w(j.steps?.flatMap((Z)=>Z.children??[]),J);return J}function l($,J,j=[]){if(!J)return w($,j);for(let Z of $??[]){if(Z.parentRunId===J.parentRunId&&(J.parentStepIndex===void 0||Z.parentStepIndex===J.parentStepIndex)){w([Z],j);continue}l(Z.children,J,j),l(Z.steps?.flatMap((Q)=>Q.children??[]),J,j)}return j}function l$(){let $;try{$=Y.readdirSync(F)}catch(j){if(j.code==="ENOENT")return[];throw j}let J=[];for(let j of $){let Z=O.join(F,j);try{let Q=JSON.parse(Y.readFileSync(O.join(Z,D),"utf-8"));if(typeof Q.rootRunId!=="string"||typeof Q.capabilityToken!=="string")continue;let f={rootRunId:Q.rootRunId,eventSink:O.join(Z,"events"),controlInbox:O.join(Z,"controls"),capabilityToken:Q.capabilityToken};H(f),J.push(f)}catch{continue}}return J}function i$($,J={}){G("id",$);let j=[];for(let Z of J.scope?.routes??l$())try{let Q=k(Z);for(let f of l(Q.children,J.scope?.descendantOf))if(J.prefix?f.id.startsWith($):f.id===$)j.push({rootRunId:Z.rootRunId,route:Z,run:f})}catch{continue}return j}function QJ($){let J=i$($)[0];return J?{rootRunId:J.rootRunId,run:J.run}:void 0}function s$($){H($);try{let J=JSON.parse(Y.readFileSync(L$($),"utf-8"));return{rootRunId:$.rootRunId,updatedAt:typeof J.updatedAt==="number"?J.updatedAt:0,children:Array.isArray(J.children)?J.children.map((j)=>v(j)).filter((j)=>Boolean(j)):[],processedEvents:Array.isArray(J.processedEvents)?J.processedEvents.filter((j)=>typeof j==="string"):[]}}catch(J){if(J.code!=="ENOENT")throw J;return{rootRunId:$.rootRunId,updatedAt:0,children:[],processedEvents:[]}}}function k($){H($);let J=s$($),j=new Set(J.processedEvents),Z=!1,Q=[];try{Q=Y.readdirSync($.eventSink).filter((f)=>f.endsWith(".json")||f.endsWith(".jsonl")).sort()}catch(f){if(f.code!=="ENOENT")throw f}for(let f of Q){if(j.has(f))continue;let X=O.join($.eventSink,f);if(!_($.eventSink,X))continue;let K;try{let q=Y.statSync(X);if(!q.isFile()||q.size>E)continue;K=Y.readFileSync(X,"utf-8")}catch{continue}for(let q of o$(K,$))J=u$(J,q),Z=!0;j.add(f),Z=!0}if(Z)J={...J,processedEvents:[...j].slice(-1000)},q$(L$($),J);return J}function s($,J,j){let Z=`${JSON.stringify(j)}
-`;if(Buffer.byteLength(Z,"utf-8")>E)throw Error("Nested route record exceeds the maximum size.");Y.mkdirSync($,{recursive:!0,mode:448});let Q=`${String(J).padStart(13,"0")}-${M$()}.json`,f=O.join($,`.${Q}.tmp`),X=O.join($,Q);return Y.writeFileSync(f,Z,{mode:384}),Y.renameSync(f,X),X}function fJ($,J){H($);let j={...J,rootRunId:$.rootRunId,capabilityToken:$.capabilityToken},Z=r(JSON.stringify(j),$);if(!Z)throw Error("Nested event record failed validation.");s($.eventSink,Z.ts,Z)}function V$($,J){if(Buffer.byteLength($,"utf-8")>E)return;let j;try{j=JSON.parse($)}catch{return}if(!j||typeof j!=="object")return;let Z=j;if(Z.type!=="subagent.nested.control-request")return;if(Z.rootRunId!==J.rootRunId||Z.capabilityToken!==J.capabilityToken)return;if(!A(Z.requestId)||!A(Z.targetRunId))return;if(Z.action!=="interrupt"&&Z.action!=="resume")return;let Q=W(Z.ts);if(Q===void 0)return;return{type:"subagent.nested.control-request",ts:Q,rootRunId:J.rootRunId,capabilityToken:J.capabilityToken,requestId:Z.requestId,targetRunId:Z.targetRunId,action:Z.action,...B(Z.message,16000)?{message:B(Z.message,16000)}:{}}}function F$($,J){if(Buffer.byteLength($,"utf-8")>E)return;let j;try{j=JSON.parse($)}catch{return}if(!j||typeof j!=="object")return;let Z=j;if(Z.type!=="subagent.nested.control-result")return;if(Z.rootRunId!==J.rootRunId||Z.capabilityToken!==J.capabilityToken)return;if(!A(Z.requestId)||!A(Z.targetRunId))return;let Q=W(Z.ts);if(Q===void 0||typeof Z.ok!=="boolean")return;return{type:"subagent.nested.control-result",ts:Q,rootRunId:J.rootRunId,capabilityToken:J.capabilityToken,requestId:Z.requestId,targetRunId:Z.targetRunId,ok:Z.ok,message:B(Z.message,16000)??(Z.ok?"Control request completed.":"Control request failed.")}}function WJ($,J){H($),G("requestId",J.requestId),G("targetRunId",J.targetRunId);let j={type:"subagent.nested.control-request",...J,rootRunId:$.rootRunId,capabilityToken:$.capabilityToken},Z=V$(JSON.stringify(j),$);if(!Z)throw Error("Nested control request failed validation.");return s($.controlInbox,Z.ts,Z)}function OJ($){H($);let J=[];try{J=Y.readdirSync($.controlInbox).filter((Z)=>Z.endsWith(".json")).sort()}catch(Z){if(Z.code!=="ENOENT")throw Z}let j=[];for(let Z of J){let Q=O.join($.controlInbox,Z);if(!_($.controlInbox,Q))continue;try{let f=Y.statSync(Q);if(!f.isFile()||f.size>E)continue;let X=V$(Y.readFileSync(Q,"utf-8"),$);if(X)j.push({...X,filePath:Q})}catch{continue}}return j}function XJ($,J){H($),G("requestId",J.requestId),G("targetRunId",J.targetRunId);let j={type:"subagent.nested.control-result",...J,rootRunId:$.rootRunId,capabilityToken:$.capabilityToken},Z=F$(JSON.stringify(j),$);if(!Z)throw Error("Nested control result failed validation.");s($.eventSink,Z.ts,Z)}function BJ($){H($);let J=[];try{J=Y.readdirSync($.eventSink).filter((Z)=>Z.endsWith(".json")||Z.endsWith(".jsonl")).sort()}catch(Z){if(Z.code!=="ENOENT")throw Z}let j=[];for(let Z of J){let Q=O.join($.eventSink,Z);if(!_($.eventSink,Q))continue;try{let f=Y.statSync(Q);if(!f.isFile()||f.size>E)continue;let X=Y.readFileSync(Q,"utf-8"),K=X.includes(`
-`)?X.split(`
-`).filter((q)=>q.trim()):[X];for(let q of K){let z=F$(q,$);if(z)j.push(z)}}catch{continue}}return j}function KJ($){return{[n]:$.eventSink,[d]:$.controlInbox,[o]:$.rootRunId,[p]:$.capabilityToken}}function a$($,J,j){if(!J?.length)return;for(let Z of J)Z.children=void 0;if(!j?.length)return;for(let Z of j){if(Z.parentRunId!==$||Z.parentStepIndex===void 0)continue;let Q=J.find((f,X)=>(f.index??X)===Z.parentStepIndex);if(!Q)continue;Q.children??=[],Q.children=[...Q.children.filter((f)=>f.id!==Z.id),Z].slice(0,b)}}function YJ($){if(!$.nestedRoute)return;let J=k($.nestedRoute);$.nestedChildren=J.children,a$($.asyncId,$.steps,J.children)}function qJ($){if(!$.nestedRoute)return;let J=k($.nestedRoute);$.nestedChildren=J.children}function U$($){if(!$?.length)return!1;for(let J of $){if(!R(J.state))return!0;if(U$(J.children))return!0;if(U$(J.steps?.flatMap((j)=>j.children??[])))return!0}return!1}function GJ($,J,j){return{id:$.runId||j.id,parentRunId:j.parentRunId,...j.parentStepIndex!==void 0?{parentStepIndex:j.parentStepIndex}:{},depth:j.depth,path:j.path??[{runId:j.parentRunId,...j.parentStepIndex!==void 0?{stepIndex:j.parentStepIndex}:{}}],asyncDir:J,...$.pid?{pid:$.pid}:{},...$.sessionId?{sessionId:$.sessionId}:{},mode:$.mode??j.mode,state:$.state,...$.currentStep!==void 0?{currentStep:$.currentStep}:{},...$.chainStepCount!==void 0?{chainStepCount:$.chainStepCount}:{},...$.activityState?{activityState:$.activityState}:{},...$.lastActivityAt!==void 0?{lastActivityAt:$.lastActivityAt}:{},...$.currentTool?{currentTool:$.currentTool}:{},...$.currentToolStartedAt!==void 0?{currentToolStartedAt:$.currentToolStartedAt}:{},...$.currentPath?{currentPath:$.currentPath}:{},...$.turnCount!==void 0?{turnCount:$.turnCount}:{},...$.toolCount!==void 0?{toolCount:$.toolCount}:{},...$.totalTokens?{totalTokens:$.totalTokens}:{},...$.timeoutMs!==void 0?{timeoutMs:$.timeoutMs}:{},...$.deadlineAt!==void 0?{deadlineAt:$.deadlineAt}:{},...$.timedOut!==void 0?{timedOut:$.timedOut}:{},...$.turnBudget?{turnBudget:$.turnBudget}:{},...$.turnBudgetExceeded!==void 0?{turnBudgetExceeded:$.turnBudgetExceeded}:{},...$.wrapUpRequested!==void 0?{wrapUpRequested:$.wrapUpRequested}:{},...$.error?{error:$.error}:{},...$.startedAt!==void 0?{startedAt:$.startedAt}:{startedAt:j.ts},...$.endedAt!==void 0?{endedAt:$.endedAt}:{},lastUpdate:$.lastUpdate??j.ts,...$.sessionFile?{sessionFile:$.sessionFile}:{},...$.steps?.length?{steps:$.steps.map((Z)=>({agent:Z.agent,status:Z.status,...Z.sessionFile?{sessionFile:Z.sessionFile}:{},...Z.activityState?{activityState:Z.activityState}:{},...Z.lastActivityAt!==void 0?{lastActivityAt:Z.lastActivityAt}:{},...Z.currentTool?{currentTool:Z.currentTool}:{},...Z.currentToolStartedAt!==void 0?{currentToolStartedAt:Z.currentToolStartedAt}:{},...Z.currentPath?{currentPath:Z.currentPath}:{},...Z.turnCount!==void 0?{turnCount:Z.turnCount}:{},...Z.toolCount!==void 0?{toolCount:Z.toolCount}:{},...Z.startedAt!==void 0?{startedAt:Z.startedAt}:{},...Z.endedAt!==void 0?{endedAt:Z.endedAt}:{},...Z.error?{error:Z.error}:{},...Z.timedOut!==void 0?{timedOut:Z.timedOut}:{},...Z.turnBudget?{turnBudget:Z.turnBudget}:{},...Z.turnBudgetExceeded!==void 0?{turnBudgetExceeded:Z.turnBudgetExceeded}:{},...Z.wrapUpRequested!==void 0?{wrapUpRequested:Z.wrapUpRequested}:{}})).slice(0,u)}:{}}}function HJ($,J){return{DM_SUBAGENT_NESTED_ROOT_RUN_ID:$,DM_SUBAGENT_NESTED_PARENT_RUN_ID:J}}function UJ($){let J=O.resolve($);return _(e,J)&&!_(O.join(L,"nested-subagent-runs"),J)}function MJ($,J){return G("rootRunId",$),G("id",J),O.join(t,"nested",$,`${J}.json`)}export{fJ as writeNestedEvent,XJ as writeNestedControlResult,WJ as writeNestedControlRequest,qJ as updateForegroundNestedProjection,YJ as updateAsyncJobNestedProjection,v as sanitizeSummary,g$ as resolveNestedRouteFromEnv,$J as resolveNestedParentAddressFromEnv,jJ as resolveNestedAsyncDir,ej as resolveInheritedNestedRouteFromEnv,s$ as readNestedRegistry,BJ as readNestedControlResults,OJ as readNestedControlRequests,ZJ as projectNestedRegistryForRoot,k as projectNestedEvents,o$ as parseNestedEventRecords,GJ as nestedSummaryFromAsyncStatus,KJ as nestedRouteEnv,MJ as nestedResultsPath,HJ as nestedArtifactEnv,UJ as isTopLevelAsyncDir,A as isSafeNestedId,U$ as hasLiveNestedDescendants,i$ as findNestedRunMatchesById,QJ as findNestedRunById,H$ as findNestedRun,r$ as findNestedRouteForRootId,tj as createNestedRoute,JJ as buildNestedRouteIndex,a$ as attachRootChildrenToSteps,c$ as assertSafeNestedId,u$ as applyNestedEvent,F as NESTED_EVENTS_DIR};
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import {
+  ASYNC_DIR,
+  RESULTS_DIR,
+  TEMP_ROOT_DIR
+} from "../../shared/types.js";
+import { isSafeNestedPathId, parseNestedPathEnv, sanitizeNestedPath } from "./nested-path.js";
+import {
+  SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV,
+  SUBAGENT_PARENT_CHILD_INDEX_ENV,
+  SUBAGENT_PARENT_CONTROL_INBOX_ENV,
+  SUBAGENT_PARENT_DEPTH_ENV,
+  SUBAGENT_PARENT_EVENT_SINK_ENV,
+  SUBAGENT_PARENT_PATH_ENV,
+  SUBAGENT_PARENT_ROOT_RUN_ID_ENV,
+  SUBAGENT_PARENT_RUN_ID_ENV
+} from "./dm-args.js";
+import { writeAtomicJson } from "../../shared/atomic-json.js";
+export const NESTED_EVENTS_DIR = path.join(TEMP_ROOT_DIR, "nested-subagent-events");
+const ROUTE_FILE = "route.json";
+const REGISTRY_FILE = "registry.json";
+const MAX_EVENT_BYTES = 64 * 1024;
+const MAX_STEPS = 12;
+const MAX_CHILDREN = 16;
+const MAX_DEPTH = 3;
+export function isSafeNestedId(value) {
+  return isSafeNestedPathId(value);
+}
+export function assertSafeNestedId(label, value) {
+  if (!isSafeNestedId(value))
+    throw new Error(`${label} must be a non-empty safe id token.`);
+}
+function assertSafeId(label, value) {
+  assertSafeNestedId(label, value);
+}
+function containedPath(base, candidate) {
+  const resolvedBase = path.resolve(base);
+  const resolvedCandidate = path.resolve(candidate);
+  return resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path.sep}`);
+}
+function commonRouteRoot(route) {
+  return path.dirname(path.resolve(route.eventSink));
+}
+function validateRouteShape(route) {
+  assertSafeId("rootRunId", route.rootRunId);
+  assertSafeId("capabilityToken", route.capabilityToken);
+  if (!containedPath(NESTED_EVENTS_DIR, route.eventSink))
+    throw new Error("Nested event sink is outside the subagent nested event root.");
+  if (!containedPath(NESTED_EVENTS_DIR, route.controlInbox))
+    throw new Error("Nested control inbox is outside the subagent nested event root.");
+  if (commonRouteRoot(route) !== path.dirname(path.resolve(route.controlInbox)))
+    throw new Error("Nested event sink and control inbox must share one route root.");
+}
+export function createNestedRoute(rootRunId) {
+  assertSafeId("rootRunId", rootRunId);
+  const capabilityToken = randomUUID();
+  const routeRoot = path.join(NESTED_EVENTS_DIR, `${rootRunId}-${capabilityToken}`);
+  const eventSink = path.join(routeRoot, "events");
+  const controlInbox = path.join(routeRoot, "controls");
+  fs.mkdirSync(eventSink, { recursive: true, mode: 448 });
+  fs.mkdirSync(controlInbox, { recursive: true, mode: 448 });
+  fs.writeFileSync(path.join(routeRoot, ROUTE_FILE), `${JSON.stringify({ rootRunId, capabilityToken, createdAt: Date.now() })}
+`, { mode: 384 });
+  return { rootRunId, eventSink, controlInbox, capabilityToken };
+}
+export function resolveNestedRouteFromEnv(env = process.env) {
+  const rootRunId = env[SUBAGENT_PARENT_ROOT_RUN_ID_ENV];
+  const eventSink = env[SUBAGENT_PARENT_EVENT_SINK_ENV];
+  const controlInbox = env[SUBAGENT_PARENT_CONTROL_INBOX_ENV];
+  const capabilityToken = env[SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV];
+  if (!rootRunId || !eventSink || !controlInbox || !capabilityToken)
+    return;
+  const route = { rootRunId, eventSink, controlInbox, capabilityToken };
+  validateRouteShape(route);
+  const routeFile = path.join(commonRouteRoot(route), ROUTE_FILE);
+  const metadata = JSON.parse(fs.readFileSync(routeFile, "utf-8"));
+  if (metadata.rootRunId !== rootRunId || metadata.capabilityToken !== capabilityToken) {
+    throw new Error("Nested event route metadata does not match the provided root id and capability token.");
+  }
+  return route;
+}
+export function resolveInheritedNestedRouteFromEnv(env = process.env) {
+  try {
+    return resolveNestedRouteFromEnv(env);
+  } catch (error) {
+    console.error("Ignoring invalid nested subagent event route:", error);
+    return;
+  }
+}
+export function resolveNestedParentAddressFromEnv(env = process.env) {
+  const parentRunId = env[SUBAGENT_PARENT_RUN_ID_ENV];
+  if (!isSafeNestedId(parentRunId))
+    return;
+  const rawIndex = env[SUBAGENT_PARENT_CHILD_INDEX_ENV];
+  const parentStepIndex = rawIndex && /^\d+$/.test(rawIndex) ? Number(rawIndex) : undefined;
+  const depth = Math.min(Math.max(1, clampNumber(Number(env[SUBAGENT_PARENT_DEPTH_ENV])) ?? 1), MAX_DEPTH);
+  const parsedPath = parseNestedPathEnv(env[SUBAGENT_PARENT_PATH_ENV]);
+  const nestedPath = parsedPath.length ? parsedPath : [{ runId: parentRunId, ...parentStepIndex !== undefined ? { stepIndex: parentStepIndex } : {} }];
+  return { parentRunId, ...parentStepIndex !== undefined ? { parentStepIndex } : {}, depth, path: nestedPath };
+}
+export function resolveNestedAsyncDir(rootRunId, run) {
+  if (!run.asyncDir)
+    return;
+  const resolved = path.resolve(run.asyncDir);
+  const nestedRoot = path.resolve(TEMP_ROOT_DIR, "nested-subagent-runs", rootRunId, run.id);
+  const relative = path.relative(nestedRoot, resolved);
+  return resolved === nestedRoot || !relative.startsWith("..") && !path.isAbsolute(relative) ? resolved : undefined;
+}
+function clampNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function stringValue(value, max = 512) {
+  return typeof value === "string" && value.length > 0 ? value.slice(0, max) : undefined;
+}
+function sanitizeTokenUsage(value) {
+  if (!value || typeof value !== "object")
+    return;
+  const raw = value;
+  const input = clampNumber(raw.input);
+  const output = clampNumber(raw.output);
+  const total = clampNumber(raw.total);
+  return input !== undefined && output !== undefined && total !== undefined ? { input, output, total } : undefined;
+}
+function sanitizeCost(value) {
+  if (!value || typeof value !== "object")
+    return;
+  const raw = value;
+  const inputTokens = clampNumber(raw.inputTokens);
+  const outputTokens = clampNumber(raw.outputTokens);
+  const costUsd = clampNumber(raw.costUsd);
+  return inputTokens !== undefined && outputTokens !== undefined && costUsd !== undefined ? { inputTokens, outputTokens, costUsd } : undefined;
+}
+function sanitizeTurnBudget(value) {
+  if (!value || typeof value !== "object")
+    return;
+  const raw = value;
+  const maxTurns = clampNumber(raw.maxTurns);
+  const graceTurns = clampNumber(raw.graceTurns);
+  const turnCount = clampNumber(raw.turnCount);
+  const outcome = raw.outcome === "within-budget" || raw.outcome === "wrap-up-requested" || raw.outcome === "exceeded" ? raw.outcome : undefined;
+  if (maxTurns === undefined || graceTurns === undefined || turnCount === undefined || !outcome)
+    return;
+  return {
+    maxTurns,
+    graceTurns,
+    turnCount,
+    outcome,
+    ...clampNumber(raw.wrapUpRequestedAtTurn) !== undefined ? { wrapUpRequestedAtTurn: clampNumber(raw.wrapUpRequestedAtTurn) } : {},
+    ...clampNumber(raw.exceededAtTurn) !== undefined ? { exceededAtTurn: clampNumber(raw.exceededAtTurn) } : {}
+  };
+}
+function sanitizeState(value, fallback) {
+  return value === "queued" || value === "running" || value === "complete" || value === "failed" || value === "paused" ? value : fallback;
+}
+function sanitizeStep(input, depth) {
+  if (!input || typeof input !== "object")
+    return;
+  const raw = input;
+  const agent = stringValue(raw.agent, 128);
+  if (!agent)
+    return;
+  const status = raw.status === "pending" || raw.status === "running" || raw.status === "complete" || raw.status === "completed" || raw.status === "failed" || raw.status === "paused" ? raw.status : "pending";
+  return {
+    agent,
+    status,
+    ...stringValue(raw.sessionFile, 2048) ? { sessionFile: stringValue(raw.sessionFile, 2048) } : {},
+    ...raw.activityState === "active_long_running" || raw.activityState === "needs_attention" ? { activityState: raw.activityState } : {},
+    ...clampNumber(raw.lastActivityAt) !== undefined ? { lastActivityAt: clampNumber(raw.lastActivityAt) } : {},
+    ...stringValue(raw.currentTool, 128) ? { currentTool: stringValue(raw.currentTool, 128) } : {},
+    ...clampNumber(raw.currentToolStartedAt) !== undefined ? { currentToolStartedAt: clampNumber(raw.currentToolStartedAt) } : {},
+    ...stringValue(raw.currentPath, 2048) ? { currentPath: stringValue(raw.currentPath, 2048) } : {},
+    ...clampNumber(raw.turnCount) !== undefined ? { turnCount: clampNumber(raw.turnCount) } : {},
+    ...clampNumber(raw.toolCount) !== undefined ? { toolCount: clampNumber(raw.toolCount) } : {},
+    ...clampNumber(raw.startedAt) !== undefined ? { startedAt: clampNumber(raw.startedAt) } : {},
+    ...clampNumber(raw.endedAt) !== undefined ? { endedAt: clampNumber(raw.endedAt) } : {},
+    ...stringValue(raw.error, 1024) ? { error: stringValue(raw.error, 1024) } : {},
+    ...raw.timedOut === true ? { timedOut: true } : {},
+    ...sanitizeTurnBudget(raw.turnBudget) ? { turnBudget: sanitizeTurnBudget(raw.turnBudget) } : {},
+    ...raw.turnBudgetExceeded === true ? { turnBudgetExceeded: true } : {},
+    ...raw.wrapUpRequested === true ? { wrapUpRequested: true } : {},
+    ...depth < MAX_DEPTH && Array.isArray(raw.children) ? { children: raw.children.map((child) => sanitizeSummary(child, depth + 1)).filter((child) => Boolean(child)).slice(0, MAX_CHILDREN) } : {}
+  };
+}
+export function sanitizeSummary(input, depth = 0) {
+  if (!input || typeof input !== "object")
+    return;
+  const raw = input;
+  if (!isSafeNestedId(raw.id) || !isSafeNestedId(raw.parentRunId))
+    return;
+  const pathParts = sanitizeNestedPath(raw.path);
+  const steps = Array.isArray(raw.steps) ? raw.steps.map((step) => sanitizeStep(step, depth + 1)).filter((step) => Boolean(step)).slice(0, MAX_STEPS) : undefined;
+  const totalTokens = sanitizeTokenUsage(raw.totalTokens);
+  const totalCost = sanitizeCost(raw.totalCost);
+  return {
+    id: raw.id,
+    parentRunId: raw.parentRunId,
+    ...clampNumber(raw.parentStepIndex) !== undefined ? { parentStepIndex: clampNumber(raw.parentStepIndex) } : {},
+    ...stringValue(raw.parentAgent, 128) ? { parentAgent: stringValue(raw.parentAgent, 128) } : {},
+    depth: Math.min(Math.max(0, clampNumber(raw.depth) ?? 0), MAX_DEPTH),
+    path: pathParts,
+    state: sanitizeState(raw.state, "running"),
+    ...stringValue(raw.asyncDir, 2048) ? { asyncDir: stringValue(raw.asyncDir, 2048) } : {},
+    ...clampNumber(raw.pid) !== undefined && clampNumber(raw.pid) > 0 && Number.isInteger(clampNumber(raw.pid)) ? { pid: clampNumber(raw.pid) } : {},
+    ...stringValue(raw.sessionId, 256) ? { sessionId: stringValue(raw.sessionId, 256) } : {},
+    ...stringValue(raw.sessionFile, 2048) ? { sessionFile: stringValue(raw.sessionFile, 2048) } : {},
+    ...stringValue(raw.intercomTarget, 256) ? { intercomTarget: stringValue(raw.intercomTarget, 256) } : {},
+    ...stringValue(raw.ownerIntercomTarget, 256) ? { ownerIntercomTarget: stringValue(raw.ownerIntercomTarget, 256) } : {},
+    ...stringValue(raw.leafIntercomTarget, 256) ? { leafIntercomTarget: stringValue(raw.leafIntercomTarget, 256) } : {},
+    ...raw.ownerState === "live" || raw.ownerState === "gone" || raw.ownerState === "unknown" ? { ownerState: raw.ownerState } : {},
+    ...stringValue(raw.controlInbox, 2048) ? { controlInbox: stringValue(raw.controlInbox, 2048) } : {},
+    ...stringValue(raw.capabilityToken, 128) ? { capabilityToken: stringValue(raw.capabilityToken, 128) } : {},
+    ...raw.mode === "single" || raw.mode === "parallel" || raw.mode === "chain" ? { mode: raw.mode } : {},
+    ...stringValue(raw.agent, 128) ? { agent: stringValue(raw.agent, 128) } : {},
+    ...Array.isArray(raw.agents) ? { agents: raw.agents.map((agent) => stringValue(agent, 128)).filter((agent) => Boolean(agent)).slice(0, MAX_STEPS) } : {},
+    ...clampNumber(raw.currentStep) !== undefined ? { currentStep: clampNumber(raw.currentStep) } : {},
+    ...clampNumber(raw.chainStepCount) !== undefined ? { chainStepCount: clampNumber(raw.chainStepCount) } : {},
+    ...raw.activityState === "active_long_running" || raw.activityState === "needs_attention" ? { activityState: raw.activityState } : {},
+    ...clampNumber(raw.lastActivityAt) !== undefined ? { lastActivityAt: clampNumber(raw.lastActivityAt) } : {},
+    ...stringValue(raw.currentTool, 128) ? { currentTool: stringValue(raw.currentTool, 128) } : {},
+    ...clampNumber(raw.currentToolStartedAt) !== undefined ? { currentToolStartedAt: clampNumber(raw.currentToolStartedAt) } : {},
+    ...stringValue(raw.currentPath, 2048) ? { currentPath: stringValue(raw.currentPath, 2048) } : {},
+    ...clampNumber(raw.turnCount) !== undefined ? { turnCount: clampNumber(raw.turnCount) } : {},
+    ...clampNumber(raw.toolCount) !== undefined ? { toolCount: clampNumber(raw.toolCount) } : {},
+    ...totalTokens ? { totalTokens } : {},
+    ...totalCost ? { totalCost } : {},
+    ...clampNumber(raw.startedAt) !== undefined ? { startedAt: clampNumber(raw.startedAt) } : {},
+    ...clampNumber(raw.endedAt) !== undefined ? { endedAt: clampNumber(raw.endedAt) } : {},
+    ...clampNumber(raw.lastUpdate) !== undefined ? { lastUpdate: clampNumber(raw.lastUpdate) } : {},
+    ...clampNumber(raw.timeoutMs) !== undefined ? { timeoutMs: clampNumber(raw.timeoutMs) } : {},
+    ...clampNumber(raw.deadlineAt) !== undefined ? { deadlineAt: clampNumber(raw.deadlineAt) } : {},
+    ...raw.timedOut === true ? { timedOut: true } : {},
+    ...sanitizeTurnBudget(raw.turnBudget) ? { turnBudget: sanitizeTurnBudget(raw.turnBudget) } : {},
+    ...raw.turnBudgetExceeded === true ? { turnBudgetExceeded: true } : {},
+    ...raw.wrapUpRequested === true ? { wrapUpRequested: true } : {},
+    ...stringValue(raw.error, 1024) ? { error: stringValue(raw.error, 1024) } : {},
+    ...steps && steps.length > 0 ? { steps } : {},
+    ...depth < MAX_DEPTH && Array.isArray(raw.children) ? { children: raw.children.map((child) => sanitizeSummary(child, depth + 1)).filter((child) => Boolean(child)).slice(0, MAX_CHILDREN) } : {}
+  };
+}
+function parseRecord(content, route) {
+  if (Buffer.byteLength(content, "utf-8") > MAX_EVENT_BYTES)
+    return;
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    return;
+  }
+  if (!parsed || typeof parsed !== "object")
+    return;
+  const raw = parsed;
+  if (raw.type !== "subagent.nested.started" && raw.type !== "subagent.nested.updated" && raw.type !== "subagent.nested.completed")
+    return;
+  if (raw.rootRunId !== route.rootRunId || raw.capabilityToken !== route.capabilityToken)
+    return;
+  if (!isSafeNestedId(raw.parentRunId))
+    return;
+  const ts = clampNumber(raw.ts);
+  if (ts === undefined)
+    return;
+  const child = sanitizeSummary(raw.child);
+  if (!child || child.id === route.rootRunId)
+    return;
+  const routedChild = {
+    ...child,
+    controlInbox: route.controlInbox,
+    capabilityToken: route.capabilityToken,
+    ownerState: child.ownerState ?? "unknown"
+  };
+  return {
+    type: raw.type,
+    ts,
+    rootRunId: route.rootRunId,
+    parentRunId: raw.parentRunId,
+    ...clampNumber(raw.parentStepIndex) !== undefined ? { parentStepIndex: clampNumber(raw.parentStepIndex) } : {},
+    capabilityToken: route.capabilityToken,
+    child: routedChild
+  };
+}
+export function parseNestedEventRecords(content, route) {
+  if (!content.includes(`
+`)) {
+    const record = parseRecord(content.trim(), route);
+    return record ? [record] : [];
+  }
+  return content.split(`
+`).slice(0, content.endsWith(`
+`) ? undefined : -1).map((line) => line.trim() ? parseRecord(line, route) : undefined).filter((event) => Boolean(event));
+}
+function terminal(state) {
+  return state === "complete" || state === "failed" || state === "paused";
+}
+function mergeSummary(existing, event) {
+  const incomingState = event.type === "subagent.nested.completed" && event.child.state === "running" ? "complete" : event.child.state;
+  const incoming = { ...event.child, state: incomingState, lastUpdate: event.child.lastUpdate ?? event.ts };
+  if (!existing)
+    return incoming;
+  const existingUpdate = existing.lastUpdate ?? 0;
+  const incomingUpdate = incoming.lastUpdate ?? event.ts;
+  if (incomingUpdate < existingUpdate)
+    return existing;
+  if (terminal(existing.state) && !terminal(incoming.state))
+    return existing;
+  if (terminal(existing.state) && terminal(incoming.state) && incomingUpdate === existingUpdate)
+    return existing;
+  return { ...existing, ...incoming, state: incoming.state, lastUpdate: Math.max(existingUpdate, incomingUpdate) };
+}
+function attachChild(children, event) {
+  let updated = false;
+  const walk = (items) => items.map((item) => {
+    if (item.id === event.parentRunId) {
+      const existingChildren = item.children ?? [];
+      const childIndex = existingChildren.findIndex((child) => child.id === event.child.id);
+      const nextChild = mergeSummary(childIndex >= 0 ? existingChildren[childIndex] : undefined, event);
+      const nextChildren = childIndex >= 0 ? existingChildren.map((child, index) => index === childIndex ? nextChild : child) : [...existingChildren, nextChild];
+      updated = true;
+      return { ...item, children: nextChildren.slice(0, MAX_CHILDREN), lastUpdate: Math.max(item.lastUpdate ?? 0, event.ts) };
+    }
+    if (!item.children?.length)
+      return item;
+    const nextChildren = walk(item.children);
+    return nextChildren === item.children ? item : { ...item, children: nextChildren };
+  });
+  const next = walk(children);
+  if (updated)
+    return next;
+  const childIndex = next.findIndex((child) => child.id === event.child.id);
+  const nextChild = mergeSummary(childIndex >= 0 ? next[childIndex] : undefined, event);
+  return childIndex >= 0 ? next.map((child, index) => index === childIndex ? nextChild : child) : [...next, nextChild].slice(0, MAX_CHILDREN);
+}
+export function applyNestedEvent(registry, event) {
+  return {
+    ...registry,
+    updatedAt: Math.max(registry.updatedAt, event.ts),
+    children: attachChild(registry.children, event)
+  };
+}
+function registryPath(route) {
+  return path.join(commonRouteRoot(route), REGISTRY_FILE);
+}
+export function findNestedRouteForRootId(rootRunId) {
+  assertSafeId("rootRunId", rootRunId);
+  let entries;
+  try {
+    entries = fs.readdirSync(NESTED_EVENTS_DIR);
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return;
+    throw error;
+  }
+  for (const entry of entries) {
+    if (!entry.startsWith(`${rootRunId}-`))
+      continue;
+    const routeRoot = path.join(NESTED_EVENTS_DIR, entry);
+    try {
+      const metadata = JSON.parse(fs.readFileSync(path.join(routeRoot, ROUTE_FILE), "utf-8"));
+      if (metadata.rootRunId !== rootRunId || typeof metadata.capabilityToken !== "string")
+        continue;
+      const route = {
+        rootRunId,
+        eventSink: path.join(routeRoot, "events"),
+        controlInbox: path.join(routeRoot, "controls"),
+        capabilityToken: metadata.capabilityToken
+      };
+      validateRouteShape(route);
+      return route;
+    } catch {
+      continue;
+    }
+  }
+  return;
+}
+export function buildNestedRouteIndex() {
+  let entries;
+  try {
+    entries = fs.readdirSync(NESTED_EVENTS_DIR);
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return new Map;
+    throw error;
+  }
+  const index = new Map;
+  for (const entry of entries) {
+    const routeRoot = path.join(NESTED_EVENTS_DIR, entry);
+    try {
+      const metadata = JSON.parse(fs.readFileSync(path.join(routeRoot, ROUTE_FILE), "utf-8"));
+      if (typeof metadata.rootRunId !== "string" || typeof metadata.capabilityToken !== "string")
+        continue;
+      if (index.has(metadata.rootRunId))
+        continue;
+      const route = {
+        rootRunId: metadata.rootRunId,
+        eventSink: path.join(routeRoot, "events"),
+        controlInbox: path.join(routeRoot, "controls"),
+        capabilityToken: metadata.capabilityToken
+      };
+      validateRouteShape(route);
+      index.set(metadata.rootRunId, route);
+    } catch {
+      continue;
+    }
+  }
+  return index;
+}
+export function projectNestedRegistryForRoot(rootRunId) {
+  const route = findNestedRouteForRootId(rootRunId);
+  return route ? projectNestedEvents(route) : undefined;
+}
+export function findNestedRun(children, id) {
+  if (!children?.length)
+    return;
+  for (const child of children) {
+    if (child.id === id)
+      return child;
+    const nested = findNestedRun(child.children, id) ?? findNestedRun(child.steps?.flatMap((step) => step.children ?? []), id);
+    if (nested)
+      return nested;
+  }
+  return;
+}
+function collectNestedRuns(children, output = []) {
+  for (const child of children ?? []) {
+    output.push(child);
+    collectNestedRuns(child.children, output);
+    collectNestedRuns(child.steps?.flatMap((step) => step.children ?? []), output);
+  }
+  return output;
+}
+function collectScopedNestedRuns(children, scope, output = []) {
+  if (!scope)
+    return collectNestedRuns(children, output);
+  for (const child of children ?? []) {
+    if (child.parentRunId === scope.parentRunId && (scope.parentStepIndex === undefined || child.parentStepIndex === scope.parentStepIndex)) {
+      collectNestedRuns([child], output);
+      continue;
+    }
+    collectScopedNestedRuns(child.children, scope, output);
+    collectScopedNestedRuns(child.steps?.flatMap((step) => step.children ?? []), scope, output);
+  }
+  return output;
+}
+function listNestedRoutes() {
+  let entries;
+  try {
+    entries = fs.readdirSync(NESTED_EVENTS_DIR);
+  } catch (error) {
+    if (error.code === "ENOENT")
+      return [];
+    throw error;
+  }
+  const routes = [];
+  for (const entry of entries) {
+    const routeRoot = path.join(NESTED_EVENTS_DIR, entry);
+    try {
+      const metadata = JSON.parse(fs.readFileSync(path.join(routeRoot, ROUTE_FILE), "utf-8"));
+      if (typeof metadata.rootRunId !== "string" || typeof metadata.capabilityToken !== "string")
+        continue;
+      const route = {
+        rootRunId: metadata.rootRunId,
+        eventSink: path.join(routeRoot, "events"),
+        controlInbox: path.join(routeRoot, "controls"),
+        capabilityToken: metadata.capabilityToken
+      };
+      validateRouteShape(route);
+      routes.push(route);
+    } catch {
+      continue;
+    }
+  }
+  return routes;
+}
+export function findNestedRunMatchesById(id, options = {}) {
+  assertSafeId("id", id);
+  const matches = [];
+  for (const route of options.scope?.routes ?? listNestedRoutes()) {
+    try {
+      const registry = projectNestedEvents(route);
+      for (const run of collectScopedNestedRuns(registry.children, options.scope?.descendantOf)) {
+        if (options.prefix ? run.id.startsWith(id) : run.id === id)
+          matches.push({ rootRunId: route.rootRunId, route, run });
+      }
+    } catch {
+      continue;
+    }
+  }
+  return matches;
+}
+export function findNestedRunById(id) {
+  const match = findNestedRunMatchesById(id)[0];
+  return match ? { rootRunId: match.rootRunId, run: match.run } : undefined;
+}
+export function readNestedRegistry(route) {
+  validateRouteShape(route);
+  try {
+    const parsed = JSON.parse(fs.readFileSync(registryPath(route), "utf-8"));
+    return {
+      rootRunId: route.rootRunId,
+      updatedAt: typeof parsed.updatedAt === "number" ? parsed.updatedAt : 0,
+      children: Array.isArray(parsed.children) ? parsed.children.map((child) => sanitizeSummary(child)).filter((child) => Boolean(child)) : [],
+      processedEvents: Array.isArray(parsed.processedEvents) ? parsed.processedEvents.filter((item) => typeof item === "string") : []
+    };
+  } catch (error) {
+    if (error.code !== "ENOENT")
+      throw error;
+    return { rootRunId: route.rootRunId, updatedAt: 0, children: [], processedEvents: [] };
+  }
+}
+export function projectNestedEvents(route) {
+  validateRouteShape(route);
+  let registry = readNestedRegistry(route);
+  const seen = new Set(registry.processedEvents);
+  let changed = false;
+  let entries = [];
+  try {
+    entries = fs.readdirSync(route.eventSink).filter((entry) => entry.endsWith(".json") || entry.endsWith(".jsonl")).sort();
+  } catch (error) {
+    if (error.code !== "ENOENT")
+      throw error;
+  }
+  for (const entry of entries) {
+    if (seen.has(entry))
+      continue;
+    const eventPath = path.join(route.eventSink, entry);
+    if (!containedPath(route.eventSink, eventPath))
+      continue;
+    let content;
+    try {
+      const stat = fs.statSync(eventPath);
+      if (!stat.isFile() || stat.size > MAX_EVENT_BYTES)
+        continue;
+      content = fs.readFileSync(eventPath, "utf-8");
+    } catch {
+      continue;
+    }
+    for (const event of parseNestedEventRecords(content, route)) {
+      registry = applyNestedEvent(registry, event);
+      changed = true;
+    }
+    seen.add(entry);
+    changed = true;
+  }
+  if (changed) {
+    registry = { ...registry, processedEvents: [...seen].slice(-1000) };
+    writeAtomicJson(registryPath(route), registry);
+  }
+  return registry;
+}
+function writeRouteRecord(dir, ts, payload) {
+  const content = `${JSON.stringify(payload)}
+`;
+  if (Buffer.byteLength(content, "utf-8") > MAX_EVENT_BYTES)
+    throw new Error("Nested route record exceeds the maximum size.");
+  fs.mkdirSync(dir, { recursive: true, mode: 448 });
+  const name = `${String(ts).padStart(13, "0")}-${randomUUID()}.json`;
+  const tmp = path.join(dir, `.${name}.tmp`);
+  const finalPath = path.join(dir, name);
+  fs.writeFileSync(tmp, content, { mode: 384 });
+  fs.renameSync(tmp, finalPath);
+  return finalPath;
+}
+export function writeNestedEvent(route, event) {
+  validateRouteShape(route);
+  const record = {
+    ...event,
+    rootRunId: route.rootRunId,
+    capabilityToken: route.capabilityToken
+  };
+  const sanitized = parseRecord(JSON.stringify(record), route);
+  if (!sanitized)
+    throw new Error("Nested event record failed validation.");
+  writeRouteRecord(route.eventSink, sanitized.ts, sanitized);
+}
+function parseControlRequest(content, route) {
+  if (Buffer.byteLength(content, "utf-8") > MAX_EVENT_BYTES)
+    return;
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    return;
+  }
+  if (!parsed || typeof parsed !== "object")
+    return;
+  const raw = parsed;
+  if (raw.type !== "subagent.nested.control-request")
+    return;
+  if (raw.rootRunId !== route.rootRunId || raw.capabilityToken !== route.capabilityToken)
+    return;
+  if (!isSafeNestedId(raw.requestId) || !isSafeNestedId(raw.targetRunId))
+    return;
+  if (raw.action !== "interrupt" && raw.action !== "resume")
+    return;
+  const ts = clampNumber(raw.ts);
+  if (ts === undefined)
+    return;
+  return {
+    type: "subagent.nested.control-request",
+    ts,
+    rootRunId: route.rootRunId,
+    capabilityToken: route.capabilityToken,
+    requestId: raw.requestId,
+    targetRunId: raw.targetRunId,
+    action: raw.action,
+    ...stringValue(raw.message, 16000) ? { message: stringValue(raw.message, 16000) } : {}
+  };
+}
+function parseControlResult(content, route) {
+  if (Buffer.byteLength(content, "utf-8") > MAX_EVENT_BYTES)
+    return;
+  let parsed;
+  try {
+    parsed = JSON.parse(content);
+  } catch {
+    return;
+  }
+  if (!parsed || typeof parsed !== "object")
+    return;
+  const raw = parsed;
+  if (raw.type !== "subagent.nested.control-result")
+    return;
+  if (raw.rootRunId !== route.rootRunId || raw.capabilityToken !== route.capabilityToken)
+    return;
+  if (!isSafeNestedId(raw.requestId) || !isSafeNestedId(raw.targetRunId))
+    return;
+  const ts = clampNumber(raw.ts);
+  if (ts === undefined || typeof raw.ok !== "boolean")
+    return;
+  return {
+    type: "subagent.nested.control-result",
+    ts,
+    rootRunId: route.rootRunId,
+    capabilityToken: route.capabilityToken,
+    requestId: raw.requestId,
+    targetRunId: raw.targetRunId,
+    ok: raw.ok,
+    message: stringValue(raw.message, 16000) ?? (raw.ok ? "Control request completed." : "Control request failed.")
+  };
+}
+export function writeNestedControlRequest(route, request) {
+  validateRouteShape(route);
+  assertSafeId("requestId", request.requestId);
+  assertSafeId("targetRunId", request.targetRunId);
+  const record = {
+    type: "subagent.nested.control-request",
+    ...request,
+    rootRunId: route.rootRunId,
+    capabilityToken: route.capabilityToken
+  };
+  const sanitized = parseControlRequest(JSON.stringify(record), route);
+  if (!sanitized)
+    throw new Error("Nested control request failed validation.");
+  return writeRouteRecord(route.controlInbox, sanitized.ts, sanitized);
+}
+export function readNestedControlRequests(route) {
+  validateRouteShape(route);
+  let entries = [];
+  try {
+    entries = fs.readdirSync(route.controlInbox).filter((entry) => entry.endsWith(".json")).sort();
+  } catch (error) {
+    if (error.code !== "ENOENT")
+      throw error;
+  }
+  const requests = [];
+  for (const entry of entries) {
+    const filePath = path.join(route.controlInbox, entry);
+    if (!containedPath(route.controlInbox, filePath))
+      continue;
+    try {
+      const stat = fs.statSync(filePath);
+      if (!stat.isFile() || stat.size > MAX_EVENT_BYTES)
+        continue;
+      const request = parseControlRequest(fs.readFileSync(filePath, "utf-8"), route);
+      if (request)
+        requests.push({ ...request, filePath });
+    } catch {
+      continue;
+    }
+  }
+  return requests;
+}
+export function writeNestedControlResult(route, result) {
+  validateRouteShape(route);
+  assertSafeId("requestId", result.requestId);
+  assertSafeId("targetRunId", result.targetRunId);
+  const record = {
+    type: "subagent.nested.control-result",
+    ...result,
+    rootRunId: route.rootRunId,
+    capabilityToken: route.capabilityToken
+  };
+  const sanitized = parseControlResult(JSON.stringify(record), route);
+  if (!sanitized)
+    throw new Error("Nested control result failed validation.");
+  writeRouteRecord(route.eventSink, sanitized.ts, sanitized);
+}
+export function readNestedControlResults(route) {
+  validateRouteShape(route);
+  let entries = [];
+  try {
+    entries = fs.readdirSync(route.eventSink).filter((entry) => entry.endsWith(".json") || entry.endsWith(".jsonl")).sort();
+  } catch (error) {
+    if (error.code !== "ENOENT")
+      throw error;
+  }
+  const results = [];
+  for (const entry of entries) {
+    const eventPath = path.join(route.eventSink, entry);
+    if (!containedPath(route.eventSink, eventPath))
+      continue;
+    try {
+      const stat = fs.statSync(eventPath);
+      if (!stat.isFile() || stat.size > MAX_EVENT_BYTES)
+        continue;
+      const content = fs.readFileSync(eventPath, "utf-8");
+      const lines = content.includes(`
+`) ? content.split(`
+`).filter((line) => line.trim()) : [content];
+      for (const line of lines) {
+        const result = parseControlResult(line, route);
+        if (result)
+          results.push(result);
+      }
+    } catch {
+      continue;
+    }
+  }
+  return results;
+}
+export function nestedRouteEnv(route) {
+  return {
+    [SUBAGENT_PARENT_EVENT_SINK_ENV]: route.eventSink,
+    [SUBAGENT_PARENT_CONTROL_INBOX_ENV]: route.controlInbox,
+    [SUBAGENT_PARENT_ROOT_RUN_ID_ENV]: route.rootRunId,
+    [SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV]: route.capabilityToken
+  };
+}
+export function attachRootChildrenToSteps(rootRunId, steps, children) {
+  if (!steps?.length)
+    return;
+  for (const step of steps) {
+    step.children = undefined;
+  }
+  if (!children?.length)
+    return;
+  for (const child of children) {
+    if (child.parentRunId !== rootRunId || child.parentStepIndex === undefined)
+      continue;
+    const step = steps.find((candidate, index) => (candidate.index ?? index) === child.parentStepIndex);
+    if (!step)
+      continue;
+    step.children ??= [];
+    step.children = [...step.children.filter((existing) => existing.id !== child.id), child].slice(0, MAX_CHILDREN);
+  }
+}
+export function updateAsyncJobNestedProjection(job) {
+  if (!job.nestedRoute)
+    return;
+  const registry = projectNestedEvents(job.nestedRoute);
+  job.nestedChildren = registry.children;
+  attachRootChildrenToSteps(job.asyncId, job.steps, registry.children);
+}
+export function updateForegroundNestedProjection(control) {
+  if (!control.nestedRoute)
+    return;
+  const registry = projectNestedEvents(control.nestedRoute);
+  control.nestedChildren = registry.children;
+}
+export function hasLiveNestedDescendants(children) {
+  if (!children?.length)
+    return false;
+  for (const child of children) {
+    if (!terminal(child.state))
+      return true;
+    if (hasLiveNestedDescendants(child.children))
+      return true;
+    if (hasLiveNestedDescendants(child.steps?.flatMap((step) => step.children ?? [])))
+      return true;
+  }
+  return false;
+}
+export function nestedSummaryFromAsyncStatus(status, asyncDir, fallback) {
+  return {
+    id: status.runId || fallback.id,
+    parentRunId: fallback.parentRunId,
+    ...fallback.parentStepIndex !== undefined ? { parentStepIndex: fallback.parentStepIndex } : {},
+    depth: fallback.depth,
+    path: fallback.path ?? [{ runId: fallback.parentRunId, ...fallback.parentStepIndex !== undefined ? { stepIndex: fallback.parentStepIndex } : {} }],
+    asyncDir,
+    ...status.pid ? { pid: status.pid } : {},
+    ...status.sessionId ? { sessionId: status.sessionId } : {},
+    mode: status.mode ?? fallback.mode,
+    state: status.state,
+    ...status.currentStep !== undefined ? { currentStep: status.currentStep } : {},
+    ...status.chainStepCount !== undefined ? { chainStepCount: status.chainStepCount } : {},
+    ...status.activityState ? { activityState: status.activityState } : {},
+    ...status.lastActivityAt !== undefined ? { lastActivityAt: status.lastActivityAt } : {},
+    ...status.currentTool ? { currentTool: status.currentTool } : {},
+    ...status.currentToolStartedAt !== undefined ? { currentToolStartedAt: status.currentToolStartedAt } : {},
+    ...status.currentPath ? { currentPath: status.currentPath } : {},
+    ...status.turnCount !== undefined ? { turnCount: status.turnCount } : {},
+    ...status.toolCount !== undefined ? { toolCount: status.toolCount } : {},
+    ...status.totalTokens ? { totalTokens: status.totalTokens } : {},
+    ...status.timeoutMs !== undefined ? { timeoutMs: status.timeoutMs } : {},
+    ...status.deadlineAt !== undefined ? { deadlineAt: status.deadlineAt } : {},
+    ...status.timedOut !== undefined ? { timedOut: status.timedOut } : {},
+    ...status.turnBudget ? { turnBudget: status.turnBudget } : {},
+    ...status.turnBudgetExceeded !== undefined ? { turnBudgetExceeded: status.turnBudgetExceeded } : {},
+    ...status.wrapUpRequested !== undefined ? { wrapUpRequested: status.wrapUpRequested } : {},
+    ...status.error ? { error: status.error } : {},
+    ...status.startedAt !== undefined ? { startedAt: status.startedAt } : { startedAt: fallback.ts },
+    ...status.endedAt !== undefined ? { endedAt: status.endedAt } : {},
+    lastUpdate: status.lastUpdate ?? fallback.ts,
+    ...status.sessionFile ? { sessionFile: status.sessionFile } : {},
+    ...status.steps?.length ? { steps: status.steps.map((step) => ({
+      agent: step.agent,
+      status: step.status,
+      ...step.sessionFile ? { sessionFile: step.sessionFile } : {},
+      ...step.activityState ? { activityState: step.activityState } : {},
+      ...step.lastActivityAt !== undefined ? { lastActivityAt: step.lastActivityAt } : {},
+      ...step.currentTool ? { currentTool: step.currentTool } : {},
+      ...step.currentToolStartedAt !== undefined ? { currentToolStartedAt: step.currentToolStartedAt } : {},
+      ...step.currentPath ? { currentPath: step.currentPath } : {},
+      ...step.turnCount !== undefined ? { turnCount: step.turnCount } : {},
+      ...step.toolCount !== undefined ? { toolCount: step.toolCount } : {},
+      ...step.startedAt !== undefined ? { startedAt: step.startedAt } : {},
+      ...step.endedAt !== undefined ? { endedAt: step.endedAt } : {},
+      ...step.error ? { error: step.error } : {},
+      ...step.timedOut !== undefined ? { timedOut: step.timedOut } : {},
+      ...step.turnBudget ? { turnBudget: step.turnBudget } : {},
+      ...step.turnBudgetExceeded !== undefined ? { turnBudgetExceeded: step.turnBudgetExceeded } : {},
+      ...step.wrapUpRequested !== undefined ? { wrapUpRequested: step.wrapUpRequested } : {}
+    })).slice(0, MAX_STEPS) } : {}
+  };
+}
+export function nestedArtifactEnv(rootRunId, parentRunId) {
+  return {
+    DM_SUBAGENT_NESTED_ROOT_RUN_ID: rootRunId,
+    DM_SUBAGENT_NESTED_PARENT_RUN_ID: parentRunId
+  };
+}
+export function isTopLevelAsyncDir(asyncDir) {
+  const resolved = path.resolve(asyncDir);
+  return containedPath(ASYNC_DIR, resolved) && !containedPath(path.join(TEMP_ROOT_DIR, "nested-subagent-runs"), resolved);
+}
+export function nestedResultsPath(rootRunId, id) {
+  assertSafeId("rootRunId", rootRunId);
+  assertSafeId("id", id);
+  return path.join(RESULTS_DIR, "nested", rootRunId, `${id}.json`);
+}