@tekmidian/pai 0.66.0 → 0.66.1

package/dist/{run-Z4akoa8G.mjs → run-BCpbxqA5.mjs}

@@ -1774,6 +1774,126 @@ function itermForClaudeSession(logDir, claudeSession, now = Date.now()) {
 	return term ? itermUuid(term) : null;
 }
 
+//#endregion
+//#region src/workers/endreason.ts
+/**
+* Who or what ended a worker. One place decides the reason; the runner's
+* signal handlers and the deadline record it, `pai worker kill` and the daemon
+* leave a kill-request marker (`<logDir>/<id>.kill`) before signalling so the
+* runner can tell their stops from an external one.
+*/
+const killMarkerPath = (logDir, id) => join(logDir, `${id}.kill`);
+/** Best description of the invoking session: PAI parent/AIBroker session env, else the Claude Code session id. */
+function callerDescription(env = process.env) {
+	const name = env.PAI_WORKER_PARENT ?? env.PAI_SESSION_NAME ?? env.AIBROKER_SESSION_NAME ?? env.AIBROKER_SESSION;
+	if (name) return name;
+	if (env.CLAUDE_CODE_SESSION_ID) return `claude-session:${env.CLAUDE_CODE_SESSION_ID}`;
+	return env.CLAUDECODE ? "claude-code" : "shell";
+}
+/** Write the kill-request marker and the WORKER-KILL ledger line; call right before signalling. */
+function requestKill(logDir, ledger, id, by = callerDescription()) {
+	const req = {
+		ts: (/* @__PURE__ */ new Date()).toISOString(),
+		by,
+		pid: process.pid,
+		ppid: process.ppid,
+		cwd: process.cwd()
+	};
+	writeFileSync(killMarkerPath(logDir, id), JSON.stringify(req));
+	appendLedger(ledger, "WORKER-KILL", {
+		id,
+		by,
+		pid: req.pid,
+		ppid: req.ppid,
+		cwd: req.cwd
+	});
+}
+function readMarker(logDir, id) {
+	const p = killMarkerPath(logDir, id);
+	if (!existsSync(p)) return null;
+	try {
+		return JSON.parse(readFileSync(p, "utf8"));
+	} catch {
+		return {
+			ts: "",
+			by: "unknown",
+			pid: 0,
+			ppid: 0,
+			cwd: ""
+		};
+	} finally {
+		try {
+			unlinkSync(p);
+		} catch {}
+	}
+}
+function pidAlive(pid) {
+	try {
+		process.kill(pid, 0);
+		return true;
+	} catch (e) {
+		return e.code === "EPERM";
+	}
+}
+/** Command name of a pid (`ps -o comm=`), or undefined when it is gone or ps fails. */
+function commOf(pid) {
+	try {
+		return execFileSync("ps", [
+			"-o",
+			"comm=",
+			"-p",
+			String(pid)
+		], { encoding: "utf8" }).trim() || void 0;
+	} catch {
+		return;
+	}
+}
+/** Parent facts recorded at start, for the end report ("parent: claude"). */
+function parentInfo() {
+	const parentPid = process.ppid;
+	return {
+		parentPid,
+		parentComm: commOf(parentPid),
+		parentBackground: process.env.CLAUDECODE ? true : void 0
+	};
+}
+/**
+* The single decision. `signal` = the signal the runner received (absent for a
+* deadline stop or a normal exit); `timedOut` = the deadline fired. Reads (and
+* consumes) the kill marker.
+*/
+function decideEndReason(a) {
+	if (a.timedOut) return { reason: "deadline" };
+	if (!a.signal) return { reason: "exit" };
+	const marker = readMarker(a.logDir, a.id);
+	if (marker) return {
+		reason: "pai-worker-kill",
+		by: marker.by,
+		note: `${a.signal} requested by pid ${marker.pid}`
+	};
+	const alive = (a.isAlive ?? pidAlive)(a.parentPid ?? process.ppid);
+	const parent = `parent ${a.parentPid ?? "?"}${a.parentComm ? ` (${a.parentComm})` : ""}`;
+	if (!alive) return {
+		reason: "parent-gone",
+		note: `${a.signal}; ${parent} not alive`
+	};
+	return {
+		reason: "external-signal",
+		note: `${a.signal}; sender unknown (not deadline, not pai worker kill); a Claude Code background task stop (TaskStop, Bash timeout, session end) is the usual source; ${parent} alive` + (a.parentBackground ? "; started from a Claude Code session" : "")
+	};
+}
+/** The status/ledger fields for an end. */
+function endFields(e) {
+	return {
+		reason: e.reason,
+		...e.by ? { by: e.by } : {}
+	};
+}
+/** "external-signal", "pai-worker-kill by <caller>" for a finished worker; null when nothing was recorded. */
+function endLabel(s) {
+	return s.endReason ? `${s.endReason}${s.endBy ? ` by ${s.endBy}` : ""}` : null;
+}
+
 //#endregion
 //#region src/workers/controls.ts
 /**
@@ -3090,6 +3210,7 @@ function fullContractPrompt(format) {
 		"116 s). Ending your turn ends this process, so a background job gets no later wake-up here:",
 		"run_in_background is denied. Run the long command in the FOREGROUND with a Bash timeout up to 600000 ms",
 		"and split longer jobs into steps that each fit it.",
+		"Kill only processes you started, by PID (`cmd & echo $! > /tmp/x.pid`, then `kill $(cat /tmp/x.pid)`); never `pkill`/`killall`/`kill $(pgrep ...)` — other workers' command lines contain your spec text.",
 		...fileNotInlineBlock(),
 		"",
 		`Operator messages: a user turn starting with ${OPERATOR_MARK} was typed by the operator while you`,
@@ -3774,7 +3895,7 @@ async function runWorker(opts) {
 		if (gc?.length) process.stderr.write(`pai worker: archived ${gc.length} leftover worktree(s) (pai worker gc)\n`);
 	} catch {}
 	if (opts.className === "plan" && !opts._planner) {
-		const { runPlanner } = await import("./planner-EJPZnnif.mjs");
+		const { runPlanner } = await import("./planner-Dm5Acyo1.mjs");
 		return runPlanner(opts);
 	}
 	const parent = launchParent(opts.parent);
@@ -4003,6 +4124,22 @@ function fireDeadline(logDir, status, ledger, limit) {
 		minutes: limit.minutes
 	});
 }
+/** Decide why a signal ended the run and put it on the status; the caller writes WORKER-END. */
+function recordSignalEnd(logDir, status, signal) {
+	const end = decideEndReason({
+		logDir,
+		id: status.id,
+		signal,
+		timedOut: status.timedOut,
+		parentPid: status.parentPid,
+		parentComm: status.parentComm,
+		parentBackground: status.parentBackground
+	});
+	status.endReason = end.reason;
+	status.endBy = end.by;
+	status.endNote = end.note;
+	return end;
+}
 async function finaliseRun(f) {
 	const { logDir, ledger, ok, rc } = f;
 	let { status, report } = f;
@@ -4044,12 +4181,19 @@ async function finaliseRun(f) {
 			reason: orphanReason
 		});
 	}
