@sanity/workflow-engine 0.3.0 → 0.5.0

package/dist/define.cjs

@@ -17,108 +17,513 @@ function _interopNamespaceCompat(e) {
   }), n.default = e, Object.freeze(n);
 }
 var v__namespace = /* @__PURE__ */ _interopNamespaceCompat(v);
+function groq(strings, ...values) {
+  return strings.reduce((out, part, i) => i === 0 ? part : `${out}${serializeGroqValue(values[i - 1])}${part}`, "");
+}
+function serializeGroqValue(value) {
+  const serialized = JSON.stringify(value);
+  if (serialized === void 0)
+    throw new Error(
+      `groq tag cannot serialize ${typeof value} \u2014 interpolate JSON-representable values only`
+    );
+  return serialized;
+}
+function desugarWorkflow(authoring) {
+  const ctx = { issues: [], claimStates: /* @__PURE__ */ new Map(), claimedStates: /* @__PURE__ */ new Set() }, workflowState = desugarStateEntries(authoring.state, ["state"], ctx), workflowLayer = layerOf(workflowState), stages = authoring.stages.map((stage, i) => {
+    const path = ["stages", i], stageState = desugarStateEntries(stage.state, [...path, "state"], ctx), stageEnv = {
+      layers: [
+        { scope: "stage", entries: layerOf(stageState) },
+        { scope: "workflow", entries: workflowLayer }
+      ]
+    }, tasks = (stage.tasks ?? []).map(
+      (task, j) => desugarTask(task, [...path, "tasks", j], stageEnv, ctx)
+    ), transitions = (stage.transitions ?? []).map(
+      (transition, k) => desugarTransition(transition, [...path, "transitions", k], stageEnv, ctx)
+    );
+    return {
+      ...stripUndefined({
+        name: stage.name,
+        title: stage.title,
+        description: stage.description,
+        guards: stage.guards
+      }),
+      ...stageState ? { state: stageState } : {},
+      ...tasks.length > 0 ? { tasks } : {},
+      ...transitions.length > 0 ? { transitions } : {}
+    };
+  });
+  return checkUnclaimedClaimStates(ctx), { definition: {
+    ...stripUndefined({
+      name: authoring.name,
+      version: authoring.version,
+      title: authoring.title,
+      description: authoring.description,
+      initialStage: authoring.initialStage,
+      predicates: authoring.predicates
+    }),
+    ...workflowState ? { state: workflowState } : {},
+    stages
+  }, issues: ctx.issues };
+}
+function desugarStateEntries(entries, path, ctx) {
+  return !entries || entries.length === 0 ? entries === void 0 ? void 0 : [] : entries.map((entry, i) => {
+    if (entry.type !== "claim") return entry;
+    const desugared = {
+      ...stripUndefined({ name: entry.name, title: entry.title, description: entry.description }),
+      type: "value.actor",
+      source: { type: "write" }
+    };
+    return ctx.claimStates.set(desugared, { name: entry.name, path: [...path, i] }), desugared;
+  });
+}
+function layerOf(entries) {
+  return new Map((entries ?? []).map((entry) => [entry.name, entry]));
+}
+function desugarTask(task, path, stageEnv, ctx) {
+  const taskState = desugarStateEntries(task.state, [...path, "state"], ctx), env = {
+    layers: [{ scope: "task", entries: layerOf(taskState) }, ...stageEnv.layers]
+  }, ops = desugarOps(task.ops, [...path, "ops"], env, task.name, ctx), actions = (task.actions ?? []).map(
+    (action, a) => desugarAction(action, [...path, "actions", a], env, task.name, ctx)
+  );
+  return {
+    ...stripUndefined({
+      name: task.name,
+      title: task.title,
+      description: task.description,
+      filter: task.filter,
+      completeWhen: task.completeWhen,
+      failWhen: task.failWhen,
+      effects: task.effects,
+      subworkflows: task.subworkflows
+    }),
+    activation: task.activation ?? "manual",
+    ...taskState ? { state: taskState } : {},
+    ...ops ? { ops } : {},
+    ...actions.length > 0 ? { actions } : {}
+  };
+}
+function desugarAction(action, path, env, taskName, ctx) {
+  if ("type" in action)
+    return desugarClaimAction(action, path, env, ctx);
+  const filter = composeFilter([rolesCondition(action.roles), action.filter]), ops = desugarOps(action.ops, [...path, "ops"], env, taskName, ctx) ?? [];
+  return action.status !== void 0 && ops.push({ type: "status.set", task: taskName, status: action.status }), {
+    ...stripUndefined({
+      name: action.name,
+      title: action.title,
+      description: action.description,
+      params: action.params,
+      effects: action.effects
+    }),
+    ...filter ? { filter } : {},
+    ...ops.length > 0 ? { ops } : {}
+  };
+}
+function desugarClaimAction(action, path, env, ctx) {
+  const ref = typeof action.state == "string" ? { state: action.state } : action.state, resolved = resolveRef(ref, env, [...path, "state"], ctx);
+  if (resolved) {
+    const entry = entryAt(env, resolved);
+    entry && entry.type !== "value.actor" && ctx.issues.push({
+      path: [...path, "state"],
+      message: `claim action "${action.name}" references "${resolved.state}" of kind "${entry.type}" \u2014 a claim pair needs an actor-valued entry (a "claim" or "value.actor" state declaration)`
+    }), checkShadowedClaimTarget(action.name, ref.state, resolved, env, [...path, "state"], ctx), entry && ctx.claimedStates.add(entry);
+  }
+  const noSteal = `!defined($state.${ref.state})`, filter = composeFilter([noSteal, rolesCondition(action.roles), action.filter]), ops = resolved ? [{ type: "state.set", target: resolved, value: { type: "actor" } }] : [];
+  return {
+    ...stripUndefined({
+      name: action.name,
+      title: action.title,
+      description: action.description,
+      params: action.params,
+      effects: action.effects
+    }),
+    filter,
+    ...ops.length > 0 ? { ops } : {}
+  };
+}
+function checkShadowedClaimTarget(actionName, state, resolved, env, path, ctx) {
+  const nearest = env.layers.find((l) => l.entries.has(state));
+  nearest === void 0 || nearest.scope === resolved.scope || ctx.issues.push({
+    path,
+    message: `claim action "${actionName}" targets "${state}" at scope "${resolved.scope}", but a nearer ${nearest.scope}-scope entry of the same name shadows it in $state \u2014 the no-steal filter would read the shadowing entry while the claim writes the "${resolved.scope}" one. Rename one of the entries or claim the nearer one`
+  });
+}
+function checkUnclaimedClaimStates(ctx) {
+  for (const [entry, { name, path }] of ctx.claimStates)
+    ctx.claimedStates.has(entry) || ctx.issues.push({
+      path,
+      message: `claim state "${name}" is never referenced by a claim action \u2014 you announced the pattern and wrote half of it. Declare a defineAction({ type: "claim", state: "${name}" }) or use a raw value.actor entry`
+    });
+}
+function desugarTransition(transition, path, stageEnv, ctx) {
+  const ops = desugarOps(transition.ops, [...path, "ops"], stageEnv, void 0, ctx);
+  return {
+    ...stripUndefined({
+      name: transition.name,
+      title: transition.title,
+      description: transition.description,
+      to: transition.to,
+      effects: transition.effects
+    }),
+    filter: transition.filter ?? "$allTasksDone",
+    ...ops ? { ops } : {}
+  };
+}
+function desugarOps(ops, path, env, firingTask, ctx) {
+  if (ops)
+    return ops.map((op, i) => desugarOp(op, [...path, i], env, firingTask, ctx));
+}
+function desugarOp(op, path, env, firingTask, ctx) {
+  if (op.type === "status.set") {
+    const task = op.task ?? firingTask;
+    return task === void 0 && ctx.issues.push({
+      path: [...path, "task"],
+      message: "status.set outside an action must name its target task"
+    }), { type: "status.set", task: task ?? "", status: op.status };
+  }
+  if (op.type === "audit") return desugarAuditOp(op, path, env, ctx);
+  const target = resolveRef(op.target, env, [...path, "target"], ctx) ?? fallbackRef(op.target);
+  return { ...op, target };
+}
+const AUDIT_STAMPS = { actor: { type: "actor" }, at: { type: "now" } };
+function desugarAuditOp(op, path, env, ctx) {
+  const target = resolveRef(op.target, env, [...path, "target"], ctx) ?? fallbackRef(op.target);
+  if (op.value.type !== "object")
+    return ctx.issues.push({
+      path: [...path, "value"],
+      message: `audit value must be an object source carrying the domain fields (got "${op.value.type}")`
+    }), { type: "state.append", target, value: op.value };
+  const actorField = op.stampFields?.actor ?? "actor", atField = op.stampFields?.at ?? "at", fields = { ...op.value.fields };
+  for (const [stamp, source] of [
+    [actorField, AUDIT_STAMPS.actor],
+    [atField, AUDIT_STAMPS.at]
+  ]) {
+    if (stamp in fields) {
+      ctx.issues.push({
+        path: [...path, "value", "fields", stamp],
+        message: `audit stamp field "${stamp}" collides with an authored domain field \u2014 rename yours or remap the stamp via stampFields`
+      });
+      continue;
+    }
+    fields[stamp] = source;
+  }
+  return { type: "state.append", target, value: { type: "object", fields } };
+}
+function resolveRef(ref, env, path, ctx) {
+  const layers = ref.scope === void 0 ? env.layers : env.layers.filter((l) => l.scope === ref.scope);
+  for (const layer of layers)
+    if (layer.entries.has(ref.state)) return { scope: layer.scope, state: ref.state };
+  const reachable = env.layers.flatMap((l) => [...l.entries.keys()].map((n) => `${l.scope}:${n}`));
+  ctx.issues.push({
+    path,
+    message: `state reference "${ref.state}"${ref.scope ? ` (scope "${ref.scope}")` : ""} does not resolve to a declared entry. Reachable: ${reachable.join(", ") || "(none)"}`
+  });
+}
+function entryAt(env, ref) {
+  return env.layers.find((l) => l.scope === ref.scope)?.entries.get(ref.state);
+}
+function fallbackRef(ref) {
+  return { scope: ref.scope ?? "workflow", state: ref.state };
+}
+function rolesCondition(roles) {
+  if (!(!roles || roles.length === 0))
+    return groq`count($actor.roles[@ in ${roles}]) > 0`;
+}
+function composeFilter(parts) {
+  const present = parts.filter((p) => p !== void 0);
+  if (present.length !== 0)
+    return present.length === 1 ? present[0] : present.map((p) => `(${p})`).join(" && ");
+}
+function stripUndefined(obj) {
+  const out = {};
+  for (const [k, value] of Object.entries(obj))
+    value !== void 0 && (out[k] = value);
+  return out;
+}
+const RESERVED_CONDITION_VARS = [
+  "state",
+  "actor",
+  "assigned",
+  "can",
+  "row",
+  "now",
+  "effects",
+  "tasks",
+  "subworkflows",
+  "self",
+  "stage",
+  "parent",
+  "ancestors",
+  "allTasksDone",
+  "anyTaskFailed"
+], PREDICATE_CALLER_VARS = ["actor", "assigned", "can"];
 function knownList(ids) {
   return [...ids].map((s) => `"${s}"`).join(", ");
 }
