@krapht/ork 1.0.0-alpha.15 → 1.0.0-alpha.17

package/dist/{run--4-1xAF2.mjs → run-OOWQIKMJ.mjs}

@@ -1,13 +1,13 @@
-import { $ as resolveInputs, $n as createFeedback, $t as sessionDriver, At as walkSummary, Cn as liveStatus, Er as placeFiles, Fn as gitRulesOf, Gr as beforeOf, In as loadProject, Ln as machineRulesOf, Mr as inside, Nt as userMessageText, On as templateOf, Q as parseInputPairs, Rn as createSignals, Tt as planNodeSession, U as openStore, X as createReplay, Y as inspectProject, Yn as runGh, Z as replayLoopAnswers, _i as AGENT_DRIVERS, an as createFollowUps, ar as renderTemplate, cr as socketPath, dn as deliverFollowUp, dr as maskReplacer, dt as createCalls, ft as adoptedCalls, gn as endLinksOf, gt as detachRun, ht as DETACHED_ENV, ir as parseTemplate, jt as startRun, kr as runDirOf, m as resolveBase, mi as readyDriver, n as resumedOptions, on as checkFollowUpsDue, qt as git, ri as isClaudeNode, si as retiredDriverHint, sr as serveRun, st as createRelay, t as createWorkspace, un as takeFollowUps, vt as NOT_STARTED, zn as endOf } from "./src-Dr_fTSu-.mjs";
-import { a as formatEvent, c as createTerminalHuman, o as formatRunEvent, s as callsShown, t as attachRun, u as createDecisionQueue } from "./attach-BHO3X3cf.mjs";
-import { h as nodeSession, n as ORK_VERSION, v as findFollowUp } from "./__build_info__-Bsb1kjgF.mjs";
-import { n as newRunId } from "./find-BYLlszqj.mjs";
+import { $r as beforeOf, $t as git, An as liveStatus, Br as inside, Cn as endLinksOf, Ct as startRun, Ei as DRIVER_IDS, Fn as templateOf, G as parseInputPairs, Gn as createSignals, Hn as gitRulesOf, K as resolveInputs, Kn as endOf, L as openStore, Lr as runDirOf, Pr as placeFiles, Qt as inspectProject, R as storePath, Si as readyDriver, St as walkSummary, Ti as AGENT_DRIVERS, Tt as userMessageText, U as createReplay, Un as loadProject, W as replayLoopAnswers, Wn as machineRulesOf, _n as takeFollowUps, _t as planNodeSession, an as sessionDriver, at as adoptedCalls, ct as DETACHED_ENV, di as isClaudeNode, dr as parseTemplate, dt as NOT_STARTED, et as createRelay, fn as createFollowUps, fr as renderTemplate, hi as retiredDriverHint, hr as socketPath, it as createCalls, lt as detachRun, m as resolveBase, mr as serveRun, n as resumedOptions, nr as runGh, or as createFeedback, pn as checkFollowUpsDue, t as createWorkspace, vn as deliverFollowUp, vr as maskReplacer } from "./src-DLsFsmOD.mjs";
+import { c as callsShown, d as createDecisionQueue, l as createTerminalHuman, o as formatEvent, s as formatRunEvent, t as attachRun } from "./attach-RQx__RzH.mjs";
+import { h as nodeSession, n as ORK_VERSION, v as findFollowUp } from "./__build_info__-C1Nm0hlJ.mjs";
+import { n as newRunId } from "./find-k489laBa.mjs";
 import { c as write, i as detachHint, l as writeErr, s as style } from "./output-B1kwo0YU.mjs";
