@voltro/cli 0.33.0 → 0.34.0

package/dist/workflowsCmd-D1VTmLMY.js

@@ -0,0 +1,608 @@
+import { n as e } from "./cliOutput-D1tSBoRM.js";
+import { n as t, o as n, r, t as i } from "./inspectFetch-Cm8_wVvp.js";
+import { ansi as a } from "@voltro/logger";
+//#region src/workflowsCmd.ts
+var o = [
+	"retry",
+	"cancel",
+	"suspend",
+	"resume",
+	"discard",
+	"redrive"
+], s = () => {
+	console.log("voltro workflows — inspect + operate workflow runs on every running api"), console.log(""), console.log("Usage:"), console.log("  voltro workflows list [--status S | --statuses a,b | --dead-letter] [--tag T] [--q TEXT] [--source S] [--id-prefix P] [--since ISO] [--until ISO] [--tail N] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows stats [--tag T] [--hours N] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows start <workflowName> [--payload <json>] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows show <runId> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows retry|cancel|suspend|resume|discard|redrive <runId> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows signal <runId> --name <signalName> [--payload <json>] [--process NAME]"), console.log("  voltro workflows update <runId> --name <updateName> [--payload <json>] [--timeout-ms N] [--process NAME]"), console.log("  voltro workflows resume-from-step <runId> <stepName> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows children <parentExecutionId> [--process NAME] [--format pretty|json]"), console.log("  voltro workflows flow [--workflow NAME] [--limit N] [--process NAME] [--format pretty|json]"), console.log("  voltro workflows pause|unpause <workflowName> [--reason TEXT] [--process NAME]"), console.log("  voltro workflows cancel-many --reason TEXT [--workflow N] [--status S] [--started-before ISO] [--limit N] [--commit]"), console.log("  voltro workflows replay-many --mode redrive|retry [--workflow N] [--status S] [--limit N] [--commit]"), console.log("  voltro workflows inferences [--limit N] [--process NAME] [--format pretty|json]"), console.log(""), console.log("Examples:"), console.log("  voltro workflows list --status running --tail 50"), console.log("  voltro workflows list --statuses failed,cancelled --q orders --since 2026-08-01T00:00:00Z"), console.log("  voltro workflows list --id-prefix wfrun_01K   # paste either kind of id from a log line"), console.log("  voltro workflows stats --hours 24             # the dashboard chart, in the terminal"), console.log("  voltro workflows list --dead-letter          # failed runs not yet discarded"), console.log("  voltro workflows discard wf_01H...           # acknowledge a failed run"), console.log("  voltro workflows redrive wf_01H...           # re-drive a failed run from where it died"), console.log("  voltro workflows resume-from-step wf_01H... charge-card  # rewind to a step and re-run from there"), console.log("  voltro workflows start notes.summarise --payload '{\"noteId\":\"n_1\"}'"), console.log("  voltro workflows show wf_01H..."), console.log("  voltro workflows signal wf_01H... --name approve --payload '{\"by\":\"alice\"}'"), console.log("  voltro workflows update wf_01H... --name approve --payload '{\"decision\":true}'"), console.log("  voltro workflows flow                        # what is queued, what was admitted or dropped, and why"), console.log("  voltro workflows pause tourNarration --reason \"deploying a fix\"   # starts COLLECT; nothing is discarded"), console.log("  voltro workflows unpause tourNarration       # drains the backlog"), console.log("  voltro workflows cancel-many --workflow tourNarration --reason \"bad deploy\"   # DRY RUN — shows what would stop"), console.log("  voltro workflows cancel-many --workflow tourNarration --reason \"bad deploy\" --commit"), console.log("  voltro workflows replay-many --status failed --mode redrive --limit 200 --commit"), console.log("  voltro workflows inferences                  # offloaded model calls in flight, and the dispatcher");
+}, c, l = async (e) => {
+	let t = await n(e, c);
+	return t.length === 0 ? (console.error(e === void 0 ? "voltro workflows: no live api processes found (start one with `voltro dev`)" : `voltro workflows: no live api named '${e}'`), 1) : t;
+}, u = (t, n) => (e(t, { pretty: !1 }), n), d = async (e, t, n, r) => {
+	let o = {};
+	for (let e = 0; e < t.length; e++) {
+		let n = t[e];
+		if (n === "--payload") {
+			let n = t[++e];
+			if (n === void 0) return console.error("voltro workflows start: --payload expects a JSON value"), 2;
+			try {
+				o = JSON.parse(n);
+			} catch {
+				return console.error(`voltro workflows start: --payload invalid JSON '${n}'`), 2;
+			}
+			continue;
+		}
+		return console.error(`voltro workflows start: unknown flag '${n}'`), 2;
+	}
+	let s = await l(n);
+	if (typeof s == "number") return s;
+	let c = `/_voltro/inspect/workflows/start/${encodeURIComponent(e)}`, d = await Promise.all(s.map((e) => i(e, c, {
+		method: "POST",
+		body: { payload: o }
+	}))), f = d.find((e) => e.kind === "ok");
+	if (r === "json") return f === void 0 ? u({
+		workflowName: e,
+		error: "no api accepted the start",
+		fetchErrors: d.map((e) => e.kind === "err" ? {
+			name: e.name,
+			error: e.error
+		} : {
+			name: e.name,
+			error: ""
+		})
+	}, 1) : u({
+		workflowName: e,
+		process: f.name,
+		run: f.data
+	}, 0);
+	if (f !== void 0) {
+		let t = f.data;
+		return console.log(`${a.green("ok")}  start ${e}  ${String(t.id ?? t.executionId ?? "?")}  ${a.dim(`@${f.name}`)}`), 0;
+	}
+	console.error(`voltro workflows: start ${e} failed on every api`);
+	for (let e of d) e.kind === "err" && console.error(a.dim(`  # ${e.name}: ${e.error}`));
+	return 1;
+}, f = async (e, t, n) => {
+	let r, o, s, c, d, f, p, m, h = !1, g = 20, _ = (e, t) => {
+		if (t === void 0) return console.error(`voltro workflows list: ${e} expects an ISO instant (e.g. 2026-08-01T00:00:00Z)`), 2;
+		let n = new Date(t);
+		return Number.isNaN(n.getTime()) ? (console.error(`voltro workflows list: ${e} could not parse '${t}' as an instant`), 2) : n.toISOString();
+	};
+	for (let t = 0; t < e.length; t++) {
+		let n = e[t];
+		if (n === "--status") {
+			r = e[++t];
+			continue;
+		}
+		if (n === "--statuses") {
+			o = e[++t];
+			continue;
+		}
+		if (n === "--tag") {
+			s = e[++t];
+			continue;
+		}
+		if (n === "--q") {
+			c = e[++t];
+			continue;
+		}
+		if (n === "--source") {
+			d = e[++t];
+			continue;
+		}
+		if (n === "--id-prefix") {
+			f = e[++t];
+			continue;
+		}
+		if (n === "--since") {
+			let n = _("--since", e[++t]);
+			if (typeof n == "number") return n;
+			p = n;
+			continue;
+		}
+		if (n === "--until") {
+			let n = _("--until", e[++t]);
+			if (typeof n == "number") return n;
+			m = n;
+			continue;
+		}
+		if (n === "--dead-letter" || n === "--failed") {
+			h = !0;
+			continue;
+		}
+		if (n === "--tail") {
+			let n = e[++t], r = n === void 0 ? NaN : Number(n);
+			if (!Number.isFinite(r) || r <= 0) return console.error(`voltro workflows list: --tail expects a positive number, got '${n ?? ""}'`), 2;
+			g = Math.floor(r);
+			continue;
+		}
+		return console.error(`voltro workflows list: unknown flag '${n}'`), 2;
+	}
+	let v = await l(t);
+	if (typeof v == "number") return v;
+	let y = new URLSearchParams();
+	h ? y.set("deadLettered", "1") : r === void 0 ? o !== void 0 && y.set("statuses", o) : y.set("status", r), s !== void 0 && y.set("tag", s), c !== void 0 && y.set("q", c), d !== void 0 && y.set("source", d), f !== void 0 && y.set("idPrefix", f), p !== void 0 && y.set("from", p), m !== void 0 && y.set("to", m), y.set("limit", String(g));
+	let b = `/_voltro/inspect/workflows/runs?${y.toString()}`, x = await Promise.all(v.map((e) => i(e, b))), S = [], C = [];
+	for (let e of x) if (e.kind === "ok") {
+		let t = e.data?.runs;
+		Array.isArray(t) && S.push(...t.map((t) => ({
+			...t,
+			process: e.name
+		})));
+	} else C.push({
+		name: e.name,
+		error: e.error
+	});
+	let w = S.slice(0, g);
+	if (n === "json") return u(C.length > 0 ? {
+		runs: w,
+		fetchErrors: C
+	} : { runs: w }, +!!x.every((e) => e.kind === "err"));
+	for (let e of w) {
+		let t = String(e.runId ?? e.id ?? "?"), n = String(e.workflowName ?? e.workflow ?? e.tag ?? "?"), r = String(e.status ?? "?"), i = typeof e.source == "string" && e.source.length > 0 ? `  ${a.dim(String(e.source))}` : "", o = r === "failed" || r === "cancelled" ? a.red(r) : r === "completed" ? a.green(r) : r === "running" ? a.cyan(r) : r, s = e.discardedAt == null ? "" : `  ${a.dim("discarded")}`;
+		console.log(`${t.padEnd(28).slice(0, 28)}  ${o.padEnd(12)}  ${n}${i}${s}  ${a.dim(`@${e.process}`)}`);
+	}
+	w.length === 0 && console.error("voltro workflows: no runs matched.");
+	for (let e of C) console.error(a.dim(`# fetch failed: ${e.name}: ${e.error}`));
+	return +!!x.every((e) => e.kind === "err");
+}, p = async (t, n, r) => {
+	let o = await l(n);
+	if (typeof o == "number") return o;
+	let s = encodeURIComponent(t), c = await Promise.all(o.map(async (e) => {
+		let [t, n] = await Promise.all([i(e, `/_voltro/inspect/workflows/runs/${s}/steps`), i(e, `/_voltro/inspect/workflows/runs/${s}/events`)]);
+		return {
+			name: e.name,
+			steps: t,
+			events: n
+		};
+	})), d = c.find((e) => e.steps.kind === "ok" && Array.isArray(e.steps.data.steps) && (e.steps.data.steps?.length ?? 0) > 0 || e.events.kind === "ok" && Array.isArray(e.events.data.events) && (e.events.data.events?.length ?? 0) > 0) ?? c.find((e) => e.steps.kind === "ok" || e.events.kind === "ok");
+	if (d === void 0) {
+		let e = c.map((e) => ({
+			name: e.name,
+			error: e.steps.kind === "err" ? e.steps.error : "no data"
+		}));
+		return r === "json" ? u({
+			runId: t,
+			steps: [],
+			events: [],
+			fetchErrors: e
+		}, 1) : (console.error(`voltro workflows: no data for run ${t}`), 1);
+	}
+	let f = d.steps.kind === "ok" ? d.steps.data.steps ?? [] : [], p = d.events.kind === "ok" ? d.events.data.events ?? [] : [];
+	return r === "json" ? u({
+		runId: t,
+		process: d.name,
+		steps: f,
+		events: p
+	}, 0) : (console.log(a.bold(`run ${t}  @${d.name}`)), console.log(""), console.log(a.bold("steps:")), e(f), console.log(""), console.log(a.bold("events:")), e(p), 0);
+}, m = async (e, t, n, r) => {
+	let a = await l(n);
+	if (typeof a == "number") return a;
+	let o = `/_voltro/inspect/workflows/runs/${encodeURIComponent(t)}/${e}`;
+	return y(e, t, await Promise.all(a.map((e) => i(e, o, {
+		method: "POST",
+		body: {}
+	}))), r);
+}, h = async (e, t, n, r) => {
+	let a, o;
+	for (let e = 0; e < t.length; e++) {
+		let n = t[e];
+		if (n === "--name" || n === "--signal") {
+			a = t[++e];
+			continue;
+		}
+		if (n === "--payload") {
+			let n = t[++e];
+			if (n === void 0) return console.error("voltro workflows signal: --payload expects a JSON value"), 2;
+			try {
+				o = JSON.parse(n);
+			} catch {
+				return console.error(`voltro workflows signal: --payload invalid JSON '${n}'`), 2;
+			}
+			continue;
+		}
+		return console.error(`voltro workflows signal: unknown flag '${n}'`), 2;
+	}
+	if (a === void 0 || a.length === 0) return console.error("voltro workflows signal: --name <signalName> is required"), 2;
+	let s = await l(n);
+	if (typeof s == "number") return s;
+	let c = `/_voltro/inspect/workflows/runs/${encodeURIComponent(e)}/signal`;
+	return y("signal", e, await Promise.all(s.map((e) => i(e, c, {
+		method: "POST",
+		body: {
+			signalName: a,
+			payload: o
+		}
+	}))), r);
+}, g = async (e, t, n, r) => {
+	let a, o, s;
+	for (let e = 0; e < t.length; e++) {
+		let n = t[e];
+		if (n === "--name" || n === "--update") {
+			a = t[++e];
+			continue;
+		}
+		if (n === "--payload") {
+			let n = t[++e];
+			if (n === void 0) return console.error("voltro workflows update: --payload expects a JSON value"), 2;
+			try {
+				o = JSON.parse(n);
+			} catch {
+				return console.error(`voltro workflows update: --payload invalid JSON '${n}'`), 2;
+			}
+			continue;
+		}
+		if (n === "--timeout-ms") {
+			let n = t[++e], r = n === void 0 ? NaN : Number(n);
+			if (!Number.isFinite(r) || r < 0) return console.error("voltro workflows update: --timeout-ms expects a non-negative number"), 2;
+			s = r;
+			continue;
+		}
+		return console.error(`voltro workflows update: unknown flag '${n}'`), 2;
+	}
+	if (a === void 0 || a.length === 0) return console.error("voltro workflows update: --name <updateName> is required"), 2;
+	let c = await l(n);
+	if (typeof c == "number") return c;
+	let u = `/_voltro/inspect/workflows/runs/${encodeURIComponent(e)}/update`, d = {
+		updateName: a,
+		...o === void 0 ? {} : { payload: o },
+		...s === void 0 ? {} : { timeoutMs: s }
+	};
+	return y("update", e, await Promise.all(c.map((e) => i(e, u, {
+		method: "POST",
+		body: d
+	}))), r);
+}, _ = async (e, t, n, r) => {
+	let a;
+	for (let e = 0; e < t.length; e++) {
+		let n = t[e];
+		if (n === "--step") {
+			a = t[++e];
+			continue;
+		}
+		if (!n.startsWith("--") && a === void 0) {
+			a = n;
+			continue;
+		}
+		return console.error(`voltro workflows resume-from-step: unexpected argument '${n}'`), 2;
+	}
+	if (a === void 0 || a.length === 0) return console.error("voltro workflows resume-from-step: <stepName> is required (the step to rewind to)"), 2;
+	let o = await l(n);
+	if (typeof o == "number") return o;
+	let s = `/_voltro/inspect/workflows/runs/${encodeURIComponent(e)}/resume-from-step`;
+	return y("resume-from-step", e, await Promise.all(o.map((e) => i(e, s, {
+		method: "POST",
+		body: { step: a }
+	}))), r);
+}, v = async (t, n, r) => {
+	let o = await l(n);
+	if (typeof o == "number") return o;
+	let s = `/_voltro/inspect/workflows/children?parentExecutionId=${encodeURIComponent(t)}`, c = await Promise.all(o.map((e) => i(e, s))), d = [], f = [];
+	for (let e of c) if (e.kind === "ok") {
+		let t = e.data?.children;
+		Array.isArray(t) && d.push(...t.map((t) => ({
+			...t,
+			process: e.name
+		})));
+	} else f.push({
+		name: e.name,
+		error: e.error
+	});
+	if (r === "json") return u(f.length > 0 ? {
+		children: d,
+		fetchErrors: f
+	} : { children: d }, +!!c.every((e) => e.kind === "err"));
+	e(d);
+	for (let e of f) console.error(a.dim(`# fetch failed: ${e.name}: ${e.error}`));
+	return +!!c.every((e) => e.kind === "err");
+}, y = (e, t, n, r) => {
+	let i = n.find((e) => e.kind === "ok");
+	if (r === "json") return i === void 0 ? u({
+		action: e,
+		runId: t,
+		error: "no api accepted the action",
+		fetchErrors: n.map((e) => e.kind === "err" ? {
+			name: e.name,
+			error: e.error
+		} : {
+			name: e.name,
+			error: ""
+		})
+	}, 1) : u({
+		action: e,
+		runId: t,
+		process: i.name,
+		result: i.data
+	}, 0);
+	if (i !== void 0) {
+		if (e === "redrive" && i.data !== null && typeof i.data == "object") {
+			let e = i.data;
+			return e.redriven === !1 ? (console.error(`${a.yellow("skipped")}  redrive ${t}  @${i.name}  — ${e.reason ?? "not re-drivable"}`), 1) : (console.log(`${a.green("ok")}  redrive ${t}  @${i.name}  ` + a.dim(`(reset ${e.activitiesReset ?? 0} failed step(s); completed steps replay)`)), 0);
+		}
+		if (e === "resume-from-step" && i.data !== null && typeof i.data == "object") {
+			let e = i.data;
+			return e.redriven === !1 ? (console.error(`${a.yellow("skipped")}  resume-from-step ${t}  @${i.name}  — ${e.reason ?? "not re-drivable"}`), 1) : (console.log(`${a.green("ok")}  resume-from-step ${t} → '${e.stepName ?? "?"}'  @${i.name}  ` + a.dim(`(reset ${e.activitiesReset ?? 0} step(s) from '${e.stepName ?? "?"}'; earlier steps replay)`)), 0);
+		}
+		return console.log(`${a.green("ok")}  ${e} ${t}  @${i.name}`), 0;
+	}
+	console.error(`voltro workflows: ${e} ${t} failed on every api`);
+	for (let e of n) e.kind === "err" && console.error(a.dim(`  # ${e.name}: ${e.error}`));
+	return 1;
+}, b = async (e) => {
+	let [n, ...i] = e;
+	if (n === void 0 || n === "--help" || n === "-h" || n === "help") return s(), 0;
+	let a = t(i);
+	if ("error" in a) return console.error(`voltro workflows: ${a.error}`), 2;
+	let { process: l, target: u, rest: y } = r(a.rest);
+	c = u;
+	let b = a.format;
+	if (n === "list") return f(y, l, b);
+	if (n === "stats") return w(y, l, b);
+	if (n === "flow") return T(y, l, b);
+	if (n === "inferences") return O(y, l, b);
+	if (n === "pause" || n === "unpause") {
+		let e = y[0];
+		return e === void 0 ? (console.error(`voltro workflows ${n}: <workflowName> is required`), 2) : E(n === "pause" ? "pause" : "resume", e, y.slice(1), l, b);
+	}
+	if (n === "cancel-many" || n === "replay-many") return D(n === "cancel-many" ? "cancel" : "replay", y, l, b);
+	if (n === "start") {
+		let e = y[0];
+		return e === void 0 ? (console.error("voltro workflows start: <workflowName> is required"), 2) : d(e, y.slice(1), l, b);
+	}
+	if (n === "show") {
+		let e = y[0];
+		return e === void 0 ? (console.error("voltro workflows show: <runId> is required"), 2) : p(e, l, b);
+	}
+	if (n === "children") {
+		let e = y[0];
+		return e === void 0 ? (console.error("voltro workflows children: <parentExecutionId> is required"), 2) : v(e, l, b);
+	}
+	if (n === "signal") {
+		let e = y[0];
+		return e === void 0 ? (console.error("voltro workflows signal: <runId> is required"), 2) : h(e, y.slice(1), l, b);
+	}
+	if (n === "update") {
+		let e = y[0];
+		return e === void 0 ? (console.error("voltro workflows update: <runId> is required"), 2) : g(e, y.slice(1), l, b);
+	}
+	if (n === "resume-from-step") {
+		let e = y[0];
+		return e === void 0 ? (console.error("voltro workflows resume-from-step: <runId> is required"), 2) : _(e, y.slice(1), l, b);
+	}
+	if (o.includes(n)) {
+		let e = y[0];
+		return e === void 0 ? (console.error(`voltro workflows ${n}: <runId> is required`), 2) : m(n, e, l, b);
+	}
+	return console.error(`voltro workflows: unknown subcommand '${n}'`), s(), 2;
+}, x = (e) => {
+	let t = e.split("\0");
+	return t.length === 3 && t[0] === "pool" ? t[2] === "" ? `pool:${t[1]}` : `pool:${t[1]}/${t[2]}` : e;
+}, S = [
+	"·",
+	"▁",
+	"▂",
+	"▃",
+	"▄",
+	"▅",
+	"▆",
+	"▇",
+	"█"
+], C = (e) => {
+	let t = e.reduce((e, t) => Math.max(e, t), 0);
+	return t === 0 ? S[0].repeat(e.length) : e.map((e) => e === 0 ? S[0] : S[Math.max(1, Math.ceil(e / t * 8))]).join("");
+}, w = async (e, t, n) => {
+	let r, o;
+	for (let t = 0; t < e.length; t++) {
+		let n = e[t];
+		if (n === "--tag" || n === "--workflow") {
+			r = e[++t];
+			continue;
+		}
+		if (n === "--hours") {
+			let n = Number(e[++t]);
+			if (!Number.isFinite(n) || n <= 0) return console.error("voltro workflows stats: --hours expects a positive number"), 2;
+			o = Math.floor(n);
+			continue;
+		}
+		return console.error(`voltro workflows stats: unknown flag '${n}'`), 2;
+	}
+	let s = await l(t);
+	if (typeof s == "number") return s;
+	let c = new URLSearchParams();
+	r !== void 0 && c.set("tag", r), o !== void 0 && c.set("hours", String(o));
+	let d = c.toString(), f = await Promise.all(s.map((e) => i(e, `/_voltro/inspect/workflows/stats${d === "" ? "" : `?${d}`}`))), p = f.filter((e) => e.kind === "ok"), m = f.flatMap((e) => e.kind === "err" ? [{
+		name: e.name,
+		error: e.error
+	}] : []);
+	if (n === "json") return u({
+		stats: p.map((e) => ({
+			process: e.name,
+			...e.data
+		})),
+		...m.length > 0 ? { fetchErrors: m } : {}
+	}, +!!f.every((e) => e.kind === "err"));
+	if (p.length === 0) {
+		console.error("voltro workflows stats: no api answered");
+		for (let e of m) console.error(a.dim(`  # ${e.name}: ${e.error}`));
+		return 1;
+	}
+	for (let e of p) {
+		let t = e.data, n = t.buckets ?? [], i = `${a.bold(e.name)}  last ${t.windowHours ?? "?"}h · ${t.bucketMinutes ?? "?"}min/bucket · ${t.total ?? 0} started${r === void 0 ? "" : `  ${a.dim(r)}`}`;
+		if (console.log(i), t.truncated === !0 && console.log(a.yellow("  ! window exceeded the scan cap — oldest buckets under-count")), n.length === 0 || n.every((e) => e.started === 0)) {
+			console.log(a.dim("  no runs in this window"));
+			continue;
+		}
+		console.log(`  started ${C(n.map((e) => e.started))}`), console.log(`  failed  ${C(n.map((e) => e.failed))}`);
+		for (let e of (t.byTag ?? []).slice(0, 10)) {
+			let t = e.failed > 0 ? a.red(`${e.failed} failed`) : a.dim("0 failed");
+			console.log(`  ${e.tag.padEnd(32)} ${String(e.started).padStart(6)} started  ${a.green(`${e.succeeded} ok`)}  ${t}`);
+		}
+	}
+	for (let e of m) console.error(a.dim(`  # ${e.name}: ${e.error}`));
+	return 0;
+}, T = async (e, t, n) => {
+	let r = 50, o;
+	for (let t = 0; t < e.length; t++) {
+		let n = e[t];
+		if (n === "--limit") {
+			let n = Number(e[++t]);
+			if (!Number.isFinite(n) || n <= 0) return console.error("voltro workflows flow: --limit expects a positive number"), 2;
+			r = Math.floor(n);
+			continue;
+		}
+		if (n === "--workflow") {
+			o = e[++t];
+			continue;
+		}
+	}
+	let s = await l(t);
+	if (typeof s == "number") return s;
+	let c = await Promise.all(s.map((e) => i(e, `/_voltro/inspect/workflows/flow-control?limit=${r}`))), d = c.filter((e) => e.kind === "ok"), f = c.flatMap((e) => e.kind === "err" ? [{
+		name: e.name,
+		error: e.error
+	}] : []), p = d.map((e) => e.data), m = (e) => o === void 0 ? e : e.filter((e) => e.workflowName === o), h = m(p.flatMap((e) => e.workflows ?? [])), g = m(p.flatMap((e) => e.intents ?? [])), _ = m(p.flatMap((e) => e.admissions ?? [])), v = p.some((e) => e.active === !0);
+	if (n === "json") return u({
+		workflows: h,
+		intents: g,
+		admissions: _,
+		active: v,
+		...f.length > 0 ? { fetchErrors: f } : {}
+	}, +!!c.every((e) => e.kind === "err"));
+	if (!v) {
+		console.log(a.dim("no workflows are registered in this deployment — flow control is not wired"));
+		for (let e of f) console.error(a.dim(`# fetch failed: ${e.name}: ${e.error}`));
+		return +!!c.every((e) => e.kind === "err");
+	}
+	console.log(a.bold("workflows")), h.length === 0 && console.log(a.dim("  (none declare a flow control, and none are paused)"));
+	for (let e of h) {
+		let t = e.paused ? a.yellow("PAUSED") : a.dim("running"), n = e.controls.length === 0 ? a.dim("—") : e.controls.join(" ");
+		console.log(`  ${e.workflowName.padEnd(28)} ${t}  pending=${e.pending}  inFlight=${e.inFlight}  ${n}`);
+	}
+	console.log(`\n${a.bold("queued")}`), g.length === 0 && console.log(a.dim("  (nothing waiting)"));
+	for (let e of g) {
+		let t = `${Math.round(e.pendingAgeMs / 1e3)}s`, n = e.overdue ? a.yellow(" OVERDUE") : "", r = e.attempts > 0 ? a.red(` attempts=${e.attempts}`) : "";
+		console.log(`  ${e.workflowName}/${x(e.controlKey) || "·"}  ${e.mode}  collapsed=${e.collapsed}  waiting=${t}${n}${r}`), e.lastError !== null && console.log(a.dim(`      last error: ${e.lastError}`));
+	}
+	console.log(`\n${a.bold("recent admissions")}`), _.length === 0 && console.log(a.dim("  (none)"));
+	for (let e of _.slice(0, 20)) {
+		let t = e.outcome === "admitted" ? a.dim : e.outcome === "dropped" ? a.red : a.yellow, n = e.waitedMs === null ? "" : ` waited=${Math.round(e.waitedMs / 1e3)}s`, r = e.holding ? a.dim(" [holding]") : "";
+		console.log(`  ${t(e.outcome.padEnd(9))} ${e.workflowName}  collapsed=${e.collapsed}${n}${r}`), e.reason !== null && console.log(a.dim(`      ${e.reason}`));
+	}
+	for (let e of f) console.error(a.dim(`# fetch failed: ${e.name}: ${e.error}`));
+	return +!!c.every((e) => e.kind === "err");
+}, E = async (e, t, n, r, o) => {
+	let s;
+	for (let e = 0; e < n.length; e++) n[e] === "--reason" && (s = n[++e]);
+	let c = await l(r);
+	if (typeof c == "number") return c;
+	let d = await Promise.all(c.map((n) => i(n, `/_voltro/inspect/workflows/flow-control/${e}`, {
+		method: "POST",
+		body: {
+			workflow: t,
+			...s === void 0 ? {} : { reason: s }
+		}
+	}))), f = d.filter((e) => e.kind === "ok");
+	if (o === "json") return u({
+		action: e,
+		workflow: t,
+		processes: f.map((e) => e.name)
+	}, +(f.length === 0));
+	if (f.length === 0) {
+		console.error(a.red(`no api accepted ${e} for '${t}'`));
+		for (let e of d) e.kind === "err" && console.error(a.dim(`  ${e.name}: ${e.error}`));
+		return 1;
+	}
+	return console.log(`${a.green("ok")}  ${e} ${t}  @${f.map((e) => e.name).join(", ")}`), e === "pause" && console.log(a.dim("    starts COLLECT while paused — nothing is discarded. `voltro workflows resume` drains the backlog.")), console.log(a.dim("    other replicas pick this up on their next drain tick (~1s).")), 0;
+}, D = async (e, t, n, r) => {
+	let o, s, c, d, f, p, m = 100, h = !1;
+	for (let n = 0; n < t.length; n++) {
+		let r = t[n];
+		if (r === "--workflow") o = t[++n];
+		else if (r === "--status") s = t[++n];
+		else if (r === "--reason") c = t[++n];
+		else if (r === "--mode") d = t[++n];
+		else if (r === "--started-after") f = t[++n];
+		else if (r === "--started-before") p = t[++n];
+		else if (r === "--limit") m = Number(t[++n]);
+		else if (r === "--commit") h = !0;
+		else if (r !== void 0 && r.startsWith("--")) return console.error(`voltro workflows ${e}-many: unknown flag '${r}'`), 2;
+	}
+	if (!Number.isInteger(m) || m <= 0) return console.error(`voltro workflows ${e}-many: --limit must be a positive integer`), 2;
+	if (e === "cancel" && (c === void 0 || c.trim().length === 0)) return console.error("voltro workflows cancel-many: --reason is required. It is recorded on every affected run, so \"why did these stop\" is answerable from the run's own event log later."), 2;
+	if (e === "replay" && d !== "retry" && d !== "redrive") return console.error("voltro workflows replay-many: --mode is required and must be 'redrive' (resume each run from the step it died on, replaying completed steps from the journal) or 'retry' (a fresh execution with an empty journal). They cost very different amounts."), 2;
+	let g = await l(n);
+	if (typeof g == "number") return g;
+	let _ = {
+		op: e,
+		limit: m,
+		dryRun: !h,
+		...c === void 0 ? {} : { reason: c },
+		...d === void 0 ? {} : { mode: d },
+		...o === void 0 ? {} : { workflow: o },
+		...s === void 0 ? {} : { status: s },
+		...f === void 0 ? {} : { startedAfter: f },
+		...p === void 0 ? {} : { startedBefore: p }
+	}, v = await Promise.all(g.map((e) => i(e, "/_voltro/inspect/workflows/flow-control/bulk", {
+		method: "POST",
+		body: _
+	}))), y = v.filter((e) => e.kind === "ok");
+	if (r === "json") return u({
+		op: e,
+		dryRun: !h,
+		processes: y.map((e) => ({
+			name: e.name,
+			result: e.data
+		}))
+	}, +(y.length === 0));
+	if (y.length === 0) {
+		console.error(a.red(`no api accepted the bulk ${e}`));
+		for (let e of v) e.kind === "err" && console.error(a.dim(`  ${e.name}: ${e.error}`));
+		return 1;
+	}
+	for (let t of y) {
+		let n = t.data, r = h ? a.green("applied") : a.dim("DRY RUN");
+		if (console.log(`${r}  ${e}${d === void 0 ? "" : `:${d}`}  @${t.name}`), console.log(`  matched=${n.matched ?? 0}  eligible=${n.eligible?.length ?? 0}  skipped=${n.skipped?.length ?? 0}`), h) {
+			console.log(`  succeeded=${n.succeeded?.length ?? 0}  failed=${n.failed?.length ?? 0}`);
+			for (let e of (n.failed ?? []).slice(0, 10)) console.log(a.red(`    ${e.runId}: ${e.reason}`));
+		}
+		n.truncated === !0 && console.log(a.yellow(`  more matched than the --limit of ${m} — run it again for the rest`));
+		let i = n.skipped?.[0];
+		i !== void 0 && console.log(a.dim(`    skipped (${i.status}): ${i.why}`));
+	}
+	h || console.log(a.dim("  nothing was changed — re-run with --commit to apply"));
+	for (let e of v) e.kind === "err" && console.error(a.dim(`# fetch failed: ${e.name}: ${e.error}`));
+	return 0;
+}, O = async (e, t, n) => {
+	let r = 100;
+	for (let t = 0; t < e.length; t++) if (e[t] === "--limit") r = Number(e[++t]);
+	else if (e[t]?.startsWith("--")) return console.error(`voltro workflows inferences: unknown flag '${e[t]}'`), 2;
+	let o = await l(t);
+	if (typeof o == "number") return o;
+	let s = await Promise.all(o.map((e) => i(e, `/_voltro/inspect/workflows/flow-control/inferences?limit=${r}`))), c = s.filter((e) => e.kind === "ok");
+	if (n === "json") return u({ processes: c.map((e) => ({
+		name: e.name,
+		data: e.data
+	})) }, +(c.length === 0));
+	if (c.length === 0) {
+		console.error(a.red("no api answered the inference-queue read"));
+		for (let e of s) e.kind === "err" && console.error(a.dim(`  ${e.name}: ${e.error}`));
+		return 1;
+	}
+	for (let e of c) {
+		let t = e.data;
+		if (console.log(a.dim(`# ${e.name}`)), t.active === !1) {
+			console.log(a.dim("  this app registers no workflows — nothing can enqueue an offloaded call"));
+			continue;
+		}
+		let n = t.counts ?? {
+			pending: 0,
+			running: 0,
+			failed: 0
+		};
+		console.log(`  queued=${n.pending}  in-flight=${n.running}  failed=${n.failed}`), t.dispatcher ?? console.log(a.yellow("  no dispatcher has reported yet — a queue that never drains and a dispatcher that is not running look identical from the counts"));
+		for (let e of (t.queued ?? []).slice(0, 20)) {
+			let t = e.waitingMs < 6e4 ? `${Math.round(e.waitingMs / 1e3)}s` : `${Math.round(e.waitingMs / 6e4)}m`, n = e.leaseExpired ? a.red(" lease-expired") : "", r = e.attempts > 0 ? a.yellow(` attempts=${e.attempts}`) : "";
+			console.log(`  ${e.status.padEnd(9)} ${e.workflowName}·${e.stepName}  ${e.model}  waiting=${t}${r}${n}`), e.errorMessage && console.log(a.dim(`      ${e.errorMessage}`));
+		}
+	}
+	for (let e of s) e.kind === "err" && console.error(a.dim(`# fetch failed: ${e.name}: ${e.error}`));
+	return 0;
+};
+//#endregion
+export { b as runWorkflowsCommand };