@duckmind/dm-windows-x64 0.60.6 → 0.60.9

package/extensions/dm-subagents/src/runs/background/async-resume.js

@@ -1,8 +1,334 @@
-import*as F from"node:fs";import*as O from"node:path";import*as R from"node:os";import*as D from"node:path";function k($){return $.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function B$($){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 Y=j[X];if(Y)return`user-${k(Y)}`}let Z=$&&Object.hasOwn($,"userInfo")?$.userInfo:R.userInfo;try{let X=Z?.().username;if(X)return`user-${k(X)}`}catch{}let W=j.USERPROFILE??j.HOME;if(W)return`home-${k(W)}`;let Q=$&&Object.hasOwn($,"homedir")?$.homedir:R.homedir;try{let X=Q?.();if(X)return`home-${k(X)}`}catch{}return"shared"}var b=D.join(R.tmpdir(),`dm-subagents-${B$()}`),w=D.join(b,"async-subagent-results"),h=D.join(b,"async-subagent-runs"),G$=D.join(b,"chain-runs"),n$=D.join(b,"artifacts");function i($){return $.trim().toLowerCase().replace(/[^a-z0-9_-]+/g,"-").replace(/^-+|-+$/g,"")||"agent"}function I($,j,J){let Z=J!==void 0?`-${J+1}`:"";return`subagent-${i(j)}-${i($)}${Z}`}import*as a from"node:fs";import*as c from"node:path";import*as V$ from"node:fs";import*as S from"node:path";var U$=[10,25,50,100,200,500,1000,2000,4000],L$=new Set(["EACCES","EBUSY","EPERM"]),r=typeof SharedArrayBuffer<"u"?new SharedArrayBuffer(4):void 0,s=r?new Int32Array(r):void 0;function z$($){if($<=0)return;if(s)try{Atomics.wait(s,0,0,$);return}catch{}let j=Date.now()+$;while(Date.now()<j);}function M$($){let j=$?.code;return typeof j==="string"&&L$.has(j)}function C$($,j,J,Z,W){for(let Q=0;;Q++)try{$.renameSync(j,J);return}catch(X){let Y=Z[Q];if(Y===void 0||!M$(X))throw X;W(Y)}}function A$($={}){let j=$.fs??V$,J=$.now??Date.now,Z=$.pid??process.pid,W=$.random??Math.random,X=$.retryRenameErrors??process.platform==="win32"?$.retryDelaysMs??U$:[],Y=$.wait??z$;return(K,H)=>{j.mkdirSync(S.dirname(K),{recursive:!0});let B=S.join(S.dirname(K),`.${S.basename(K)}.${Z}.${J()}.${W().toString(36).slice(2)}.tmp`);try{j.writeFileSync(B,JSON.stringify(H,null,2),"utf-8"),C$(j,B,K,X,Y)}finally{j.rmSync(B,{force:!0})}}}var N=A$();var F$=process.platform==="win32"?"SIGBREAK":"SIGUSR2";function q$($){return c.join($,"control")}function _$($){return c.join(q$($),"interrupt.json")}function T$($,j={},J={}){let Z=_$($),W={...j,ts:j.ts??J.now?.()??Date.now(),type:"interrupt"};return N(Z,W),Z}function t($){let j=T$($.asyncDir,$.source?{source:$.source}:{},{now:$.now});if(typeof $.pid==="number"&&$.pid>0)try{($.kill??process.kill)($.pid,$.signal??F$)}catch(J){if(J?.code==="ENOSYS")return;try{a.rmSync(j,{force:!0})}catch{}throw J}}import*as V from"node:fs";import*as L from"node:path";function f$($,j,J){if(typeof $!=="object"||$===null)return!1;let{start:Z,count:W,stepIndex:Q}=$;return typeof Z==="number"&&typeof W==="number"&&typeof Q==="number"&&Number.isInteger(Z)&&Number.isInteger(W)&&Number.isInteger(Q)&&Z>=0&&W>0&&Q>=0&&Q<J&&Z+W<=j}function e($,j,J){if(!Array.isArray($))return[];return $.filter((Z)=>f$(Z,j,J)).sort((Z,W)=>Z.stepIndex-W.stepIndex||Z.start-W.start)}import*as y from"node:path";import*as _ from"node:path";import{fileURLToPath as $$}from"node:url";import*as f from"node:os";import*as q from"node:path";var Ej=q.join(f.homedir(),".config","mcp","mcp.json"),bj={cursor:[q.join(f.homedir(),".cursor","mcp.json")],"claude-code":[q.join(f.homedir(),".claude","mcp.json"),q.join(f.homedir(),".claude.json"),q.join(f.homedir(),".claude","claude_desktop_config.json")],"claude-desktop":[q.join(f.homedir(),"Library","Application Support","Claude","claude_desktop_config.json")],codex:[q.join(f.homedir(),".codex","config.json")],windsurf:[q.join(f.homedir(),".windsurf","mcp.json")],vscode:[".vscode/mcp.json"]};import{Compile as yj}from"typebox/compile";function j$($,j){let J=$$($),Z=_.extname(J),W=[".js",".mjs",".cjs",".ts",".mts",".cts"].includes(Z)?Z:".ts";return _.join(_.dirname(J),`${j}${W}`)}function J$($){return _.basename($$($)).startsWith("dm-args.")}function b$($=import.meta.url){let j=J$($)?"subagent-prompt-runtime":_.join("..","runs","shared","subagent-prompt-runtime");return j$($,j)}function S$($=import.meta.url){let j=J$($)?_.join("..","..","extension","fanout-child"):"fanout-child";return j$($,j)}var oj=b$(),nj=S$();var Y0=y.join(b,"nested-subagent-events");function d($){return $ instanceof Error?$.message:String($)}function N$($){let j=L.join($,"runner.stderr.log"),J=65536,Z;try{let Q=V.statSync(j);if(Q.size<=0)return;let X=V.openSync(j,"r");try{let Y=Math.min(Q.size,65536),K=Math.max(0,Q.size-Y),H=Buffer.alloc(Y);V.readSync(X,H,0,Y,K),Z=H.toString("utf-8").trim()}finally{V.closeSync(X)}}catch{return}if(!Z)return;let W=Z.split(/\r?\n/).slice(-30).join(`
-`);return W.length>4000?`${W.slice(-4000)}
-[stderr tail truncated]`:W}function Q$($){return typeof $==="object"&&$!==null&&"code"in $&&$.code==="ENOENT"}function y$($,j){try{V.mkdirSync(L.dirname($),{recursive:!0}),V.appendFileSync($,`${JSON.stringify(j)}
-`,"utf-8")}catch{}}function x$($){let j=L.join($,"status.json"),J;try{J=V.readFileSync(j,"utf-8")}catch(Z){if(Q$(Z))return null;throw Error(`Failed to read async status file '${j}': ${d(Z)}`,{cause:Z instanceof Error?Z:void 0})}try{return JSON.parse(J)}catch(Z){throw Error(`Failed to parse async status file '${j}': ${d(Z)}`,{cause:Z instanceof Error?Z:void 0})}}function R$($){try{let j=JSON.parse(V.readFileSync($,"utf-8"));return{state:j.success?"complete":j.state==="paused"||j.exitCode===0?"paused":"failed",...Array.isArray(j.results)?{results:j.results}:{}}}catch(j){if(Q$(j))return;throw Error(`Failed to read async result file '${$}': ${d(j)}`,{cause:j instanceof Error?j:void 0})}}function D$($,j){if(j?.success===!0)return"complete";if(j?.success===!1)return"failed";return $}function w$($,j,J){let Z=R$(j);if(!Z)return;let W=($.steps??[]).map((Q,X)=>{if(Q.status!=="running"&&Q.status!=="pending")return Q;let Y=Z.results?.[X],K=D$(Z.state,Y);return{...Q,status:K==="complete"?"complete":K,endedAt:Q.endedAt??J,durationMs:Q.startedAt!==void 0&&Q.durationMs===void 0?Math.max(0,J-Q.startedAt):Q.durationMs,exitCode:Q.exitCode??(K==="complete"||K==="paused"?0:1),error:K==="failed"?Q.error??Y?.error:Q.error,sessionFile:Q.sessionFile??Y?.sessionFile,model:Q.model??Y?.model,attemptedModels:Q.attemptedModels??Y?.attemptedModels,modelAttempts:Q.modelAttempts??Y?.modelAttempts}});return{...$,state:Z.state,activityState:void 0,lastUpdate:J,endedAt:$.endedAt??J,steps:W}}function k$($,j,J){let Z=j.startedAt??J,W=j.agents?.length?j.agents:["subagent"],Q=j.chainStepCount,X=Q!==void 0?e(j.parallelGroups,W.length,Q):[];return{runId:j.runId||L.basename($),...j.sessionId?{sessionId:j.sessionId}:{},mode:j.mode??"single",state:"running",pid:j.pid,startedAt:Z,lastUpdate:J,currentStep:0,...Q!==void 0?{chainStepCount:Q}:{},...X.length?{parallelGroups:X}:{},steps:W.map((Y)=>({agent:Y,status:"running",startedAt:Z})),...j.sessionFile?{sessionFile:j.sessionFile}:{}}}function I$($,j,J,Z){let W=$.runId||L.basename(j),Q=typeof $.pid==="number"?$.pid:"unknown",X=Z??`Async runner process ${Q} exited or disappeared before writing a result. Marked run failed by stale-run reconciliation.`,Y=N$(j),K=Y?`${X}
-
-Runner stderr tail:
-${Y}`:X,B=(($.steps?.length)?$.steps:[{agent:"subagent",status:"running"}]).map((G)=>G.status==="running"||G.status==="pending"?{...G,status:"failed",activityState:void 0,endedAt:G.endedAt??J,durationMs:G.startedAt!==void 0&&G.durationMs===void 0?Math.max(0,J-G.startedAt):G.durationMs,exitCode:G.exitCode??1,error:G.error??K}:G),C={...$,state:"failed",activityState:void 0,lastUpdate:J,endedAt:J,steps:B},z=B[$.currentStep??0]?.agent??B[0]?.agent??"subagent";return{status:C,message:K,result:{id:W,agent:z,mode:$.mode,success:!1,state:"failed",summary:K,results:B.map((G)=>({agent:G.agent,output:G.status==="complete"||G.status==="completed"?"":K,error:G.status==="complete"||G.status==="completed"?void 0:G.error??K,success:G.status==="complete"||G.status==="completed",model:G.model,attemptedModels:G.attemptedModels,modelAttempts:G.modelAttempts,sessionFile:G.sessionFile})),exitCode:1,timestamp:J,durationMs:Math.max(0,J-$.startedAt),asyncDir:j,sessionId:$.sessionId,sessionFile:$.sessionFile}}}function Z$($,j,J,Z,W){let Q=I$(j,$,Z,W);return N(J,Q.result),N(L.join($,"status.json"),Q.status),y$(L.join($,"events.jsonl"),{type:"subagent.run.repaired_stale",ts:Z,runId:Q.status.runId,pid:j.pid,resultPath:J,message:Q.message}),{status:Q.status,repaired:!0,resultPath:J,message:Q.message}}function P$($,j=process.kill){try{return j($,0),"alive"}catch(J){let Z=typeof J==="object"&&J!==null&&"code"in J?J.code:void 0;if(Z==="ESRCH")return"dead";if(Z==="EPERM")return"unknown";return"unknown"}}function p($,j={}){let J=j.now?.()??Date.now(),Z=x$($),W=!Z&&j.startedRun?k$($,j.startedRun,J):void 0,Q=Z??W;if(!Q)return{status:null,repaired:!1};let X=Q.runId||L.basename($),Y=L.join(j.resultsDir??w,`${X}.json`);if(V.existsSync(Y)){let H=Q.state==="running"||Q.state==="queued"?w$(Q,Y,J):void 0;if(H)return N(L.join($,"status.json"),H),{status:H,repaired:!0,resultPath:Y,message:"Existing async result file was used to repair stale running status."};return{status:Q,repaired:!1,resultPath:Y}}if(Q.state!=="running"||typeof Q.pid!=="number")return{status:Z??null,repaired:!1,resultPath:Y};if(!Z){let H=j.startedRun?.startedAt??Q.startedAt;if(J-H<(j.missingStatusGraceMs??1000))return{status:null,repaired:!1,resultPath:Y}}if(P$(Q.pid,j.kill)!=="dead"){let H=j.staleAlivePidMs??86400000,B=Q.lastUpdate??Q.startedAt;if(J-B<=H)return{status:Z??null,repaired:!1,resultPath:Y};let C=`Async runner process ${Q.pid} still has a live PID, but status has not updated for ${J-B}ms. Marked run failed by stale-run reconciliation because PID ownership cannot be verified.`;return Z$($,Q,Y,J,C)}return Z$($,Q,Y,J)}var v$=process.platform==="win32"?"SIGBREAK":"SIGUSR2";function _0($){let j=$.target.runId;if(!$.target.asyncDir)return{ok:!1,message:`Async run ${j} is live but does not have an async directory to interrupt.`};let J=p($.target.asyncDir,{resultsDir:$.resultsDir,kill:$.kill,now:$.now}).status;if(!J||J.state!=="running"||typeof J.pid!=="number")return{ok:!1,message:`Async run ${j} is live but no interrupt-capable runner pid was found.`};try{t({asyncDir:$.target.asyncDir,pid:J.pid,kill:$.kill,signal:v$,now:$.now,source:"async-resume"});let Z=$.state?.asyncJobs.get(j);if(Z)Z.activityState=void 0,Z.updatedAt=$.now?.()??Date.now();return{ok:!0,asyncId:j}}catch(Z){let W=Z instanceof Error?Z.message:String(Z);return{ok:!1,message:`Failed to interrupt async run ${j}: ${W}`}}}function W$($){return $ instanceof Error?$.message:String($)}function X$($,j){if(!$||typeof $!=="object"||Array.isArray($))throw Error(`Async result file '${j}' must contain a JSON object.`);return $}function T($,j,J,Z=j){let W=$[j];if(W===void 0)return;if(typeof W!=="string")throw Error(`Invalid async result file '${J}': ${Z} must be a string.`);return W}function g$($,j){let J=X$($,j),Z=J.results,W;if(Z!==void 0){if(!Array.isArray(Z))throw Error(`Invalid async result file '${j}': results must be an array.`);W=Z.map((X,Y)=>{let K=X$(X,`${j} results[${Y}]`),H=T(K,"agent",j,`results[${Y}].agent`),B=T(K,"sessionFile",j,`results[${Y}].sessionFile`),C=T(K,"intercomTarget",j,`results[${Y}].intercomTarget`),z=K.success;if(z!==void 0&&typeof z!=="boolean")throw Error(`Invalid async result file '${j}': results[${Y}].success must be a boolean.`);return{agent:H,sessionFile:B,intercomTarget:C,...typeof z==="boolean"?{success:z}:{}}})}let Q=J.success;if(Q!==void 0&&typeof Q!=="boolean")throw Error(`Invalid async result file '${j}': success must be a boolean.`);return{id:T(J,"id",j),runId:T(J,"runId",j),agent:T(J,"agent",j),mode:T(J,"mode",j),state:T(J,"state",j),cwd:T(J,"cwd",j),sessionFile:T(J,"sessionFile",j),...typeof Q==="boolean"?{success:Q}:{},...W?{results:W}:{}}}function m$($){let j;try{j=F.readFileSync($,"utf-8")}catch(J){throw Error(`Failed to read async result file '${$}': ${W$(J)}`,{cause:J instanceof Error?J:void 0})}try{return g$(JSON.parse(j),$)}catch(J){if(J instanceof SyntaxError)throw Error(`Failed to parse async result file '${$}': ${W$(J)}`,{cause:J});throw J}}function o($,j){if($===void 0)return;if($.trim()==="")throw Error(`${j} must not be empty.`);if(O.isAbsolute($)||/[\\/]/.test($)||$.includes(".."))throw Error(`${j} must be an async run id or prefix, not a path.`);return $}function P($,j,J){let Z=O.resolve($),W=O.resolve(j),Q=O.relative(Z,W);if(Q===""||!Q.startsWith("..")&&!O.isAbsolute(Q))return;throw Error(`${J} must be inside ${Z}.`)}function Y$($,j,J=""){if(!F.existsSync($))return[];return F.readdirSync($).filter((Z)=>Z.startsWith(j)&&(!J||Z.endsWith(J))).map((Z)=>J?Z.slice(0,-J.length):Z).sort()}function n($,j){let J=O.join($,`${j}.json`);return P($,J,"Async result file"),F.existsSync(J)?J:null}function h$($,j,J){let Z=o($,"id");if(!Z)return[];let W=O.resolve(j),Q=O.resolve(J);return[...new Set([...Y$(W,Z),...Y$(Q,Z,".json")])].sort().map((Y)=>{let K=O.join(W,Y);return P(W,K,"Async run directory"),{id:Y,location:{asyncDir:F.existsSync(K)?K:null,resultPath:n(Q,Y),resolvedId:Y}}})}function c$($,j,J){let Z=O.resolve(j),W=O.resolve(J),Q=o($.id,"id")??o($.runId,"runId");if($.dir){let H=O.resolve($.dir);P(Z,H,"Async run directory");let B=Q??O.basename(H);if(Q&&Q!==O.basename(H))throw Error(`Async run id '${Q}' does not match directory '${O.basename(H)}'.`);return{asyncDir:H,resultPath:n(W,B),resolvedId:B}}if(!Q)return{asyncDir:null,resultPath:null};let X=O.join(Z,Q);P(Z,X,"Async run directory");let Y=n(W,Q);if(F.existsSync(X)||Y)return{asyncDir:F.existsSync(X)?X:null,resultPath:Y,resolvedId:Q};let K=h$(Q,Z,W);if(K.length===0)return{asyncDir:null,resultPath:null,resolvedId:Q};if(K.length>1)throw Error(`Ambiguous async run id prefix '${Q}' matched: ${K.map((H)=>H.id).join(", ")}. Provide a longer id.`);return K[0].location}function d$($){if($.state==="complete"||$.state==="failed"||$.state==="paused"||$.state==="running"||$.state==="queued")return $.state;return $.success?"complete":"failed"}function p$($,j){if(!$)return;if(typeof $.runId!=="string")throw Error(`Invalid async status '${j}': runId must be a string.`);if($.sessionId!==void 0&&typeof $.sessionId!=="string")throw Error(`Invalid async status '${j}': sessionId must be a string.`);if($.cwd!==void 0&&typeof $.cwd!=="string")throw Error(`Invalid async status '${j}': cwd must be a string.`);if($.sessionFile!==void 0&&typeof $.sessionFile!=="string")throw Error(`Invalid async status '${j}': sessionFile must be a string.`);if($.steps!==void 0){if(!Array.isArray($.steps))throw Error(`Invalid async status '${j}': steps must be an array.`);$.steps.forEach((J,Z)=>{if(!J||typeof J!=="object"||Array.isArray(J))throw Error(`Invalid async status '${j}': steps[${Z}] must be an object.`);if(typeof J.agent!=="string")throw Error(`Invalid async status '${j}': steps[${Z}].agent must be a string.`);if(J.sessionFile!==void 0&&typeof J.sessionFile!=="string")throw Error(`Invalid async status '${j}': steps[${Z}].sessionFile must be a string.`)})}}function o$($,j){if(O.extname(j)!==".jsonl")throw Error(`Async run '${$}' session file must be a .jsonl file: ${j}`);let J=O.resolve(j);if(!F.existsSync(J))throw Error(`Async run '${$}' session file does not exist: ${j}`);return J}function T0($,j={},J={}){let Z=j.asyncDirRoot??h,W=j.resultsDir??w,Q=J.requireSessionFile??!0,X=c$($,Z,W);if(!X.asyncDir&&!X.resultPath)throw Error("Async run not found. Provide id or dir.");let K=(X.asyncDir?p(X.asyncDir,{resultsDir:W,kill:j.kill,now:j.now}):void 0)?.status??null;p$(K,X.asyncDir?O.join(X.asyncDir,"status.json"):"status.json");let H=X.resultPath?m$(X.resultPath):void 0,B=K?.runId??H?.runId??H?.id??X.resolvedId??(X.asyncDir?O.basename(X.asyncDir):"unknown"),C=K?.state??(H?d$(H):void 0);if(!C)throw Error(`Status file not found for async run '${B}'.`);let z=K?.steps??[],G=H?.results??[],E=z.length||G.length||(H?.agent?1:0),U=$.index;if(U!==void 0&&!Number.isInteger(U))throw Error(`Async run '${B}' index must be an integer.`);let K$=new Set(["complete","completed","failed","paused"]);if(C==="running")if(U!==void 0){if(U<0||U>=E)throw Error(`Async run '${B}' has ${E} children. Index ${U} is out of range.`);let M=z[U];if(M?.status==="running")return{kind:"live",runId:B,asyncDir:X.asyncDir??void 0,state:C,agent:M.agent,index:U,intercomTarget:I(B,M.agent,U),cwd:K?.cwd??H?.cwd,sessionFile:M.sessionFile??K?.sessionFile??H?.sessionFile};if(M?.status==="pending")throw Error(`Async run '${B}' child ${U} is pending and has not started yet. Wait for it to run or complete before resuming.`);if(M&&!K$.has(M.status))throw Error(`Async run '${B}' child ${U} is ${M.status} and cannot be revived yet.`)}else{let M=z.map((m,H$)=>({step:m,index:H$})).filter(({step:m})=>m.status==="running"),x=M.length===1?M[0]:void 0;if(!x)throw Error(`Async run '${B}' has ${M.length} running children. Provide index to choose one.`);return{kind:"live",runId:B,asyncDir:X.asyncDir??void 0,state:C,agent:x.step.agent,index:x.index,intercomTarget:I(B,x.step.agent,x.index),cwd:K?.cwd??H?.cwd,sessionFile:x.step.sessionFile??K?.sessionFile??H?.sessionFile}}if(E>1&&U===void 0)throw Error(`Async run '${B}' has ${E} children. Provide index to choose one.`);let A=U??0;if(!Number.isInteger(A))throw Error(`Async run '${B}' index must be an integer.`);if(A<0||A>=E)throw Error(`Async run '${B}' has ${E} children. Index ${A} is out of range.`);let v=z[A]?.agent??G[A]?.agent??H?.agent;if(!v)throw Error(`Could not determine child agent for async run '${B}'.`);let g=z[A]?.sessionFile??G[A]?.sessionFile??(E===1?K?.sessionFile??H?.sessionFile:void 0);if(!g&&Q)throw Error(`Async run '${B}' child ${A} does not have a persisted session file to resume from.`);let u=g?o$(B,g):void 0;return{kind:"revive",runId:B,asyncDir:X.asyncDir??void 0,state:C,agent:v,index:A,intercomTarget:I(B,v,A),cwd:K?.cwd??H?.cwd,...u?{sessionFile:u}:{}}}function f0($,j){return["You are reviving a previous subagent conversation.","",`Original run: ${$.runId}`,`Original agent: ${$.agent}`,$.sessionFile?`Original session file: ${$.sessionFile}`:void 0,"","Use the stored session context as background. Answer the orchestrator's follow-up below. Do not assume the original child process is still alive.","","Follow-up:",j].filter((J)=>J!==void 0).join(`
-`)}export{c$ as resolveAsyncRunLocation,T0 as resolveAsyncResumeTarget,_0 as interruptLiveAsyncResumeTarget,h$ as findAsyncRunPrefixMatches,f0 as buildRevivedAsyncTask,v$ as ASYNC_RESUME_INTERRUPT_SIGNAL};
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { ASYNC_DIR, RESULTS_DIR } from "../../shared/types.js";
+import { resolveSubagentIntercomTarget } from "../../intercom/intercom-bridge.js";
+import { deliverInterruptRequest } from "./control-channel.js";
+import { reconcileAsyncRun } from "./stale-run-reconciler.js";
+export const ASYNC_RESUME_INTERRUPT_SIGNAL = process.platform === "win32" ? "SIGBREAK" : "SIGUSR2";
+export function interruptLiveAsyncResumeTarget(input) {
+  const asyncId = input.target.runId;
+  if (!input.target.asyncDir) {
+    return { ok: false, message: `Async run ${asyncId} is live but does not have an async directory to interrupt.` };
+  }
+  const status = reconcileAsyncRun(input.target.asyncDir, { resultsDir: input.resultsDir, kill: input.kill, now: input.now }).status;
+  if (!status || status.state !== "running" || typeof status.pid !== "number") {
+    return { ok: false, message: `Async run ${asyncId} is live but no interrupt-capable runner pid was found.` };
+  }
+  try {
+    deliverInterruptRequest({
+      asyncDir: input.target.asyncDir,
+      pid: status.pid,
+      kill: input.kill,
+      signal: ASYNC_RESUME_INTERRUPT_SIGNAL,
+      now: input.now,
+      source: "async-resume"
+    });
+    const tracked = input.state?.asyncJobs.get(asyncId);
+    if (tracked) {
+      tracked.activityState = undefined;
+      tracked.updatedAt = input.now?.() ?? Date.now();
+    }
+    return { ok: true, asyncId };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return { ok: false, message: `Failed to interrupt async run ${asyncId}: ${message}` };
+  }
+}
+function getErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function ensureObject(value, source) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    throw new Error(`Async result file '${source}' must contain a JSON object.`);
+  }
+  return value;
+}
+function validateOptionalString(value, field, source, displayField = field) {
+  const fieldValue = value[field];
+  if (fieldValue === undefined)
+    return;
+  if (typeof fieldValue !== "string")
+    throw new Error(`Invalid async result file '${source}': ${displayField} must be a string.`);
+  return fieldValue;
+}
+function validateResultFile(value, resultPath) {
+  const data = ensureObject(value, resultPath);
+  const resultsValue = data.results;
+  let results;
+  if (resultsValue !== undefined) {
+    if (!Array.isArray(resultsValue))
+      throw new Error(`Invalid async result file '${resultPath}': results must be an array.`);
+    results = resultsValue.map((entry, index) => {
+      const child = ensureObject(entry, `${resultPath} results[${index}]`);
+      const agent = validateOptionalString(child, "agent", resultPath, `results[${index}].agent`);
+      const sessionFile = validateOptionalString(child, "sessionFile", resultPath, `results[${index}].sessionFile`);
+      const intercomTarget = validateOptionalString(child, "intercomTarget", resultPath, `results[${index}].intercomTarget`);
+      const success = child.success;
+      if (success !== undefined && typeof success !== "boolean")
+        throw new Error(`Invalid async result file '${resultPath}': results[${index}].success must be a boolean.`);
+      return { agent, sessionFile, intercomTarget, ...typeof success === "boolean" ? { success } : {} };
+    });
+  }
+  const success = data.success;
+  if (success !== undefined && typeof success !== "boolean")
+    throw new Error(`Invalid async result file '${resultPath}': success must be a boolean.`);
+  return {
+    id: validateOptionalString(data, "id", resultPath),
+    runId: validateOptionalString(data, "runId", resultPath),
+    agent: validateOptionalString(data, "agent", resultPath),
+    mode: validateOptionalString(data, "mode", resultPath),
+    state: validateOptionalString(data, "state", resultPath),
+    cwd: validateOptionalString(data, "cwd", resultPath),
+    sessionFile: validateOptionalString(data, "sessionFile", resultPath),
+    ...typeof success === "boolean" ? { success } : {},
+    ...results ? { results } : {}
+  };
+}
+function readResultFile(resultPath) {
+  let raw;
+  try {
+    raw = fs.readFileSync(resultPath, "utf-8");
+  } catch (error) {
+    throw new Error(`Failed to read async result file '${resultPath}': ${getErrorMessage(error)}`, {
+      cause: error instanceof Error ? error : undefined
+    });
+  }
+  try {
+    return validateResultFile(JSON.parse(raw), resultPath);
+  } catch (error) {
+    if (error instanceof SyntaxError) {
+      throw new Error(`Failed to parse async result file '${resultPath}': ${getErrorMessage(error)}`, {
+        cause: error
+      });
+    }
+    throw error;
+  }
+}
+function assertRunId(value, field) {
+  if (value === undefined)
+    return;
+  if (value.trim() === "")
+    throw new Error(`${field} must not be empty.`);
+  if (path.isAbsolute(value) || /[\\/]/.test(value) || value.includes("..")) {
+    throw new Error(`${field} must be an async run id or prefix, not a path.`);
+  }
+  return value;
+}
+function assertInsideRoot(root, target, label) {
+  const rootPath = path.resolve(root);
+  const targetPath = path.resolve(target);
+  const relative = path.relative(rootPath, targetPath);
+  if (relative === "" || !relative.startsWith("..") && !path.isAbsolute(relative))
+    return;
+  throw new Error(`${label} must be inside ${rootPath}.`);
+}
+function prefixedRunIds(dir, prefix, suffix = "") {
+  if (!fs.existsSync(dir))
+    return [];
+  return fs.readdirSync(dir).filter((entry) => entry.startsWith(prefix) && (!suffix || entry.endsWith(suffix))).map((entry) => suffix ? entry.slice(0, -suffix.length) : entry).sort();
+}
+function exactResultPath(resultsDir, runId) {
+  const resultPath = path.join(resultsDir, `${runId}.json`);
+  assertInsideRoot(resultsDir, resultPath, "Async result file");
+  return fs.existsSync(resultPath) ? resultPath : null;
+}
+export function findAsyncRunPrefixMatches(prefix, asyncDirRoot, resultsDir) {
+  const requestedId = assertRunId(prefix, "id");
+  if (!requestedId)
+    return [];
+  const asyncRoot = path.resolve(asyncDirRoot);
+  const resultRoot = path.resolve(resultsDir);
+  const matchingIds = [...new Set([
+    ...prefixedRunIds(asyncRoot, requestedId),
+    ...prefixedRunIds(resultRoot, requestedId, ".json")
+  ])].sort();
+  return matchingIds.map((id) => {
+    const asyncDir = path.join(asyncRoot, id);
+    assertInsideRoot(asyncRoot, asyncDir, "Async run directory");
+    return {
+      id,
+      location: {
+        asyncDir: fs.existsSync(asyncDir) ? asyncDir : null,
+        resultPath: exactResultPath(resultRoot, id),
+        resolvedId: id
+      }
+    };
+  });
+}
+export function resolveAsyncRunLocation(params, asyncDirRoot, resultsDir) {
+  const asyncRoot = path.resolve(asyncDirRoot);
+  const resultRoot = path.resolve(resultsDir);
+  const requestedId = assertRunId(params.id, "id") ?? assertRunId(params.runId, "runId");
+  if (params.dir) {
+    const asyncDir = path.resolve(params.dir);
+    assertInsideRoot(asyncRoot, asyncDir, "Async run directory");
+    const resolvedId = requestedId ?? path.basename(asyncDir);
+    if (requestedId && requestedId !== path.basename(asyncDir)) {
+      throw new Error(`Async run id '${requestedId}' does not match directory '${path.basename(asyncDir)}'.`);
+    }
+    return { asyncDir, resultPath: exactResultPath(resultRoot, resolvedId), resolvedId };
+  }
+  if (!requestedId)
+    return { asyncDir: null, resultPath: null };
+  const directAsyncDir = path.join(asyncRoot, requestedId);
+  assertInsideRoot(asyncRoot, directAsyncDir, "Async run directory");
+  const directResultPath = exactResultPath(resultRoot, requestedId);
+  if (fs.existsSync(directAsyncDir) || directResultPath) {
+    return {
+      asyncDir: fs.existsSync(directAsyncDir) ? directAsyncDir : null,
+      resultPath: directResultPath,
+      resolvedId: requestedId
+    };
+  }
+  const matching = findAsyncRunPrefixMatches(requestedId, asyncRoot, resultRoot);
+  if (matching.length === 0)
+    return { asyncDir: null, resultPath: null, resolvedId: requestedId };
+  if (matching.length > 1) {
+    throw new Error(`Ambiguous async run id prefix '${requestedId}' matched: ${matching.map((match) => match.id).join(", ")}. Provide a longer id.`);
+  }
+  return matching[0].location;
+}
+function resultState(result) {
+  if (result.state === "complete" || result.state === "failed" || result.state === "paused" || result.state === "running" || result.state === "queued") {
+    return result.state;
+  }
+  return result.success ? "complete" : "failed";
+}
+function validateStatusForResume(status, source) {
+  if (!status)
+    return;
+  if (typeof status.runId !== "string")
+    throw new Error(`Invalid async status '${source}': runId must be a string.`);
+  if (status.sessionId !== undefined && typeof status.sessionId !== "string")
+    throw new Error(`Invalid async status '${source}': sessionId must be a string.`);
+  if (status.cwd !== undefined && typeof status.cwd !== "string")
+    throw new Error(`Invalid async status '${source}': cwd must be a string.`);
+  if (status.sessionFile !== undefined && typeof status.sessionFile !== "string")
+    throw new Error(`Invalid async status '${source}': sessionFile must be a string.`);
+  if (status.steps !== undefined) {
+    if (!Array.isArray(status.steps))
+      throw new Error(`Invalid async status '${source}': steps must be an array.`);
+    status.steps.forEach((step, index) => {
+      if (!step || typeof step !== "object" || Array.isArray(step))
+        throw new Error(`Invalid async status '${source}': steps[${index}] must be an object.`);
+      if (typeof step.agent !== "string")
+        throw new Error(`Invalid async status '${source}': steps[${index}].agent must be a string.`);
+      if (step.sessionFile !== undefined && typeof step.sessionFile !== "string")
+        throw new Error(`Invalid async status '${source}': steps[${index}].sessionFile must be a string.`);
+    });
+  }
+}
+function validateResumeSessionFile(runId, sessionFile) {
+  if (path.extname(sessionFile) !== ".jsonl")
+    throw new Error(`Async run '${runId}' session file must be a .jsonl file: ${sessionFile}`);
+  const resolved = path.resolve(sessionFile);
+  if (!fs.existsSync(resolved))
+    throw new Error(`Async run '${runId}' session file does not exist: ${sessionFile}`);
+  return resolved;
+}
+export function resolveAsyncResumeTarget(params, deps = {}, options = {}) {
+  const asyncDirRoot = deps.asyncDirRoot ?? ASYNC_DIR;
+  const resultsDir = deps.resultsDir ?? RESULTS_DIR;
+  const requireSessionFile = options.requireSessionFile ?? true;
+  const location = resolveAsyncRunLocation(params, asyncDirRoot, resultsDir);
+  if (!location.asyncDir && !location.resultPath) {
+    throw new Error("Async run not found. Provide id or dir.");
+  }
+  const reconciliation = location.asyncDir ? reconcileAsyncRun(location.asyncDir, { resultsDir, kill: deps.kill, now: deps.now }) : undefined;
+  const status = reconciliation?.status ?? null;
+  validateStatusForResume(status, location.asyncDir ? path.join(location.asyncDir, "status.json") : "status.json");
+  const result = location.resultPath ? readResultFile(location.resultPath) : undefined;
+  const runId = status?.runId ?? result?.runId ?? result?.id ?? location.resolvedId ?? (location.asyncDir ? path.basename(location.asyncDir) : "unknown");
+  const state = status?.state ?? (result ? resultState(result) : undefined);
+  if (!state)
+    throw new Error(`Status file not found for async run '${runId}'.`);
+  const statusSteps = status?.steps ?? [];
+  const resultSteps = result?.results ?? [];
+  const stepCount = statusSteps.length || resultSteps.length || (result?.agent ? 1 : 0);
+  const requestedIndex = params.index;
+  if (requestedIndex !== undefined && !Number.isInteger(requestedIndex))
+    throw new Error(`Async run '${runId}' index must be an integer.`);
+  const terminalStepStatuses = new Set(["complete", "completed", "failed", "paused"]);
+  if (state === "running") {
+    if (requestedIndex !== undefined) {
+      if (requestedIndex < 0 || requestedIndex >= stepCount)
+        throw new Error(`Async run '${runId}' has ${stepCount} children. Index ${requestedIndex} is out of range.`);
+      const selectedStep = statusSteps[requestedIndex];
+      if (selectedStep?.status === "running") {
+        return {
+          kind: "live",
+          runId,
+          asyncDir: location.asyncDir ?? undefined,
+          state,
+          agent: selectedStep.agent,
+          index: requestedIndex,
+          intercomTarget: resolveSubagentIntercomTarget(runId, selectedStep.agent, requestedIndex),
+          cwd: status?.cwd ?? result?.cwd,
+          sessionFile: selectedStep.sessionFile ?? status?.sessionFile ?? result?.sessionFile
+        };
+      }
+      if (selectedStep?.status === "pending")
+        throw new Error(`Async run '${runId}' child ${requestedIndex} is pending and has not started yet. Wait for it to run or complete before resuming.`);
+      if (selectedStep && !terminalStepStatuses.has(selectedStep.status))
+        throw new Error(`Async run '${runId}' child ${requestedIndex} is ${selectedStep.status} and cannot be revived yet.`);
+    } else {
+      const running = statusSteps.map((step, index) => ({ step, index })).filter(({ step }) => step.status === "running");
+      const selected = running.length === 1 ? running[0] : undefined;
+      if (!selected) {
+        throw new Error(`Async run '${runId}' has ${running.length} running children. Provide index to choose one.`);
+      }
+      return {
+        kind: "live",
+        runId,
+        asyncDir: location.asyncDir ?? undefined,
+        state,
+        agent: selected.step.agent,
+        index: selected.index,
+        intercomTarget: resolveSubagentIntercomTarget(runId, selected.step.agent, selected.index),
+        cwd: status?.cwd ?? result?.cwd,
+        sessionFile: selected.step.sessionFile ?? status?.sessionFile ?? result?.sessionFile
+      };
+    }
+  }
+  if (stepCount > 1 && requestedIndex === undefined) {
+    throw new Error(`Async run '${runId}' has ${stepCount} children. Provide index to choose one.`);
+  }
+  const index = requestedIndex ?? 0;
+  if (!Number.isInteger(index))
+    throw new Error(`Async run '${runId}' index must be an integer.`);
+  if (index < 0 || index >= stepCount)
+    throw new Error(`Async run '${runId}' has ${stepCount} children. Index ${index} is out of range.`);
+  const agent = statusSteps[index]?.agent ?? resultSteps[index]?.agent ?? result?.agent;
+  if (!agent)
+    throw new Error(`Could not determine child agent for async run '${runId}'.`);
+  const sessionFile = statusSteps[index]?.sessionFile ?? resultSteps[index]?.sessionFile ?? (stepCount === 1 ? status?.sessionFile ?? result?.sessionFile : undefined);
+  if (!sessionFile && requireSessionFile)
+    throw new Error(`Async run '${runId}' child ${index} does not have a persisted session file to resume from.`);
+  const resolvedSessionFile = sessionFile ? validateResumeSessionFile(runId, sessionFile) : undefined;
+  return {
+    kind: "revive",
+    runId,
+    asyncDir: location.asyncDir ?? undefined,
+    state,
+    agent,
+    index,
+    intercomTarget: resolveSubagentIntercomTarget(runId, agent, index),
+    cwd: status?.cwd ?? result?.cwd,
+    ...resolvedSessionFile ? { sessionFile: resolvedSessionFile } : {}
+  };
+}
+export function buildRevivedAsyncTask(target, message) {
+  return [
+    "You are reviving a previous subagent conversation.",
+    "",
+    `Original run: ${target.runId}`,
+    `Original agent: ${target.agent}`,
+    target.sessionFile ? `Original session file: ${target.sessionFile}` : undefined,
+    "",
+    "Use the stored session context as background. Answer the orchestrator's follow-up below. Do not assume the original child process is still alive.",
+    "",
+    "Follow-up:",
+    message
+  ].filter((line) => line !== undefined).join(`
+`);
+}