-import { _ as namedMcpEntries, a as builtinExecutors, d as maskedEnv, f as maskedNamesOfRun, g as clearOutputFiles, h as sessionEnv, i as onPath, l as clearStateFiles, m as runScrubber, n as missingProgramMessage, r as missingPrograms, t as envProblems, v as resultOf } from "./src-DcrhgipG.mjs";
-import { i as refusedBuiltin, o as workflowArg } from "./workflows-CW28ZU-z.mjs";
-import { a as formatReport, c as checksHere, d as unfitLines, i as walkLoaded, l as chooseReadyDriver, o as warningLines, s as budgetWarningLines, t as loadWorkflow, u as runReadyDriver } from "./validate-Bs_gg22g.mjs";
+import { _ as clearOutputFiles, a as builtinExecutors, d as maskedEnv, f as maskedNamesOfRun, i as onPath, l as clearStateFiles, m as sessionEnv, n as missingProgramMessage, p as runScrubber, r as missingPrograms, t as envProblems, v as namedMcpEntries, y as resultOf } from "./src-DmmrX2_C.mjs";
+import { i as refusedBuiltin, o as workflowArg } from "./workflows-Djo1edlK.mjs";
+import { a as formatReport, c as checksHere, d as runReadyDriver, f as unfitLines, i as walkLoaded, l as chooseReadyDriver, o as warningLines, s as budgetWarningLines, t as loadWorkflow, u as overrideRefusal } from "./validate-BS0nCccW.mjs";
 import { a as createView, o as styler } from "./verdict-CMvPCpWC.mjs";
-import { i as runLimits, r as limitsRefusal, t as chatNotice } from "./limits-B1qzS4cX.mjs";
+import { i as runLimits, r as limitsRefusal, t as chatNotice } from "./limits-CHqBO7wb.mjs";
 import path from "node:path";
 import { appendFileSync, existsSync, linkSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { createHash, randomUUID } from "node:crypto";
@@ -478,9 +478,17 @@ const followUpSink = (options) => (input, at) => {
 		...options.gh === void 0 ? {} : { gh: options.gh }
 	});
 };
+/** Gh's own words when it has no login. */
+const SIGNED_OUT = /not logged in|gh auth login/iu;
+/**
+* A gh error's first line, without a trailing period, so the notice is one
+* line.
+*/
+const oneLine = (error) => (error.trim().split("\n")[0] ?? "").trim().replace(/\.$/u, "");
 /**
 * Moves the project's follow-ups whose time has come to due, as every `ork
-* follow-ups` call does first. `gh` failing only warns, through `warn`.
+* follow-ups` call does first. `gh` failing only warns, through `warn`: one
+* line per call, however many refs failed.
 */
 const refreshDue = async (store, project, warn, gh = runGh) => {
 	try {
@@ -489,7 +497,8 @@ const refreshDue = async (store, project, warn, gh = runGh) => {
 			project,
 			gh
 		});
-		for (const error of checked.errors) warn(`couldn't check a ref: ${error}`);
+		const [first] = checked.errors;
+		if (first !== void 0) warn(checked.errors.some((error) => SIGNED_OUT.test(error)) ? "Can't check PRs: `gh` isn't signed in. After-merge follow-ups stay waiting; run `gh auth login` yourself." : `Can't check PRs: ${oneLine(first)}. After-merge follow-ups stay waiting.`);
 		return checked.due;
 	} catch (error) {
 		warn(`couldn't check what is due: ${error instanceof Error ? error.message : String(error)}`);
@@ -610,6 +619,10 @@ const runNode = async (options) => {
 		named: plan.driver,
 		pinned: plan.pinned
 	});
+	if (options.driver !== void 0 && named === options.driver) {
+		const refusal = await overrideRefusal(options.driver, options.driverChecks);
+		if (refusal.length > 0) return failed(refusal);
+	}
 	const ready = named === void 0 ? chooseReadyDriver([options.nodeId], true, await (options.driverChecks ?? checksHere)()) : null;
 	if (ready?.ok === false) return failed(ready.lines);
 	if (ready?.line !== void 0) options.err(ready.line);