+	const end = decideEndReason({
+		logDir,
+		id: wid,
+		timedOut: f.timedOut !== void 0
+	});
+	status.endReason = end.reason;
 	saveStatus(logDir, status);
 	appendLedger(ledger, "WORKER-END", {
 		id: wid,
 		...f.end,
 		rc,
-		secs: f.secs
+		secs: f.secs,
+		...endFields(end)
 	});
 	if (f.worktree) status = recordWorktree(logDir, status, f.worktree, ok);
 	const early = await f.beforeHandoff?.(status, report);
@@ -4297,6 +4441,7 @@ async function executeRun(a) {
 	let status = {
 		id: wid,
 		pid: process.pid,
+		...parentInfo(),
 		label,
 		cwd,
 		term,
@@ -4409,7 +4554,8 @@ async function executeRun(a) {
 		status.state = "killed";
 		status.rc = 143;
 		status.secs = Math.floor((Date.now() - t0) / 1e3);
-		status.last = `killed by signal ${sig}`;
+		const end = recordSignalEnd(logDir, status, sig);
+		status.last = `killed by signal ${sig} (${end.reason}${end.by ? ` by ${end.by}` : ""})`;
 		saveStatus(logDir, status);
 		appendLedger(ledger, "WORKER-END", {
 			id: wid,
@@ -4419,6 +4565,8 @@ async function executeRun(a) {
 			rc: 143,
 			secs: status.secs,
 			killed: 1,
+			...endFields(end),
+			note: end.note,
 			label
 		});
 		if (worktree) {
@@ -4684,6 +4832,7 @@ async function executeCodexRun(a) {
 	let status = {
 		id: wid,
 		pid: process.pid,
+		...parentInfo(),
 		label,
 		cwd,
 		term,
@@ -4776,8 +4925,21 @@ async function executeCodexRun(a) {
 			status.state = "killed";
 			status.rc = 143;
 			status.secs = Math.floor((Date.now() - t0) / 1e3);
-			status.last = `killed by signal ${sig}`;
+			const end = recordSignalEnd(logDir, status, sig);
+			status.last = `killed by signal ${sig} (${end.reason}${end.by ? ` by ${end.by}` : ""})`;
 			saveStatus(logDir, status);
+			appendLedger(ledger, "WORKER-END", {
+				id: wid,
+				provider: target.providerName,
+				mode: "headless",
+				model,
+				rc: 143,
+				secs: status.secs,
+				killed: 1,
+				...endFields(end),
+				note: end.note,
+				label
+			});
 			if (worktree) {
 				salvageOnExit(ledger, wid, label, worktree.dir, SIGNAL_SALVAGE_MS);
 				try {
@@ -4992,5 +5154,5 @@ function resultFromOutput(out) {
 }
 
 //#endregion
-export { projectLaunchConfig as $, worktreesDir as A, isLive as B, workerInScope as C, mergeWorker as D, git as E, alive as F, ownsPid as G, loadStatuses as H, contextLabel as I, waitForTerminalStatus as J, saveStatus as K, contextPercent as L, ledgerSummary as M, UNLABELED as N, uncommittedPaths as O, ageOf as P, pinNotices as Q, elapsedOf as R, sessionTag as S, gcWorktrees as T, newWorkerId as U, loadStatus as V, nowStamp as W, parseRunnerArgs as X, longInlinePromptHint as Y, shortText as Z, currentTabKey as _, deadlineLabel as a, resolveSession as b, handoffFromInside as c, workerDepth as d, describeMcp as et, checkPaneForWorker as f, markControlsHeld as g, clickrControlsArgv as h, usageContextTokens as i, appendLedger as j, verifyWorker as k, readInbox as l, openPaneForWorker as m, runWorker as n, parseWorkerReport as o, openFollowPane as p, setWorkerLabel as q, testProvider as r, renderReport as s, printResult as t, expandMcpNames as tt, sayToWorker as u, itermForClaudeSession as v, discardWorker as w, sessionMapPath as x, itermUuid as y, isChatPane as z };
-//# sourceMappingURL=run-Z4akoa8G.mjs.map
+export { parseRunnerArgs as $, mergeWorker as A, contextPercent as B, resolveSession as C, discardWorker as D, workerInScope as E, ledgerSummary as F, loadStatuses as G, isChatPane as H, UNLABELED as I, ownsPid as J, newWorkerId as K, ageOf as L, verifyWorker as M, worktreesDir as N, gcWorktrees as O, appendLedger as P, longInlinePromptHint as Q, alive as R, itermUuid as S, sessionTag as T, isLive as U, elapsedOf as V, loadStatus as W, setWorkerLabel as X, saveStatus as Y, waitForTerminalStatus as Z, callerDescription as _, deadlineLabel as a, currentTabKey as b, handoffFromInside as c, workerDepth as d, shortText as et, checkPaneForWorker as f, markControlsHeld as g, clickrControlsArgv as h, usageContextTokens as i, expandMcpNames as it, uncommittedPaths as j, git as k, readInbox as l, openPaneForWorker as m, runWorker as n, projectLaunchConfig as nt, parseWorkerReport as o, openFollowPane as p, nowStamp as q, testProvider as r, describeMcp as rt, renderReport as s, printResult as t, pinNotices as tt, sayToWorker as u, endLabel as v, sessionMapPath as w, itermForClaudeSession as x, requestKill as y, contextLabel as z };
+//# sourceMappingURL=run-BCpbxqA5.mjs.map