-function checkStagesAndTasks(def, issues) {
-  const stageIds = /* @__PURE__ */ new Set();
-  for (const [i, stage] of def.stages.entries())
-    stageIds.has(stage.id) && issues.push({
-      path: ["stages", i, "id"],
-      message: `duplicate stage id "${stage.id}" (already declared earlier)`
-    }), stageIds.add(stage.id), stage.kind === "terminal" && stage.transitions && stage.transitions.length > 0 && issues.push({
-      path: ["stages", i, "transitions"],
-      message: `terminal stage "${stage.id}" must not declare transitions`
-    }), checkDuplicateTaskIds(stage, i, issues);
-  return stageIds;
-}
-function checkDuplicateTaskIds(stage, i, issues) {
-  const taskIds = /* @__PURE__ */ new Set();
-  for (const [j, task] of (stage.tasks ?? []).entries())
-    taskIds.has(task.id) && issues.push({
-      path: ["stages", i, "tasks", j, "id"],
-      message: `duplicate task id "${task.id}" in stage "${stage.id}"`
-    }), taskIds.add(task.id);
-}
-function checkInitialStage(def, stageIds, issues) {
-  stageIds.has(def.initialStageId) || issues.push({
-    path: ["initialStageId"],
-    message: `initialStageId "${def.initialStageId}" is not a declared stage. Known stages: ${knownList(stageIds)}`
+function checkDuplicates(names, what, issues) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const { name, path } of names)
+    seen.has(name) && issues.push({ path, message: `duplicate ${what} "${name}" (already declared earlier)` }), seen.add(name);
+  return seen;
+}
+function checkStages(def, issues) {
+  const stageNames = checkDuplicates(
+    def.stages.map((stage, i) => ({ name: stage.name, path: ["stages", i, "name"] })),
+    "stage name",
+    issues
+  );
+  for (const [i, stage] of def.stages.entries()) {
+    const taskNames = checkDuplicates(
+      (stage.tasks ?? []).map((task, j) => ({
+        name: task.name,
+        path: ["stages", i, "tasks", j, "name"]
+      })),
+      `task name in stage "${stage.name}"`,
+      issues
+    );
+    checkDuplicates(
+      (stage.transitions ?? []).map((t, k) => ({
+        name: t.name,
+        path: ["stages", i, "transitions", k, "name"]
+      })),
+      `transition name in stage "${stage.name}"`,
+      issues
+    ), checkTasks(def, i, taskNames, issues);
+  }
+  return stageNames;
+}
+function checkTasks(def, i, taskNames, issues) {
+  const stage = def.stages[i];
+  for (const [j, task] of (stage.tasks ?? []).entries()) {
+    const path = ["stages", i, "tasks", j];
+    checkDuplicates(
+      (task.actions ?? []).map((action, a) => ({
+        name: action.name,
+        path: [...path, "actions", a, "name"]
+      })),
+      `action name in task "${task.name}"`,
+      issues
+    ), checkStatusSetTargets(task, taskNames, path, issues);
+  }
+}
+function checkStatusSetTargets(task, taskNames, path, issues) {
+  checkStatusSetOps(task.ops, taskNames, [...path, "ops"], issues);
+  for (const [a, action] of (task.actions ?? []).entries())
+    checkStatusSetOps(action.ops, taskNames, [...path, "actions", a, "ops"], issues);
+}
+function checkStatusSetOps(ops, taskNames, path, issues) {
+  for (const [o, op] of (ops ?? []).entries())
+    op.type !== "status.set" || taskNames.has(op.task) || issues.push({
+      path: [...path, o, "task"],
+      message: `status.set targets task "${op.task}" which is not declared in this stage. Known tasks: ${knownList(taskNames)}`
+    });
+}
+function checkInitialStage(def, stageNames, issues) {
+  stageNames.has(def.initialStage) || issues.push({
+    path: ["initialStage"],
+    message: `initialStage "${def.initialStage}" is not a declared stage. Known stages: ${knownList(stageNames)}`
   });
 }
-function checkTransitionTargets(def, stageIds, issues) {
+function checkTransitionTargets(def, stageNames, issues) {
   for (const [i, stage] of def.stages.entries())
     for (const [k, t] of (stage.transitions ?? []).entries())
-      stageIds.has(t.to) || issues.push({
+      stageNames.has(t.to) || issues.push({
         path: ["stages", i, "transitions", k, "to"],
-        message: `transition target "${t.to}" is not a declared stage. Known stages: ${knownList(stageIds)}`
+        message: `transition target "${t.to}" is not a declared stage. Known stages: ${knownList(stageNames)}`
       });
 }
-function collectPredicateIds(def, issues) {
-  const predicateIds = /* @__PURE__ */ new Set();
-  for (const [i, p] of (def.predicates ?? []).entries())
-    predicateIds.has(p.id) && issues.push({
-      path: ["predicates", i, "id"],
-      message: `duplicate predicate id "${p.id}"`
-    }), predicateIds.add(p.id);
-  return predicateIds;
-}
-function checkFilterRefs(def, predicateIds, issues) {
-  const visit = (g, path) => {
-    g === void 0 || typeof g == "string" || predicateIds.has(g.ref) || issues.push({
-      path: [...path, "ref"],
-      message: `Filter references predicate "${g.ref}" which is not declared. Known predicates: ${knownList(predicateIds) || "(none)"}`
-    });
-  };
+function checkEffectNames(def, issues) {
+  const sites = [];
   for (const [i, stage] of def.stages.entries()) {
-    visit(stage.completion, ["stages", i, "completion"]);
     for (const [j, task] of (stage.tasks ?? []).entries()) {
-      visit(task.filter, ["stages", i, "tasks", j, "filter"]), visit(task.completeWhen, ["stages", i, "tasks", j, "completeWhen"]), visit(task.failWhen, ["stages", i, "tasks", j, "failWhen"]);
+      collectEffects(task.effects, ["stages", i, "tasks", j, "effects"], sites);
       for (const [a, action] of (task.actions ?? []).entries())
-        visit(action.filter, ["stages", i, "tasks", j, "actions", a, "filter"]);
+        collectEffects(action.effects, ["stages", i, "tasks", j, "actions", a, "effects"], sites);
     }
     for (const [k, t] of (stage.transitions ?? []).entries())
-      visit(t.filter, ["stages", i, "transitions", k, "filter"]);
+      collectEffects(t.effects, ["stages", i, "transitions", k, "effects"], sites);
+  }
+  checkDuplicates(sites, "effect name (registry key \u2014 unique per definition)", issues);
+}
+function collectEffects(effects, path, sites) {
+  for (const [e, effect] of (effects ?? []).entries())
+    sites.push({ name: effect.name, path: [...path, e, "name"] });
+}
+function checkGuardNames(def, issues) {
+  const sites = def.stages.flatMap(
+    (stage, i) => (stage.guards ?? []).map((guard, g) => ({
+      name: guard.name,
+      path: ["stages", i, "guards", g, "name"]
+    }))
+  );
+  checkDuplicates(
+    sites,
+    "guard name (the guard lake _id derives from it \u2014 unique per definition)",
+    issues
+  );
+}
+function stateScopes(def) {
+  const scopes = [{ entries: def.state, path: ["state"], label: "workflow state" }];
+  for (const [i, stage] of def.stages.entries()) {
+    scopes.push({
+      entries: stage.state,
+      path: ["stages", i, "state"],
+      label: `stage "${stage.name}" state`
+    });
+    for (const [j, task] of (stage.tasks ?? []).entries())
+      scopes.push({
+        entries: task.state,
+        path: ["stages", i, "tasks", j, "state"],
+        label: `task "${task.name}" state`
+      });
   }
+  return scopes;
+}
+function checkStateEntryNames(def, issues) {
+  for (const { entries, path, label } of stateScopes(def))
+    checkDuplicates(
+      (entries ?? []).map((entry, n) => ({ name: entry.name, path: [...path, n, "name"] })),
+      `state entry name in ${label}`,
+      issues
+    );
+}
+function checkPredicates(def, issues) {
+  const reserved = new Set(RESERVED_CONDITION_VARS), names = Object.keys(def.predicates ?? {});
+  for (const name of names)
+    reserved.has(name) && issues.push({
+      path: ["predicates", name],
+      message: `predicate "${name}" shadows the built-in $${name} \u2014 pick another name`
+    });
+  for (const [name, groq2] of Object.entries(def.predicates ?? {}))
+    checkPredicateBody(name, groq2, names, issues);
+}
+function checkPredicateBody(name, groq2, names, issues) {
+  for (const caller of PREDICATE_CALLER_VARS)
+    referencesVar(groq2, caller) && issues.push({
+      path: ["predicates", name],
+      message: `predicate "${name}" reads $${caller} \u2014 predicates are instance-level (pre-evaluated once, without a caller); compose caller gates at the condition site instead`
+    });
+  for (const other of names)
+    other === name || !referencesVar(groq2, other) || issues.push({
+      path: ["predicates", name],
+      message: `predicate "${name}" references predicate $${other} \u2014 predicates may read built-in vars only (no cross-references; compose at the condition site instead)`
+    });
+}
+function referencesVar(groq2, name) {
+  return schema.GROQ_IDENTIFIER.test(name) ? new RegExp(`\\$${name}\\b`).test(groq2) : !1;
+}
+function checkCanOutsideActionFilters(def, issues) {
+  for (const site of nonActionFilterConditionSites(def))
+    referencesVar(site.groq, "can") && issues.push({
+      path: site.path,
+      message: `${site.label} reads $can \u2014 $can (the caller's grants) is bound only when an action fires, so it may appear in action filters only`
+    });
+}
+function nonActionFilterConditionSites(def) {
+  const sites = [];
+  for (const [i, stage] of def.stages.entries()) {
+    for (const [k, t] of (stage.transitions ?? []).entries())
+      sites.push({
+        groq: t.filter,
+        path: ["stages", i, "transitions", k, "filter"],
+        label: `transition "${t.name}" filter`
+      }), collectBindingSites(
+        t.effects,
+        ["stages", i, "transitions", k, "effects"],
+        `transition "${t.name}"`,
+        sites
+      );
+    for (const [j, task] of (stage.tasks ?? []).entries())
+      collectTaskConditionSites(task, ["stages", i, "tasks", j], sites);
+  }
+  return sites;
+}
+function collectTaskConditionSites(task, path, sites) {
+  for (const field of ["filter", "completeWhen", "failWhen"]) {
+    const groq2 = task[field];
+    groq2 !== void 0 && sites.push({ groq: groq2, path: [...path, field], label: `task "${task.name}".${field}` });
+  }
+  collectBindingSites(task.effects, [...path, "effects"], `task "${task.name}"`, sites);
+  for (const [a, action] of (task.actions ?? []).entries())
+    collectBindingSites(
+      action.effects,
+      [...path, "actions", a, "effects"],
+      `action "${action.name}"`,
+      sites
+    );
+  collectSubworkflowSites(task, path, sites);
+}
+function collectSubworkflowSites(task, path, sites) {
+  const sub = task.subworkflows;
+  if (sub === void 0) return;
+  const subPath = [...path, "subworkflows"];
+  sites.push({
+    groq: sub.forEach,
+    path: [...subPath, "forEach"],
+    label: `task "${task.name}".subworkflows.forEach`
+  });
+  for (const [group, record] of [
+    ["with", sub.with],
+    ["context", sub.context]
+  ])
+    for (const [key, groq2] of Object.entries(record ?? {}))
+      sites.push({
+        groq: groq2,
+        path: [...subPath, group, key],
+        label: `task "${task.name}".subworkflows.${group} "${key}"`
+      });
+}
+function collectBindingSites(effects, path, label, sites) {
+  for (const [e, effect] of (effects ?? []).entries())
+    for (const [key, groq2] of Object.entries(effect.bindings ?? {}))
+      sites.push({
+        groq: groq2,
+        path: [...path, e, "bindings", key],
+        label: `${label} effect "${effect.name}" binding "${key}"`
+      });
+}
+function checkAssigneesEntries(def, issues) {
+  for (const { entries, path } of stateScopes(def))
+    (entries ?? []).filter((e) => e.type === "assignees").length <= 1 || issues.push({
+      path,
+      message: "at most one assignees-kind state entry per scope \u2014 the inbox reads it by kind"
+    });
 }
 function checkWorkflowInvariants(def) {
-  const issues = [], stageIds = checkStagesAndTasks(def, issues);
-  checkInitialStage(def, stageIds, issues), checkTransitionTargets(def, stageIds, issues);
-  const predicateIds = collectPredicateIds(def, issues);
-  return checkFilterRefs(def, predicateIds, issues), issues;
+  const issues = [], stageNames = checkStages(def, issues);
+  return checkInitialStage(def, stageNames, issues), checkTransitionTargets(def, stageNames, issues), checkEffectNames(def, issues), checkGuardNames(def, issues), checkStateEntryNames(def, issues), checkPredicates(def, issues), checkCanOutsideActionFilters(def, issues), checkAssigneesEntries(def, issues), issues;
 }
 function defineWorkflow(definition) {
-  const workflowId = definition.workflowId, label = typeof workflowId == "string" ? `defineWorkflow("${workflowId}")` : "defineWorkflow", parsed = parseOrThrow(schema.WorkflowDefinitionSchema, definition, label), issues = checkWorkflowInvariants(parsed);
+  const label = labelFor("defineWorkflow", definition), parsed = parseOrThrow(schema.AuthoringWorkflowSchema, definition, label), { definition: stored, issues: desugarIssues } = desugarWorkflow(parsed), issues = [...desugarIssues, ...checkWorkflowInvariants(stored)];
   if (issues.length > 0) throw new Error(schema.formatValidationError(label, issues));
-  return parsed;
+  return stored;
 }
 function defineStage(stage) {
-  return parseOrThrow(schema.StageSchema, stage, labelFor("defineStage", stage, "id"));
+  return parseOrThrow(schema.AuthoringStageSchema, stage, labelFor("defineStage", stage));
 }
 function defineTask(task) {
-  return parseOrThrow(schema.TaskSchema, task, labelFor("defineTask", task, "id"));
+  return parseOrThrow(schema.AuthoringTaskSchema, task, labelFor("defineTask", task));
 }
 function defineAction(action) {
-  return parseOrThrow(schema.ActionSchema, action, labelFor("defineAction", action, "id"));
+  return parseOrThrow(schema.AuthoringActionSchema, action, labelFor("defineAction", action));
 }
 function defineTransition(transition) {
-  return parseOrThrow(schema.TransitionSchema, transition, transitionLabel(transition));
+  return parseOrThrow(schema.AuthoringTransitionSchema, transition, transitionLabel(transition));
 }
-function transitionLabel(transition) {
-  const { id, to } = transition;
-  return typeof id == "string" ? `defineTransition("${id}")` : typeof to == "string" ? `defineTransition(\u2192 "${to}")` : "defineTransition";
-}
-function defineFilter(filter) {
-  return parseOrThrow(schema.FilterSchema, filter, "defineFilter");
+function defineState(entry) {
+  return parseOrThrow(schema.AuthoringStateEntrySchema, entry, labelFor("defineState", entry));
 }
-function defineAssignee(assignee) {
-  return parseOrThrow(schema.AssigneeSchema, assignee, "defineAssignee");
+function defineOp(op) {
+  return parseOrThrow(schema.AuthoringOpSchema, op, "defineOp");
 }
-function definePredicate(predicate) {
-  return parseOrThrow(schema.PredicateSchema, predicate, labelFor("definePredicate", predicate, "id"));
+function defineGuard(guard) {
+  return parseOrThrow(schema.GuardSchema, guard, labelFor("defineGuard", guard));
 }
 function defineEffect(effect) {
-  return parseOrThrow(schema.EffectSchema, effect, labelFor("defineEffect", effect, "id"));
+  return parseOrThrow(schema.EffectSchema, effect, labelFor("defineEffect", effect));
+}
+function transitionLabel(transition) {
+  const { name, to } = transition;
+  return typeof name == "string" ? `defineTransition("${name}")` : typeof to == "string" ? `defineTransition(\u2192 "${to}")` : "defineTransition";
 }
 function defineEffectDescriptor(descriptor) {
   if (!descriptor.name) throw new Error("EffectDescriptor missing name");
@@ -130,21 +535,22 @@ function parseOrThrow(schema$1, input, label) {
     throw new Error(schema.formatValidationError(label, schema.issuesFromValibot(result.issues)));
   return result.output;
 }
-function labelFor(fn, value, key) {
-  if (value && typeof value == "object" && key in value) {
-    const raw = value[key];
+function labelFor(fn, value) {
+  if (value && typeof value == "object" && "name" in value) {
+    const raw = value.name;
     if (typeof raw == "string") return `${fn}("${raw}")`;
   }
   return fn;
 }
 exports.defineAction = defineAction;
-exports.defineAssignee = defineAssignee;
 exports.defineEffect = defineEffect;
 exports.defineEffectDescriptor = defineEffectDescriptor;
-exports.defineFilter = defineFilter;
-exports.definePredicate = definePredicate;
+exports.defineGuard = defineGuard;
+exports.defineOp = defineOp;
 exports.defineStage = defineStage;
+exports.defineState = defineState;
 exports.defineTask = defineTask;
 exports.defineTransition = defineTransition;
 exports.defineWorkflow = defineWorkflow;
+exports.groq = groq;
 //# sourceMappingURL=define.cjs.map