@krapht/ork 1.0.0-alpha.11 → 1.0.0-alpha.12

package/dist/{src-D6_xjm-x.mjs → src-CdDTQLdQ.mjs}

@@ -544,13 +544,14 @@ const DriverSchema = z.enum(DRIVER_IDS, { error: (issue) => retiredDriverHint(is
 /** `opus`, `sonnet`, `haiku`, or a full model id such as `claude-opus-5-5`. */
 const ModelSchema = z.string().min(1);
 /** How hard the model thinks; Claude Code's own default when unset. */
-const EffortSchema = z.enum([
+const EFFORTS = [
 	"low",
 	"medium",
 	"high",
 	"xhigh",
 	"max"
-]).describe("Reasoning effort. Default: Claude Code's for the model.");
+];
+const EffortSchema = z.enum(EFFORTS).describe("Reasoning effort. Default: Claude Code's for the model.");
 const IsolationSchema = z.enum([
 	"worktree",
 	"continue",
@@ -720,13 +721,20 @@ const TOOL_NODE_SCHEMAS = INTEGRATIONS.map((i) => toolNodeSchema(i));
 const base = nodeBaseFields;
 /** A Claude node's output field that is not a list: a rule or JSON Schema. */
 const NotListSchema = z.unknown().refine((value) => typeof value !== "object" || value === null || !("list" in value), { message: LIST_RULE_HINT });
+const NODE_EFFORT_HINT = "expected low, medium, high, xhigh or max, or {{item.<field>}}";
+/**
+* A Claude node's effort: a level, or on a `forEach` node a template reading
+* its item (`{{item.effort}}`), which the compiler checks and each item
+* renders.
+*/
+const NodeEffortSchema = z.union([EffortSchema, z.string().regex(/\{\{.*\}\}/su, { error: NODE_EFFORT_HINT })], { error: NODE_EFFORT_HINT }).describe("Reasoning effort, or {{item.<field>}} on a forEach node. Default: Claude Code's for the model.");
 /**
 * What an agent brings to the node it fills, and what a plain Claude node sets
 * itself. A node's own value wins over its agent's.
 */
 const agentSettings = {
 	model: ModelSchema.optional(),
-	effort: EffortSchema.optional(),
+	effort: NodeEffortSchema.optional(),
 	driver: DriverSchema.optional(),
 	skills: z.array(z.string()).optional().describe("Node-layer skills (highest precedence)."),
 	context: z.array(z.string()).optional().describe("Node-layer context files."),
@@ -6449,6 +6457,122 @@ const gatherProblems = (id, node) => {
 		return isList(rule) ? [] : [error("output.gather", `\`${field}\` isn't declared as a list (\`{ type: array }\` or \`{ list: … }\`), so its rounds can't be added together`, [...path, index])];
 	});
 };
+// ../core/src/graph/item-settings.ts
+/**
+* @file A fanned node's `model` and `effort` from its item (`{{item.model}}`):
+*   the compiler's checks (only on a `forEach` node, reading only `item`, and
+*   every written item's value), and the rendering each item's session plan
+*   uses, which checks an item from `from:` when it runs.
+*/
+const FIELDS$1 = ["model", "effort"];
+/**
+* The parts of a template that reads something, or `null` for a plain value (or
+* one that does not parse, which the compiler reports).
+*/
+const templateOf$1 = (text) => {
+	const parsed = parseTemplate(text);
+	if (!parsed.ok) return null;
+	return parsed.parts.some((part) => typeof part !== "string") ? parsed.parts : null;
+};
+const isEffort = (text) => EFFORTS.includes(text);
+/** Checks what one item's template rendered to. */
+const checkRendered = (field, template, rendered) => {
+	const text = rendered.trim();
+	if (text === "") return {
+		ok: true,
+		value: void 0
+	};
+	return (field === "effort" ? isEffort(text) : /^[^\s{}"]+$/u.test(text)) ? {
+		ok: true,
+		value: text
+	} : {
+		ok: false,
+		error: `\`${field}: ${template}\` gave \`${text}\`, which is not ${field === "effort" ? `an effort level (${EFFORTS.join(", ")})` : "a model name"}`
+	};
+};
+/**
+* A node's `model` or `effort` for one item: a plain value as written, a
+* template rendered with the item. Without an item, a template renders empty.
+*/
+const itemSetting = (field, value, scope) => {
+	if (value === void 0) return {
+		ok: true,
+		value: void 0
+	};
+	const parts = templateOf$1(value);
+	if (parts === null) return {
+		ok: true,
+		value
+	};
+	return checkRendered(field, value, renderTemplate(parts, scope));
+};
+/** `itemSetting` for `effort`, as an effort level. */
+const itemEffort = (value, scope) => {
+	const given = itemSetting("effort", value, scope);
+	if (!given.ok) return given;
+	if (given.value === void 0) return {
+		ok: true,
+		value: void 0
+	};
+	return isEffort(given.value) ? {
+		ok: true,
+		value: given.value
+	} : {
+		ok: false,
+		error: `\`effort\` is \`${given.value}\``
+	};
+};
+/** A `model` or `effort` template's problems on one node. */
+const checkNodeField = (workflow, says, id, field) => {
+	const node = workflow.nodes[id];
+	const value = node === void 0 ? void 0 : Reflect.get(node, field);
+	if (node === void 0 || typeof value !== "string") return [];
+	const path = [
+		"nodes",
+		id,
+		field
+	];
+	const parsed = parseTemplate(value);
+	if (!parsed.ok) return [error("template.syntax", `${parsed.message} at column ${parsed.offset + 1}`, path)];
+	if (parsed.parts.every((part) => typeof part === "string")) return [];
+	const each = forEachOf$1(node);
+	if (each === void 0) return [error(`${field}.template`, `\`${field}\` may be a template only on a node with \`forEach\`, reading its item, e.g. \`{{item.${field}}}\``, path)];
+	const reads = parsed.parts.flatMap((part) => typeof part === "string" ? [] : collectPaths(part.expr));
+	const outside = reads.filter(([root]) => root !== "item");
+	if (outside.length > 0) return outside.map((segments) => error(`${field}.template`, `\`${describePath(segments)}\`: a \`${field}\` template reads only the item, e.g. \`{{item.${field}}}\``, path));
+	const scope = { fields: itemFieldsOf(node, says) };
+	const fields = reads.flatMap((segments) => checkItemRead(segments, scope, path));
+	if (fields.length > 0 || !("items" in each)) return fields;
+	return each.items.flatMap((item, index) => {
+		const given = checkRendered(field, value, renderTemplate(parsed.parts, {
+			inputs: {},
+			nodes: {},
+			item,
+			index
+		}));
+		return given.ok ? [] : [error(`${field}.item`, `item ${String(index)}: ${given.error}`, [
+			"nodes",
+			id,
+			"forEach",
+			"items",
+			index
+		])];
+	});
+};
+/**
+* `model` and `effort` templates: only on a `forEach` node, reading only
+* `item`, and every written item's value a model name or an effort level.
+* `defaults:` belong to no node, so they take no template.
+*/
+const checkItemSettings = (workflow, edges) => {
+	const says = nodeSays(workflow.nodes, edges);
+	const defaults = FIELDS$1.flatMap((field) => {
+		const value = workflow.defaults?.[field];
+		return value !== void 0 && templateOf$1(value) !== null ? [error(`${field}.template`, `\`defaults.${field}\` applies to every node, so it can't read an item; set the template on the \`forEach\` node`, ["defaults", field])] : [];
+	});
+	const nodes = Object.entries(workflow.nodes).flatMap(([id, node]) => isClaudeNode(node) ? FIELDS$1.flatMap((field) => checkNodeField(workflow, says, id, field)) : []);
+	return [...defaults, ...nodes];
+};
 // ../core/src/graph/script.ts
 /**
 * @file Checks on the programs a workflow declares (RFC-006): a tool node's and
@@ -6514,7 +6638,7 @@ const statusProblems = (id, node) => {
 };
 /** Per-type checks that need the rest of the graph. */
 const checkNodes = (workflow, edges) => {
-	const diagnostics = checkScripts(workflow);
+	const diagnostics = [...checkScripts(workflow), ...checkItemSettings(workflow, edges)];
 	for (const [id, node] of Object.entries(workflow.nodes)) {
 		const path = ["nodes", id];
 		const incoming = edges.filter((e) => e.to === id);
@@ -7090,11 +7214,13 @@ const startAt = (priority, bin, args, env = process.env) => {
 	return [first, [...rest, ...args]];
 };
 /**
-* Lowers a started child's priority for `low`, best effort; what it starts
-* later inherits it.
+* Lowers a started child's priority for `low` where {@link startAt} had no
+* `nice` to start it under (Windows), best effort; what it starts later
+* inherits it. Under `nice` it does nothing: `nice` lowers relative to the
+* priority it finds, so lowering here too could land first and the two add up.
 */
 const lowerChild = (priority, pid) => {
-	if (priority !== "low" || pid === void 0) return;
+	if (priority !== "low" || pid === void 0 || existsSync(NICE)) return;
 	try {
 		setPriority(pid, constants$1.priority.PRIORITY_BELOW_NORMAL);
 	} catch {}
@@ -11481,12 +11607,13 @@ const parseReport = (value) => {
 // ../core/src/run/brief.ts
 /**
 * @file What a Claude node is asked: its brief, rendered against the run's
-*   inputs and outputs, and its `claude.subagent` children as Claude Code
-*   subagents of its session (the SDK's `agents`, the CLI's `--agents`). A
-*   subagent's role (its agent's instructions), `instructions` and `prompt` are
-*   its system prompt, and its `description` says when the session hands it
-*   work with the Agent tool; it runs inside that session, with no process,
-*   worktree or edges of its own.
+*   inputs and outputs, the model and effort it runs on (a fanned node's from
+*   its item), and its `claude.subagent` children as Claude Code subagents of
+*   its session (the SDK's `agents`, the CLI's `--agents`). A subagent's role
+*   (its agent's instructions), `instructions` and `prompt` are its system
+*   prompt, and its `description` says when the session hands it work with the
+*   Agent tool; it runs inside that session, with no process, worktree or edges
+*   of its own.
 */
 /** The tool a session hands a subagent work with. */
 const AGENT_TOOL = "Agent";
@@ -11515,6 +11642,23 @@ const renderBrief = (text, inputs, outputs, before, item) => {
 		warnings
 	};
 };
+/**
+* The model and effort a session asks for: the node's own, rendered with its
+* item on a fanned node (`{{item.model}}`), else the workflow's defaults. An
+* item's value that is no model name or effort level fails it.
+*/
+const modelOf = (node, defaults, run) => {
+	const scope = runScope(run.inputs, run.outputs ?? {}, void 0, run.item);
+	const model = itemSetting("model", node.model, scope);
+	if (!model.ok) return model;
+	const effort = itemEffort(node.effort, scope);
+	if (!effort.ok) return effort;
+	return {
+		ok: true,
+		model: model.value ?? defaults.model,
+		effort: effort.value ?? defaults.effort
+	};
+};
 const rendered = (text, inputs, outputs) => {
 	const brief = renderBrief(text, inputs, outputs);
 	return brief.ok ? brief.text : (text ?? "").trim();
@@ -11691,6 +11835,11 @@ const planNodeSession = (workflow, id, options) => {
 		ok: false,
 		error: `\`${id}\` uses worktree isolation, which a run on its own does not set up; run the whole workflow, or pass \`--in-place\` to run it in this checkout`
 	};
+	const models = modelOf(node, defaults, options);
+	if (!models.ok) return {
+		ok: false,
+		error: models.error
+	};
 	const warnings = [];
 	const brief = renderBrief(node.prompt, options.inputs, options.outputs, options.before, options.item);
 	if (!brief.ok) return {
@@ -11738,10 +11887,8 @@ const planNodeSession = (workflow, id, options) => {
 		spec.agents = agents;
 		spec.tools.only?.push(AGENT_TOOL);
 	}
-	const model = node.model ?? defaults.model;
-	if (model !== void 0) spec.model = model;
-	const effort = node.effort ?? defaults.effort;
-	if (effort !== void 0) spec.effort = effort;
+	if (models.model !== void 0) spec.model = models.model;
+	if (models.effort !== void 0) spec.effort = models.effort;
 	const maxTurns = node.maxTurns ?? defaults.maxTurns;
 	if (maxTurns !== void 0) spec.maxTurns = maxTurns;
 	const budgets = [node.budgetUsd ?? defaults.budgetUsd, options.budgetLeftUsd].filter((b) => b !== void 0);
@@ -12063,18 +12210,16 @@ const followEvents = async (store, runId, onEvent, options) => {
 		seq: options.after ?? 0,
 		finished: false
 	};
-	const done = new AbortController();
 	const emit = (stored) => {
 		if (stored.seq <= seen.seq) return;
 		seen.seq = stored.seq;
 		onEvent(stored);
-		if (stored.event.type === "run.finished") {
-			seen.finished = true;
-			done.abort();
-		}
+		const { type } = stored.event;
+		if (type === "run.finished") seen.finished = true;
+		else if (type === "run.started" || type === "run.resumed") seen.finished = false;
 	};
 	const aborted = () => options.signal?.aborted === true;
-	/** Takes what the store has; true once `run.finished` is among it. */
+	/** Takes what the store has; true once the run's latest go has finished. */
 	const drain = () => {
 		for (const stored of store.events(runId, seen.seq)) emit(stored);
 		return seen.finished;
@@ -12083,7 +12228,11 @@ const followEvents = async (store, runId, onEvent, options) => {
 		if (drain()) return "finished";
 		if (!options.follow) return "stored";
 		if (aborted()) return "aborted";
-		const via = await followSocket(socketPath(runId, options.home), seen.seq, emit, options.signal === void 0 ? done.signal : AbortSignal.any([options.signal, done.signal]));
+		const done = new AbortController();
+		const via = await followSocket(socketPath(runId, options.home), seen.seq, (stored) => {
+			emit(stored);
+			if (seen.finished) done.abort();
+		}, options.signal === void 0 ? done.signal : AbortSignal.any([options.signal, done.signal]));
 		if (seen.finished) return "finished";
 		if (aborted()) return "aborted";
 		if (via === "ended") continue;

package/dist/{src-BnZgZGrf.mjs → src-D1QedD5y.mjs}

@@ -1,4 +1,4 @@
-import { Ar as AGENT_DRIVERS, Bt as lowerChild, En as maskSecrets, Vt as startAt, an as FEEDBACK_SEVERITIES, en as outcomeEnd, ft as parseReport, in as FEEDBACK_KINDS, nn as END_KINDS, on as FEEDBACK_TARGETS, rn as endFor, wn as MASK } from "./src-D6_xjm-x.mjs";
+import { Ar as AGENT_DRIVERS, Bt as lowerChild, En as maskSecrets, Vt as startAt, an as FEEDBACK_SEVERITIES, en as outcomeEnd, ft as parseReport, in as FEEDBACK_KINDS, nn as END_KINDS, on as FEEDBACK_TARGETS, rn as endFor, wn as MASK } from "./src-CdDTQLdQ.mjs";
 import path from "node:path";
 import { z } from "zod";
 import { existsSync, linkSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";

package/dist/{src-B6KvTm7B.mjs → src-S9yK2OHU.mjs}

@@ -1,10 +1,11 @@
-import { $n as skillsIn, $t as endOf, At as nestItems, B as linkNodes, Bn as placeFiles, C as openStore, Ct as runStatus, Dt as processAlive, G as requestContinue, Gn as workflowDirOf, In as loadAgents, J as tellLiveRun, Jn as LESSON_CAP_TOKENS, K as requestPause, Kn as inside, S as isNodeEvent, St as pausedOf, U as unlinkNodes, Un as runDirOf, Ut as nodeSays, Vn as placeFor, X as detachResume, Z as resumable, a as releaseNotes, c as detectInstaller, cn as planPost, er as WorkflowEditSchema, et as detachRun, gt as walkSummary, hr as NodeSchema, ht as walkChecks, i as planUpgrade, it as limitsReport, ln as runGh, mt as checkWorkflowText, nn as END_KINDS, nr as newWorkflowText, o as runningRunIds, or as renderJsonSchema, p as triggersReport, pr as expandEdge, q as requestStop, r as capsHere, rr as readDocument, s as runningScript, sn as DISCUSSIONS, sr as parseWorkflow, st as explainWorkflowText, tr as applyEdits, tt as followEvents, un as sendPost, ur as EdgeInputSchema, w as storePath, x as activeTree, xt as liveStatus, yn as readCondition } from "./src-D6_xjm-x.mjs";
-import { C as feedbackActions, S as placeOf$1, _ as previewPost, a as registryShown, b as acceptItem, c as checkDue, f as readUpdateCache, g as nodeSession, h as writeUpdateCache, i as registryOf, l as fetchLatest, m as updateCachePath, o as updateSwitchOff, p as refreshUpdateCache, s as runInstall, u as newerVersion, w as openFixRun, x as lessonPlaceOf, y as recordNote } from "./__build_info__-CIchF6nr.mjs";
-import { n as pendingDecisions, r as builtinProblem, t as answerDecision } from "./decide-B6PnKeqo.mjs";
-import { n as newRunId, t as findRun } from "./find-BicBbGMg.mjs";
+import { $n as skillsIn, $t as endOf, At as nestItems, B as linkNodes, Bn as placeFiles, C as openStore, Ct as runStatus, Dt as processAlive, G as requestContinue, Gn as workflowDirOf, In as loadAgents, J as tellLiveRun, Jn as LESSON_CAP_TOKENS, K as requestPause, Kn as inside, S as isNodeEvent, St as pausedOf, U as unlinkNodes, Un as runDirOf, Ut as nodeSays, Vn as placeFor, X as detachResume, Z as resumable, a as releaseNotes, c as detectInstaller, cn as planPost, er as WorkflowEditSchema, et as detachRun, gt as walkSummary, hr as NodeSchema, ht as walkChecks, i as planUpgrade, it as limitsReport, ln as runGh, mt as checkWorkflowText, nn as END_KINDS, nr as newWorkflowText, o as runningRunIds, or as renderJsonSchema, p as triggersReport, pr as expandEdge, q as requestStop, r as capsHere, rr as readDocument, s as runningScript, sn as DISCUSSIONS, sr as parseWorkflow, st as explainWorkflowText, tr as applyEdits, tt as followEvents, un as sendPost, ur as EdgeInputSchema, w as storePath, x as activeTree, xt as liveStatus, yn as readCondition } from "./src-CdDTQLdQ.mjs";
+import { C as feedbackActions, S as placeOf$1, _ as previewPost, a as registryShown, b as acceptItem, c as checkDue, f as readUpdateCache, g as nodeSession, h as writeUpdateCache, i as registryOf, l as fetchLatest, m as updateCachePath, o as updateSwitchOff, p as refreshUpdateCache, s as runInstall, u as newerVersion, w as openFixRun, x as lessonPlaceOf, y as recordNote } from "./__build_info__-BJbE3Zvp.mjs";
+import { t as builtinProblem } from "./builtin-files-w0YULJ4c.mjs";
+import { n as pendingDecisions, t as answerDecision } from "./decide-DlbyctOE.mjs";
+import { n as newRunId, t as findRun } from "./find-p05wlbmu.mjs";
 import { n as usageReport } from "./report-CEN8VoUb.mjs";
-import { a as planClean, i as keyOf, o as stepActs, r as cleanStep, s as stepPrunes, t as applyClean } from "./clean-Di-KT7Mf.mjs";
-import { a as readWorktrees, c as mergeStateOf, d as stateParts, i as projectHead, l as planLine, n as lostWork, r as planRemove, s as labelOf, t as applyRemove, u as removeRefusal } from "./remove-CpMb4NDl.mjs";
+import { a as planClean, i as keyOf, o as stepActs, r as cleanStep, s as stepPrunes, t as applyClean } from "./clean-D8GI_2K-.mjs";
+import { a as readWorktrees, c as mergeStateOf, d as stateParts, i as projectHead, l as planLine, n as lostWork, r as planRemove, s as labelOf, t as applyRemove, u as removeRefusal } from "./remove-Dh7D_hVn.mjs";
 import path from "node:path";
 import { z } from "zod";
 import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, renameSync, rmSync, statSync, writeFileSync } from "node:fs";