@sanity/workflow-engine 0.7.0 → 0.8.0

package/dist/index.js

@@ -1,13 +1,9 @@
 import { parse, evaluate } from "groq-js";
 import { isTerminalTaskStatus, WORKFLOW_DEFINITION_TYPE, DOCUMENT_VALUE_PERMISSIONS } from "./_chunks-es/schema.js";
+import { isStartableDefinition } from "./_chunks-es/schema.js";
 import * as v from "valibot";
-function getPath(value, path) {
-  let current = value;
-  for (const part of path.split(".")) {
-    if (current == null || typeof current != "object") return;
-    current = current[part];
-  }
-  return current;
+function findOpenStageEntry(host) {
+  return host.stages.find((s) => s.name === host.currentStage && s.exitedAt === void 0);
 }
 const KNOWN_SCHEMES = /* @__PURE__ */ new Set(["dataset", "canvas", "media-library", "dashboard"]);
 function parseGdr(uri) {
@@ -111,12 +107,100 @@ function gdrRef(res, documentId, type) {
 function isGdr(value) {
   return typeof value == "object" && value !== null && typeof value.id == "string" && typeof value.type == "string";
 }
+function buildParams(args) {
+  const { instance, now, snapshot, extra } = args, currentTasks2 = findOpenStageEntry(instance)?.tasks ?? [];
+  return {
+    self: selfGdr(instance),
+    state: renderedState(instance.state ?? [], snapshot),
+    parent: instance.ancestors.at(-1)?.id ?? null,
+    ancestors: instance.ancestors.map((a) => a.id),
+    stage: instance.currentStage,
+    now,
+    /** `$effects` — parent context handoff by entry name, completed-effect
+     *  outputs namespaced under the effect's name (`$effects['x.y'].out`). */
+    effects: effectsContextMap(instance),
+    /** `$tasks` — the current stage's task rows, statuses included. */
+    tasks: currentTasks2,
+    allTasksDone: currentTasks2.every((t) => t.status === "done" || t.status === "skipped"),
+    anyTaskFailed: currentTasks2.some((t) => t.status === "failed"),
+    ...extra
+  };
+}
+function renderedState(entries, snapshot) {
+  const out = {};
+  for (const entry of entries) out[entry.name] = renderedValue(entry, snapshot);
+  return out;
+}
+function renderedValue(entry, snapshot) {
+  return entry._type !== "doc.ref" || entry.value === null || snapshot === void 0 ? entry.value : snapshot.docs.find((d) => d._id === entry.value.id) ?? entry.value;
+}
+function scopedStateOverlay(instance, snapshot, taskName) {
+  const stageEntry = findOpenStageEntry(instance);
+  if (stageEntry === void 0) return {};
+  const stageState = renderedState(stageEntry.state ?? [], snapshot), task = taskName ? stageEntry.tasks.find((t) => t.name === taskName) : void 0;
+  return { ...stageState, ...renderedState(task?.state ?? [], snapshot) };
+}
+function assignedFor(instance, taskName, actor) {
+  if (actor === void 0) return !1;
+  const entry = findOpenStageEntry(instance)?.tasks.find((t) => t.name === taskName)?.state?.find((s) => s._type === "assignees");
+  return entry === void 0 ? !1 : entry.value.some(
+    (a) => a.type === "user" ? a.id === actor.id : (actor.roles ?? []).includes(a.role)
+  );
+}
+function effectsContextMap(instance) {
+  const out = {};
+  for (const entry of instance.effectsContext)
+    out[entry.name] = entry._type === "effectsContext.json" ? parseJsonContextEntry(entry) : entry.value;
+  return out;
+}
+function parseJsonContextEntry(entry) {
+  try {
+    return JSON.parse(entry.value);
+  } catch (err) {
+    throw new Error(
+      `effectsContext entry "${entry.name}" holds unparseable JSON: ${err instanceof Error ? err.message : String(err)}`,
+      { cause: err }
+    );
+  }
+}
+function paramsForLake(params) {
+  return {
+    ...params,
+    self: typeof params.self == "string" ? bareId(params.self) : params.self,
+    parent: typeof params.parent == "string" ? bareId(params.parent) : params.parent,
+    ancestors: Array.isArray(params.ancestors) ? params.ancestors.map((a) => typeof a == "string" ? bareId(a) : a) : params.ancestors,
+    state: stripStateForLake(params.state)
+  };
+}
+function stripStateForLake(value) {
+  if (value == null) return value;
+  if (typeof value == "string") return bareId(value);
+  if (Array.isArray(value)) return value.map(stripStateForLake);
+  if (typeof value == "object") {
+    const out = {};
+    for (const [k, v2] of Object.entries(value))
+      out[k] = stripStateForLake(v2);
+    return out;
+  }
+  return value;
+}
+function bareId(id) {
+  return isGdrUri(id) ? extractDocumentId(id) : id;
+}
+function getPath(value, path) {
+  let current = value;
+  for (const part of path.split(".")) {
+    if (current == null || typeof current != "object") return;
+    current = current[part];
+  }
+  return current;
+}
 function resourceOf(p) {
   return p.scheme === "dataset" ? { type: "dataset", id: `${p.projectId}.${p.dataset}` } : { type: p.scheme, id: p.resourceId ?? "" };
 }
-const STATE_READ = /^\$state\.(\w+)(?:\.(.+))?$/;
+const STATE_READ = /^\$state\.(\w+)(?:\.(.+))?$/, EFFECTS_READ = /^\$effects\['([^']+)'\](?:\.(.+))?$/;
 function isGuardReadExpr(expr) {
-  return expr === "$self" || expr === "$now" || STATE_READ.test(expr);
+  return expr === "$self" || expr === "$now" || STATE_READ.test(expr) || EFFECTS_READ.test(expr);
 }
 function resolveGuardRead(expr, ctx) {
   if (expr === "$self") return selfGdr(ctx.instance);
@@ -126,8 +210,13 @@ function resolveGuardRead(expr, ctx) {
     const value = (ctx.instance.state ?? []).find((s) => s.name === stateRead[1])?.value;
     return stateRead[2] !== void 0 ? getPath(value, stateRead[2]) : value;
   }
+  const effectsRead = EFFECTS_READ.exec(expr);
+  if (effectsRead !== null) {
+    const outputs = effectsContextMap(ctx.instance)[effectsRead[1]];
+    return effectsRead[2] !== void 0 ? getPath(outputs, effectsRead[2]) : outputs;
+  }
   throw new Error(
-    `Guard read "${expr}" is not a supported deploy-time value \u2014 use "$self", "$now", or "$state.<name>[.path]" (guards store resolved values; the lake cannot see $state)`
+    `Guard read "${expr}" is not a supported deploy-time value \u2014 use "$self", "$now", "$state.<name>[.path]", or "$effects['<name>'][.path]" (guards store resolved values; the lake cannot see $state or $effects)`
   );
 }
 function resolveIdRefTarget(expr, ctx) {
@@ -209,7 +298,7 @@ function createDefinitionValidator() {
     entry.source.type === "query" && tryParse(entry.source.query, `${label}.query`);
   }, checkGuardRead: (expr, where) => {
     isGuardReadExpr(expr) || errors.push(
-      `  \xB7 ${where}: guard read "${expr}" is not a supported deploy-time value \u2014 use "$self", "$now", or "$state.<name>[.path]" (guards store resolved values; the lake cannot see $state)`
+      `  \xB7 ${where}: guard read "${expr}" is not a supported deploy-time value \u2014 use "$self", "$now", "$state.<name>[.path]", or "$effects['<name>'][.path]" (guards store resolved values; the lake cannot see $state or $effects)`
     );
   } };
 }
@@ -388,89 +477,6 @@ async function assertInstanceWriteAllowed(args) {
       guards: denied
     });
 }
