@duckmind/dm-windows-x64 0.60.6 → 0.60.9

package/extensions/dm-subagents/src/runs/background/scheduled-runs.js

@@ -1,4 +1,487 @@
-import{createHash as o,randomUUID as i}from"node:crypto";import*as M from"node:fs";import*as T from"node:path";import*as g from"node:fs";import*as F from"node:path";var h=[10,25,50,100,200,500,1000,2000,4000],m=new Set(["EACCES","EBUSY","EPERM"]),I=typeof SharedArrayBuffer<"u"?new SharedArrayBuffer(4):void 0,j=I?new Int32Array(I):void 0;function c(Q){if(Q<=0)return;if(j)try{Atomics.wait(j,0,0,Q);return}catch{}let Z=Date.now()+Q;while(Date.now()<Z);}function u(Q){let Z=Q?.code;return typeof Z==="string"&&m.has(Z)}function p(Q,Z,$,Y,X){for(let V=0;;V++)try{Q.renameSync(Z,$);return}catch(W){let J=Y[V];if(J===void 0||!u(W))throw W;X(J)}}function d(Q={}){let Z=Q.fs??g,$=Q.now??Date.now,Y=Q.pid??process.pid,X=Q.random??Math.random,W=Q.retryRenameErrors??process.platform==="win32"?Q.retryDelaysMs??h:[],J=Q.wait??c;return(B,q)=>{Z.mkdirSync(F.dirname(B),{recursive:!0});let G=F.join(F.dirname(B),`.${F.basename(B)}.${Y}.${$()}.${X().toString(36).slice(2)}.tmp`);try{Z.writeFileSync(G,JSON.stringify(q,null,2),"utf-8"),p(Z,G,B,W,J)}finally{Z.rmSync(G,{force:!0})}}}var w=d();import*as L from"node:os";import*as O from"node:path";function E(Q){return Q.trim().replace(/[^A-Za-z0-9._-]+/g,"-").replace(/^-+|-+$/g,"")||"unknown"}function n(Q){let Z=Q?.env??process.env,$=Q&&Object.hasOwn(Q,"getuid")?Q.getuid:process.getuid?.bind(process);if(typeof $==="function")return`uid-${$()}`;for(let W of["USERNAME","USER","LOGNAME"]){let J=Z[W];if(J)return`user-${E(J)}`}let Y=Q&&Object.hasOwn(Q,"userInfo")?Q.userInfo:L.userInfo;try{let W=Y?.().username;if(W)return`user-${E(W)}`}catch{}let X=Z.USERPROFILE??Z.HOME;if(X)return`home-${E(X)}`;let V=Q&&Object.hasOwn(Q,"homedir")?Q.homedir:L.homedir;try{let W=V?.();if(W)return`home-${E(W)}`}catch{}return"shared"}var _=O.join(L.tmpdir(),`dm-subagents-${n()}`),LQ=O.join(_,"async-subagent-results"),OQ=O.join(_,"async-subagent-runs"),l=O.join(_,"chain-runs"),_Q=O.join(_,"artifacts");function C(Q){if(Q<1000)return`${Q}ms`;if(Q<60000)return`${(Q/1000).toFixed(1)}s`;return`${Math.floor(Q/60000)}m${Math.floor(Q%60000/1000)}s`}function S(Q){let Z=process.env.HOME;if(Z&&Q.startsWith(Z))return`~${Q.slice(Z.length)}`;return Q}function R(Q){let Z=Q.getSessionFile()??Q.getSessionId();if(!Z)throw Error("Current session identity is unavailable.");return Z}var P=T.join(_,"scheduled-subagent-runs"),r=["schedule","schedule-list","schedule-status","schedule-cancel"],a=2147483647,s=300000,t=20;function mQ(Q){return typeof Q==="string"&&r.includes(Q)}function D(Q){return Q.scheduledRuns?.enabled===!0}function e(Q,Z,$=P){let Y=o("sha256").update(`${T.resolve(Q)}\x00${Z}`).digest("hex").slice(0,20);return T.join($,`${Y}.json`)}function QQ(Q,Z=Date.now()){let $=Q.trim(),Y=$.match(/^\+(\d+)(s|m|h|d)$/);if(Y){let X=Number(Y[1]);if(!Number.isSafeInteger(X)||X<1)throw Error(`Invalid schedule "${Q}". Relative schedules must be positive, such as "+10m".`);let V={s:1000,m:60000,h:3600000,d:86400000}[Y[2]],W=Z+X*V;if(!Number.isSafeInteger(W)||Number.isNaN(new Date(W).getTime()))throw Error(`Invalid schedule "${Q}". Relative delay is too large.`);return W}if(/^\d{4}-\d{2}-\d{2}T/.test($)){let X=$.match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/);if(!X)throw Error(`Invalid schedule "${Q}". Absolute ISO timestamps must include a timezone, such as "2030-01-01T09:00:00Z".`);let V=Number(X[1]),W=Number(X[2]),J=Number(X[3]),B=Number(X[4]),q=Number(X[5]),G=X[6]===void 0?0:Number(X[6]),K=X[7],A=K==="Z"?0:Number(K.slice(1,3)),H=K==="Z"?0:Number(K.slice(4,6)),z=W>=1&&W<=12?new Date(Date.UTC(V,W,0)).getUTCDate():0;if(W<1||W>12||J<1||J>z||B>23||q>59||G>59||A>23||H>59)throw Error(`Invalid schedule "${Q}". Use a valid future ISO timestamp.`);let N=new Date($).getTime();if(!Number.isNaN(N)){if(N<=Z)throw Error(`Scheduled time ${new Date(N).toISOString()} is in the past.`);return N}}throw Error(`Invalid schedule "${Q}". Use a one-shot relative delay like "+10m" or a future ISO timestamp with timezone.`)}function y(Q,Z,$){if(!M.existsSync(Q))return{version:1,cwd:Z,sessionId:$,jobs:[]};let Y;try{Y=JSON.parse(M.readFileSync(Q,"utf-8"))}catch(J){let B=J instanceof Error?J.message:String(J);throw Error(`Failed to parse scheduled subagent store '${Q}': ${B}`,{cause:J instanceof Error?J:void 0})}if(!Y||typeof Y!=="object"||Array.isArray(Y))throw Error(`Scheduled subagent store '${Q}' must be a JSON object.`);let X=Y;if(X.version!==1)throw Error(`Unsupported scheduled subagent store version in '${Q}'.`);if(!Array.isArray(X.jobs))throw Error(`Scheduled subagent store '${Q}' must contain a jobs array.`);let V=[],W=new Set(["scheduled","running","fired","canceled","missed","failed"]);for(let[J,B]of X.jobs.entries()){if(!B||typeof B!=="object"||Array.isArray(B))throw Error(`Scheduled subagent store '${Q}' job ${J} must be an object.`);let q=B;if(typeof q.id!=="string"||typeof q.name!=="string"||typeof q.schedule!=="string"||typeof q.cwd!=="string"||typeof q.sessionId!=="string")throw Error(`Scheduled subagent store '${Q}' job ${J} has invalid string fields.`);if([q.runAt,q.createdAt,q.updatedAt].some((K)=>typeof K!=="number"||!Number.isFinite(K)||Number.isNaN(new Date(K).getTime())))throw Error(`Scheduled subagent store '${Q}' job ${J} has invalid timestamps.`);if(!q.state||!W.has(q.state))throw Error(`Scheduled subagent store '${Q}' job ${J} has invalid state.`);if(!q.params||typeof q.params!=="object"||Array.isArray(q.params))throw Error(`Scheduled subagent store '${Q}' job ${J} has invalid params.`);V.push(q)}return{version:1,cwd:typeof X.cwd==="string"?X.cwd:Z,sessionId:typeof X.sessionId==="string"?X.sessionId:$,jobs:V}}class f{filePath;cwd;sessionId;constructor(Q,Z,$){this.filePath=Q,this.cwd=Z,this.sessionId=$}list(){return y(this.filePath,this.cwd,this.sessionId).jobs}get(Q){return this.list().find((Z)=>Z.id===Q)}mutate(Q){let Z=y(this.filePath,this.cwd,this.sessionId),$=Q(Z);return w(this.filePath,Z),$}}function x(Q){let Z=Q.scheduledRuns?.maxLatenessMs;return Number.isInteger(Z)&&Z>=0?Z:s}function ZQ(Q){let Z=Q.scheduledRuns?.maxPending;return Number.isInteger(Z)&&Z>=1?Z:t}function $Q(Q){return Q==="fired"||Q==="canceled"||Q==="missed"||Q==="failed"}function b(Q){if((Q.chain?.length??0)>0)return"chain";if((Q.tasks?.length??0)>0)return"parallel";return"single"}function YQ(Q){if((Q.chain?.length??0)>0)return`chain (${Q.chain.length})`;if((Q.tasks?.length??0)>0)return`parallel (${Q.tasks.length})`;return Q.agent?`agent ${Q.agent}`:"subagent run"}function U(Q,Z=!1){return{content:[{type:"text",text:Q}],...Z?{isError:!0}:{},details:{mode:"management",results:[]}}}function v(Q,Z){let $=Q.find((X)=>X.id===Z);if($)return $;let Y=Q.filter((X)=>X.id.startsWith(Z));if(Y.length===1)return Y[0];if(Y.length>1)throw Error(`Ambiguous scheduled run id prefix '${Z}' matched: ${Y.map((X)=>X.id).join(", ")}. Provide a longer id.`);throw Error(`Scheduled run '${Z}' not found.`)}function XQ(Q){let Z=(Q.chain?.length??0)>0,$=(Q.tasks?.length??0)>0,Y=!Z&&!$&&Boolean(Q.agent);if(Number(Z)+Number($)+Number(Y)!==1)return{error:"action='schedule' requires exactly one execution mode: agent, tasks, or chain."};if(!Q.schedule?.trim())return{error:"action='schedule' requires schedule, such as '+10m' or a future ISO timestamp."};if(Q.context==="fork")return{error:"Scheduled subagent runs require fresh context. Forked parent-session context is not safe at fire time."};if(Q.async===!1)return{error:"Scheduled subagent runs are always async; omit async or set async: true."};if(Q.clarify===!0)return{error:"Scheduled subagent runs cannot open clarify UI; omit clarify or set clarify: false."};let{action:X,id:V,runId:W,dir:J,index:B,message:q,chainName:G,config:K,schedule:A,scheduleName:H,...z}=Q;return{params:{...z,async:!0,clarify:!1,context:"fresh"}}}class k{store;ctx;timers=new Map;storeRoot;now;randomId;timersApi;deps;constructor(Q){this.deps=Q,this.storeRoot=Q.storeRoot??P,this.now=Q.now??Date.now,this.randomId=Q.randomId??(()=>i().slice(0,8)),this.timersApi=Q.timers??globalThis}bindSession(Q){if(this.stopTimers(),this.ctx=Q,!D(this.deps.config)){this.store=void 0;return}let Z=R(Q.sessionManager);this.store=new f(e(Q.cwd,Z,this.storeRoot),Q.cwd,Z),this.rearmScheduledJobs()}stop(){this.stopTimers(),this.store=void 0,this.ctx=void 0}async handleToolCall(Q,Z){this.ctx=Z;try{if(!D(this.deps.config))return U('Scheduled subagent runs are disabled. Set { "scheduledRuns": { "enabled": true } } in ~/.dm/agent/extensions/subagent/config.json, then reload Pi. Schedule only explicit delayed runs the user asked for.',!0);if(!this.store)this.bindSession(Z);if(!this.store)return U("Scheduled subagent store is unavailable for this session.",!0);switch(Q.action){case"schedule":return this.createJob(Q,Z);case"schedule-list":return this.listJobs();case"schedule-status":return this.statusJob(Q);case"schedule-cancel":return this.cancelJob(Q);default:return U(`Unknown scheduled-run action: ${Q.action}`,!0)}}catch($){let Y=$ instanceof Error?$.message:String($);return U(Y,!0)}}createJob(Q,Z){let $=this.requireStore(),Y=XQ(Q);if(Y.error)return U(Y.error,!0);let X=Q.schedule.trim(),V=QQ(X,this.now()),W=$.list().filter((z)=>z.state==="scheduled"||z.state==="running").length,J=ZQ(this.deps.config);if(W>=J)return U(`Scheduled subagent limit reached (${W}/${J} pending or running). Cancel an existing scheduled run before adding another.`,!0);let B=this.randomId(),q=R(Z.sessionManager),G=Q.scheduleName?.trim(),K=Y.params,A=this.now(),H={id:B,name:G||YQ(K),schedule:X,runAt:V,state:"scheduled",createdAt:A,updatedAt:A,cwd:Z.cwd,sessionId:q,params:K};return $.mutate((z)=>{z.jobs.push(H)}),this.arm(H),U([`Scheduled subagent run ${H.id}.`,`Name: ${H.name}`,`When: ${new Date(H.runAt).toISOString()}`,`Mode: ${b(K)}`,"Context: fresh (scheduled runs never fork parent-session context)",`Status: subagent({ action: "schedule-status", id: "${H.id}" })`,`Cancel before it fires: subagent({ action: "schedule-cancel", id: "${H.id}" })`].join(`
-`))}listJobs(){let Q=this.requireStore().list().sort(($,Y)=>$.runAt-Y.runAt);if(Q.length===0)return U("No scheduled subagent runs for this session.");let Z=[`Scheduled subagent runs: ${Q.length}`,""];for(let $ of Q){let Y=[$.id,$.state,new Date($.runAt).toISOString(),$.name];if($.lastRunId)Y.push(`run ${$.lastRunId}`);if($.lastError)Y.push(`error: ${$.lastError}`);Z.push(`- ${Y.join(" | ")}`)}return U(Z.join(`
-`))}statusJob(Q){let Z=Q.id??Q.runId;if(!Z)return U("action='schedule-status' requires id.",!0);let $=v(this.requireStore().list(),Z),Y=[`Scheduled run: ${$.id}`,`Name: ${$.name}`,`State: ${$.state}`,`Schedule: ${$.schedule}`,`Run at: ${new Date($.runAt).toISOString()}`,`Mode: ${b($.params)}`,`CWD: ${S($.cwd)}`,`Created: ${new Date($.createdAt).toISOString()}`,`Updated: ${new Date($.updatedAt).toISOString()}`,$.lastRunId?`Launched async run: ${$.lastRunId}`:void 0,$.lastAsyncDir?`Async dir: ${$.lastAsyncDir}`:void 0,$.lastError?`Error: ${$.lastError}`:void 0,$.state==="scheduled"?`Cancel: subagent({ action: "schedule-cancel", id: "${$.id}" })`:void 0,$.lastRunId?`Async status: subagent({ action: "status", id: "${$.lastRunId}" })`:void 0].filter((X)=>Boolean(X));return U(Y.join(`
-`))}cancelJob(Q){let Z=Q.id??Q.runId;if(!Z)return U("action='schedule-cancel' requires id.",!0);let $=this.requireStore(),Y=v($.list(),Z);if(Y.state==="running")return U(`Scheduled run ${Y.id} already launched async run ${Y.lastRunId??"unknown"}; interrupt that async run instead.`,!0);if($Q(Y.state))return U(`Scheduled run ${Y.id} is already ${Y.state}.`,!0);let X=this.now();return this.clearTimer(Y.id),$.mutate((V)=>{let W=V.jobs.find((J)=>J.id===Y.id);if(!W)return;W.state="canceled",W.canceledAt=X,W.updatedAt=X}),U(`Canceled scheduled subagent run ${Y.id}.`)}rearmScheduledJobs(){let Q=this.requireStore(),Z=this.now(),$=x(this.deps.config),Y=Q.list().filter((X)=>X.state==="scheduled"&&X.runAt+$<Z);if(Y.length>0)Q.mutate((X)=>{for(let V of Y){let W=X.jobs.find((J)=>J.id===V.id);if(!W||W.state!=="scheduled")continue;W.state="missed",W.updatedAt=Z,W.lastError=`Missed scheduled time by more than ${C($)} while DM was not available.`}});for(let X of Q.list())if(X.state==="scheduled")this.arm(X)}arm(Q){this.clearTimer(Q.id);let Z=Math.max(0,Q.runAt-this.now()),$=this.timersApi.setTimeout(()=>{this.fire(Q.id)},Math.min(Z,a));$.unref?.(),this.timers.set(Q.id,$)}async fire(Q){this.clearTimer(Q);let Z=this.store,$=this.ctx;if(!Z||!$)return;let Y=Z.get(Q);if(!Y||Y.state!=="scheduled")return;let X=this.now();if(X<Y.runAt){this.arm(Y);return}let V=x(this.deps.config);if(Y.runAt+V<X){Z.mutate((J)=>{let B=J.jobs.find((q)=>q.id===Q);if(!B||B.state!=="scheduled")return;B.state="missed",B.updatedAt=X,B.lastError=`Missed scheduled time by more than ${C(V)}.`});return}if(Z.mutate((J)=>{let B=J.jobs.find((q)=>q.id===Q);if(!B||B.state!=="scheduled")return;B.state="running",B.firedAt=X,B.updatedAt=X}),Y=Z.get(Q),!Y||Y.state!=="running")return;let W=new AbortController;try{let J=await this.deps.launch(Y.params,$,W.signal),B=J.details?.asyncId??J.details?.runId;Z.mutate((q)=>{let G=q.jobs.find((K)=>K.id===Q);if(!G)return;if(G.updatedAt=this.now(),J.isError||!B){G.state="failed",G.lastError=J.content.find((K)=>K.type==="text")?.text??"Scheduled subagent launch failed.";return}G.state="fired",G.lastRunId=B,G.lastAsyncDir=J.details?.asyncDir})}catch(J){let B=J instanceof Error?J.message:String(J);Z.mutate((q)=>{let G=q.jobs.find((K)=>K.id===Q);if(!G)return;G.state="failed",G.lastError=B,G.updatedAt=this.now()})}}requireStore(){if(!this.store)throw Error("Scheduled subagent store is not bound to a session.");return this.store}clearTimer(Q){let Z=this.timers.get(Q);if(!Z)return;this.timersApi.clearTimeout(Z),this.timers.delete(Q)}stopTimers(){for(let Q of this.timers.values())this.timersApi.clearTimeout(Q);this.timers.clear()}}function cQ(Q){return new k(Q)}export{D as scheduledRunsEnabled,e as scheduledRunStorePath,QQ as parseScheduledRunTime,mQ as isScheduledRunAction,cQ as createScheduledRunManager,k as ScheduledRunManager,r as SCHEDULED_RUN_ACTIONS,P as SCHEDULED_RUNS_DIR};
+import { createHash, randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { writeAtomicJson } from "../../shared/atomic-json.js";
+import { formatDuration, shortenPath } from "../../shared/formatters.js";
+import { resolveCurrentSessionId } from "../../shared/session-identity.js";
+import {
+  TEMP_ROOT_DIR
+} from "../../shared/types.js";
+export const SCHEDULED_RUNS_DIR = path.join(TEMP_ROOT_DIR, "scheduled-subagent-runs");
+export const SCHEDULED_RUN_ACTIONS = ["schedule", "schedule-list", "schedule-status", "schedule-cancel"];
+const MAX_TIMER_DELAY_MS = 2147483647;
+const DEFAULT_MAX_LATENESS_MS = 5 * 60 * 1000;
+const DEFAULT_MAX_PENDING = 20;
+export function isScheduledRunAction(action) {
+  return typeof action === "string" && SCHEDULED_RUN_ACTIONS.includes(action);
+}
+export function scheduledRunsEnabled(config) {
+  return config.scheduledRuns?.enabled === true;
+}
+export function scheduledRunStorePath(cwd, sessionId, root = SCHEDULED_RUNS_DIR) {
+  const digest = createHash("sha256").update(`${path.resolve(cwd)}\x00${sessionId}`).digest("hex").slice(0, 20);
+  return path.join(root, `${digest}.json`);
+}
+export function parseScheduledRunTime(schedule, now = Date.now()) {
+  const trimmed = schedule.trim();
+  const relative = trimmed.match(/^\+(\d+)(s|m|h|d)$/);
+  if (relative) {
+    const amount = Number(relative[1]);
+    if (!Number.isSafeInteger(amount) || amount < 1)
+      throw new Error(`Invalid schedule "${schedule}". Relative schedules must be positive, such as "+10m".`);
+    const unitMs = { s: 1000, m: 60000, h: 3600000, d: 86400000 }[relative[2]];
+    const runAt = now + amount * unitMs;
+    if (!Number.isSafeInteger(runAt) || Number.isNaN(new Date(runAt).getTime()))
+      throw new Error(`Invalid schedule "${schedule}". Relative delay is too large.`);
+    return runAt;
+  }
+  if (/^\d{4}-\d{2}-\d{2}T/.test(trimmed)) {
+    const iso = trimmed.match(/^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/);
+    if (!iso)
+      throw new Error(`Invalid schedule "${schedule}". Absolute ISO timestamps must include a timezone, such as "2030-01-01T09:00:00Z".`);
+    const year = Number(iso[1]);
+    const month = Number(iso[2]);
+    const day = Number(iso[3]);
+    const hour = Number(iso[4]);
+    const minute = Number(iso[5]);
+    const second = iso[6] === undefined ? 0 : Number(iso[6]);
+    const offset = iso[7];
+    const offsetHour = offset === "Z" ? 0 : Number(offset.slice(1, 3));
+    const offsetMinute = offset === "Z" ? 0 : Number(offset.slice(4, 6));
+    const daysInMonth = month >= 1 && month <= 12 ? new Date(Date.UTC(year, month, 0)).getUTCDate() : 0;
+    if (month < 1 || month > 12 || day < 1 || day > daysInMonth || hour > 23 || minute > 59 || second > 59 || offsetHour > 23 || offsetMinute > 59) {
+      throw new Error(`Invalid schedule "${schedule}". Use a valid future ISO timestamp.`);
+    }
+    const parsed = new Date(trimmed).getTime();
+    if (!Number.isNaN(parsed)) {
+      if (parsed <= now)
+        throw new Error(`Scheduled time ${new Date(parsed).toISOString()} is in the past.`);
+      return parsed;
+    }
+  }
+  throw new Error(`Invalid schedule "${schedule}". Use a one-shot relative delay like "+10m" or a future ISO timestamp with timezone.`);
+}
+function readStoreData(filePath, cwd, sessionId) {
+  if (!fs.existsSync(filePath))
+    return { version: 1, cwd, sessionId, jobs: [] };
+  let parsed;
+  try {
+    parsed = JSON.parse(fs.readFileSync(filePath, "utf-8"));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to parse scheduled subagent store '${filePath}': ${message}`, { cause: error instanceof Error ? error : undefined });
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`Scheduled subagent store '${filePath}' must be a JSON object.`);
+  }
+  const data = parsed;
+  if (data.version !== 1)
+    throw new Error(`Unsupported scheduled subagent store version in '${filePath}'.`);
+  if (!Array.isArray(data.jobs))
+    throw new Error(`Scheduled subagent store '${filePath}' must contain a jobs array.`);
+  const jobs = [];
+  const validStates = new Set(["scheduled", "running", "fired", "canceled", "missed", "failed"]);
+  for (const [index, job] of data.jobs.entries()) {
+    if (!job || typeof job !== "object" || Array.isArray(job))
+      throw new Error(`Scheduled subagent store '${filePath}' job ${index} must be an object.`);
+    const candidate = job;
+    if (typeof candidate.id !== "string" || typeof candidate.name !== "string" || typeof candidate.schedule !== "string" || typeof candidate.cwd !== "string" || typeof candidate.sessionId !== "string") {
+      throw new Error(`Scheduled subagent store '${filePath}' job ${index} has invalid string fields.`);
+    }
+    const timestamps = [candidate.runAt, candidate.createdAt, candidate.updatedAt];
+    if (timestamps.some((value) => typeof value !== "number" || !Number.isFinite(value) || Number.isNaN(new Date(value).getTime()))) {
+      throw new Error(`Scheduled subagent store '${filePath}' job ${index} has invalid timestamps.`);
+    }
+    if (!candidate.state || !validStates.has(candidate.state))
+      throw new Error(`Scheduled subagent store '${filePath}' job ${index} has invalid state.`);
+    if (!candidate.params || typeof candidate.params !== "object" || Array.isArray(candidate.params))
+      throw new Error(`Scheduled subagent store '${filePath}' job ${index} has invalid params.`);
+    jobs.push(candidate);
+  }
+  return {
+    version: 1,
+    cwd: typeof data.cwd === "string" ? data.cwd : cwd,
+    sessionId: typeof data.sessionId === "string" ? data.sessionId : sessionId,
+    jobs
+  };
+}
+
+class ScheduledRunStore {
+  filePath;
+  cwd;
+  sessionId;
+  constructor(filePath, cwd, sessionId) {
+    this.filePath = filePath;
+    this.cwd = cwd;
+    this.sessionId = sessionId;
+  }
+  list() {
+    return readStoreData(this.filePath, this.cwd, this.sessionId).jobs;
+  }
+  get(id) {
+    return this.list().find((job) => job.id === id);
+  }
+  mutate(fn) {
+    const data = readStoreData(this.filePath, this.cwd, this.sessionId);
+    const result = fn(data);
+    writeAtomicJson(this.filePath, data);
+    return result;
+  }
+}
+function resolveMaxLatenessMs(config) {
+  const value = config.scheduledRuns?.maxLatenessMs;
+  return Number.isInteger(value) && value >= 0 ? value : DEFAULT_MAX_LATENESS_MS;
+}
+function resolveMaxPending(config) {
+  const value = config.scheduledRuns?.maxPending;
+  return Number.isInteger(value) && value >= 1 ? value : DEFAULT_MAX_PENDING;
+}
+function terminalState(state) {
+  return state === "fired" || state === "canceled" || state === "missed" || state === "failed";
+}
+function jobMode(params) {
+  if ((params.chain?.length ?? 0) > 0)
+    return "chain";
+  if ((params.tasks?.length ?? 0) > 0)
+    return "parallel";
+  return "single";
+}
+function describeScheduledTarget(params) {
+  if ((params.chain?.length ?? 0) > 0)
+    return `chain (${params.chain.length})`;
+  if ((params.tasks?.length ?? 0) > 0)
+    return `parallel (${params.tasks.length})`;
+  return params.agent ? `agent ${params.agent}` : "subagent run";
+}
+function textResult(text, isError = false) {
+  return {
+    content: [{ type: "text", text }],
+    ...isError ? { isError: true } : {},
+    details: { mode: "management", results: [] }
+  };
+}
+function resolveJobById(jobs, requestedId) {
+  const exact = jobs.find((job) => job.id === requestedId);
+  if (exact)
+    return exact;
+  const matches = jobs.filter((job) => job.id.startsWith(requestedId));
+  if (matches.length === 1)
+    return matches[0];
+  if (matches.length > 1)
+    throw new Error(`Ambiguous scheduled run id prefix '${requestedId}' matched: ${matches.map((job) => job.id).join(", ")}. Provide a longer id.`);
+  throw new Error(`Scheduled run '${requestedId}' not found.`);
+}
+function sanitizeScheduledParams(params) {
+  const hasChain = (params.chain?.length ?? 0) > 0;
+  const hasTasks = (params.tasks?.length ?? 0) > 0;
+  const hasSingle = !hasChain && !hasTasks && Boolean(params.agent);
+  if (Number(hasChain) + Number(hasTasks) + Number(hasSingle) !== 1) {
+    return { error: "action='schedule' requires exactly one execution mode: agent, tasks, or chain." };
+  }
+  if (!params.schedule?.trim())
+    return { error: "action='schedule' requires schedule, such as '+10m' or a future ISO timestamp." };
+  if (params.context === "fork")
+    return { error: "Scheduled subagent runs require fresh context. Forked parent-session context is not safe at fire time." };
+  if (params.async === false)
+    return { error: "Scheduled subagent runs are always async; omit async or set async: true." };
+  if (params.clarify === true)
+    return { error: "Scheduled subagent runs cannot open clarify UI; omit clarify or set clarify: false." };
+  const {
+    action: _action,
+    id: _id,
+    runId: _runId,
+    dir: _dir,
+    index: _index,
+    message: _message,
+    chainName: _chainName,
+    config: _config,
+    schedule: _schedule,
+    scheduleName: _scheduleName,
+    ...executionParams
+  } = params;
+  return { params: { ...executionParams, async: true, clarify: false, context: "fresh" } };
+}
+
+export class ScheduledRunManager {
+  store;
+  ctx;
+  timers = new Map;
+  storeRoot;
+  now;
+  randomId;
+  timersApi;
+  deps;
+  constructor(deps) {
+    this.deps = deps;
+    this.storeRoot = deps.storeRoot ?? SCHEDULED_RUNS_DIR;
+    this.now = deps.now ?? Date.now;
+    this.randomId = deps.randomId ?? (() => randomUUID().slice(0, 8));
+    this.timersApi = deps.timers ?? globalThis;
+  }
+  bindSession(ctx) {
+    this.stopTimers();
+    this.ctx = ctx;
+    if (!scheduledRunsEnabled(this.deps.config)) {
+      this.store = undefined;
+      return;
+    }
+    const sessionId = resolveCurrentSessionId(ctx.sessionManager);
+    this.store = new ScheduledRunStore(scheduledRunStorePath(ctx.cwd, sessionId, this.storeRoot), ctx.cwd, sessionId);
+    this.rearmScheduledJobs();
+  }
+  stop() {
+    this.stopTimers();
+    this.store = undefined;
+    this.ctx = undefined;
+  }
+  async handleToolCall(params, ctx) {
+    this.ctx = ctx;
+    try {
+      if (!scheduledRunsEnabled(this.deps.config)) {
+        return textResult('Scheduled subagent runs are disabled. Set { "scheduledRuns": { "enabled": true } } in ~/.dm/agent/extensions/subagent/config.json, then reload Pi. Schedule only explicit delayed runs the user asked for.', true);
+      }
+      if (!this.store)
+        this.bindSession(ctx);
+      if (!this.store)
+        return textResult("Scheduled subagent store is unavailable for this session.", true);
+      switch (params.action) {
+        case "schedule":
+          return this.createJob(params, ctx);
+        case "schedule-list":
+          return this.listJobs();
+        case "schedule-status":
+          return this.statusJob(params);
+        case "schedule-cancel":
+          return this.cancelJob(params);
+        default:
+          return textResult(`Unknown scheduled-run action: ${params.action}`, true);
+      }
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      return textResult(message, true);
+    }
+  }
+  createJob(params, ctx) {
+    const store = this.requireStore();
+    const sanitized = sanitizeScheduledParams(params);
+    if (sanitized.error)
+      return textResult(sanitized.error, true);
+    const scheduleInput = params.schedule.trim();
+    const runAt = parseScheduledRunTime(scheduleInput, this.now());
+    const pendingCount = store.list().filter((job) => job.state === "scheduled" || job.state === "running").length;
+    const maxPending = resolveMaxPending(this.deps.config);
+    if (pendingCount >= maxPending)
+      return textResult(`Scheduled subagent limit reached (${pendingCount}/${maxPending} pending or running). Cancel an existing scheduled run before adding another.`, true);
+    const id = this.randomId();
+    const sessionId = resolveCurrentSessionId(ctx.sessionManager);
+    const scheduleName = params.scheduleName?.trim();
+    const executionParams = sanitized.params;
+    const now = this.now();
+    const job = {
+      id,
+      name: scheduleName || describeScheduledTarget(executionParams),
+      schedule: scheduleInput,
+      runAt,
+      state: "scheduled",
+      createdAt: now,
+      updatedAt: now,
+      cwd: ctx.cwd,
+      sessionId,
+      params: executionParams
+    };
+    store.mutate((data) => {
+      data.jobs.push(job);
+    });
+    this.arm(job);
+    return textResult([
+      `Scheduled subagent run ${job.id}.`,
+      `Name: ${job.name}`,
+      `When: ${new Date(job.runAt).toISOString()}`,
+      `Mode: ${jobMode(executionParams)}`,
+      `Context: fresh (scheduled runs never fork parent-session context)`,
+      `Status: subagent({ action: "schedule-status", id: "${job.id}" })`,
+      `Cancel before it fires: subagent({ action: "schedule-cancel", id: "${job.id}" })`
+    ].join(`
+`));
+  }
+  listJobs() {
+    const jobs = this.requireStore().list().sort((left, right) => left.runAt - right.runAt);
+    if (jobs.length === 0)
+      return textResult("No scheduled subagent runs for this session.");
+    const lines = [`Scheduled subagent runs: ${jobs.length}`, ""];
+    for (const job of jobs) {
+      const parts = [job.id, job.state, new Date(job.runAt).toISOString(), job.name];
+      if (job.lastRunId)
+        parts.push(`run ${job.lastRunId}`);
+      if (job.lastError)
+        parts.push(`error: ${job.lastError}`);
+      lines.push(`- ${parts.join(" | ")}`);
+    }
+    return textResult(lines.join(`
+`));
+  }
+  statusJob(params) {
+    const requestedId = params.id ?? params.runId;
+    if (!requestedId)
+      return textResult("action='schedule-status' requires id.", true);
+    const job = resolveJobById(this.requireStore().list(), requestedId);
+    const lines = [
+      `Scheduled run: ${job.id}`,
+      `Name: ${job.name}`,
+      `State: ${job.state}`,
+      `Schedule: ${job.schedule}`,
+      `Run at: ${new Date(job.runAt).toISOString()}`,
+      `Mode: ${jobMode(job.params)}`,
+      `CWD: ${shortenPath(job.cwd)}`,
+      `Created: ${new Date(job.createdAt).toISOString()}`,
+      `Updated: ${new Date(job.updatedAt).toISOString()}`,
+      job.lastRunId ? `Launched async run: ${job.lastRunId}` : undefined,
+      job.lastAsyncDir ? `Async dir: ${job.lastAsyncDir}` : undefined,
+      job.lastError ? `Error: ${job.lastError}` : undefined,
+      job.state === "scheduled" ? `Cancel: subagent({ action: "schedule-cancel", id: "${job.id}" })` : undefined,
+      job.lastRunId ? `Async status: subagent({ action: "status", id: "${job.lastRunId}" })` : undefined
+    ].filter((line) => Boolean(line));
+    return textResult(lines.join(`
+`));
+  }
+  cancelJob(params) {
+    const requestedId = params.id ?? params.runId;
+    if (!requestedId)
+      return textResult("action='schedule-cancel' requires id.", true);
+    const store = this.requireStore();
+    const job = resolveJobById(store.list(), requestedId);
+    if (job.state === "running")
+      return textResult(`Scheduled run ${job.id} already launched async run ${job.lastRunId ?? "unknown"}; interrupt that async run instead.`, true);
+    if (terminalState(job.state))
+      return textResult(`Scheduled run ${job.id} is already ${job.state}.`, true);
+    const now = this.now();
+    this.clearTimer(job.id);
+    store.mutate((data) => {
+      const stored = data.jobs.find((candidate) => candidate.id === job.id);
+      if (!stored)
+        return;
+      stored.state = "canceled";
+      stored.canceledAt = now;
+      stored.updatedAt = now;
+    });
+    return textResult(`Canceled scheduled subagent run ${job.id}.`);
+  }
+  rearmScheduledJobs() {
+    const store = this.requireStore();
+    const now = this.now();
+    const maxLatenessMs = resolveMaxLatenessMs(this.deps.config);
+    const dueToMiss = store.list().filter((job) => job.state === "scheduled" && job.runAt + maxLatenessMs < now);
+    if (dueToMiss.length > 0) {
+      store.mutate((data) => {
+        for (const missed of dueToMiss) {
+          const job = data.jobs.find((candidate) => candidate.id === missed.id);
+          if (!job || job.state !== "scheduled")
+            continue;
+          job.state = "missed";
+          job.updatedAt = now;
+          job.lastError = `Missed scheduled time by more than ${formatDuration(maxLatenessMs)} while DM was not available.`;
+        }
+      });
+    }
+    for (const job of store.list()) {
+      if (job.state === "scheduled")
+        this.arm(job);
+    }
+  }
+  arm(job) {
+    this.clearTimer(job.id);
+    const delayMs = Math.max(0, job.runAt - this.now());
+    const timer = this.timersApi.setTimeout(() => {
+      this.fire(job.id);
+    }, Math.min(delayMs, MAX_TIMER_DELAY_MS));
+    timer.unref?.();
+    this.timers.set(job.id, timer);
+  }
+  async fire(jobId) {
+    this.clearTimer(jobId);
+    const store = this.store;
+    const ctx = this.ctx;
+    if (!store || !ctx)
+      return;
+    let job = store.get(jobId);
+    if (!job || job.state !== "scheduled")
+      return;
+    const now = this.now();
+    if (now < job.runAt) {
+      this.arm(job);
+      return;
+    }
+    const maxLatenessMs = resolveMaxLatenessMs(this.deps.config);
+    if (job.runAt + maxLatenessMs < now) {
+      store.mutate((data) => {
+        const stored = data.jobs.find((candidate) => candidate.id === jobId);
+        if (!stored || stored.state !== "scheduled")
+          return;
+        stored.state = "missed";
+        stored.updatedAt = now;
+        stored.lastError = `Missed scheduled time by more than ${formatDuration(maxLatenessMs)}.`;
+      });
+      return;
+    }
+    store.mutate((data) => {
+      const stored = data.jobs.find((candidate) => candidate.id === jobId);
+      if (!stored || stored.state !== "scheduled")
+        return;
+      stored.state = "running";
+      stored.firedAt = now;
+      stored.updatedAt = now;
+    });
+    job = store.get(jobId);
+    if (!job || job.state !== "running")
+      return;
+    const controller = new AbortController;
+    try {
+      const result = await this.deps.launch(job.params, ctx, controller.signal);
+      const launchRunId = result.details?.asyncId ?? result.details?.runId;
+      store.mutate((data) => {
+        const stored = data.jobs.find((candidate) => candidate.id === jobId);
+        if (!stored)
+          return;
+        stored.updatedAt = this.now();
+        if (result.isError || !launchRunId) {
+          stored.state = "failed";
+          stored.lastError = result.content.find((item) => item.type === "text")?.text ?? "Scheduled subagent launch failed.";
+          return;
+        }
+        stored.state = "fired";
+        stored.lastRunId = launchRunId;
+        stored.lastAsyncDir = result.details?.asyncDir;
+      });
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      store.mutate((data) => {
+        const stored = data.jobs.find((candidate) => candidate.id === jobId);
+        if (!stored)
+          return;
+        stored.state = "failed";
+        stored.lastError = message;
+        stored.updatedAt = this.now();
+      });
+    }
+  }
+  requireStore() {
+    if (!this.store)
+      throw new Error("Scheduled subagent store is not bound to a session.");
+    return this.store;
+  }
+  clearTimer(jobId) {
+    const timer = this.timers.get(jobId);
+    if (!timer)
+      return;
+    this.timersApi.clearTimeout(timer);
+    this.timers.delete(jobId);
+  }
+  stopTimers() {
+    for (const timer of this.timers.values())
+      this.timersApi.clearTimeout(timer);
+    this.timers.clear();
+  }
+}
+export function createScheduledRunManager(deps) {
+  return new ScheduledRunManager(deps);
+}