@sanity/workflow-studio-plugin 0.5.0 → 0.20.0

package/dist/_chunks-cjs/index.cjs

@@ -1,6 +1,6 @@
 "use strict";
 
-var workflowEngine = require("@sanity/workflow-engine"), jsxRuntime = require("react/jsx-runtime"), Timeline = require("@sanity/icons/Timeline"), ui = require("@sanity/ui"), react = require("react"), structure = require("sanity/structure"), formatDistanceToNow = require("date-fns/formatDistanceToNow"), csm = require("@sanity/client/csm"), workflowStudio = require("@sanity/workflow-studio"), sanity = require("sanity"), Calendar = require("@sanity/icons/Calendar"), workflowComponents = require("@sanity/workflow-components"), User = require("@sanity/icons/User"), Close = require("@sanity/icons/Close"), Search = require("@sanity/icons/Search"), ChevronRight = require("@sanity/icons/ChevronRight"), Checkmark = require("@sanity/icons/Checkmark"), Edit = require("@sanity/icons/Edit"), content = require("@sanity/util/content"), InfoOutline = require("@sanity/icons/InfoOutline"), Document = require("@sanity/icons/Document"), WarningOutline = require("@sanity/icons/WarningOutline"), router = require("sanity/router"), types = require("@sanity/types"), Launch = require("@sanity/icons/Launch"), Empty$1 = require("@sanity/icons/Empty"), ErrorFilled = require("@sanity/icons/ErrorFilled"), RemoveCircle = require("@sanity/icons/RemoveCircle"), Add = require("@sanity/icons/Add"), Bolt = require("@sanity/icons/Bolt"), ChevronDown = require("@sanity/icons/ChevronDown"), CheckmarkCircle = require("@sanity/icons/CheckmarkCircle"), Ulist = require("@sanity/icons/Ulist"), pluralize = require("pluralize-esm"), EllipsisHorizontal = require("@sanity/icons/EllipsisHorizontal"), ArrowUp = require("@sanity/icons/ArrowUp"), workflowReact = require("@sanity/workflow-react"), Transfer = require("@sanity/icons/Transfer");
+var jsxRuntime = require("react/jsx-runtime"), Timeline = require("@sanity/icons/Timeline"), ui = require("@sanity/ui"), react = require("react"), structure = require("sanity/structure"), workflowEngine = require("@sanity/workflow-engine"), Checkmark = require("@sanity/icons/Checkmark"), Close = require("@sanity/icons/Close"), formatDistanceToNow = require("date-fns/formatDistanceToNow"), csm = require("@sanity/client/csm"), workflowStudio = require("@sanity/workflow-studio"), sanity = require("sanity"), Calendar = require("@sanity/icons/Calendar"), workflowComponents = require("@sanity/workflow-components"), User = require("@sanity/icons/User"), Search = require("@sanity/icons/Search"), ChevronRight = require("@sanity/icons/ChevronRight"), Edit = require("@sanity/icons/Edit"), content = require("@sanity/util/content"), InfoOutline = require("@sanity/icons/InfoOutline"), Document = require("@sanity/icons/Document"), WarningOutline = require("@sanity/icons/WarningOutline"), router = require("sanity/router"), types = require("@sanity/types"), Launch = require("@sanity/icons/Launch"), Empty$1 = require("@sanity/icons/Empty"), ErrorFilled = require("@sanity/icons/ErrorFilled"), RemoveCircle = require("@sanity/icons/RemoveCircle"), Add = require("@sanity/icons/Add"), Bolt = require("@sanity/icons/Bolt"), ChevronDown = require("@sanity/icons/ChevronDown"), CheckmarkCircle = require("@sanity/icons/CheckmarkCircle"), Ulist = require("@sanity/icons/Ulist"), pluralize = require("pluralize-esm"), EllipsisHorizontal = require("@sanity/icons/EllipsisHorizontal"), ArrowUp = require("@sanity/icons/ArrowUp"), workflowReact = require("@sanity/workflow-react"), Transfer = require("@sanity/icons/Transfer");
 
 function _interopDefaultCompat(e) {
     return e && typeof e == "object" && "default" in e ? e : {
@@ -23,20 +23,58 @@ function gdrLocality(id, contentResource) {
     };
 }
 
-function mappingsForDocType(mappings, docType) {
-    return mappings.filter(m => m.docType === docType);
+function assertUniqueWorkflowMappings(mappings) {
+    const keys = /* @__PURE__ */ new Set;
+    for (const mapping of mappings) {
+        const key = mappingKey(mapping);
+        if (keys.has(key)) throw new Error(`Duplicate workflow mapping for ${key}`);
+        keys.add(key);
+    }
 }
 
-function mappingForDocType(mappings, docType) {
-    return mappingsForDocType(mappings, docType)[0];
+function discoverWorkflowMappings(args) {
+    assertUniqueWorkflowMappings(args.overrides ?? []);
+    const discovered = workflowEngine.latestDeployedDefinitions(args.definitions).flatMap(definition => {
+        if (!workflowEngine.isStartableDefinition(definition)) return [];
+        const subject = (definition.fields ?? []).find(workflowEngine.isSubjectEntry);
+        if (subject === void 0 || !workflowEngine.isInputSourced(subject)) return [];
+        const source = {
+            fields: [ ...definition.fields ?? [] ]
+        };
+        return [ ...args.schemaContentTypes ].filter(docType => workflowEngine.acceptsDocumentType(source, docType)).map(docType => ({
+            docType: docType,
+            definition: definition.name,
+            label: definition.title ?? definition.name
+        }));
+    }), byKey = new Map(discovered.map(mapping => [ mappingKey(mapping), mapping ]));
+    for (const override of args.overrides ?? []) {
+        const key = mappingKey(override);
+        byKey.set(key, override);
+    }
+    return [ ...byKey.values() ];
+}
+
+function mappingAutoStartMap(mappings) {
+    const byType = /* @__PURE__ */ Object.create(null);
+    for (const mapping of mappings) {
+        if (!mapping.autoStart) continue;
+        const definitions = byType[mapping.docType] ?? [];
+        byType[mapping.docType] = [ ...definitions, mapping.definition ];
+    }
+    return byType;
+}
+
+function mappingsForDocType(mappings, docType) {
+    return mappings.filter(m => m.docType === docType);
 }
 
 function mappingKey(mapping) {
     return `${mapping.docType}::${mapping.definition}`;
 }
 
-function workflowDocTypes(mappings) {
-    return new Set(mappings.map(m => m.docType));
+function documentSubjectEntry(definition) {
+    const fields = definition.fields ?? [];
+    return fields.find(workflowEngine.isSubjectEntry) ?? fields.find(entry => entry.type === "doc.ref" && entry.name === "subject");
 }
 
 function mappingStartBlocks(args) {
@@ -357,7 +395,7 @@ function stateByActivity(instance) {
 }
 
 function evaluationFreshness(args) {
-    return args.evaluation ? args.committed.lastChangedAt > args.evaluation.instance.lastChangedAt ? "stale" : "current" : "pending";
+    return args.evaluation ? Date.parse(args.committed.lastChangedAt) > Date.parse(args.evaluation.instance.lastChangedAt) ? "stale" : "current" : "pending";
 }
 
 function isEvaluationCurrent(args) {
@@ -404,12 +442,27 @@ function useWorkflowContext() {
 }
 
 function useWorkflowsForDocument(rawId) {
-    const {register: register, unregister: unregister, entries: entries} = useWorkflowContext(), docId = rawId ? csm.getPublishedId(rawId) : void 0;
+    return useDocumentWorkflowEntries(rawId, !0);
+}
+
+function useCommittedWorkflowsForDocument(rawId) {
+    return useDocumentWorkflowEntries(rawId, !1);
+}
+
+function useDocumentWorkflowEntries(rawId, evaluate) {
+    const {register: register, unregister: unregister, requestEvaluation: requestEvaluation, releaseEvaluation: releaseEvaluation, entries: entries} = useWorkflowContext(), docId = rawId ? csm.getPublishedId(rawId) : void 0;
     react.useEffect(() => {
         if (docId) return register(docId), () => unregister(docId);
     }, [ docId, register, unregister ]);
-    const list = react.useSyncExternalStore(entries.subscribe, react.useCallback(() => docId ? entries.getDocument(docId) : EMPTY_ENTRIES, [ entries, docId ]));
-    return {
+    const list = react.useSyncExternalStore(entries.subscribe, react.useCallback(() => docId ? entries.getDocument(docId) : EMPTY_ENTRIES, [ entries, docId ])), evaluationKey = evaluate ? list.map(entry => entry.instance._id).join("\0") : "";
+    return react.useEffect(() => {
+        if (!evaluate) return;
+        const ids = evaluationKey === "" ? [] : evaluationKey.split("\0");
+        for (const id of ids) requestEvaluation(id);
+        return () => {
+            for (const id of ids) releaseEvaluation(id);
+        };
+    }, [ evaluate, evaluationKey, requestEvaluation, releaseEvaluation ]), {
         docId: docId,
         entries: list
     };
@@ -420,11 +473,13 @@ function useHeldWorkflowEntry(instanceId) {
     return react.useSyncExternalStore(entries.subscribe, react.useCallback(() => instanceId ? entries.getInstance(instanceId) : void 0, [ entries, instanceId ]));
 }
 
-function useWorkflowInstanceEntry(instanceId) {
-    const {requestInstance: requestInstance, releaseInstance: releaseInstance} = useWorkflowContext();
+function useWorkflowInstanceEntry(instanceId, options = {}) {
+    const {requestInstance: requestInstance, releaseInstance: releaseInstance, requestEvaluation: requestEvaluation, releaseEvaluation: releaseEvaluation} = useWorkflowContext(), evaluate = options.evaluate ?? !0;
     return react.useEffect(() => {
         if (instanceId) return requestInstance(instanceId), () => releaseInstance(instanceId);
-    }, [ instanceId, requestInstance, releaseInstance ]), useHeldWorkflowEntry(instanceId);
+    }, [ instanceId, requestInstance, releaseInstance ]), react.useEffect(() => {
+        if (!(!instanceId || !evaluate)) return requestEvaluation(instanceId), () => releaseEvaluation(instanceId);
+    }, [ instanceId, evaluate, requestEvaluation, releaseEvaluation ]), useHeldWorkflowEntry(instanceId);
 }
 
 const isTodoDone = item => item.status === "done", toggledTodoStatus = item => isTodoDone(item) ? "open" : "done";
@@ -697,13 +752,29 @@ function concludesHere(actionEval, activityName) {
     return changesOwnStatus(actionEval.action, activityName) || actionEval.firing?.exitsStage === !0;
 }
 
-function actionButtonTone(args) {
-    return concludesHere(args.actionEval, args.activityName) ? {
-        mode: "default",
-        tone: actionAdvanceStatus(args.actionEval.action, args.activityName) === "failed" ? "critical" : "default"
-    } : {
-        mode: "ghost",
-        tone: "default"
+const SEMANTIC_FACE = {
+    "decision.accept": {
+        tone: "positive",
+        icon: Checkmark.CheckmarkIcon
+    },
+    "decision.decline": {
+        tone: "caution",
+        icon: Close.CloseIcon
+    }
+};
+
+function actionButtonFace(args) {
+    const mode = concludesHere(args.actionEval, args.activityName) ? "default" : "ghost";
+    if (actionAdvanceStatus(args.actionEval.action, args.activityName) === "failed") return {
+        mode: mode,
+        tone: "critical",
+        icon: void 0
+    };
+    const [semantic] = args.actionEval.semantics ?? [], face = semantic === void 0 ? void 0 : SEMANTIC_FACE[semantic];
+    return {
+        mode: mode,
+        tone: face?.tone ?? "default",
+        icon: face?.icon
     };
 }
 
@@ -958,10 +1029,19 @@ function personActor(user) {
     };
 }
 
+const memberIndexes = /* @__PURE__ */ new WeakMap;
+
+function memberIndex(members) {
+    const cached = memberIndexes.get(members);
+    if (cached) return cached;
+    const created = new Map(members.map(member => [ member.id, member ]));
+    return memberIndexes.set(members, created), created;
+}
+
 const selfUserFor = (id, me) => me != null && me.id === id ? me : void 0;
 
 function userDisplayFor(args) {
-    const member = args.members.find(m => m.id === args.id), self = selfUserFor(args.id, args.me);
+    const member = memberIndex(args.members).get(args.id), self = selfUserFor(args.id, args.me);
     return {
         id: args.id,
         name: member?.displayName ?? self?.name ?? args.id,
@@ -971,19 +1051,20 @@ function userDisplayFor(args) {
 
 function useUserDisplays(ids) {
     const {members: members} = useProjectMembers(), me = sanity.useCurrentUser();
-    return ids.map(id => userDisplayFor({
+    return react.useMemo(() => ids.map(id => userDisplayFor({
         id: id,
         members: members,
         me: me
-    }));
+    })), [ ids, me, members ]);
 }
 
 function useUserDisplay(id) {
-    const [display] = useUserDisplays([ id ]);
-    return display ?? {
-        name: id,
-        imageUrl: void 0
-    };
+    const {members: members} = useProjectMembers(), me = sanity.useCurrentUser();
+    return react.useMemo(() => userDisplayFor({
+        id: id,
+        members: members,
+        me: me
+    }), [ id, me, members ]);
 }
 
 function useAssignmentIdentity() {
@@ -994,8 +1075,12 @@ function useAssignmentIdentity() {
     };
 }
 
+const projectMembersByUsers = /* @__PURE__ */ new WeakMap;
+
 function projectMembersFrom(users) {
-    return users.map(({membership: membership, profile: profile}) => ({
+    const cached = projectMembersByUsers.get(users);
+    if (cached) return cached;
+    const members = users.map(({membership: membership, profile: profile}) => ({
         id: membership.id,
         displayName: profile?.displayName ?? membership.id,
         ...profile?.email ? {
@@ -1006,6 +1091,7 @@ function projectMembersFrom(users) {
         } : {},
         roles: (membership.roles ?? []).map(role => role.name)
     }));
+    return projectMembersByUsers.set(users, members), members;
 }
 
 function useProjectMembers() {
@@ -1447,7 +1533,7 @@ function DocPicker({value: value, onChange: onChange, types: types2, readOnly: r
         children: /* @__PURE__ */ jsxRuntime.jsx(ui.Box, {
             flex: 1,
             children: /* @__PURE__ */ jsxRuntime.jsx(PreviewOrId, {
-                id: workflowEngine.extractDocumentId(value.id),
+                id: workflowEngine.toBareId(value.id),
                 type: value.type
             })
         })
@@ -1543,7 +1629,7 @@ function DocRefsInput({value: value, onChange: onChange, types: types2}) {
             /* @__PURE__ */ jsxRuntime.jsx(ui.Box, {
                 flex: 1,
                 children: /* @__PURE__ */ jsxRuntime.jsx(PreviewOrId, {
-                    id: workflowEngine.extractDocumentId(ref.id),
+                    id: workflowEngine.toBareId(ref.id),
                     type: ref.type
                 })
             }), 
@@ -1697,6 +1783,15 @@ function useFireAction(args) {
     };
 }
 
+const ACTION_ICON_GAP = 2;
+
+function actionIconProps(icon) {
+    return icon ? {
+        gap: ACTION_ICON_GAP,
+        icon: icon
+    } : {};
+}
+
 function stopRowMouseDown(e) {
     e.preventDefault(), e.stopPropagation();
 }
@@ -1724,7 +1819,7 @@ function RowClickShield({active: active, children: children}) {
     });
 }
 
-function FireButton({instanceId: instanceId, activity: activity, action: action, label: label, mode: mode = "default", chrome: chrome, tone: tone = "default"}) {
+function FireButton({instanceId: instanceId, activity: activity, action: action, label: label, mode: mode = "default", chrome: chrome, tone: tone = "default", icon: icon}) {
     const {fire: fire, pending: pending} = useFireAction({
         instanceId: instanceId,
         activity: activity,
@@ -1736,6 +1831,7 @@ function FireButton({instanceId: instanceId, activity: activity, action: action,
     /* @__PURE__ */
     return jsxRuntime.jsx(ui.Button, {
         fontSize: 1,
+        ...actionIconProps(icon),
         loading: pending,
         mode: chrome?.mode ?? mode,
         onClick: handleClick,
@@ -1753,6 +1849,7 @@ function ActivityActionRow({actionEval: actionEval, instanceId: instanceId, acti
     const rowKind = actionRowKind(actionEval);
     return rowKind.kind === "disabled" ? /* @__PURE__ */ jsxRuntime.jsx(DisabledActionButton, {
         actionEval: actionEval,
+        activity: activity,
         chrome: chrome
     }) : rowKind.kind === "plain" ? /* @__PURE__ */ jsxRuntime.jsx(PlainActionButton, {
         actionEval: actionEval,
@@ -1767,13 +1864,18 @@ function ActivityActionRow({actionEval: actionEval, instanceId: instanceId, acti
     });
 }
 
-function DisabledActionButton({actionEval: actionEval, chrome: chrome}) {
-    const label = actionTriggerLabel(actionEval), button = /* @__PURE__ */ jsxRuntime.jsx(ui.Button, {
+function DisabledActionButton({actionEval: actionEval, activity: activity, chrome: chrome}) {
+    const label = actionTriggerLabel(actionEval), {tone: tone, icon: icon} = actionButtonFace({
+        actionEval: actionEval,
+        activityName: activity
+    }), button = /* @__PURE__ */ jsxRuntime.jsx(ui.Button, {
         fontSize: 1,
+        ...actionIconProps(icon),
         mode: chrome?.mode ?? "ghost",
         onClick: e => e.stopPropagation(),
         padding: 2,
         text: label,
+        tone: tone,
         ...spanTriggerProps(chrome),
         disabled: !0
     });
@@ -1784,11 +1886,12 @@ function DisabledActionButton({actionEval: actionEval, chrome: chrome}) {
 }
 
 function PlainActionButton({actionEval: actionEval, instanceId: instanceId, activity: activity, chrome: chrome}) {
-    const {action: action} = actionEval, label = actionLabel(action), btn = actionButtonTone({
+    const {action: action} = actionEval, label = actionLabel(action), btn = actionButtonFace({
         actionEval: actionEval,
         activityName: activity
     }), button = /* @__PURE__ */ jsxRuntime.jsx(FireButton, {
         action: action.name,
+        icon: btn.icon,
         instanceId: instanceId,
         label: label,
         mode: btn.mode,
@@ -1863,7 +1966,7 @@ function ParamsActionDialog({actionEval: actionEval, instanceId: instanceId, act
 }
 
 function ParamsActionButton({actionEval: actionEval, instanceId: instanceId, activity: activity, chrome: chrome}) {
-    const [open, setOpen] = react.useState(!1), btn = actionButtonTone({
+    const [open, setOpen] = react.useState(!1), btn = actionButtonFace({
         actionEval: actionEval,
         activityName: activity
     });
@@ -1872,6 +1975,7 @@ function ParamsActionButton({actionEval: actionEval, instanceId: instanceId, act
         children: [ 
         /* @__PURE__ */ jsxRuntime.jsx(ui.Button, {
             fontSize: 1,
+            ...actionIconProps(btn.icon),
             mode: chrome?.mode ?? btn.mode,
             onClick: e => {
                 chrome?.inButtonCard === !0 && e.stopPropagation(), setOpen(!0);
@@ -2697,7 +2801,7 @@ function ReadOnlyDocRefs({entry: entry}) {
             padding: 2,
             radius: 2,
             children: /* @__PURE__ */ jsxRuntime.jsx(PreviewOrId, {
-                id: workflowEngine.extractDocumentId(ref.id),
+                id: workflowEngine.toBareId(ref.id),
                 type: ref.type
             })
         }, ref.id))
@@ -4061,7 +4165,12 @@ const ACTIONS_MENU_TRIGGER = {
 };
 
 function ActionMenuItem({actionEval: actionEval, instanceId: instanceId, activity: activity, onCollectParams: onCollectParams}) {
-    const rowKind = actionRowKind(actionEval), label = actionTriggerLabel(actionEval), {fire: fire, pending: pending} = useFireAction({
+    const rowKind = actionRowKind(actionEval), label = actionTriggerLabel(actionEval), {tone: tone, icon: icon} = actionButtonFace({
+        actionEval: actionEval,
+        activityName: activity
+    }), iconProp = icon ? {
+        icon: icon
+    } : {}, {fire: fire, pending: pending} = useFireAction({
         instanceId: instanceId,
         activity: activity,
         action: actionEval.action.name,
@@ -4069,17 +4178,23 @@ function ActionMenuItem({actionEval: actionEval, instanceId: instanceId, activit
     });
     return rowKind.kind === "disabled" ? /* @__PURE__ */ jsxRuntime.jsx(ui.MenuItem, {
         disabled: !0,
-        text: label
+        ...iconProp,
+        text: label,
+        tone: tone
     }) : rowKind.kind === "plain" ? /* @__PURE__ */ jsxRuntime.jsx(ui.MenuItem, {
         disabled: pending,
+        ...iconProp,
         onClick: () => {
             fire();
         },
-        text: label
+        text: label,
+        tone: tone
     }) : /* @__PURE__ */ jsxRuntime.jsx(ui.MenuItem, {
         disabled: pending,
+        ...iconProp,
         onClick: onCollectParams,
-        text: label
+        text: label,
+        tone: tone
     });
 }
 
@@ -4192,6 +4307,7 @@ function FittedActions({actions: actions, activity: activity, instanceId: instan
         children: [ 
         /* @__PURE__ */ jsxRuntime.jsx(MeasureRow, {
             actions: actions,
+            activity: activity,
             onElement: setMeasureEl
         }), 
         /* @__PURE__ */ jsxRuntime.jsxs(FooterRow, {
@@ -4211,7 +4327,7 @@ function FittedActions({actions: actions, activity: activity, instanceId: instan
     });
 }
 
-function MeasureRow({actions: actions, onElement: onElement}) {
+function MeasureRow({actions: actions, activity: activity, onElement: onElement}) {
     /* @__PURE__ */
     return jsxRuntime.jsx("div", {
         "aria-hidden": !0,
@@ -4225,12 +4341,20 @@ function MeasureRow({actions: actions, onElement: onElement}) {
                 display: "inline-flex",
                 whiteSpace: "nowrap"
             },
-            children: [ actions.map(a => /* @__PURE__ */ jsxRuntime.jsx(ui.Button, {
-                as: "span",
-                fontSize: 1,
-                padding: 2,
-                text: actionTriggerLabel(a)
-            }, a.action.name)), 
+            children: [ actions.map(a => {
+                const {icon: icon} = actionButtonFace({
+                    actionEval: a,
+                    activityName: activity
+                });
+                /* @__PURE__ */
+                return jsxRuntime.jsx(ui.Button, {
+                    as: "span",
+                    fontSize: 1,
+                    ...actionIconProps(icon),
+                    padding: 2,
+                    text: actionTriggerLabel(a)
+                }, a.action.name);
+            }), 
             /* @__PURE__ */ jsxRuntime.jsx(ui.Button, {
                 ...ACTIONS_MENU_TRIGGER,
                 as: "span",
@@ -4512,7 +4636,26 @@ function CountedLabel({count: count, label: label}) {
     });
 }
 
-function GroupHeading({count: count, title: title, end: end}) {
+function SpinnerSlot({busy: busy, size: size}) {
+    /* @__PURE__ */
+    return jsxRuntime.jsx(ui.Flex, {
+        align: "center",
+        flex: "none",
+        justify: "center",
+        style: {
+            width: 19,
+            height: 19
+        },
+        children: busy ? /* @__PURE__ */ jsxRuntime.jsx(ui.Spinner, {
+            muted: !0,
+            ...size !== void 0 ? {
+                size: size
+            } : {}
+        }) : null
+    });
+}
+
+function GroupHeading({busy: busy, count: count, title: title, end: end}) {
     /* @__PURE__ */
     return jsxRuntime.jsxs(ui.Flex, {
         align: "center",
@@ -4527,6 +4670,9 @@ function GroupHeading({count: count, title: title, end: end}) {
                 weight: "semibold",
                 children: title
             })
+        }), busy === void 0 ? null : /* @__PURE__ */ jsxRuntime.jsx(SpinnerSlot, {
+            busy: busy,
+            size: 1
         }), end === void 0 ? null : /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, {
             children: [ 
             /* @__PURE__ */ jsxRuntime.jsx(ui.Flex, {
@@ -4649,6 +4795,18 @@ function TabSwitch({ariaControls: ariaControls, idPrefix: idPrefix, options: opt
     });
 }
 
+function useDelayedFlag(active, delayMs) {
+    const [held, setHeld] = react.useState(!1);
+    return react.useEffect(() => {
+        if (!active) {
+            setHeld(!1);
+            return;
+        }
+        const timer = setTimeout(() => setHeld(!0), delayMs);
+        return () => clearTimeout(timer);
+    }, [ active, delayMs ]), held && active;
+}
+
 function instanceTitle(instance, definition) {
     return definition?.title ?? instance.definition;
 }
@@ -5487,9 +5645,16 @@ function instanceNotice(entry) {
             size: 1,
             children: "This workflow didn’t finish starting — use Start workflow to continue it"
         })
-    }) : pending ? /* @__PURE__ */ jsxRuntime.jsx(LoadingRow, {
-        label: "Loading…",
-        padding: 4
+    }) : pending ? /* @__PURE__ */ jsxRuntime.jsx(WorkRow, {
+        lead: /* @__PURE__ */ jsxRuntime.jsx(ui.Spinner, {
+            muted: !0,
+            size: 1
+        }),
+        children: /* @__PURE__ */ jsxRuntime.jsx(ui.Text, {
+            muted: !0,
+            size: 1,
+            children: "Loading…"
+        })
     }) : null;
 }
 
@@ -6553,20 +6718,7 @@ function InstanceDebugMenu({entry: entry}) {
 }
 
 function InstanceAccordion({entry: entry, children: children, defaultOpen: defaultOpen}) {
-    const definition = useDefinition(entry), {instance: instance, ready: ready} = entry, settled = !isLiveEntry(entry), title = instanceTitle(instance, definition), badgeTrim = useBadgeCapTrim(), status = /* @__PURE__ */ jsxRuntime.jsxs(ui.Flex, {
-        align: "center",
-        gap: 2,
-        style: badgeTrim,
-        children: [ 
-        /* @__PURE__ */ jsxRuntime.jsx(AbortedBadge, {
-            instance: instance
-        }), settled ? null : /* @__PURE__ */ jsxRuntime.jsx(OlderDefinitionBadge, {
-            instance: instance
-        }), !ready && entry.invalid === void 0 ? /* @__PURE__ */ jsxRuntime.jsx(ui.Spinner, {
-            muted: !0,
-            size: 1
-        }) : null ]
-    });
+    const definition = useDefinition(entry), {instance: instance} = entry, settled = !isLiveEntry(entry), title = instanceTitle(instance, definition), badgeTrim = useBadgeCapTrim();
     /* @__PURE__ */
     return jsxRuntime.jsx(CollapsibleBand, {
         defaultOpen: defaultOpen ?? !settled,
@@ -6589,7 +6741,18 @@ function InstanceAccordion({entry: entry, children: children, defaultOpen: defau
                     textOverflow: "ellipsis",
                     weight: "medium",
                     children: title
-                }), status ]
+                }), 
+                /* @__PURE__ */ jsxRuntime.jsxs(ui.Flex, {
+                    align: "center",
+                    gap: 2,
+                    style: badgeTrim,
+                    children: [ 
+                    /* @__PURE__ */ jsxRuntime.jsx(AbortedBadge, {
+                        instance: instance
+                    }), settled ? null : /* @__PURE__ */ jsxRuntime.jsx(OlderDefinitionBadge, {
+                        instance: instance
+                    }) ]
+                }) ]
             }), 
             /* @__PURE__ */ jsxRuntime.jsx(TrailingHairline, {}), 
             /* @__PURE__ */ jsxRuntime.jsx(InstanceDebugMenu, {
@@ -6607,7 +6770,7 @@ function InstanceAccordion({entry: entry, children: children, defaultOpen: defau
 }
 
 function PartOfBand({instance: instance}) {
-    const parentRef = instance.ancestors.at(-1), parentId = parentRef ? workflowEngine.extractDocumentId(parentRef.id) : null, parentEntry = useWorkflowInstanceEntry(parentId), parentDefinition = useDefinition(parentEntry);
+    const parentRef = instance.ancestors.at(-1), parentId = parentRef ? workflowEngine.toBareId(parentRef.id) : null, parentEntry = useWorkflowInstanceEntry(parentId), parentDefinition = useDefinition(parentEntry);
     if (!parentId) return null;
     const title = parentEntry ? instanceTitle(parentEntry.instance, parentDefinition) : parentId;
     /* @__PURE__ */
@@ -7164,11 +7327,9 @@ const VIEW_TAB_CODEC = workflowsTabCodec([ "overview", "for-me" ]), WorkflowsVie
 };
 
 function DiscoverySpinner() {
-    const [visible, setVisible] = react.useState(!1);
-    return react.useEffect(() => {
-        const timer = setTimeout(() => setVisible(!0), 1e3);
-        return () => clearTimeout(timer);
-    }, []), /* @__PURE__ */ jsxRuntime.jsx(ui.Flex, {
+    const visible = useDelayedFlag(!0, 1e3);
+    /* @__PURE__ */
+    return jsxRuntime.jsx(ui.Flex, {
         align: "center",
         height: "fill",
         justify: "center",
@@ -7178,7 +7339,7 @@ function DiscoverySpinner() {
     });
 }
 
-const GROUP_GAP = 1;
+const BOOT_CUE_DELAY_MS = 400, GROUP_GAP = 1;
 
 function useWorkflowsTab() {
     const {params: params, setParams: setParams} = structure.usePaneRouter();
@@ -7203,7 +7364,7 @@ function useOpenActivity(entries) {
 }
 
 function WorkflowsPanel({entries: entries, documentId: documentId, docTypeMappings: docTypeMappings, initialValue: initialValue}) {
-    const identity = useAssignmentIdentity(), panelId = react.useId(), {params: params} = structure.usePaneRouter(), {view: view, setView: setView} = useWorkflowsTab(), {openActivity: openActivity, setOpenActivity: setOpenActivity, dialogEntry: dialogEntry} = useOpenActivity(entries), active = entries.filter(isLiveEntry), finished = entries.filter(e => !isLiveEntry(e)), forMe = forMeWorkOf(active, identity), [landing] = react.useState(() => focusedLanding(params?.[WORKFLOWS_FOCUS_PARAM], entries.map(e => e.instance._id))), assignedWorkUnknown = active.some(e => e.invalid !== void 0), sectionFor = e => /* @__PURE__ */ jsxRuntime.jsx(WorkflowInstanceSection, {
+    const identity = useAssignmentIdentity(), panelId = react.useId(), {params: params} = structure.usePaneRouter(), {view: view, setView: setView} = useWorkflowsTab(), {openActivity: openActivity, setOpenActivity: setOpenActivity, dialogEntry: dialogEntry} = useOpenActivity(entries), active = entries.filter(isLiveEntry), finished = entries.filter(e => !isLiveEntry(e)), forMe = forMeWorkOf(active, identity), [landing] = react.useState(() => focusedLanding(params?.[WORKFLOWS_FOCUS_PARAM], entries.map(e => e.instance._id))), assignedWorkUnknown = active.some(e => e.invalid !== void 0), booting = useDelayedFlag(active.some(e => !e.ready && e.invalid === void 0), BOOT_CUE_DELAY_MS), sectionFor = e => /* @__PURE__ */ jsxRuntime.jsx(WorkflowInstanceSection, {
         defaultOpen: landingDefaultOpen(landing, e.instance._id),
         entry: e,
         onOpenActivity: activityName => setOpenActivity({
@@ -7224,6 +7385,7 @@ function WorkflowsPanel({entries: entries, documentId: documentId, docTypeMappin
             padding: 3,
             children: [ 
             /* @__PURE__ */ jsxRuntime.jsx(GroupHeading, {
+                busy: booting,
                 count: active.length,
                 end: 
                 /* @__PURE__ */ jsxRuntime.jsx(ui.Box, {
@@ -7359,10 +7521,8 @@ function workflowsView(S) {
     return S.view.component(WorkflowsView).id(WORKFLOWS_VIEW_ID).title("Workflows");
 }
 
-function workflowDefaultDocumentNode(options) {
-    return (S, ctx) => {
-        if (mappingForDocType(options.mappings, ctx.schemaType)) return S.document().views([ S.view.form(), workflowsView(S) ]);
-    };
+function workflowDefaultDocumentNode() {
+    return S => S.document().views([ S.view.form(), workflowsView(S) ]);
 }
 
 function lockTitleFor(args) {
@@ -7375,26 +7535,12 @@ function lockTitleFor(args) {
     return workflows.length === 1 ? `The ${workflowList} workflow is holding this document.` : `The ${workflowList} workflows are holding this document.`;
 }
 
-const EMPTY = {
-    byType: /* @__PURE__ */ new Map,
-    definitions: /* @__PURE__ */ new Map,
-    warnings: []
-};
-
 function resolveAutoStart(args) {
-    const {autoStart: autoStart, context: context, knownDocTypes: knownDocTypes, definitions: definitions} = args;
-    if (autoStart === void 0) return EMPTY;
-    const evaluated = evaluateMap(autoStart, context);
-    if ("warning" in evaluated) return {
-        byType: /* @__PURE__ */ new Map,
-        definitions: /* @__PURE__ */ new Map,
-        warnings: [ evaluated.warning ]
-    };
-    const map = evaluated.map, latestByName = new Map(workflowEngine.latestDeployedDefinitions(definitions).map(d => [ d.name, d ])), byType = /* @__PURE__ */ new Map, resolvedDefinitions = /* @__PURE__ */ new Map, warnings = [];
-    for (const [docType, spec] of Object.entries(map)) {
+    const {autoStart: autoStart, knownDocTypes: knownDocTypes, definitions: definitions} = args, latestByName = new Map(workflowEngine.latestDeployedDefinitions(definitions).map(d => [ d.name, d ])), byType = /* @__PURE__ */ new Map, resolvedDefinitions = /* @__PURE__ */ new Map, warnings = [];
+    for (const [docType, names] of Object.entries(autoStart)) {
         const entry = resolveEntry({
             docType: docType,
-            spec: spec,
+            names: names,
             knownDocTypes: knownDocTypes,
             latestByName: latestByName
         });
@@ -7410,35 +7556,15 @@ function resolveAutoStart(args) {
     };
 }
 
-function evaluateMap(autoStart, context) {
-    let map;
-    try {
-        map = typeof autoStart == "function" ? autoStart(context) : autoStart;
-    } catch (err) {
-        return {
-            warning: `autoStart: config function threw — ignoring it (${describeError(err)}).`
-        };
-    }
-    return typeof map != "object" || map === null ? {
-        warning: "autoStart: config did not resolve to an object — ignoring it."
-    } : {
-        map: map
-    };
-}
-
-function specNames(spec) {
-    return typeof spec == "string" ? [ spec ] : Array.isArray(spec) ? spec : [];
-}
-
 function resolveEntry(args) {
-    const {docType: docType, spec: spec, knownDocTypes: knownDocTypes, latestByName: latestByName} = args;
+    const {docType: docType, names: names, knownDocTypes: knownDocTypes, latestByName: latestByName} = args;
     if (!knownDocTypes.has(docType)) return {
         valid: [],
         definitions: [],
         warnings: [ `autoStart: no schema type "${docType}" — entry skipped.` ]
     };
     const valid = [], definitions = [], warnings = [];
-    for (const name of specNames(spec)) {
+    for (const name of names) {
         const definition = latestByName.get(name), issue = workflowIssue({
             name: name,
             docType: docType,
@@ -7464,11 +7590,9 @@ function workflowIssue(args) {
     const {name: name, docType: docType, definition: definition} = args;
     if (definition === void 0) return `autoStart: "${docType}" → workflow "${name}" is not deployed — skipped.`;
     if (!workflowEngine.isStartableDefinition(definition)) return `autoStart: "${docType}" → workflow "${name}" is spawn-only, not startable — skipped.`;
-    if (!workflowEngine.acceptsDocumentType({
-        fields: [ ...definition.fields ?? [] ]
-    }, docType)) return `autoStart: "${docType}" → workflow "${name}" has no subject accepting "${docType}" — skipped.`;
-    const subject = (definition.fields ?? []).find(workflowEngine.isSubjectEntry);
-    if (subject !== void 0 && !workflowEngine.isInputSourced(subject)) return `autoStart: "${docType}" → workflow "${name}" has a self-filling subject (not caller-provided), so the document can't be its subject — skipped.`;
+    const subject = documentSubjectEntry(definition), acceptsType = subject?.types === void 0 || subject.types.includes(docType);
+    if (subject === void 0 || !acceptsType) return `autoStart: "${docType}" → workflow "${name}" has no document subject accepting "${docType}" — skipped.`;
+    if (!workflowEngine.isInputSourced(subject)) return `autoStart: "${docType}" → workflow "${name}" has a self-filling subject (not caller-provided), so the document can't be its subject — skipped.`;
 }
 
 function contentDocumentTypes(schema) {
@@ -7488,20 +7612,31 @@ const EMPTY_SNAPSHOT = {
 };
 
 function useDiscoveryState(args) {
-    const {registered: registered, requested: requested, contentResource: contentResource} = args, watching = registered.length + requested.length > 0, [latest, setLatest] = react.useState(EMPTY_SNAPSHOT), [resolved, setResolved] = react.useState(EMPTY_SNAPSHOT), onSnapshot = react.useCallback(snapshot => {
-        setLatest(snapshot), snapshot.instances !== void 0 && setResolved(snapshot);
-    }, []);
-    react.useEffect(() => {
-        watching || (setLatest(EMPTY_SNAPSHOT), setResolved(EMPTY_SNAPSHOT));
-    }, [ watching ]);
-    const filter = react.useMemo(() => ({
-        documents: registered.map(id => workflowEngine.gdrFromResource(contentResource, id)),
+    const {observed: observed, requested: requested, contentResource: contentResource} = args, documentWatching = observed.length > 0, requestedWatching = requested.length > 0, documents = useDiscoveryStream(documentWatching), explicit = useDiscoveryStream(requestedWatching), documentFilter = react.useMemo(() => documentWatching ? {
+        documents: observed.map(id => workflowEngine.gdrFromResource(contentResource, id)),
+        includeCompleted: !0
+    } : void 0, [ documentWatching, observed, contentResource ]), requestedFilter = react.useMemo(() => requestedWatching ? {
         ids: requested,
         includeCompleted: !0
-    }), [ registered, requested, contentResource ]);
+    } : void 0, [ requestedWatching, requested ]), resolved = react.useMemo(() => mergeResolved(documents.resolved, explicit.resolved), [ documents.resolved, explicit.resolved ]);
     return {
-        watching: watching,
-        filter: filter,
+        documentFilter: documentFilter,
+        requestedFilter: requestedFilter,
+        loading: documents.loading || explicit.loading,
+        invalid: documents.invalid ?? explicit.invalid,
+        resolved: resolved,
+        onDocumentSnapshot: documents.onSnapshot,
+        onRequestedSnapshot: explicit.onSnapshot
+    };
+}
+
+function useDiscoveryStream(watching) {
+    const [latest, setLatest] = react.useState(EMPTY_SNAPSHOT), [resolved, setResolved] = react.useState(EMPTY_SNAPSHOT), onSnapshot = react.useCallback(snapshot => {
+        setLatest(snapshot), snapshot.instances !== void 0 && setResolved(snapshot);
+    }, []);
+    return react.useEffect(() => {
+        watching || (setLatest(EMPTY_SNAPSHOT), setResolved(EMPTY_SNAPSHOT));
+    }, [ watching ]), {
         loading: watching && latest.instances === void 0 && latest.invalid === void 0,
         invalid: watching ? latest.invalid : void 0,
         resolved: resolved,
@@ -7509,18 +7644,62 @@ function useDiscoveryState(args) {
     };
 }
 
-function indexDiscoveredInstances(args) {
-    const {instances: instances, registered: registered, contentResource: contentResource} = args, ordered = [ ...instances ].sort((a, b) => b.startedAt.localeCompare(a.startedAt)), index = /* @__PURE__ */ new Map;
-    for (const bareId of registered) {
-        const uri = workflowEngine.gdrFromResource(contentResource, bareId), watching = ordered.filter(inst => workflowEngine.instanceWatchesDocument(inst, uri));
-        watching.length > 0 && index.set(bareId, watching.map(inst => inst._id));
+function mergeResolved(documents, explicit) {
+    const rows = [ ...documents.instances ?? [], ...explicit.instances ?? [] ], freshest = /* @__PURE__ */ new Map;
+    for (const instance of rows) {
+        const current = freshest.get(instance._id);
+        (current === void 0 || Date.parse(instance.lastChangedAt) > Date.parse(current.lastChangedAt)) && freshest.set(instance._id, instance);
     }
+    return {
+        instances: documents.instances === void 0 && explicit.instances === void 0 ? void 0 : [ ...freshest.values() ],
+        invalid: documents.invalid ?? explicit.invalid,
+        registered: documents.registered
+    };
+}
+
+function createDiscoveryIndexer(deriveWatchSet = workflowEngine.subscriptionDocumentsForInstance) {
+    const cached = /* @__PURE__ */ new Map;
+    return {
+        index(args) {
+            const liveIds = new Set(args.instances.map(instance => instance._id));
+            for (const id of cached.keys()) liveIds.has(id) || cached.delete(id);
+            const watchedById = /* @__PURE__ */ new Map;
+            for (const instance of args.instances) {
+                let row = cached.get(instance._id);
+                row?.source !== instance && (row = {
+                    source: instance,
+                    globalDocumentIds: [ ...new Set(deriveWatchSet(instance).documents.map(document => document.globalDocumentId)) ]
+                }, cached.set(instance._id, row)), watchedById.set(instance._id, row.globalDocumentIds);
+            }
+            return buildDiscoveryIndex(args, watchedById);
+        }
+    };
+}
+
+function buildDiscoveryIndex(args, watchedById) {
+    const {instances: instances, registered: registered, contentResource: contentResource} = args, ordered = [ ...instances ].sort((a, b) => b.startedAt.localeCompare(a.startedAt)), index = /* @__PURE__ */ new Map, registeredByUri = new Map(registered.map(bareId => [ workflowEngine.gdrFromResource(contentResource, bareId), bareId ]));
+    for (const instance of ordered) appendInstanceWatches({
+        index: index,
+        registeredByUri: registeredByUri,
+        instanceId: instance._id,
+        watched: watchedById.get(instance._id) ?? []
+    });
     return {
         instances: new Map(ordered.map(inst => [ inst._id, inst ])),
         index: index
     };
 }
 
+function appendInstanceWatches(args) {
+    const {index: index, registeredByUri: registeredByUri, instanceId: instanceId, watched: watched} = args;
+    for (const uri of watched) {
+        const bareId = registeredByUri.get(uri);
+        if (bareId === void 0) continue;
+        const ids = index.get(bareId);
+        ids === void 0 ? index.set(bareId, [ instanceId ]) : ids.push(instanceId);
+    }
+}
+
 function sameInstance(a, b) {
     return a === b || a._id === b._id && a._rev === b._rev;
 }
@@ -7544,7 +7723,7 @@ function entryOf(inst, report) {
         instance: report?.evaluation?.instance ?? inst,
         committed: inst,
         evaluation: report?.evaluation,
-        ready: report?.ready ?? !1,
+        ready: report?.ready ?? workflowEngine.terminalState(inst) !== "in-flight",
         invalid: report?.invalid,
         guards: report?.guards
     };
@@ -7637,7 +7816,19 @@ function createEntriesStore() {
     };
 }
 
-const notReady = (..._args) => Promise.reject(new Error("workflow session not ready yet"));
+function sessionPlan(args) {
+    const demandedIds = new Set(args.demanded), evaluated = [ ...args.discovered.values() ].filter(inst => demandedIds.has(inst._id));
+    return {
+        evaluated: evaluated,
+        guardScope: evaluated.map(inst => inst._id).sort()
+    };
+}
+
+function useDefaultLayout(props) {
+    return react.useMemo(() => props.renderDefault(props), [ props ]);
+}
+
+const notReady = (..._args) => Promise.reject(new Error("workflow session not ready yet")), NO_REGISTERED_DOCUMENTS = [], DEMAND_RELEASE_GRACE_MS = 500;
 
 function workspaceParts(config) {
     if (!config.projectId || !config.dataset) throw new Error("workflow plugin requires a workspace with projectId and dataset");
@@ -7665,10 +7856,11 @@ class InstanceEvaluatorBoundary extends react.Component {
 }
 
 function InstanceEvaluator(props) {
-    const {engine: engine, instanceId: instanceId, grantsFromPath: grantsFromPath, onReport: onReport} = props, {evaluation: evaluation, ready: ready, invalid: invalid, guards: guards, fireAction: fireAction, editField: editField, previewField: previewField, discardFieldPreview: discardFieldPreview} = workflowStudio.useWorkflowSession({
+    const {engine: engine, instanceId: instanceId, grantsFromPath: grantsFromPath, guardScope: guardScope, onReport: onReport} = props, {evaluation: evaluation, ready: ready, invalid: invalid, guards: guards, fireAction: fireAction, editField: editField, previewField: previewField, discardFieldPreview: discardFieldPreview} = workflowStudio.useWorkflowSession({
         engine: engine,
         instanceId: instanceId,
-        grantsFromPath: grantsFromPath
+        grantsFromPath: grantsFromPath,
+        guardScope: guardScope
     });
     return react.useEffect(() => {
         onReport(instanceId, {
@@ -7712,9 +7904,9 @@ function engineOptionsFrom(config) {
 }
 
 function WorkflowProvider(props) {
-    const {config: config} = props, studioClient = sanity.useClient({
+    const {config: config} = props, defaultLayout = useDefaultLayout(props), studioClient = sanity.useClient({
         apiVersion: WORKFLOW_API_VERSION
-    }), schema = sanity.useSchema(), {name: workspaceName} = sanity.useWorkspace(), {projectId: projectId, dataset: contentDataset} = workspaceParts(studioClient.config()), workflowDataset = config.workflowDataset ?? contentDataset, binding = react.useMemo(() => ({
+    }), schema = sanity.useSchema(), {projectId: projectId, dataset: contentDataset} = workspaceParts(studioClient.config()), workflowDataset = config.workflowDataset ?? contentDataset, binding = react.useMemo(() => ({
         engineResource: {
             type: "dataset",
             id: `${projectId}.${workflowDataset}`
@@ -7732,7 +7924,15 @@ function WorkflowProvider(props) {
     }), grantsFromPath = workflowEngine.aclPathForResource({
         type: "dataset",
         id: `${projectId}.${workflowDataset}`
-    }), {ids: registered, acquire: register, release: unregister} = workflowReact.useRefcountedIds(), {ids: requested, acquire: requestInstance, release: releaseInstance} = workflowReact.useRefcountedIds(), [seeded, setSeeded] = react.useState(/* @__PURE__ */ new Map), seedInstance = react.useCallback(instance => {
+    }), {ids: registered, acquire: registerActive, release: unregisterActive} = workflowReact.useRefcountedIds(), {ids: observed, acquire: retainRegistration, release: releaseRegistration} = workflowReact.useRefcountedIds({
+        releaseDelayMs: DEMAND_RELEASE_GRACE_MS
+    }), register = react.useCallback(id => {
+        registerActive(id), retainRegistration(id);
+    }, [ registerActive, retainRegistration ]), unregister = react.useCallback(id => {
+        unregisterActive(id), releaseRegistration(id);
+    }, [ unregisterActive, releaseRegistration ]), {ids: requested, acquire: requestInstance, release: releaseInstance} = workflowReact.useRefcountedIds(), {ids: evaluationDemand, acquire: requestEvaluation, release: releaseEvaluation} = workflowReact.useRefcountedIds({
+        releaseDelayMs: DEMAND_RELEASE_GRACE_MS
+    }), [seeded, setSeeded] = react.useState(/* @__PURE__ */ new Map), seedInstance = react.useCallback(instance => {
         setSeeded(prev => new Map(prev).set(instance._id, instance));
     }, []), [startRequest2, setStartRequest] = react.useState(void 0), openStartDialog = react.useCallback(r => setStartRequest(r), []), closeStartDialog = react.useCallback(() => setStartRequest(void 0), []), [entriesStore] = react.useState(createEntriesStore);
     react.useEffect(() => () => entriesStore.dispose(), [ entriesStore ]);
@@ -7783,15 +7983,18 @@ function WorkflowProvider(props) {
         });
     }, [ engine ]);
     drainRef.current = drainEffectsFor;
-    const {watching: watching, filter: filter, loading: loading, invalid: discoveryInvalid, resolved: resolved, onSnapshot: onSnapshot} = useDiscoveryState({
-        registered: registered,
+    const {documentFilter: documentFilter, requestedFilter: requestedFilter, loading: loading, invalid: discoveryInvalid, resolved: resolved, onDocumentSnapshot: onDocumentSnapshot, onRequestedSnapshot: onRequestedSnapshot} = useDiscoveryState({
+        observed: observed,
         requested: requested,
         contentResource: binding.contentResource
-    }), {instances: discovered, index: docIndex} = react.useMemo(() => indexDiscoveredInstances({
+    }), discoveryIndexer = react.useMemo(createDiscoveryIndexer, []), {instances: discovered, index: docIndex} = react.useMemo(() => discoveryIndexer.index({
         instances: resolved.instances ?? [],
         registered: resolved.registered,
         contentResource: binding.contentResource
-    }), [ resolved, binding.contentResource ]), resolvedDocs = react.useMemo(() => new Set(resolved.registered), [ resolved.registered ]);
+    }), [ discoveryIndexer, resolved, binding.contentResource ]), {evaluated: evaluated, guardScope: guardScope} = react.useMemo(() => sessionPlan({
+        discovered: discovered,
+        demanded: evaluationDemand
+    }), [ discovered, evaluationDemand ]), resolvedDocs = react.useMemo(() => new Set(resolved.registered), [ resolved.registered ]);
     react.useEffect(() => {
         setSeeded(prev => {
             const kept = [ ...prev ].filter(([id]) => !discovered.has(id));
@@ -7804,15 +8007,13 @@ function WorkflowProvider(props) {
             docIndex: docIndex
         });
     }, [ entriesStore, seeded, discovered, docIndex ]);
-    const isDocResolved = react.useCallback(docId => resolvedDocs.has(docId), [ resolvedDocs ]), schemaContentTypes = react.useMemo(() => new Set(contentDocumentTypes(schema)), [ schema ]), {issues: issues, starts: starts, fields: fields, latestVersions: latestVersions, autoStartByType: autoStartByType, autoStartDefinitions: autoStartDefinitions} = useDeployedDefinitions({
+    const isDocResolved = react.useCallback(docId => resolvedDocs.has(docId), [ resolvedDocs ]), schemaContentTypes = react.useMemo(() => new Set(contentDocumentTypes(schema)), [ schema ]), {mappings: mappings, issues: issues, starts: starts, fields: fields, latestVersions: latestVersions, autoStartByType: autoStartByType, autoStartDefinitions: autoStartDefinitions} = useDeployedDefinitions({
         engine: engine,
-        mappings: config.mappings,
+        overrides: config.mappings,
         contentResource: binding.contentResource,
         schemaContentTypes: schemaContentTypes,
         startRequest: startRequest2,
-        autoStart: config.autoStart,
-        schema: schema,
-        workspaceName: workspaceName
+        schema: schema
     }), value = react.useMemo(() => ({
         register: register,
         unregister: unregister,
@@ -7820,6 +8021,8 @@ function WorkflowProvider(props) {
         entries: entriesStore,
         requestInstance: requestInstance,
         releaseInstance: releaseInstance,
+        requestEvaluation: requestEvaluation,
+        releaseEvaluation: releaseEvaluation,
         seedInstance: seedInstance,
         openStartDialog: openStartDialog,
         closeStartDialog: closeStartDialog,
@@ -7834,7 +8037,7 @@ function WorkflowProvider(props) {
         completeEffectFor: completeEffectFor,
         engine: engine,
         binding: binding,
-        mappings: config.mappings,
+        mappings: mappings,
         mappingIssues: issues,
         mappingStarts: starts,
         mappingFields: fields,
@@ -7842,24 +8045,30 @@ function WorkflowProvider(props) {
         effectHandlers: engine.effectHandlers,
         autoStartByType: autoStartByType,
         autoStartDefinitions: autoStartDefinitions
-    }), [ register, unregister, isDocResolved, entriesStore, requestInstance, releaseInstance, seedInstance, openStartDialog, closeStartDialog, startRequest2, loading, discoveryInvalid, fireActionFor, editFieldFor, previewFieldFor, discardFieldPreviewFor, drainEffectsFor, completeEffectFor, engine, binding, config.mappings, issues, starts, latestVersions, autoStartByType, autoStartDefinitions ]);
+    }), [ register, unregister, isDocResolved, entriesStore, requestInstance, releaseInstance, requestEvaluation, releaseEvaluation, seedInstance, openStartDialog, closeStartDialog, startRequest2, loading, discoveryInvalid, fireActionFor, editFieldFor, previewFieldFor, discardFieldPreviewFor, drainEffectsFor, completeEffectFor, engine, binding, mappings, issues, starts, fields, latestVersions, autoStartByType, autoStartDefinitions ]);
     /* @__PURE__ */
     return jsxRuntime.jsxs(WorkflowContext.Provider, {
         value: value,
-        children: [ watching ? /* @__PURE__ */ jsxRuntime.jsx(DiscoverySubscription, {
+        children: [ documentFilter ? /* @__PURE__ */ jsxRuntime.jsx(DiscoverySubscription, {
             engine: engine,
-            filter: filter,
-            onSnapshot: onSnapshot,
+            filter: documentFilter,
+            onSnapshot: onDocumentSnapshot,
             registered: registered
-        }) : null, [ ...discovered.values() ].map(inst => /* @__PURE__ */ jsxRuntime.jsx(InstanceEvaluatorBoundary, {
+        }) : null, requestedFilter ? /* @__PURE__ */ jsxRuntime.jsx(DiscoverySubscription, {
+            engine: engine,
+            filter: requestedFilter,
+            onSnapshot: onRequestedSnapshot,
+            registered: NO_REGISTERED_DOCUMENTS
+        }) : null, evaluated.map(inst => /* @__PURE__ */ jsxRuntime.jsx(InstanceEvaluatorBoundary, {
             instanceId: inst._id,
             children: /* @__PURE__ */ jsxRuntime.jsx(InstanceEvaluator, {
                 engine: engine,
                 grantsFromPath: grantsFromPath,
+                guardScope: guardScope,
                 instanceId: inst._id,
                 onReport: onReport
             })
-        }, inst._id)), props.renderDefault(props), props.overlay ]
+        }, inst._id)), defaultLayout, props.overlay ]
     });
 }
 
@@ -7869,14 +8078,25 @@ function sameEntries(a, b) {
     return !0;
 }
 
+function sameMappings(a, b) {
+    return a.length === b.length && a.every((mapping, index) => {
+        const other = b[index];
+        return other !== void 0 && mappingKey(mapping) === mappingKey(other) && mapping.label === other.label && mapping.autoStart === other.autoStart && mapping.initialStateBuilder === other.initialStateBuilder && mapping.contextBuilder === other.contextBuilder && mapping.perspectiveField === other.perspectiveField;
+    });
+}
+
 function useDeployedDefinitions(args) {
-    const {engine: engine, mappings: mappings, contentResource: contentResource, schemaContentTypes: schemaContentTypes, startRequest: startRequest2, autoStart: autoStart, schema: schema, workspaceName: workspaceName} = args, [issues, setIssues] = react.useState(/* @__PURE__ */ new Map), [starts, setStarts] = react.useState(/* @__PURE__ */ new Map), [fields, setFields] = react.useState(/* @__PURE__ */ new Map), [latestVersions, setLatestVersions] = react.useState(/* @__PURE__ */ new Map), [autoStartByType, setAutoStartByType] = react.useState(
+    const {engine: engine, overrides: overrides, contentResource: contentResource, schemaContentTypes: schemaContentTypes, startRequest: startRequest2, schema: schema} = args, [mappings, setMappings] = react.useState([]), [issues, setIssues] = react.useState(/* @__PURE__ */ new Map), [starts, setStarts] = react.useState(/* @__PURE__ */ new Map), [fields, setFields] = react.useState(/* @__PURE__ */ new Map), [latestVersions, setLatestVersions] = react.useState(/* @__PURE__ */ new Map), [autoStartByType, setAutoStartByType] = react.useState(
     /* @__PURE__ */ new Map), [autoStartDefinitions, setAutoStartDefinitions] = react.useState(/* @__PURE__ */ new Map), logged = react.useRef(/* @__PURE__ */ new Set);
     return react.useEffect(() => {
         let cancelled = !1;
         return (async () => {
-            const definitions = await readDeployedDefinitions(engine), found = mappingIssues({
-                mappings: mappings,
+            const definitions = await readDeployedDefinitions(engine), effectiveMappings = discoverWorkflowMappings({
+                definitions: definitions,
+                schemaContentTypes: schemaContentTypes,
+                overrides: overrides
+            }), found = mappingIssues({
+                mappings: effectiveMappings,
                 definitions: definitions,
                 contentResource: contentResource,
                 schemaContentTypes: schemaContentTypes
@@ -7886,32 +8106,30 @@ function useDeployedDefinitions(args) {
                 logged.current.has(signature) || (logged.current.add(signature), console.error(`[workflow-studio-plugin] ${message}`));
             }
             const resolvedAutoStart = resolveAutoStart({
-                autoStart: autoStart,
-                context: {
-                    workspaceName: workspaceName,
-                    schema: schema
-                },
+                autoStart: mappingAutoStartMap(effectiveMappings),
                 knownDocTypes: new Set(schema.getTypeNames()),
                 definitions: definitions
             });
             if (logOnce(resolvedAutoStart.warnings, logged.current), cancelled) return;
+            setMappings(prev => sameMappings(prev, effectiveMappings) ? prev : effectiveMappings), 
             setIssues(prev => sameEntries(prev, found) ? prev : found), setStarts(mappingStartBlocks({
-                mappings: mappings,
+                mappings: effectiveMappings,
                 definitions: definitions
             })), setFields(mappingDeclaredFields({
-                mappings: mappings,
+                mappings: effectiveMappings,
                 definitions: definitions
             }));
             const versions = new Map(workflowEngine.latestDeployedDefinitions(definitions).map(d => [ d.name, d.version ]));
             setLatestVersions(prev => sameEntries(prev, versions) ? prev : versions), setAutoStartByType(resolvedAutoStart.byType), 
             setAutoStartDefinitions(resolvedAutoStart.definitions);
         })().catch(err => {
-            console.error("[workflow-studio-plugin] mapping validation could not read the deployed definitions — keeping the previous verdicts:", err);
+            console.error("[workflow-studio-plugin] mapping discovery failed — keeping the last resolved workflow state:", err);
         }), () => {
             cancelled = !0;
         };
-    }, [ engine, mappings, contentResource, schemaContentTypes, startRequest2, autoStart, schema, workspaceName ]), 
+    }, [ engine, overrides, contentResource, schemaContentTypes, startRequest2, schema ]), 
     {
+        mappings: mappings,
         issues: issues,
         starts: starts,
         fields: fields,
@@ -8697,7 +8915,7 @@ function isFreshDocument(value) {
 }
 
 function subjectEntry(definition) {
-    return (definition.fields ?? []).find(workflowEngine.isSubjectEntry);
+    return documentSubjectEntry(definition);
 }
 
 function autoStartInputs(args) {
@@ -8724,11 +8942,11 @@ function pendingWorkflows(workflows, live) {
 }
 
 function extraRequiredInputs(definition) {
-    const fields = definition.fields ?? [], subjectNames = new Set(fields.filter(workflowEngine.isSubjectEntry).map(entry => entry.name)), requiredNames = new Set(workflowEngine.missingRequiredInputs({
+    const fields = definition.fields ?? [], subjectName = subjectEntry(definition)?.name, requiredNames = new Set(workflowEngine.missingRequiredInputs({
         entryDefs: fields,
         initialFields: []
     }).map(input => input.name));
-    return fields.filter(entry => requiredNames.has(entry.name) && !subjectNames.has(entry.name));
+    return fields.filter(entry => requiredNames.has(entry.name) && entry.name !== subjectName);
 }
 
 function buildAutoStartRequests(args) {
@@ -8776,7 +8994,7 @@ function AutoStartDriver(props) {
     const pending = react.useMemo(() => pendingWorkflows(workflows, new Set(entries.map(entry => entry.instance.definition))), [ workflows, entries ]), inputs = react.useMemo(() => autoStartInputs({
         workflows: pending,
         definitions: autoStartDefinitions
-    }), [ pending, autoStartDefinitions ]), pendingRef = react.useRef(pending);
+    }), [ pending, autoStartDefinitions ]), definitionsResolved = workflows.every(name => autoStartDefinitions.has(name)), pendingRef = react.useRef(pending);
     pendingRef.current = pending;
     const instanceIds = react.useRef(/* @__PURE__ */ new Map), instanceIdFor = react.useCallback(workflow => {
         const held = instanceIds.current.get(workflow);
@@ -8820,7 +9038,7 @@ function AutoStartDriver(props) {
     }, [ autoStartDefinitions, docId, docType, binding, engine, observer, seedInstance, instanceIdFor, selectedReleaseId ]), retry = react.useCallback(() => {
         firedRef.current = !1, setFired(!1), setSettled(!1), setFailure(void 0);
     }, []), action = autoStartAction({
-        resolved: isDocResolved(docId),
+        resolved: definitionsResolved && isDocResolved(docId),
         pendingCount: pending.length,
         needsInput: inputs.length > 0,
         fired: fired,
@@ -9242,6 +9460,61 @@ function TaskCountSpinner({entry: entry}) {
     });
 }
 
+function stagePillState(instance) {
+    const definition = definitionSnapshotOf(instance), stage = definition?.stages.find(candidate => candidate.name === instance.currentStage), state = workflowEngine.terminalState(instance);
+    return {
+        title: stageTitle(definition, instance.currentStage),
+        terminal: stage !== void 0 && workflowEngine.isTerminalStage(stage) || state !== "in-flight",
+        state: state,
+        stageKnown: stage !== void 0
+    };
+}
+
+function WorkflowStagePreview(props) {
+    const {mappings: mappings} = useWorkflowContext(), mapped = props.schemaType !== void 0 && mappingsForDocType(mappings, props.schemaType.name).length > 0, {entries: entries} = useCommittedWorkflowsForDocument(mapped ? props._id ?? null : null), lead = entries.find(isLiveEntry) ?? entries[0], extraLive = entries.filter(e => e !== lead && isLiveEntry(e)).length;
+    return props.renderDefault({
+        ...props,
+        status: lead ? /* @__PURE__ */ jsxRuntime.jsx(StagePill, {
+            entry: lead,
+            extraLive: extraLive
+        }) : props.status
+    });
+}
+
+function StagePill({entry: entry, extraLive: extraLive}) {
+    /* @__PURE__ */
+    return jsxRuntime.jsxs(ui.Flex, {
+        align: "center",
+        gap: 2,
+        children: [ 
+        /* @__PURE__ */ jsxRuntime.jsx(LeadBadge, {
+            entry: entry
+        }), extraLive > 0 ? /* @__PURE__ */ jsxRuntime.jsxs(ui.Badge, {
+            fontSize: 1,
+            mode: "outline",
+            tone: "default",
+            children: [ "+", extraLive ]
+        }) : null ]
+    });
+}
+
+function LeadBadge({entry: entry}) {
+    const {instance: instance} = entry;
+    if (workflowEngine.isUnprimed(instance)) /* @__PURE__ */ return jsxRuntime.jsx(StartIncompleteBadge, {});
+    const pill = stagePillState(instance);
+    /* @__PURE__ */
+    return jsxRuntime.jsxs(ui.Badge, {
+        fontSize: 1,
+        mode: pill.terminal ? "default" : "outline",
+        tone: pillTone(pill),
+        children: [ pill.title, pill.state === "completed" ? " ✓" : "" ]
+    });
+}
+
+function pillTone(args) {
+    return args.state === "aborted" ? "critical" : args.terminal ? "positive" : args.stageKnown ? "primary" : "default";
+}
+
 function StartWorkflowDialogHost() {
     const {startRequest: startRequest2, closeStartDialog: closeStartDialog} = useWorkflowContext();
     return startRequest2 ? /* @__PURE__ */ jsxRuntime.jsx(StartWorkflowDialog, {
@@ -9316,7 +9589,8 @@ function withWorkflowLock(Action, guardAction) {
     Locked;
 }
 
-const workflowStudioPlugin = sanity.definePlugin(config => ({
+const workflowStudioPlugin = sanity.definePlugin(config => (assertUniqueWorkflowMappings(config.mappings ?? []), 
+{
     name: "workflow-studio-plugin",
     tools: prev => [ ...prev, workflowsTool ],
     studio: {
@@ -9330,84 +9604,37 @@ const workflowStudioPlugin = sanity.definePlugin(config => ({
     },
     form: {
         components: {
-            input: props => {
-                if (props.id === "root" && sanity.isObjectInputProps(props)) {
-                    const docTypeMappings = mappingsForDocType(config.mappings, props.schemaType.name), fallback = docTypeMappings.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(WorkflowFormStrip, {
-                        ...props,
-                        mappings: docTypeMappings
-                    }) : props.renderDefault(props);
-                    /* @__PURE__ */
-                    return jsxRuntime.jsx(AutoStartGate, {
-                        ...props,
-                        fallback: fallback
-                    });
-                }
-                return props.renderDefault(props);
-            }
+            preview: WorkflowStagePreview,
+            input: props => props.id === "root" && sanity.isObjectInputProps(props) ? /* @__PURE__ */ jsxRuntime.jsx(WorkflowRootInput, {
+                ...props
+            }) : props.renderDefault(props)
         }
     },
     document: {
         badges: (prev, ctx) => {
-            if (!mappingForDocType(config.mappings, ctx.schemaType) || !ctx.documentId) return prev;
+            if (!ctx.documentId) return prev;
             const docId = ctx.documentId;
             return [ makeActiveWorkflowsBadge(docId), makePerspectiveBadge(docId), ...prev ];
         },
-        actions: (prev, ctx) => mappingForDocType(config.mappings, ctx.schemaType) ? prev.map(Action => {
+        actions: prev => prev.map(Action => {
             const guardAction = Action.action ? LOCKABLE_ACTIONS.get(Action.action) : void 0;
             return guardAction ? withWorkflowLock(Action, guardAction) : Action;
-        }) : prev
+        })
     }
 }));
 
-function WorkflowStagePreview(props) {
-    const {entries: entries} = useWorkflowsForDocument(props.documentId ?? props._id ?? null), lead = entries.find(isLiveEntry) ?? entries[0], extraLive = entries.filter(e => e !== lead && isLiveEntry(e)).length;
-    return props.renderDefault({
+function WorkflowRootInput(props) {
+    const {mappings: mappings} = useWorkflowContext(), docTypeMappings = mappingsForDocType(mappings, props.schemaType.name), fallback = docTypeMappings.length > 0 ? /* @__PURE__ */ jsxRuntime.jsx(WorkflowFormStrip, {
         ...props,
-        status: lead ? /* @__PURE__ */ jsxRuntime.jsx(StagePill, {
-            entry: lead,
-            extraLive: extraLive
-        }) : props.status
-    });
-}
-
-function StagePill({entry: entry, extraLive: extraLive}) {
-    /* @__PURE__ */
-    return jsxRuntime.jsxs(ui.Flex, {
-        align: "center",
-        gap: 2,
-        children: [ 
-        /* @__PURE__ */ jsxRuntime.jsx(LeadBadge, {
-            entry: entry
-        }), extraLive > 0 ? /* @__PURE__ */ jsxRuntime.jsxs(ui.Badge, {
-            fontSize: 1,
-            mode: "outline",
-            tone: "default",
-            children: [ "+", extraLive ]
-        }) : null ]
-    });
-}
-
-function LeadBadge({entry: entry}) {
-    const {instance: instance, evaluation: evaluation} = entry;
-    if (workflowEngine.isUnprimed(instance)) /* @__PURE__ */ return jsxRuntime.jsx(StartIncompleteBadge, {});
-    const stage = evaluation?.currentStage?.stage, title = stage?.title ?? stageTitle(definitionSnapshotOf(instance), instance.currentStage), state = workflowEngine.terminalState(instance), isTerminal = (stage ? workflowEngine.isTerminalStage(stage) : !1) || state !== "in-flight";
+        mappings: docTypeMappings
+    }) : props.renderDefault(props);
     /* @__PURE__ */
-    return jsxRuntime.jsxs(ui.Badge, {
-        fontSize: 1,
-        mode: isTerminal ? "default" : "outline",
-        tone: pillTone({
-            state: state,
-            isTerminal: isTerminal,
-            stageKnown: stage !== void 0
-        }),
-        children: [ title, state === "completed" ? " ✓" : "" ]
+    return jsxRuntime.jsx(AutoStartGate, {
+        ...props,
+        fallback: fallback
     });
 }
 
-function pillTone(args) {
-    return args.state === "aborted" ? "critical" : args.isTerminal ? "positive" : args.stageKnown ? "primary" : "default";
-}
-
 exports.AbortedBadge = AbortedBadge;
 
 exports.ActivitiesList = ActivitiesList;
@@ -9436,6 +9663,8 @@ exports.LinkChip = LinkChip;
 
 exports.LoadingRow = LoadingRow;
 
+exports.SpinnerSlot = SpinnerSlot;
+
 exports.StageChip = StageChip;
 
 exports.StageFace = StageFace;
@@ -9450,8 +9679,6 @@ exports.TrailingHairline = TrailingHairline;
 
 exports.UnreadableDocsNote = UnreadableDocsNote;
 
-exports.WorkflowStagePreview = WorkflowStagePreview;
-
 exports.activityRowProps = activityRowProps;
 
 exports.assigneeUserIdsOf = assigneeUserIdsOf;
@@ -9488,8 +9715,6 @@ exports.isEvaluationStale = isEvaluationStale;
 
 exports.isOpenActivityStatus = isOpenActivityStatus;
 
-exports.mappingForDocType = mappingForDocType;
-
 exports.openActivityGone = openActivityGone;
 
 exports.parseDateFieldValue = parseDateFieldValue;
@@ -9528,8 +9753,6 @@ exports.useWorkflowInstanceEntry = useWorkflowInstanceEntry;
 
 exports.workflowDefaultDocumentNode = workflowDefaultDocumentNode;
 
-exports.workflowDocTypes = workflowDocTypes;
-
 exports.workflowStudioPlugin = workflowStudioPlugin;
 
 exports.workflowsTabCodec = workflowsTabCodec;