-function findOpenStageEntry(host) {
-  return host.stages.find((s) => s.name === host.currentStage && s.exitedAt === void 0);
-}
-function buildParams(args) {
-  const { instance, now, snapshot, extra } = args, currentTasks2 = findOpenStageEntry(instance)?.tasks ?? [];
-  return {
-    self: selfGdr(instance),
-    state: renderedState(instance.state ?? [], snapshot),
-    parent: instance.ancestors.at(-1)?.id ?? null,
-    ancestors: instance.ancestors.map((a) => a.id),
-    stage: instance.currentStage,
-    now,
-    /** `$effects` — parent context handoff by entry name, completed-effect
-     *  outputs namespaced under the effect's name (`$effects['x.y'].out`). */
-    effects: effectsContextMap(instance),
-    /** `$tasks` — the current stage's task rows, statuses included. */
-    tasks: currentTasks2,
-    allTasksDone: currentTasks2.every((t) => t.status === "done" || t.status === "skipped"),
-    anyTaskFailed: currentTasks2.some((t) => t.status === "failed"),
-    ...extra
-  };
-}
-function renderedState(entries, snapshot) {
-  const out = {};
-  for (const entry of entries) out[entry.name] = renderedValue(entry, snapshot);
-  return out;
-}
-function renderedValue(entry, snapshot) {
-  return entry._type !== "doc.ref" || entry.value === null || snapshot === void 0 ? entry.value : snapshot.docs.find((d) => d._id === entry.value.id) ?? entry.value;
-}
-function scopedStateOverlay(instance, snapshot, taskName) {
-  const stageEntry = findOpenStageEntry(instance);
-  if (stageEntry === void 0) return {};
-  const stageState = renderedState(stageEntry.state ?? [], snapshot), task = taskName ? stageEntry.tasks.find((t) => t.name === taskName) : void 0;
-  return { ...stageState, ...renderedState(task?.state ?? [], snapshot) };
-}
-function assignedFor(instance, taskName, actor) {
-  if (actor === void 0) return !1;
-  const entry = findOpenStageEntry(instance)?.tasks.find((t) => t.name === taskName)?.state?.find((s) => s._type === "assignees");
-  return entry === void 0 ? !1 : entry.value.some(
-    (a) => a.type === "user" ? a.id === actor.id : (actor.roles ?? []).includes(a.role)
-  );
-}
-function effectsContextMap(instance) {
-  const out = {};
-  for (const entry of instance.effectsContext)
-    out[entry.name] = entry._type === "effectsContext.json" ? parseJsonContextEntry(entry) : entry.value;
-  return out;
-}
-function parseJsonContextEntry(entry) {
-  try {
-    return JSON.parse(entry.value);
-  } catch (err) {
-    throw new Error(
-      `effectsContext entry "${entry.name}" holds unparseable JSON: ${err instanceof Error ? err.message : String(err)}`,
-      { cause: err }
-    );
-  }
-}
-function paramsForLake(params) {
-  return {
-    ...params,
-    self: typeof params.self == "string" ? bareId(params.self) : params.self,
-    parent: typeof params.parent == "string" ? bareId(params.parent) : params.parent,
-    ancestors: Array.isArray(params.ancestors) ? params.ancestors.map((a) => typeof a == "string" ? bareId(a) : a) : params.ancestors,
-    state: stripStateForLake(params.state)
-  };
-}
-function stripStateForLake(value) {
-  if (value == null) return value;
-  if (typeof value == "string") return bareId(value);
-  if (Array.isArray(value)) return value.map(stripStateForLake);
-  if (typeof value == "object") {
-    const out = {};
-    for (const [k, v2] of Object.entries(value))
-      out[k] = stripStateForLake(v2);
-    return out;
-  }
-  return value;
-}
-function bareId(id) {
-  return isGdrUri(id) ? extractDocumentId(id) : id;
-}
 function abortReason(instance) {
   return instance.history.find(
     (h) => h._type === "aborted"
@@ -593,6 +599,79 @@ function remediationsFor(diagnosis) {
     available: RUNNABLE_VERBS.has(seed.verb)
   }));
 }