@@ -1149,7 +1162,8 @@ const runWorkflowFile = async (options) => {
 	const executorOptions = {
 		runtimeFor: (driver) => options.runtime(driver, placeFiles(place).runs),
 		inPlace: options.inPlace,
-		maskedNames
+		maskedNames,
+		store: storePath(options.home)
 	};
 	if (options.driver !== void 0) executorOptions.driver = options.driver;
 	if (ready.readyDriver !== void 0) executorOptions.readyDriver = ready.readyDriver;
@@ -1238,7 +1252,7 @@ const isDriver = (value) => AGENT_DRIVERS.some((d) => d.id === value);
 /** Why `--driver` refuses a value: a retired id names its replacement. */
 const badDriver = (value) => `--${retiredDriverHint(value) ?? `driver must be one of ${AGENT_DRIVERS.map((d) => d.id).join(", ")}, got \`${value}\``}`;
 /** Loads the drivers only when a run starts, so other commands stay fast. */
-const loadRuntime = async (driver, runs) => (await import("./src-B9zWIVqo.mjs")).createRuntime(driver, sessionEnv(process.env), runs);
+const loadRuntime = async (driver, runs) => (await import("./src-BHod38UQ.mjs")).createRuntime(driver, sessionEnv(process.env), runs);
 /**
 * Ctrl-C asks the run to stop, and so does a terminal closing or a polite kill,
 * so that the run ends tidily and leaves no result unscrubbed.
@@ -1289,11 +1303,11 @@ const run = defineCommand({
 		},
 		"follow-ups": {
 			type: "string",
-			description: "Follow-up ids an agent does (repeatable or comma-separated): they become the run's brief, done when it publishes"
+			description: "Follow-up ids an agent does, or `due` for every due one (repeatable or comma-separated): they become the run's brief, done when it publishes"
 		},
 		driver: {
 			type: "string",
-			description: "claude-code (default: the driver ready here)"
+			description: `${DRIVER_IDS.join(", ")} (default: the driver ready here)`
 		},
 		"in-place": {
 			type: "boolean",
@@ -1360,8 +1374,9 @@ const run = defineCommand({
 			process.exitCode = 1;
 			return;
 		}
+		const { prepareFollowUps: prepare, followUpsFlagFine: flagFine } = await import("./brief-Bs3cMQU0.mjs");
 		const cwd = process.cwd();
-		if (refusedBuiltin([args.workflow], cwd)) return;
+		if (refusedBuiltin([args.workflow], cwd) || !flagFine(rawArgs)) return;
 		const target = workflowArg(args.workflow, cwd);
 		const store = openStore();
 		if (args.detach) {
@@ -1393,9 +1408,8 @@ const run = defineCommand({
 			}
 			return;
 		}
-		const { prepareFollowUps } = await import("./brief-za0ozN_E.mjs");
-		const taking = prepareFollowUps(store, rawArgs, args["run-id"], target);
-		if (taking === void 0) {
+		const taken = await prepare(store, rawArgs, args["run-id"], target);
+		if (taken === void 0) {
 			store.close();
 			return;
 		}
@@ -1403,7 +1417,7 @@ const run = defineCommand({
 		const common = {
 			file: target.file,
 			cwd,
-			inputs: taking.inputs,
+			...taken,
 			inPlace: args["in-place"],
 			...args["machine-claude"] ? { machineClaude: true } : {},
 			json: args.json,
@@ -1411,7 +1425,6 @@ const run = defineCommand({
 			runtime: loadRuntime,
 			store,
 			...human === void 0 ? {} : { human },
-			...taking.runId === void 0 ? {} : { runId: taking.runId },
 			out: write,
 			err: writeErr,
 			...args.driver === void 0 ? {} : { driver: args.driver }

package/dist/{send-CnNNW-ot.mjs → send-CKth_vgn.mjs}

@@ -1,6 +1,6 @@
-import { U as openStore, at as scriptRefusal, it as TOO_LONG, ot as sendFromScript } from "./src-Dr_fTSu-.mjs";
+import { $ as sendFromScript, L as openStore, Q as scriptRefusal, Z as TOO_LONG } from "./src-DLsFsmOD.mjs";
 import { l as writeErr } from "./output-B1kwo0YU.mjs";
-import { u as inheritedScrubber } from "./src-DcrhgipG.mjs";
+import { u as inheritedScrubber } from "./src-DmmrX2_C.mjs";
 import { defineCommand } from "citty";
 // src/commands/send.ts
 /**

package/dist/{src-B9zWIVqo.mjs → src-BHod38UQ.mjs}

@@ -1,4 +1,4 @@
-import { Bn as outcomeEnd, Et as parseReport, Gn as FEEDBACK_SEVERITIES, Gt as programFound, Hn as END_KINDS, Kn as FEEDBACK_TARGETS, Kt as startAt, Nn as countedTokens, Un as endFor, Wn as FEEDBACK_KINDS, Wt as lowerChild, _i as AGENT_DRIVERS, fr as maskSecrets, ur as MASK } from "./src-Dr_fTSu-.mjs";
+import { $n as FEEDBACK_TARGETS, Bn as countedTokens, It as lowerChild, Lt as programFound, Qn as FEEDBACK_SEVERITIES, Rt as startAt, Ti as AGENT_DRIVERS, Xn as endFor, Yn as END_KINDS, Zn as FEEDBACK_KINDS, _r as MASK, dn as FOLLOW_UP_KINDS, qn as outcomeEnd, vt as parseReport, yr as maskSecrets } from "./src-DLsFsmOD.mjs";
 import { n as holdGuard, r as orphanGuard } from "./orphan-guard-BFKg8VSd.mjs";
 import path from "node:path";
 import { z } from "zod";
@@ -9,13 +9,6 @@ import { createInterface } from "node:readline";
 import { execFile, spawn } from "node:child_process";
 import { setTimeout as setTimeout$1 } from "node:timers/promises";
 import { createServer } from "node:http";
-// ../core/src/follow-ups/types.ts
-const FOLLOW_UP_KINDS = [
-	"change",
-	"message",
-	"task",
-	"check"
-];
 // ../runtime/src/hold.ts
 /**
 * Waits at a tool call while `hold` is held: "go" once it is released within
@@ -456,8 +449,10 @@ const classifyProviderError = (text, status) => {
 *   it can see (a turn cap, an exit code, a provider's error), and the report
 *   the session handed in decides the rest. The runner then writes the end in
 *   the node's numbers, its detail scrubbed with the feedback redactor. A
-*   session the driver could not run ends as `driverFailure` says, and one that
-*   reached its token cap as `tokenCapOutcome` says.
+*   session the driver could not run (or that was stopped, with what it had
+*   spent) ends as `driverFailure` says, one whose process died as
+*   `failureReason` explains, and one that reached its token cap as
+*   `tokenCapOutcome` says.
 */
 /** The end a report gives: done, a reported failure, or none handed in. */
 const reportEnd = (report) => {
@@ -482,9 +477,15 @@ const errorEnd = (text, fallback = "unknown", status) => endFor(classifyProvider
 */
 const settleEnd = (outcome, facts, scrub) => {
 	const end = outcome.report === null ? outcome.end ?? outcomeEnd(outcome) : reportEnd(outcome.report);
+	const { usage } = outcome;
+	const used = {
+		...facts,
+		usedTokens: countedTokens(usage),
+		...usage.costUsd > 0 ? { usedUsd: usage.costUsd } : {}
+	};
 	return {
 		...outcome,
-		end: endFor(end.kind, facts, end.detail, scrub)
+		end: endFor(end.kind, used, end.detail, scrub)
 	};
 };
 /**
@@ -517,6 +518,17 @@ const tokenCapOutcome = ({ budgetTokens }, usage, sessionId) => budgetTokens ===
 	usage,
 	errors: [`Reached the token budget (${String(budgetTokens)})`]
 };
+const REASON_LIMIT = 500;
+/** Noise a Node crash ends stderr with, or a stack frame: never the reason. */
+const isNoise = (line) => /^Node\.js v\d/u.test(line) || /^\s+at /u.test(line);
+/**
+* Why a process ended without a result: the last block of its stderr as one
+* masked, capped line (the reason reaches the terminal, which is not masked).
+*/
+const failureReason = (name, stderr, code) => {
+	const block = stderr.split("\n").filter((line) => !isNoise(line)).join("\n").split(/\n\s*\n/u).map((text) => text.trim().replaceAll(/\s*\n\s*/gu, " ")).findLast((text) => text !== "");
+	return block === void 0 ? `${name} exited with code ${String(code)}` : maskSecrets(block).slice(0, REASON_LIMIT);
+};
 /**
 * The kind of a failure to run the driver: its program missing, else what a
 * provider's words in it say, else a crash.
@@ -527,27 +539,32 @@ const failureKind = (error) => {
 	if (/\bENOENT\b/u.test(text)) return "tool_missing";
 	return classifyProviderError(text)?.kind ?? "driver_crashed";
 };
+const NOTHING_SPENT = {
+	usage: {
+		costUsd: 0,
+		inputTokens: 0,
+		outputTokens: 0,
+		cacheReadTokens: 0,
+		cacheWriteTokens: 0,
+		turns: 0,
+		durationMs: 0
+	},
+	sessionId: ""
+};
 /**
 * A finished event for a session the driver could not run, ended as `kind` with
-* `message` (Ork's words or the tool's, masked) as its detail.
+* `message` (Ork's words or the tool's, masked) as its detail; a stopped one
+* keeps what it had `spent` (its tokens decoded so far, dollars $0).
 */
-const driverFailure = (message, kind, scope) => ({
+const driverFailure = (message, kind, scope, spent = NOTHING_SPENT) => ({
 	type: "session.finished",
 	outcome: {
 		subtype: "error_driver",
 		end: endFor(kind, scope.facts, kind === "interrupted" ? void 0 : message, scope.scrub),
-		sessionId: "",
+		sessionId: spent.sessionId,
 		report: null,
 		text: "",
-		usage: {
-			costUsd: 0,
-			inputTokens: 0,
-			outputTokens: 0,
-			cacheReadTokens: 0,
-			cacheWriteTokens: 0,
-			turns: 0,
-			durationMs: 0
-		},
+		usage: spent.usage,
 		errors: [message]
 	}
 });
@@ -608,7 +625,6 @@ const spawnLeg = (start) => {
 *   Windows the process ends with `ork`, whatever ends `ork` (the orphan
 *   guard).
 */
-const REASON_LIMIT = 500;
 /** Marks a session's start with the driver that runs it. */
 const withDriver = (event, driver) => event.type === "session.started" ? {
 	...event,
@@ -622,10 +638,11 @@ const settled = (outcome, input) => settleEnd(input.reported === void 0 ? outcom
 	...outcome,
 	report: input.reported()
 }, input.scope.facts, input.scope.scrub);
+/** What this leg `used`, with what the legs before it spent. */
+const withCarried = (input, used) => used === void 0 || input.carried === void 0 ? used ?? input.carried : input.adapter.usage.combine(input.carried, used);
 /** The session's end at its token cap, its earlier legs' usage included. */
 const tokenCapEnd = (input, used, sessionId) => {
-	const usage = used === void 0 || input.carried === void 0 ? used : input.adapter.usage.combine(input.carried, used);
-	const capped = tokenCapOutcome(input.scope.facts, usage, sessionId);
+	const capped = tokenCapOutcome(input.scope.facts, used === void 0 ? void 0 : withCarried(input, used), sessionId);
 	return capped === void 0 ? void 0 : {
 		type: "session.finished",
 		outcome: settled(capped, input)
@@ -645,37 +662,36 @@ const legStep = (decoded, input) => {
 	const events = [];
 	let ended;
 	for (const said of decoded.events) {
-		const event = said.type === "session.finished" ? {
+		if (said.type === "session.started" && carried !== void 0) continue;
+		if (said.type !== "session.finished") {
+			events.push(withDriver(said, adapter.driver));
+			continue;
+		}
+		const own = said.outcome.usage;
+		const usage = carried === void 0 ? own : adapter.usage.combine(carried, own);
+		const last = {
 			...said,
-			outcome: settled(said.outcome, input)
-		} : said;
-		if (event.type === "session.started" && carried !== void 0) continue;
-		if (event.type !== "session.finished") events.push(withDriver(event, adapter.driver));
-		else if (deferred) ended = {
+			outcome: settled({
+				...said.outcome,
+				usage
+			}, input)
+		};
+		const { sessionId, end } = last.outcome;
+		if (deferred) ended = {
 			kind: "deferred",
-			sessionId: event.outcome.sessionId,
-			usage: event.outcome.usage,
-			last: event
+			sessionId,
+			usage: own,
+			last
+		};
+		else if (input.withhold() && wentWell(end?.kind)) ended = {
+			kind: "continued",
+			sessionId,
+			usage: own,
+			last
 		};
 		else {
-			const usage = carried === void 0 ? event.outcome.usage : adapter.usage.combine(carried, event.outcome.usage);
-			const last = {
-				...event,
-				outcome: {
-					...event.outcome,
-					usage
-				}
-			};
-			if (input.withhold() && wentWell(event.outcome.end?.kind)) ended = {
-				kind: "continued",
-				sessionId: event.outcome.sessionId,
-				usage: event.outcome.usage,
-				last
-			};
-			else {
-				events.push(last);
-				ended = { kind: "finished" };
-			}
+			events.push(last);
+			ended = { kind: "finished" };
 		}
 	}
 	return ended === void 0 ? { events } : {
@@ -683,16 +699,6 @@ const legStep = (decoded, input) => {
 		ended
 	};
 };
-/** Noise a Node crash ends stderr with, or a stack frame: never the reason. */
-const isNoise = (line) => /^Node\.js v\d/u.test(line) || /^\s+at /u.test(line);
-/**
-* Why a process ended without a result: the last block of its stderr as one
-* masked, capped line (the reason reaches the terminal, which is not masked).
-*/
-const failureReason = (name, stderr, code) => {
-	const block = stderr.split("\n").filter((line) => !isNoise(line)).join("\n").split(/\n\s*\n/u).map((text) => text.trim().replaceAll(/\s*\n\s*/gu, " ")).findLast((text) => text !== "");
-	return block === void 0 ? `${name} exited with code ${String(code)}` : maskSecrets(block).slice(0, REASON_LIMIT);
-};
 /** Runs one process of a session, yielding its events; returns how it ended. */
 const runLeg = async function* (input) {
 	const child = spawnLeg(input);
@@ -728,11 +734,14 @@ const runLeg = async function* (input) {
 	if (input.adapter.command.input === void 0) child.stdin.end();
 	let outcome;
 	let sessionId = "";
+	/** What this leg has used so far, as the last usage step said. */
+	let used;
 	const { decoder } = input;
 	const decode = decoder?.decode ?? input.adapter.decode;
 	try {
 		for await (const line of createInterface({ input: child.stdout })) {
 			const decoded = decode(line);
+			used = decoded.usage ?? used;
 			const { events, ended } = legStep(decoded, input);
 			for (const event of decoded.events) if (event.type === "session.started") sessionId = event.sessionId;
 			yield* events;
@@ -760,11 +769,18 @@ const runLeg = async function* (input) {
 			reason: `could not start ${input.bin}: ${end.message}`,
 			end: failureKind(end)
 		};
-		if (stopped || end.signal !== null) return {
-			kind: "failed",
-			reason: "interrupted",
-			end: "interrupted"
-		};
+		if (stopped || end.signal !== null) {
+			const usage = withCarried(input, used);
+			return {
+				kind: "failed",
+				reason: "interrupted",
+				end: "interrupted",
+				...usage === void 0 ? {} : { spent: {
+					usage,
+					sessionId
+				} }
+			};
+		}
 		const reason = failureReason(input.adapter.command.bin, stderr, end.code);
 		return {
 			kind: "failed",
@@ -850,6 +866,7 @@ const releaseTool = defineTool({
 });
 // ../runtime/src/tools/delegate.ts
 const BRIEF = z.string().min(1).describe("Self-contained: the goal, the files that matter, and what done looks like. The child does not see your conversation.");
+const DESCRIPTION = z.string().exactOptional().describe("A few words naming this task; shown as the child's label.");
 /** What the leader reads back: each report without the usage details. */
 const reportLine = (report) => {
 	const { usage, ...output } = report.output;
@@ -875,7 +892,8 @@ const delegateTool = defineTool({
 		const ids = ports.ownership?.children.map((child) => child.id) ?? [];
 		return { tasks: z.array(z.strictObject({
 			child: z.enum(ids).describe(`The id of a node you own: ${ids.join(", ")}.`),
-			brief: BRIEF
+			brief: BRIEF,
+			description: DESCRIPTION
 		})).min(1) };
 	},
 	available: ({ ports }) => (ports.ownership?.children.length ?? 0) > 0,
@@ -891,7 +909,8 @@ const spawnWorkerTool = defineTool({
 		const ids = ports.ownership?.templates ?? [];
 		return { tasks: z.array(z.strictObject({
 			template: z.enum(ids).describe(`The id of a child worker you own: ${ids.join(", ")}.`),
-			brief: BRIEF
+			brief: BRIEF,
+			description: DESCRIPTION
 		})).min(1) };
 	},
 	available: ({ ports }) => ports.ownership !== void 0 && ports.ownership.templates.length > 0 && ports.ownership.workersLeft() > 0,
@@ -959,7 +978,7 @@ const followUpTool = defineTool({
 			text: z.string().min(1).max(4e3)
 		}).optional().describe("For a message: what the maintainer will send."),
 		steps: z.array(z.strictObject({
-			text: z.string().min(1),
+			text: z.string().trim().min(1),
 			command: z.string().optional().describe("Shown to the maintainer to copy; Ork never runs it.")
 		})).max(20).optional().describe("For a task or check: what to do, in order.")
 	},
@@ -1335,7 +1354,9 @@ const createSessionRuntime = (adapter, options = {}) => ({
 					}
 					const leg = yield* runLeg(legOf(legSpec, spent));
 					if (leg.kind === "failed") {
-						yield driverFailure(leg.reason, leg.end, scope);
+						const { spent: stopped } = leg;
+						if (stopped?.sessionId === "") stopped.sessionId = legSpec.resume ?? "";
+						yield driverFailure(leg.reason, leg.end, scope, stopped);
 						return;
 					}
 					if (leg.kind === "finished") return;
@@ -1612,8 +1633,19 @@ const cacheEnv = (spec) => spec.promptCache === "1h" ? { [PROMPT_CACHE_1H]: "1"
 const strictMcpOf = (spec) => spec.tools.strictMcp === true || spec.machineClaude !== true;
 /** The variables that keep the machine's auto-memory out of a session. */
 const memoryEnv = (spec) => spec.machineClaude === true ? {} : { [NO_AUTO_MEMORY]: "1" };
+/** Claude Code's default timeout for a Bash call, in milliseconds. */
+const BASH_TIMEOUT = "BASH_DEFAULT_TIMEOUT_MS";
+/**
+* Ten minutes, Claude Code's own most for a Bash call. At its default of two, a
+* longer command (a typecheck of the workspace) moves to the background, and
+* the session then polls it with `sleep`, `until` or `Monitor`, which ask.
+*/
+const BASH_TIMEOUT_MS = 6e5;
+/** The variables that let a session's Bash calls run to the end in front. */
+const bashEnv = () => ({ [BASH_TIMEOUT]: String(BASH_TIMEOUT_MS) });
 /** Everything a session adds to its driver's environment. */
 const driverEnv = (spec) => ({
+	...bashEnv(),
 	...cacheEnv(spec),
 	...memoryEnv(spec)
 });