@voltro/plugin-ai-flows 0.86.0 → 0.88.0

package/dist/cadence.js

@@ -1,4 +1,4 @@
-//#region src/cadence.ts
+// src/cadence.ts
 var e = (e) => (e.getDay() + 6) % 7, t = (e) => Math.ceil(e.getDate() / 7), n = (e) => {
 	let t = new Date(e.getFullYear(), e.getMonth() + 1, 0).getDate();
 	return e.getDate() + 7 > t;
@@ -36,5 +36,4 @@ var e = (e) => (e.getDay() + 6) % 7, t = (e) => Math.ceil(e.getDate() / 7), n =
 	for (; r.length < n && i.getTime() <= s;) a(e, i) && r.push(new Date(i)), i.setMinutes(i.getMinutes() + 15);
 	return r;
 };
-//#endregion
 export { a as cadenceMatches, o as nextRuns };

package/dist/cadenceTick.js

@@ -5,7 +5,7 @@ import { cadenceMatches as r } from "./cadence.js";
 import { recordFlowStartReceipt as i } from "./startReceipt.js";
 import { Schema as a } from "effect";
 import { createHash as o } from "node:crypto";
-//#region src/cadenceTick.ts
+// src/cadenceTick.ts
 var s = (e, t, n) => {
 	if (!Number.isFinite(t.getTime())) throw Error("cadence timestamp must be valid");
 	return `cron-${o("sha256").update(JSON.stringify([
@@ -76,5 +76,4 @@ var s = (e, t, n) => {
 		reconciled: f
 	};
 };
-//#endregion
 export { s as cronRequestId, l as runCadenceTick };

package/dist/condition.js

@@ -1,5 +1,5 @@
 import { Schema as e } from "effect";
-//#region src/condition.ts
+// src/condition.ts
 var t = e.Literals([
 	"truthy",
 	"falsy",
@@ -42,5 +42,4 @@ var t = e.Literals([
 		case "contains": return `{{${e.ref}}} contains ${JSON.stringify(e.value)}`;
 	}
 };
-//#endregion
 export { t as ConditionOp, n as StepCondition, o as describeCondition, a as evaluateCondition, r as isTruthy };

package/dist/defaults.js

@@ -1,4 +1,4 @@
-//#region src/defaults.ts
+// src/defaults.ts
 var e = 168, t = "VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS", n = 2160, r = "VOLTRO_AI_FLOW_RUNS_TTL_HOURS", i = 5, a = "VOLTRO_AI_FLOW_MAX_CHAIN_DEPTH", o = { current: {} }, s = (e) => {
 	o.current = e;
 }, c = () => o.current, l = () => {
@@ -14,5 +14,4 @@ var e = 168, t = "VOLTRO_AI_FLOW_HUMAN_REVIEW_TIMEOUT_HOURS", n = 2160, r = "VOL
 	let t = e?.env ?? process.env, n = Number(t[a]), r = e?.maxChainDepth ?? c().maxChainDepth ?? (Number.isFinite(n) && n >= 1 ? n : 5);
 	return Number.isFinite(r) && r >= 1 ? r : 5;
 };
-//#endregion
 export { r as FLOW_RUNS_TTL_ENV, n as FLOW_RUNS_TTL_HOURS_DEFAULT, t as HUMAN_REVIEW_TIMEOUT_ENV, e as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, i as MAX_CHAIN_DEPTH_DEFAULT, a as MAX_CHAIN_DEPTH_ENV, c as getAiFlowsDefaults, u as msFromHoursEnv, l as resetAiFlowsDefaults, f as resolveHumanReviewTimeoutMs, p as resolveMaxChainDepth, s as setAiFlowsDefaults, d as toTimeoutMs };

package/dist/define.js

@@ -3,7 +3,7 @@ import { normalizeFlow as t, sanitizeOutputKey as n } from "./ir.js";
 import { collectRefs as r } from "./interpolate.js";
 import { flowSegments as i, nonContiguousGroups as a } from "./segments.js";
 import { FlowValidationError as o } from "./errors.js";
-//#region src/define.ts
+// src/define.ts
 var s = {
 	text: (e) => ({
 		type: "generate",
@@ -67,5 +67,4 @@ var s = {
 	});
 	return l(r), e(r), r;
 };
-//#endregion
 export { u as defineFlow, s as flowStep, l as validateFlow };

package/dist/engine.js

@@ -12,10 +12,11 @@ import { decodeMediaResult as x } from "./mediaResult.js";
 import { FlowCapabilityMissing as S, FlowDependencyError as C, FlowNotFound as w } from "./errors.js";
 import { Cause as T, Effect as E, Exit as D, Result as O, Schema as k } from "effect";
 import { and as A, eq as j, queryFor as M } from "@voltro/database";
-import { SuspensionUnavailable as ee, awaitSignalSuspending as te, step as N } from "@voltro/workflow";
-import { defineTool as P, estimateCostUsd as ne, gatewayCostUsd as re, generateObject as ie, generateObjectJson as ae, generateObjectWithTools as oe, generateText as F } from "@voltro/ai";
-//#region src/engine.ts
-var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessage ?? "agent unavailable" : "agent not found", L = k.Struct({
+import { WorkflowEngine as ee } from "effect/workflow";
+import { SuspensionUnavailable as te, awaitSignalSuspending as ne, step as N } from "@voltro/workflow";
+import { defineTool as P, estimateCostUsd as re, gatewayCostUsd as ie, generateObject as ae, generateObjectJson as oe, generateObjectWithTools as se, generateText as F } from "@voltro/ai";
+// src/engine.ts
+var I = (e) => e, ce = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessage ?? "agent unavailable" : "agent not found", L = k.Struct({
 	value: k.optional(k.Unknown),
 	text: k.optional(k.String),
 	url: k.optional(k.String),
@@ -41,10 +42,10 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 	...e.costMicroUsd ? { costMicroUsd: e.costMicroUsd } : {},
 	...e.costSource === void 0 ? {} : { costSource: e.costSource },
 	...e.usage === void 0 ? {} : { usage: e.usage }
-}), B = () => (/* @__PURE__ */ new Date()).toISOString(), ce = (e) => Math.round(e * 1e6), le = (e) => ({
+}), B = () => (/* @__PURE__ */ new Date()).toISOString(), le = (e) => Math.round(e * 1e6), ue = (e) => ({
 	name: "gateway",
 	model: e
-}), V = (e, t) => e.resolveModel?.(t) ?? le(t), H = (e, t, n, r) => E.gen(function* () {
+}), V = (e, t) => e.resolveModel?.(t) ?? ue(t), H = (e, t, n, r) => E.gen(function* () {
 	return t.maxSteps !== void 0 && (!Number.isSafeInteger(t.maxSteps) || t.maxSteps < 1) ? yield* E.fail(new S({
 		capability: "resolveAgent",
 		message: "agent maxSteps must be a positive safe integer"
@@ -57,12 +58,12 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		...t.maxSteps === void 0 ? {} : { maxSteps: t.maxSteps }
 	});
 }), U = (e, t, n) => W(e, t, n).costMicroUsd, W = (e, t, n) => {
-	let r = re(t);
+	let r = ie(t);
 	if (typeof r == "number") return {
-		costMicroUsd: ce(r),
+		costMicroUsd: le(r),
 		costSource: "gateway"
 	};
-	let i = ne(e, { model: n ?? "unknown" });
+	let i = re(e, { model: n ?? "unknown" });
 	return {
 		costMicroUsd: i.costMicroUsd ?? 0,
 		costSource: i.costSource ?? "unpriced"
@@ -75,10 +76,13 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 }, K = (e, n, r) => E.promise(() => e.store.update(t.tableName, n, r).then(() => void 0)).pipe(E.catchCause(() => E.void)), q = (e, n, r, i) => E.promise(async () => {
 	let a = await e.store.query(M(t).where(j("id", n)).descriptor), o = a[0]?.[i];
 	a[0] !== void 0 && o == null && await e.store.update(t.tableName, n, r);
-}).pipe(E.catchCause(() => E.void)), ue = (e, n) => E.promise(async () => {
+}).pipe(E.catchCause(() => E.void)), de = (e, n) => E.promise(async () => {
 	let r = (await e.store.query(M(t).where(j("id", n)).descriptor))[0]?.status;
 	return r === "cancelling" || r === "cancelled";
-}).pipe(E.catchCause(() => E.succeed(!1))), de = (e, n) => E.promise(() => e.store.updateMany(t.tableName, {
+}).pipe(E.catchCause(() => E.succeed(!1))), fe = E.gen(function* () {
+	let e = yield* ee.WorkflowInstance;
+	return e.interrupted = !0, yield* E.interrupt;
+}), pe = (e, n) => E.promise(() => e.store.updateMany(t.tableName, {
 	status: "cancelled",
 	completedAt: B()
 }, { where: A(j("id", n), j("status", "cancelling")) }).then(() => void 0)).pipe(E.catchCause(() => E.void)), J = (t, r) => E.gen(function* () {
@@ -146,7 +150,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		}
 		case "structured": {
 			if (n.schema === void 0) return { error: `step "${n.id}": structured step requires a JSON Schema` };
-			let r = n.model ?? t.defaultModels?.text, i = yield* ae({
+			let r = n.model ?? t.defaultModels?.text, i = yield* oe({
 				...s.success,
 				prompt: e,
 				jsonSchema: n.schema,
@@ -220,7 +224,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		}).message };
 		default: return { error: `unknown step type: ${String(n.type)}` };
 	}
-}), fe = (e, t, n, a, c, u) => E.gen(function* () {
+}), me = (e, t, n, a, c, u) => E.gen(function* () {
 	let d = Object.assign(Object.create(null), c), f = Object.create(null), p = a.steps.map((e, t) => ({
 		id: t,
 		title: e.title ?? `Step ${t + 1}`,
@@ -236,10 +240,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		startedAt: B()
 	}, "startedAt");
 	for (let c of g(a.steps)) {
-		if (yield* ue(e, n)) return yield* de(e, n), {
-			runId: n,
-			status: "cancelled"
-		};
+		if (yield* de(e, n)) return yield* pe(e, n), yield* fe;
 		if (c.steps.length > 1) {
 			let r = [];
 			for (let { index: e, step: t } of c.steps) t.when !== void 0 && !s(t.when, d) ? p[e] = {
@@ -346,7 +347,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 				step: _,
 				flow: a,
 				deps: t
-			}), c = yield* te(e, {
+			}), c = yield* ne(e, {
 				name: r(g),
 				schema: l,
 				timeoutMs: s
@@ -468,7 +469,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		status: "succeeded",
 		output: _
 	};
-}), pe = (e, n, r, i, o, s, c) => E.gen(function* () {
+}), he = (e, n, r, i, o, s, c) => E.gen(function* () {
 	let l = r.chain;
 	if (!l) return;
 	let u = [...s.chainPath ?? [], s.flowRef];
@@ -519,33 +520,33 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 			chainPath: u
 		});
 	}).pipe(E.catchCause(() => E.void));
-}), me = (e) => e.type === "agent" ? e.agentRef ? `agent step, agent "${e.agentRef}"` : "agent step" : e.type === "generate" ? `${e.modality ?? "media"} generation step` : `${e.type} step`, he = (e) => e.steps.length === 0 ? "" : "Suggested plan (you MAY reorder, insert, or skip steps):\n" + e.steps.map((e, t) => `${t + 1}. ${e.title ?? e.id}${e.prompt ? `: ${e.prompt}` : ""} (${me(e)})`).join("\n"), ge = "an agentic flow runs its planner and every tool inside one durable step, which cannot park. Call the provider directly from the tool (generateImage, generateVideo, …), or give the work its own deterministic flow step", X = k.optional(k.String.annotate({ description: "One short sentence: what this call is for. Shown to the user in the run timeline." })), Z = (e) => e === void 0 || e.trim() === "" ? {} : { description: e.trim().slice(0, 200) }, Q = k.Struct({ json: k.String.annotate({ description: "The requested JSON object, serialized as a JSON string." }) }), _e = (e) => {
+}), ge = (e) => e.type === "agent" ? e.agentRef ? `agent step, agent "${e.agentRef}"` : "agent step" : e.type === "generate" ? `${e.modality ?? "media"} generation step` : `${e.type} step`, _e = (e) => e.steps.length === 0 ? "" : "Suggested plan (you MAY reorder, insert, or skip steps):\n" + e.steps.map((e, t) => `${t + 1}. ${e.title ?? e.id}${e.prompt ? `: ${e.prompt}` : ""} (${ge(e)})`).join("\n"), ve = "an agentic flow runs its planner and every tool inside one durable step, which cannot park. Call the provider directly from the tool (generateImage, generateVideo, …), or give the work its own deterministic flow step", X = k.optional(k.String.annotate({ description: "One short sentence: what this call is for. Shown to the user in the run timeline." })), Z = (e) => e === void 0 || e.trim() === "" ? {} : { description: e.trim().slice(0, 200) }, Q = k.Struct({ json: k.String.annotate({ description: "The requested JSON object, serialized as a JSON string." }) }), ye = (e) => {
 	try {
 		let t = JSON.parse(e);
 		return typeof t == "object" && t && !Array.isArray(t) ? t : void 0;
 	} catch {
 		return;
 	}
-}, ve = (e) => {
+}, be = (e) => {
 	if (D.isSuccess(e)) return "the tool returned without recording a result";
 	if (T.hasInterruptsOnly(e.cause)) return "interrupted before it finished — nothing waited for its result";
 	let t = T.squash(e.cause);
 	return t instanceof Error ? t.message : String(t);
-}, ye = (e) => {
+}, xe = (e) => {
 	let t = Object.entries(e);
 	return t.length === 0 ? "Execute the flow." : "Brief for this run:\n" + t.map(([e, t]) => `- ${e}: ${typeof t == "string" ? t : JSON.stringify(t)}`).join("\n");
 }, $ = (e) => [
 	e.orchestrator?.instructions ?? "You are an orchestrator that uses the available tools to produce a bundled result.",
-	he(e),
+	_e(e),
 	"When finished, emit a JSON object mapping each deliverable name (outputKey) to its value, serialized as a string in the json field."
-].filter(Boolean).join("\n\n"), be = k.Struct({
+].filter(Boolean).join("\n\n"), Se = k.Struct({
 	object: k.Record(k.String, k.Unknown),
 	planCostMicroUsd: k.Number,
 	planCostSource: k.optional(c),
 	toolCostMicroUsd: k.Number,
 	steps: k.Array(d),
 	error: k.optional(k.String)
-}), xe = (e, t, n, r, i, a, o, s) => E.gen(function* () {
+}), Ce = (e, t, n, r, i, a, o, s) => E.gen(function* () {
 	yield* q(e, n, {
 		status: "running",
 		startedAt: B(),
@@ -554,7 +555,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 	let c = yield* N({
 		name: "flow-agentic",
 		input: { flowRef: r.name },
-		success: be,
+		success: Se,
 		execute: E.gen(function* () {
 			let c = [], l = 0, u = (e) => {
 				let t = c.length;
@@ -578,7 +579,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 				let n = u(e);
 				return E.andThen(f(), t(n)).pipe(E.onExit((e) => c[n]?.status === "running" ? (d(n, {
 					status: "failed",
-					errorMessage: ve(e)
+					errorMessage: be(e)
 				}), E.ignore(f())) : E.void));
 			}), m = yield* (t.listAgents ? I(t.listAgents({
 				runId: n,
@@ -624,7 +625,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 					if (!s.ok) return d(i, {
 						status: "failed",
 						errorMessage: s.e.message
-					}), yield* f(), `ERROR: ${se(s.e)}`;
+					}), yield* f(), `ERROR: ${ce(s.e)}`;
 					let c = yield* H(t, s.a, r, {}).pipe(E.map((e) => ({
 						ok: !0,
 						r: e
@@ -719,7 +720,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 					type: "structured",
 					...Z(n)
 				}, (n) => E.gen(function* () {
-					let i = yield* ie({
+					let i = yield* ae({
 						prompt: `${e}\n\nReturn the JSON object serialized as a string in the \`json\` field.`,
 						schema: Q,
 						...r ? { provider: V(t, r) } : {}
@@ -739,7 +740,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 					}
 					let a = U(i.r.usage, i.r.providerMetadata, r);
 					l += a;