+class ActionParamsInvalidError extends Error {
+  action;
+  task;
+  issues;
+  constructor(args) {
+    const lines = args.issues.map((i) => `  - ${i.param}: ${i.reason}`).join(`
+`);
+    super(`Action "${args.action}" on task "${args.task}" rejected: invalid params
+${lines}`), this.name = "ActionParamsInvalidError", this.action = args.action, this.task = args.task, this.issues = args.issues;
+  }
+}
+class RequiredStateNotProvidedError extends Error {
+  definition;
+  missing;
+  constructor(args) {
+    const lines = args.missing.map((m) => `  - ${m.name} (${m.type})`).join(`
+`), where = args.definition !== void 0 ? ` for workflow "${args.definition}"` : "";
+    super(
+      `Required init state${where} was not provided:
+${lines}
+Provide each via \`initialState\` when starting standalone, or via the parent's \`subworkflows.with\` when spawned.`
+    ), this.name = "RequiredStateNotProvidedError", args.definition !== void 0 && (this.definition = args.definition), this.missing = args.missing;
+  }
+}
+class WorkflowStateDivergedError extends Error {
+  instanceId;
+  /** The guard-deploy failure that triggered the (attempted) rollback. */
+  guardError;
+  /** The rollback failure, when rollback was attempted and itself failed. */
+  rollbackError;
+  constructor(args) {
+    super(
+      `Workflow "${args.instanceId}" state committed but its guards could not be reconciled: ${args.reason}.`,
+      { cause: args.guardError }
+    ), this.name = "WorkflowStateDivergedError", this.instanceId = args.instanceId, this.guardError = args.guardError, args.rollbackError !== void 0 && (this.rollbackError = args.rollbackError);
+  }
+}
+class PartialGuardDeployError extends Error {
+  stageName;
+  deployed;
+  constructor(args) {
+    super(
+      `Partial guard deploy on stage "${args.stageName}": ${args.deployed} guard(s) deployed before a later one failed.`,
+      { cause: args.cause }
+    ), this.name = "PartialGuardDeployError", this.stageName = args.stageName, this.deployed = args.deployed;
+  }
+}
+const CONCURRENT_FIRE_ACTION_MAX_ATTEMPTS = 3;
+class ConcurrentFireActionError extends Error {
+  instanceId;
+  task;
+  action;
+  attempts;
+  constructor(args) {
+    super(
+      `Action "${args.action}" on task "${args.task}" (instance ${args.instanceId}) lost the optimistic-locking race ${args.attempts} attempts running \u2014 a concurrent writer kept committing first. Re-read and retry, or investigate a write storm on this instance.`
+    ), this.name = "ConcurrentFireActionError", this.instanceId = args.instanceId, this.task = args.task, this.action = args.action, this.attempts = args.attempts;
+  }
+}
+function isRevisionConflict(error) {
+  if (typeof error != "object" || error === null) return !1;
+  const { statusCode, message } = error;
+  return statusCode === 409 ? !0 : typeof message == "string" && message.includes("ifRevisionId check failed");
+}
+class CascadeLimitError extends Error {
+  instanceId;
+  limit;
+  constructor(args) {
+    super(
+      `Cascade did not stabilise after ${args.limit} auto-transitions on ${args.instanceId} \u2014 likely a runaway loop (transition guards that stay mutually satisfied). Check that each transition's filter eventually goes false.`
+    ), this.name = "CascadeLimitError", this.instanceId = args.instanceId, this.limit = args.limit;
+  }
+}
 function buildSnapshot(args) {
   const docs = [], knownIds = /* @__PURE__ */ new Set();
   for (const { doc, resource } of args.docs) {
@@ -858,9 +937,16 @@ async function committedInstance(args) {
 }
 async function deployStageGuards(args) {
   const live = await committedInstance(args);
-  if (!(live === void 0 || live.currentStage !== args.stageName) && live.abortedAt === void 0)
-    for (const { client, doc } of resolvedStageGuards(args))
+  if (live === void 0 || live.currentStage !== args.stageName || live.abortedAt !== void 0) return;
+  let deployed = 0;
+  for (const { client, doc } of resolvedStageGuards(args)) {
+    try {
       await upsertGuard(client, doc);
+    } catch (cause) {
+      throw deployed > 0 ? new PartialGuardDeployError({ stageName: args.stageName, deployed, cause }) : cause;
+    }
+    deployed += 1;
+  }
 }
 async function retractStageGuards(args) {
   const live = await committedInstance(args);
@@ -1049,6 +1135,7 @@ function derivePerspectiveFromState(entries) {
 async function resolveDeclaredState(args) {
   const { entryDefs, initialState, ctx, randomKey: randomKey2 } = args;
   if (entryDefs === void 0 || entryDefs.length === 0) return [];
+  assertRequiredInitProvided(entryDefs, initialState, ctx.definitionName);
   const out = [];
   for (const entry of entryDefs) {
     const scopedCtx = { ...ctx, resolvedState: out };
@@ -1056,6 +1143,17 @@ async function resolveDeclaredState(args) {
   }
   return out;
 }
+function assertRequiredInitProvided(entryDefs, initialState, definitionName) {
+  const missing = entryDefs.filter((entry) => entry.required === !0 && entry.source.type === "init").filter((entry) => {
+    const match = initialState.find((s) => s.name === entry.name && s.type === entry.type);
+    return match === void 0 || match.value === void 0 || match.value === null;
+  }).map((entry) => ({ name: entry.name, type: entry.type }));
+  if (missing.length !== 0)
+    throw new RequiredStateNotProvidedError({
+      ...definitionName !== void 0 ? { definition: definitionName } : {},
+      missing
+    });
+}
 const ARRAY_SLOT_TYPES = /* @__PURE__ */ new Set([
   "doc.refs",
   "checklist",
@@ -1280,56 +1378,6 @@ async function resolveTaskStateEntries(args) {
     randomKey
   });
 }
-class ActionParamsInvalidError extends Error {
-  action;
-  task;
-  issues;
-  constructor(args) {
-    const lines = args.issues.map((i) => `  - ${i.param}: ${i.reason}`).join(`
-`);
-    super(`Action "${args.action}" on task "${args.task}" rejected: invalid params
-${lines}`), this.name = "ActionParamsInvalidError", this.action = args.action, this.task = args.task, this.issues = args.issues;
-  }
-}
-class WorkflowStateDivergedError extends Error {
-  instanceId;
-  /** The guard-deploy failure that triggered the (attempted) rollback. */
-  guardError;
-  /** The rollback failure, when rollback was attempted and itself failed. */
-  rollbackError;
-  constructor(args) {
-    super(
-      `Workflow "${args.instanceId}" state committed but its guards could not be reconciled: ${args.reason}.`,
-      { cause: args.guardError }
-    ), this.name = "WorkflowStateDivergedError", this.instanceId = args.instanceId, this.guardError = args.guardError, args.rollbackError !== void 0 && (this.rollbackError = args.rollbackError);
-  }
-}
-const CONCURRENT_FIRE_ACTION_MAX_ATTEMPTS = 3;
-class ConcurrentFireActionError extends Error {
-  instanceId;
-  task;
-  action;
-  attempts;
-  constructor(args) {
-    super(
-      `Action "${args.action}" on task "${args.task}" (instance ${args.instanceId}) lost the optimistic-locking race ${args.attempts} attempts running \u2014 a concurrent writer kept committing first. Re-read and retry, or investigate a write storm on this instance.`
-    ), this.name = "ConcurrentFireActionError", this.instanceId = args.instanceId, this.task = args.task, this.action = args.action, this.attempts = args.attempts;
-  }
-}
-function isRevisionConflict(error) {
-  if (typeof error != "object" || error === null) return !1;
-  const { statusCode, message } = error;
-  return statusCode === 409 ? !0 : typeof message == "string" && message.includes("ifRevisionId check failed");
-}
-class CascadeLimitError extends Error {
-  instanceId;
-  limit;
-  constructor(args) {
-    super(
-      `Cascade did not stabilise after ${args.limit} auto-transitions on ${args.instanceId} \u2014 likely a runaway loop (transition guards that stay mutually satisfied). Check that each transition's filter eventually goes false.`
-    ), this.name = "CascadeLimitError", this.instanceId = args.instanceId, this.limit = args.limit;
-  }
-}
 async function deployOrRollback(args) {
   try {
     await args.deploy();
@@ -1351,7 +1399,11 @@ async function deployOrRollback(args) {
         reason: "rollback of the committed move failed"
       });
     }
-    throw guardError;
+    throw guardError instanceof PartialGuardDeployError ? new WorkflowStateDivergedError({
+      instanceId: args.instanceId,
+      guardError,
+      reason: "a multi-guard deploy partially applied; the rolled-back move left orphaned guard locks"
+    }) : guardError;
   }
 }
 function applyTaskStatusChange(args) {
@@ -1440,7 +1492,8 @@ function materializeInstance(base, mutation) {
     ...base,
     currentStage: mutation.currentStage,
     state: mutation.state,
-    stages: mutation.stages
+    stages: mutation.stages,
+    effectsContext: mutation.effectsContext
   };
 }
 async function persist(ctx, mutation) {
@@ -1455,7 +1508,21 @@ async function persist(ctx, mutation) {
   tx.patch(ctx.client.patch(ctx.instance._id).set(set).ifRevisionId(ctx.instance._rev)), await tx.commit(), mutation.pendingCreates = [];
   const actorForPriming = void 0;
   for (const body of pendingCreates)
-    await primeInitialStage(ctx.client, body._id, actorForPriming, ctx.clientForGdr, ctx.clock), await cascadeAutoTransitions(ctx.client, body._id, actorForPriming, ctx.clientForGdr, ctx.clock), await propagateToAncestors(ctx.client, body._id, actorForPriming, ctx.clientForGdr, ctx.clock);
+    try {
+      await primeInitialStage(ctx.client, body._id, actorForPriming, ctx.clientForGdr, ctx.clock), await cascadeAutoTransitions(
+        ctx.client,
+        body._id,
+        actorForPriming,
+        ctx.clientForGdr,
+        ctx.clock
+      ), await propagateToAncestors(ctx.client, body._id, actorForPriming, ctx.clientForGdr, ctx.clock);
+    } catch (cause) {
+      throw cause instanceof WorkflowStateDivergedError ? cause : new WorkflowStateDivergedError({
+        instanceId: ctx.instance._id,
+        guardError: cause,
+        reason: `spawned child "${body._id}" failed to settle after the spawn transaction committed`
+      });
+    }
   const reloaded = await ctx.client.getDocument(ctx.instance._id);
   if (!reloaded)
     throw new Error(`Instance ${ctx.instance._id} disappeared after transaction commit`);
@@ -1720,6 +1787,7 @@ async function prepareChildInstance(args) {
       selfId: childDocId,
       tag: childTag,
       workflowResource,
+      definitionName: definition.name,
       ...inheritedPerspective !== void 0 ? { perspective: inheritedPerspective } : {}
     },
     randomKey
@@ -1766,6 +1834,28 @@ async function resolveBindings(args) {
     resolved[key] = await runGroq(groq, args.params, args.snapshot);
   return { ...resolved, ...args.staticInput };
 }
+async function persistThenDeploy(ctx, mutation, deploy) {
+  const spawned = mutation.pendingCreates.length > 0, committed = await persist(ctx, mutation);
+  await deployOrRollback({
+    client: ctx.client,
+    instanceId: ctx.instance._id,
+    committedRev: committed._rev,
+    restore: instanceStateFields(ctx.instance),
+    unset: ctx.instance.completedAt === void 0 ? ["completedAt"] : [],
+    reversible: !spawned,
+    deploy
+  });
+}
+async function refreshStageGuards(ctx, mutation, stageName) {
+  await deployStageGuards({
+    client: ctx.client,
+    clientForGdr: ctx.clientForGdr,
+    instance: materializeInstance(ctx.instance, mutation),
+    definition: ctx.definition,
+    stageName,
+    now: ctx.now
+  });
+}
 async function completeEffect(args) {
   const { client, instanceId, effectKey, status, outputs, detail, error, durationMs, options } = args, ctx = await loadContext(client, instanceId, {
     ...options?.clock ? { clock: options.clock } : {},
@@ -1811,9 +1901,11 @@ async function commitCompleteEffect(ctx, effectKey, status, outputs, detail, err
   const mutation = startMutation(ctx.instance);
   mutation.pendingEffects = mutation.pendingEffects.filter((e) => e._key !== effectKey);
   const ranAt = ctx.now;
-  return mutation.effectHistory.push(
+  mutation.effectHistory.push(
     buildEffectHistoryEntry(pending, { status, ranAt, actor, detail, error, durationMs, outputs })
-  ), status === "done" && outputs !== void 0 && upsertEffectsContext(mutation, pending.name, outputs), mutation.history.push({
+  );
+  const wroteEffectsContext = status === "done" && outputs !== void 0;
+  return wroteEffectsContext && upsertEffectsContext(mutation, pending.name, outputs), mutation.history.push({
     _key: randomKey(),
     _type: "effectCompleted",
     at: ranAt,
@@ -1823,7 +1915,11 @@ async function commitCompleteEffect(ctx, effectKey, status, outputs, detail, err
     ...outputs !== void 0 ? { outputs } : {},
     ...detail !== void 0 ? { detail } : {},
     ...actor !== void 0 ? { actor } : {}
-  }), await persist(ctx, mutation), { effectKey, status };
+  }), await persistThenDeploy(
+    ctx,
+    mutation,
+    () => wroteEffectsContext ? refreshStageGuards(ctx, mutation, ctx.instance.currentStage) : Promise.resolve()
+  ), { effectKey, status };
 }
 function buildQueuedEffect(effect, origin, params, actor, now) {
   const key = randomKey(), pending = {
@@ -2283,28 +2379,6 @@ async function persistStageMove(ctx, mutation, exitedStage, enteredStage) {
     now: ctx.now
   });
 }
-async function persistThenDeploy(ctx, mutation, deploy) {
-  const spawned = mutation.pendingCreates.length > 0, committed = await persist(ctx, mutation);
-  await deployOrRollback({
-    client: ctx.client,
-    instanceId: ctx.instance._id,
-    committedRev: committed._rev,
-    restore: instanceStateFields(ctx.instance),
-    unset: ctx.instance.completedAt === void 0 ? ["completedAt"] : [],
-    reversible: !spawned,
-    deploy
-  });
-}
-async function refreshStageGuards(ctx, mutation, stageName) {
-  await deployStageGuards({
-    client: ctx.client,
-    clientForGdr: ctx.clientForGdr,
-    instance: materializeInstance(ctx.instance, mutation),
-    definition: ctx.definition,
-    stageName,
-    now: ctx.now
-  });
-}
 async function commitTransition(ctx, actor) {
   if (isTerminal(ctx))
     return { fired: !1 };
@@ -3261,6 +3335,7 @@ const workflow = {
         selfId: id,
         tag,
         workflowResource,
+        definitionName: definition.name,
         ...perspective !== void 0 ? { perspective } : {}
       },
       randomKey
@@ -4151,6 +4226,8 @@ export {
   HISTORY_DISPLAY,
   MutationGuardDeniedError,
   OP_DISPLAY,
+  PartialGuardDeployError,
+  RequiredStateNotProvidedError,
   STATE_SLOT_DISPLAY,
   WORKFLOW_DEFINITION_TYPE,
   WORKFLOW_INSTANCE_TYPE,
@@ -4186,6 +4263,7 @@ export {
   instanceGuardQuery,
   isDefinitionUnchanged,
   isGdr,
+  isStartableDefinition,
   isTerminalStage,
   lakeGuardId,
   parseGdr,