-					let o = _e(i.r.object.json);
+					let o = ye(i.r.object.json);
 					if (o === void 0) {
 						let e = "the model's `json` field is not a JSON object";
 						return d(n, {
@@ -777,9 +778,9 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 				steps: c,
 				error: "flow tools cannot replace reserved planner tools"
 			};
-			let T = t.memoryPrefix ? yield* I(t.memoryPrefix(a)).pipe(E.catch(() => E.succeed(""))) : "", D = T ? `${T}\n\n${$(r)}` : $(r), A = yield* oe({
+			let T = t.memoryPrefix ? yield* I(t.memoryPrefix(a)).pipe(E.catch(() => E.succeed(""))) : "", D = T ? `${T}\n\n${$(r)}` : $(r), A = yield* se({
 				system: D,
-				prompt: ye(i),
+				prompt: xe(i),
 				schema: Q,
 				tools: {
 					...w.success,
@@ -790,7 +791,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 				},
 				maxSteps: r.maxSteps,
 				...r.orchestrator?.model ? { provider: V(t, r.orchestrator.model) } : {}
-			}).pipe(E.provideService(ee, ge), E.map((e) => ({
+			}).pipe(E.provideService(te, ve), E.map((e) => ({
 				ok: !0,
 				r: e
 			})), E.catch((e) => E.succeed({
@@ -808,7 +809,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 				steps: c,
 				error: String(A.e.message ?? A.e)
 			};
-			let j = _e(A.r.object.json);
+			let j = ye(A.r.object.json);
 			return {
 				object: j ?? {},
 				...j === void 0 ? { error: "the planner's `json` field is not a JSON object" } : {},
@@ -845,7 +846,7 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		status: "succeeded",
 		output: c.object
 	});
-}), Se = (e, n = {}) => (r, i) => E.gen(function* () {
+}), we = (e, n = {}) => (r, i) => E.gen(function* () {
 	let { runId: i, flowRef: a, input: o } = r, s = yield* E.tryPromise(() => e.store.query(M(t).where(j("id", i)).descriptor)).pipe(E.flatMap(k.decodeUnknownEffect(k.Tuple([k.Struct({
 		id: k.Literal(i),
 		tenantId: k.NullOr(k.NonEmptyString),
@@ -889,12 +890,12 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		runId: i,
 		status: "failed"
 	};
-	let d = u.ir, f = d.mode === "agentic" ? yield* xe(e, n, i, d, o, l, c, a) : yield* fe(e, n, i, d, o, {
+	let d = u.ir, f = d.mode === "agentic" ? yield* Ce(e, n, i, d, o, l, c, a) : yield* me(e, n, i, d, o, {
 		ownerId: l,
 		tenantId: c,
 		source: r.source
 	});
-	return f.status === "succeeded" && d.chain && (yield* pe(e, i, d, o, f.output ?? {}, r, n)), n.onEvent && (f.status === "succeeded" || f.status === "failed") && (yield* I(n.onEvent({
+	return f.status === "succeeded" && d.chain && (yield* he(e, i, d, o, f.output ?? {}, r, n)), n.onEvent && (f.status === "succeeded" || f.status === "failed") && (yield* I(n.onEvent({
 		kind: f.status,
 		runId: i,
 		flowName: d.name,
@@ -902,5 +903,4 @@ var I = (e) => e, se = (e) => e._tag === "FlowAgentUnavailable" ? e.publicMessag
 		source: r.source
 	})).pipe(E.catchCause(() => E.void))), f;
 });
-//#endregion
-export { Se as buildFlowRunExecute, J as resolveIr };
+export { we as buildFlowRunExecute, J as resolveIr };

package/dist/errors.js

@@ -1,6 +1,6 @@
 import { MediaReceipt as e } from "./ir.js";
 import { Schema as t } from "effect";
-//#region src/errors.ts
+// src/errors.ts
 var n = class extends t.TaggedError()("FlowNotFound", {
 	flowRef: t.String,
 	message: t.String
@@ -45,5 +45,4 @@ var n = class extends t.TaggedError()("FlowNotFound", {
 	message: t.String,
 	publicMessage: t.optional(t.String)
 }) {};
-//#endregion
 export { u as FlowAgentUnavailable, o as FlowBriefIncomplete, l as FlowCapabilityMissing, a as FlowDependencyError, s as FlowNotAwaitingResponse, n as FlowNotFound, c as FlowReviewDeliveryError, r as FlowRunNotFound, i as FlowValidationError };

package/dist/index.d.ts

@@ -10,8 +10,7 @@ import { Schema } from 'effect';
 import { Table } from '@voltro/database';
 import { TableLike } from '@voltro/database';
 import { VoltroPlugin } from '@voltro/protocol';
-import { WorkflowEngine } from 'effect/workflow/WorkflowEngine';
-import { WorkflowInstance } from 'effect/workflow/WorkflowEngine';
+import { WorkflowEngine } from 'effect/workflow';
 import { WorkflowRunHandle } from '@voltro/protocol';
 import { YieldableError } from 'effect/Cause';
 
@@ -49,7 +48,7 @@ export declare const aiFlowRunsTable: Table<"_voltro_ai_flow_runs", FieldDefinit
     /** Last observed admission answer, not current execution state. Null means
      * no answer was recorded, not that submission did not reach the engine. */
     readonly workflowStart: ColumnBuilder<{
-        readonly status: "dropped" | "skipped" | "running" | "succeeded" | "queued" | "replayed";
+        readonly status: "succeeded" | "dropped" | "skipped" | "running" | "queued" | "replayed";
         readonly id: string;
         readonly executionId: string | null;
         readonly workflowName: string;
@@ -275,17 +274,17 @@ export declare interface BriefField {
  */
 export declare const buildFlowRunExecute: (ctx: AppContext, deps?: EngineDeps) => (payload: FlowRunPayload, _executionId: string) => Effect.Effect<{
     runId: string;
-    status: "cancelled";
+    status: "failed";
     output?: never;
 } | {
     runId: string;
-    status: "failed";
+    status: "cancelled";
     output?: never;
 } | {
     runId: string;
     status: "succeeded";
     output: Record<string, unknown>;
-}, never, WorkflowEngine | WorkflowInstance>;
+}, never, WorkflowEngine.WorkflowEngine | WorkflowEngine.WorkflowInstance>;
 
 /**
  * Does `cadence` fire at wall-clock `now`? True only on a 15-min slot matching
@@ -314,14 +313,14 @@ export declare const cancelFlow: (ctx: AppContext, args: {
     runId: string;
 }) => Effect.Effect<{
     readonly runId: string;
-    readonly status: "failed" | "pending" | "waiting" | "cancelled" | "running" | "succeeded" | "cancelling";
+    readonly status: "failed" | "succeeded" | "pending" | "waiting" | "cancelled" | "running" | "cancelling";
     readonly engine: "unknown" | "unreachable" | "cancelled" | "accepted" | "already-terminal" | "not-requested";
     readonly control: {
         readonly operation: "resume" | "cancel";
         readonly kind: "unknown" | "accepted" | "confirmed" | "already-terminal";
         readonly requestId: string | null;
         readonly snapshot: {
-            readonly status: "unknown" | "failed" | "cancelled" | "running" | "succeeded" | "suspended";
+            readonly status: "unknown" | "failed" | "succeeded" | "cancelled" | "running" | "suspended";
             readonly id: string;
             readonly executionId: string;
             readonly workflowName: string;
@@ -1112,7 +1111,7 @@ export declare const launchFlow: (ctx: AppContext, args: {
     readonly runId: string;
     readonly requestId: string;
     readonly admission: {
-        readonly status: "dropped" | "skipped" | "running" | "succeeded" | "queued" | "replayed";
+        readonly status: "succeeded" | "dropped" | "skipped" | "running" | "queued" | "replayed";
         readonly id: string;
         readonly executionId: string | null;
         readonly workflowName: string;
@@ -1400,7 +1399,7 @@ export declare const retryFlow: (ctx: AppContext, args: {
     readonly runId: string;
     readonly requestId: string;
     readonly admission: {
-        readonly status: "dropped" | "skipped" | "running" | "succeeded" | "queued" | "replayed";
+        readonly status: "succeeded" | "dropped" | "skipped" | "running" | "queued" | "replayed";
         readonly id: string;
         readonly executionId: string | null;
         readonly workflowName: string;

package/dist/index.js

@@ -16,7 +16,7 @@ import { cancelFlow as je, createFlow as Me, deleteFlow as Ne, getFlow as Pe, la
 import { Effect as Z } from "effect";
 import { definePlugin as Be, pluginInstanceName as Ve } from "@voltro/protocol";
 import { eq as Q, inSet as He, notInSet as Ue, queryFor as We, registerRetention as Ge } from "@voltro/database";
-//#region src/index.ts
+// src/index.ts
 var $ = "aiFlows", Ke = (e = {}) => {
 	let t = Ve({
 		base: $,
@@ -160,5 +160,4 @@ var $ = "aiFlows", Ke = (e = {}) => {
 		}).pipe(Z.catchCause(() => Z.void))
 	});
 };
-//#endregion
 export { w as BriefField, T as ChainPending, y as ConditionOp, E as CostCompleteness, D as CostSource, f as FLOW_RUNS_TTL_ENV, p as FLOW_RUNS_TTL_HOURS_DEFAULT, s as FLOW_RUN_WORKFLOW, O as FlowCadence, k as FlowCancelReceipt, A as FlowChain, j as FlowMode, M as FlowReviewInput, N as FlowReviewReceipt, P as FlowStartReceipt, F as FlowStatus, I as FlowStep, c as HUMAN_RESPONSE_SIGNAL_PREFIX, m as HUMAN_REVIEW_TIMEOUT_ENV, h as HUMAN_REVIEW_TIMEOUT_HOURS_DEFAULT, L as HumanResponse, R as Json, ee as MAX_CHAIN_DEPTH_DEFAULT, te as MAX_CHAIN_DEPTH_ENV, z as MAX_STEPS_DEFAULT, B as MAX_STEPS_MAX, V as MAX_STEPS_MIN, H as MediaArtifact, U as MediaArtifacts, W as MediaInputSlot, G as MediaInputs, K as MediaReceipt, q as Modality, J as ReviewMode, Y as ReviewOption, ae as RunReview, oe as RunSource, se as RunStatus, ce as RunStep, le as RunStepStatus, b as StepCondition, ue as StepType, de as StepUsage, fe as Visibility, u as admittedStartHandle, i as aiFlowRunsTable, Ke as aiFlowsPlugin, a as aiFlowsTable, o as aiFlowsTables, xe as buildFlowRunExecute, Ee as cadenceMatches, je as cancelFlow, pe as clampMaxSteps, e as clearRegistry, ge as collectRefs, Me as createFlow, Oe as cronRequestId, Ce as defineFlow, Ne as deleteFlow, x as describeCondition, S as evaluateCondition, ye as flowSegments, we as flowStep, ne as getAiFlowsDefaults, Pe as getFlow, t as getRegisteredFlow, l as humanResponseSignalName, _e as interpolate, C as isTruthy, Fe as launchFlow, Ie as listFlows, n as listRegisteredFlows, Ae as makeMediaGenerator, De as nextRuns, be as nonContiguousGroups, me as normalizeFlow, d as reconcileFlowStarts, r as registerFlow, ie as resetAiFlowsDefaults, g as resolveHumanReviewTimeoutMs, Se as resolveIr, _ as resolveMaxChainDepth, Le as respondToFlow, X as retryFlow, ke as runCadenceTick, he as sanitizeOutputKey, v as setAiFlowsDefaults, ve as unresolvedRefs, Re as updateFlow, Te as validateFlow, ze as waitingStepIndex };

package/dist/interpolate.js

@@ -1,4 +1,4 @@
-//#region src/interpolate.ts
+// src/interpolate.ts
 var e = /\{\{\s*([\w.-]+)\s*\}\}/g, t = (t) => {
 	let n = [];
 	for (let r of t.matchAll(e)) n.push(r[1]);
@@ -11,5 +11,4 @@ var e = /\{\{\s*([\w.-]+)\s*\}\}/g, t = (t) => {
 	for (let i of t(e)) n[i] == null && !r.has(i) && r.add(i);
 	return [...r];
 };
-//#endregion
 export { t as collectRefs, n as interpolate, r as unresolvedRefs };

package/dist/ir.js

@@ -1,7 +1,7 @@
 import { ConditionOp as e, StepCondition as t, describeCondition as n, evaluateCondition as r, isTruthy as i } from "./condition.js";
 import { Schema as a } from "effect";
 import { WorkflowControlResultSchema as o, WorkflowRunHandleSchema as s } from "@voltro/protocol";
-//#region src/ir.ts
+// src/ir.ts
 var c = a.Struct({
 	runId: a.NonEmptyString,
 	requestId: a.NonEmptyString,
@@ -229,5 +229,4 @@ var c = a.Struct({
 		...e.humanTimeoutMs != null && Number.isFinite(e.humanTimeoutMs) ? { humanTimeoutMs: e.humanTimeoutMs } : {}
 	};
 };
-//#endregion
 export { T as BriefField, R as ChainPending, e as ConditionOp, j as CostCompleteness, A as CostSource, D as FlowCadence, p as FlowCancelReceipt, E as FlowChain, l as FlowMode, I as FlowReviewInput, L as FlowReviewReceipt, c as FlowStartReceipt, u as FlowStatus, w as FlowStep, F as HumanResponse, x as Json, z as MAX_STEPS_DEFAULT, V as MAX_STEPS_MAX, B as MAX_STEPS_MIN, S as MediaArtifact, C as MediaArtifacts, y as MediaInputSlot, b as MediaInputs, N as MediaReceipt, g as Modality, _ as ReviewMode, v as ReviewOption, k as RunReview, m as RunSource, f as RunStatus, P as RunStep, O as RunStepStatus, t as StepCondition, h as StepType, M as StepUsage, d as Visibility, H as clampMaxSteps, n as describeCondition, r as evaluateCondition, i as isTruthy, W as normalizeFlow, U as sanitizeOutputKey };

package/dist/jsonParams.js

@@ -1,5 +1,5 @@
 import { Schema as e } from "effect";
-//#region src/jsonParams.ts
+// src/jsonParams.ts
 var t = e.suspend(() => e.Union([
 	e.Null,
 	e.Boolean,
@@ -8,5 +8,4 @@ var t = e.suspend(() => e.Union([
 	e.Array(t).pipe(e.mutable),
 	e.Record(e.String, t)
 ])), n = e.Record(e.String, e.Record(e.String, t));
-//#endregion
 export { n as ProviderOptions };

package/dist/mediaAdapter.js

@@ -3,7 +3,7 @@ import { FlowCapabilityMissing as t } from "./errors.js";
 import { audioParams as n, imageParams as r, videoParams as i } from "./mediaParams.js";
 import { Effect as a } from "effect";
 import { estimateCostUsd as o, gatewayCostUsd as s, generateImage as c, generateSpeech as l, generateVideo as u, isMeteredUsage as d } from "@voltro/ai";
-//#region src/mediaAdapter.ts
+// src/mediaAdapter.ts
 var f = (e) => ({
 	name: "gateway",
 	model: e
@@ -175,5 +175,4 @@ var f = (e) => ({
 		message: String(e.message ?? e)
 	}))));
 };
-//#endregion
 export { _ as makeMediaGenerator };

package/dist/mediaInputs.js

@@ -1,6 +1,6 @@
 import { MediaInputs as e } from "./ir.js";
 import { Effect as t, Schema as n } from "effect";
-//#region src/mediaInputs.ts
+// src/mediaInputs.ts
 var r = n.String.pipe(n.check(n.makeFilter((e) => {
 	try {
 		let t = new URL(e);
@@ -53,5 +53,4 @@ var s = (t, i = {}) => {
 	},
 	catch: () => `invalid or unsupported media input for ${e}; check the built-in adapter's slot contract`
 });
-//#endregion
 export { r as MediaInputUrl, o as ResolvedMediaInputRef, i as ResolvedMediaInputs, c as nativeMediaInputs, s as resolveMediaInputRefs, a as resolveMediaInputs };

package/dist/mediaParams.js

@@ -1,6 +1,6 @@
 import { ProviderOptions as e } from "./jsonParams.js";
 import { Effect as t, Schema as n } from "effect";
-//#region src/mediaParams.ts
+// src/mediaParams.ts
 var r = (e) => n.optionalKey(e), i = n.Int.pipe(n.check(n.isGreaterThan(0)), n.check(n.isLessThanOrEqualTo(2 ** 53 - 1))), a = n.Int.pipe(n.check(n.isBetween({
 	minimum: -(2 ** 53 - 1),
 	maximum: 2 ** 53 - 1
@@ -38,5 +38,4 @@ var r = (e) => n.optionalKey(e), i = n.Int.pipe(n.check(n.isGreaterThan(0)), n.c
 	try: () => n.decodeUnknownSync(e, { onExcessProperty: "error" })(r === void 0 ? {} : r),
 	catch: () => `invalid ${i} media params: check the built-in adapter's supported options and value ranges`
 }), f = (e) => d(c, e, "image"), p = (e) => d(l, e, "audio"), m = (e) => d(u, e, "video");
-//#endregion
 export { p as audioParams, f as imageParams, m as videoParams };

package/dist/mediaResult.js

@@ -1,6 +1,6 @@
 import { CostSource as e, MediaArtifacts as t, StepUsage as n } from "./ir.js";
 import { Effect as r, Schema as i } from "effect";
-//#region src/mediaResult.ts
+// src/mediaResult.ts
 var a = i.Struct({
 	artifacts: t,
 	costMicroUsd: i.optional(i.Finite.pipe(i.check(i.isGreaterThanOrEqualTo(0)))),
@@ -11,5 +11,4 @@ var a = i.Struct({
 	try: () => i.decodeUnknownSync(a, { onExcessProperty: "error" })(e),
 	catch: () => "invalid media result: expected artifacts with URL, mediaType and role, exactly one primary artifact, and optional storage references"
 });
-//#endregion
 export { a as MediaResult, o as decodeMediaResult };

package/dist/procedures.js

@@ -7,7 +7,7 @@ import { recordFlowStartReceipt as m } from "./startReceipt.js";
 import { Effect as h, Result as g, Schema as _ } from "effect";
 import { WorkflowControlResultSchema as v } from "@voltro/protocol";
 import { and as y, eq as b, inSet as x, queryFor as S } from "@voltro/database";
-//#region src/procedures.ts
+// src/procedures.ts
 var C = () => globalThis.crypto?.randomUUID?.() ?? `req-${Date.now().toString(36)}`, w = (e) => e.request?.subject?.id ?? null, T = (t, n) => h.promise(() => t.store.query(S(e).where(b("id", n)).descriptor)).pipe(h.map((e) => e[0])), E = (e) => h.sync(() => {
 	let t = e.workflows;
 	if (!t) throw Error("workflow runtime unavailable; no flow start was submitted");
@@ -204,5 +204,4 @@ var C = () => globalThis.crypto?.randomUUID?.() ?? `req-${Date.now().toString(36
 	id: n.id ?? `flow-${C()}`,
 	...n
 })), I = (e, n) => h.promise(() => e.store.update(t.tableName, n.id, n.patch)), L = (e, n) => h.promise(() => e.store.delete(t.tableName, n.id));
-//#endregion
 export { k as cancelFlow, F as createFlow, L as deleteFlow, N as getFlow, i as humanResponseSignalName, D as launchFlow, P as listFlows, M as respondToFlow, O as retryFlow, I as updateFlow, j as waitingStepIndex };

package/dist/registry.js

@@ -1,6 +1,5 @@
-//#region src/registry.ts
+// src/registry.ts
 var e = /* @__PURE__ */ new Map(), t = (t) => {
 	e.set(t.name, t);
 }, n = (t) => e.get(t), r = () => [...e.values()], i = () => e.clear();
-//#endregion
 export { i as clearRegistry, n as getRegisteredFlow, r as listRegisteredFlows, t as registerFlow };

package/dist/rpc.js

@@ -1,4 +1,3 @@
-//#region src/rpc.ts
+// src/rpc.ts
 var e = [];
-//#endregion
 export { e as aiFlowsRpcClientImports };

package/dist/segments.js

@@ -1,4 +1,4 @@
-//#region src/segments.ts
+// src/segments.ts
 var e = (e) => {
 	let t = [], n;
 	if (e.forEach((e, r) => {
@@ -29,5 +29,4 @@ var e = (e) => {
 	for (let n of e) n.group !== void 0 && t.set(n.group, (t.get(n.group) ?? 0) + 1);
 	return [...t.entries()].filter(([, e]) => e > 1).map(([e]) => e).sort();
 };
-//#endregion
 export { e as flowSegments, t as nonContiguousGroups };

package/dist/startReceipt.js

@@ -2,11 +2,10 @@ import { aiFlowRunsTable as e } from "./table.js";
 import "./workflow.js";
 import { Schema as t } from "effect";
 import { WorkflowRunHandleSchema as n } from "@voltro/protocol";
-//#region src/startReceipt.ts
+// src/startReceipt.ts
 var r = async (r, i, a) => {
 	let o = t.decodeUnknownSync(n.pipe(t.check(t.makeFilter((e) => e.workflowName === "flow.run" && e.id.length > 0))))(a);
 	if (await r.store.update(e.tableName, i, { workflowStart: o }) === null) throw Error("flow start receipt could not be recorded; workflow submission may have succeeded");
 	return o;
 };
-//#endregion
 export { r as recordFlowStartReceipt };

package/dist/startReconcile.js

@@ -2,7 +2,7 @@ import { aiFlowRunsTable as e } from "./table.js";
 import { FLOW_RUN_WORKFLOW as t } from "./workflow.js";
 import { Schema as n } from "effect";
 import { eq as r } from "@voltro/database";
-//#region src/startReconcile.ts
+// src/startReconcile.ts
 var i = n.Struct({
 	id: n.NonEmptyString,
 	workflowName: n.Literal(t),
@@ -77,5 +77,4 @@ var i = n.Struct({
 	}
 	return d;
 };
-//#endregion
 export { a as admittedStartHandle, s as reconcileFlowStarts };

package/dist/table.js

@@ -2,7 +2,7 @@ import { boolean as e, id as t, integer as n, json as r, table as i, text as a,
 import { tenant as s } from "@voltro/plugin-multitenancy/mixin";
 import { audit as c } from "@voltro/plugin-audit/mixin";
 import { softDelete as l } from "@voltro/plugin-soft-delete/mixin";
-//#region src/table.ts
+// src/table.ts
 var u = i("_voltro_ai_flows", {
 	id: t({ prefix: "aifl" }),
 	name: a(),
@@ -55,5 +55,4 @@ var u = i("_voltro_ai_flows", {
 	ownerId: a().nullable(),
 	metadata: r().nullable()
 }).renamedFrom("ai_flow_runs").with(s(), c()).index(["flowRef"]).index(["status"]).index(["requestId"]), f = [u, d];
-//#endregion
 export { d as aiFlowRunsTable, u as aiFlowsTable, f as aiFlowsTables };

package/dist/textParams.js

@@ -1,6 +1,6 @@
 import { ProviderOptions as e } from "./jsonParams.js";
 import { Effect as t, Schema as n } from "effect";
-//#region src/textParams.ts
+// src/textParams.ts
 var r = n.Struct({
 	maxTokens: n.optionalKey(n.Int.pipe(n.check(n.isGreaterThan(0)), n.check(n.isLessThanOrEqualTo(2 ** 53 - 1)))),
 	temperature: n.optionalKey(n.Finite.pipe(n.check(n.isGreaterThanOrEqualTo(0)))),
@@ -17,5 +17,4 @@ var r = n.Struct({
 	try: () => n.decodeUnknownSync(r, { onExcessProperty: "error" })(e === void 0 ? {} : e),
 	catch: () => `invalid text params (${a(e)}): expected maxTokens (positive safe integer), temperature (finite nonnegative number), and/or providerOptions (provider-keyed JSON object); other fields are not supported`
 });
-//#endregion
 export { o as decodeTextParams };