@sanity/workflow-studio-plugin 0.5.0 → 0.20.0

package/dist/_chunks-es/index.js

@@ -1,5 +1,3 @@
-import { tryParseGdr, resourceFromParsed, latestDeployedDefinitions, gdrRef, isSubjectEntry, isInputSourced, missingRequiredInputs, initialFieldIssues, releaseRef, refKindAcceptsTypes, rejectedRefTypes, ActionDisabledError, MutationGuardDeniedError, errorMessage, findOpenStageEntry, actionRendering, terminalState, ENGINE_API_VERSION, WORKFLOW_INSTANCE_TYPE, WORKFLOW_DEFINITION_TYPE, GUARD_DOC_TYPE, isTodoListEntry, isTodoListItem, isTerminalActivityStatus, describeCondition, sentenceCase, checklistLines, findCurrentActivityEntry, scalarValidationIssues, extractDocumentId, isSingleDocRefEntry, isGdr, resolveFieldEntry, isSingleDocRefKind, isNotesEntry, parseDefinitionSnapshot, StartNotSettledError, StartNotAllowedError, isUnprimed, unboundAllowedReads, explainStartAllowed, evaluateStartFilter, startKindOf, readsRootDocument, instancesQuery, assertReadableModel, isTerminalStage, DEFAULT_TRANSITION_WHEN, isStartableDefinition, acceptsDocumentType, definitionsListGroq, gdrFromResource, instanceWatchesDocument, aclPathForResource, definitionLookupGroq, instanceDocId, documentActionDenials } from "@sanity/workflow-engine";
-
 import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 
 import { TimelineIcon } from "@sanity/icons/Timeline";
@@ -10,6 +8,12 @@ import { createContext, useContext, useEffect, useSyncExternalStore, useCallback
 
 import { usePaneRouter } from "sanity/structure";
 
+import { tryParseGdr, resourceFromParsed, latestDeployedDefinitions, isStartableDefinition, isSubjectEntry, isInputSourced, acceptsDocumentType, missingRequiredInputs, initialFieldIssues, gdrRef, releaseRef, refKindAcceptsTypes, rejectedRefTypes, ActionDisabledError, MutationGuardDeniedError, errorMessage, findOpenStageEntry, actionRendering, terminalState, ENGINE_API_VERSION, WORKFLOW_INSTANCE_TYPE, WORKFLOW_DEFINITION_TYPE, GUARD_DOC_TYPE, isTodoListEntry, isTodoListItem, isTerminalActivityStatus, describeCondition, sentenceCase, checklistLines, findCurrentActivityEntry, scalarValidationIssues, toBareId, isSingleDocRefEntry, isGdr, resolveFieldEntry, isSingleDocRefKind, isNotesEntry, parseDefinitionSnapshot, isUnprimed, StartNotSettledError, StartNotAllowedError, unboundAllowedReads, explainStartAllowed, evaluateStartFilter, startKindOf, readsRootDocument, instancesQuery, assertReadableModel, isTerminalStage, DEFAULT_TRANSITION_WHEN, definitionsListGroq, gdrFromResource, subscriptionDocumentsForInstance, aclPathForResource, definitionLookupGroq, instanceDocId, documentActionDenials } from "@sanity/workflow-engine";
+
+import { CheckmarkIcon } from "@sanity/icons/Checkmark";
+
+import { CloseIcon } from "@sanity/icons/Close";
+
 import { formatDistanceToNow } from "date-fns/formatDistanceToNow";
 
 import { getPublishedId } from "@sanity/client/csm";
@@ -24,14 +28,10 @@ import { ClearableDatePicker, MemberPicker as MemberPicker$1, AssigneePicker as
 
 import { UserIcon } from "@sanity/icons/User";
 
-import { CloseIcon } from "@sanity/icons/Close";
-
 import { SearchIcon } from "@sanity/icons/Search";
 
 import { ChevronRightIcon } from "@sanity/icons/ChevronRight";
 
-import { CheckmarkIcon } from "@sanity/icons/Checkmark";
-
 import { EditIcon } from "@sanity/icons/Edit";
 
 import { randomKey } from "@sanity/util/content";
@@ -87,20 +87,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 discoverWorkflowMappings(args) {
+    assertUniqueWorkflowMappings(args.overrides ?? []);
+    const discovered = latestDeployedDefinitions(args.definitions).flatMap(definition => {
+        if (!isStartableDefinition(definition)) return [];
+        const subject = (definition.fields ?? []).find(isSubjectEntry);
+        if (subject === void 0 || !isInputSourced(subject)) return [];
+        const source = {
+            fields: [ ...definition.fields ?? [] ]
+        };
+        return [ ...args.schemaContentTypes ].filter(docType => 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 mappingForDocType(mappings, docType) {
-    return mappingsForDocType(mappings, docType)[0];
+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(isSubjectEntry) ?? fields.find(entry => entry.type === "doc.ref" && entry.name === "subject");
 }
 
 function mappingStartBlocks(args) {
@@ -421,7 +459,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) {
@@ -468,12 +506,27 @@ function useWorkflowContext() {
 }
 
 function useWorkflowsForDocument(rawId) {
-    const {register: register, unregister: unregister, entries: entries} = useWorkflowContext(), docId = rawId ? 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 ? getPublishedId(rawId) : void 0;
     useEffect(() => {
         if (docId) return register(docId), () => unregister(docId);
     }, [ docId, register, unregister ]);
-    const list = useSyncExternalStore(entries.subscribe, useCallback(() => docId ? entries.getDocument(docId) : EMPTY_ENTRIES, [ entries, docId ]));
-    return {
+    const list = useSyncExternalStore(entries.subscribe, useCallback(() => docId ? entries.getDocument(docId) : EMPTY_ENTRIES, [ entries, docId ])), evaluationKey = evaluate ? list.map(entry => entry.instance._id).join("\0") : "";
+    return 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
     };
@@ -484,11 +537,13 @@ function useHeldWorkflowEntry(instanceId) {
     return useSyncExternalStore(entries.subscribe, 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 useEffect(() => {
         if (instanceId) return requestInstance(instanceId), () => releaseInstance(instanceId);
-    }, [ instanceId, requestInstance, releaseInstance ]), useHeldWorkflowEntry(instanceId);
+    }, [ instanceId, requestInstance, releaseInstance ]), 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";
@@ -761,13 +816,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: CheckmarkIcon
+    },
+    "decision.decline": {
+        tone: "caution",
+        icon: 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
     };
 }
 
@@ -1022,10 +1093,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,
@@ -1035,19 +1115,20 @@ function userDisplayFor(args) {
 
 function useUserDisplays(ids) {
     const {members: members} = useProjectMembers(), me = useCurrentUser();
-    return ids.map(id => userDisplayFor({
+    return 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 = useCurrentUser();
+    return useMemo(() => userDisplayFor({
+        id: id,
+        members: members,
+        me: me
+    }), [ id, me, members ]);
 }
 
 function useAssignmentIdentity() {
@@ -1058,8 +1139,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 ? {
@@ -1070,6 +1155,7 @@ function projectMembersFrom(users) {
         } : {},
         roles: (membership.roles ?? []).map(role => role.name)
     }));
+    return projectMembersByUsers.set(users, members), members;
 }
 
 function useProjectMembers() {
@@ -1511,7 +1597,7 @@ function DocPicker({value: value, onChange: onChange, types: types, readOnly: re
         children: /* @__PURE__ */ jsx(Box, {
             flex: 1,
             children: /* @__PURE__ */ jsx(PreviewOrId, {
-                id: extractDocumentId(value.id),
+                id: toBareId(value.id),
                 type: value.type
             })
         })
@@ -1607,7 +1693,7 @@ function DocRefsInput({value: value, onChange: onChange, types: types}) {
             /* @__PURE__ */ jsx(Box, {
                 flex: 1,
                 children: /* @__PURE__ */ jsx(PreviewOrId, {
-                    id: extractDocumentId(ref.id),
+                    id: toBareId(ref.id),
                     type: ref.type
                 })
             }), 
@@ -1761,6 +1847,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();
 }
@@ -1788,7 +1883,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,
@@ -1800,6 +1895,7 @@ function FireButton({instanceId: instanceId, activity: activity, action: action,
     /* @__PURE__ */
     return jsx(Button, {
         fontSize: 1,
+        ...actionIconProps(icon),
         loading: pending,
         mode: chrome?.mode ?? mode,
         onClick: handleClick,
@@ -1817,6 +1913,7 @@ function ActivityActionRow({actionEval: actionEval, instanceId: instanceId, acti
     const rowKind = actionRowKind(actionEval);
     return rowKind.kind === "disabled" ? /* @__PURE__ */ jsx(DisabledActionButton, {
         actionEval: actionEval,
+        activity: activity,
         chrome: chrome
     }) : rowKind.kind === "plain" ? /* @__PURE__ */ jsx(PlainActionButton, {
         actionEval: actionEval,
@@ -1831,13 +1928,18 @@ function ActivityActionRow({actionEval: actionEval, instanceId: instanceId, acti
     });
 }
 
-function DisabledActionButton({actionEval: actionEval, chrome: chrome}) {
-    const label = actionTriggerLabel(actionEval), button = /* @__PURE__ */ jsx(Button, {
+function DisabledActionButton({actionEval: actionEval, activity: activity, chrome: chrome}) {
+    const label = actionTriggerLabel(actionEval), {tone: tone, icon: icon} = actionButtonFace({
+        actionEval: actionEval,
+        activityName: activity
+    }), button = /* @__PURE__ */ jsx(Button, {
         fontSize: 1,
+        ...actionIconProps(icon),
         mode: chrome?.mode ?? "ghost",
         onClick: e => e.stopPropagation(),
         padding: 2,
         text: label,
+        tone: tone,
         ...spanTriggerProps(chrome),
         disabled: !0
     });
@@ -1848,11 +1950,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__ */ jsx(FireButton, {
         action: action.name,
+        icon: btn.icon,
         instanceId: instanceId,
         label: label,
         mode: btn.mode,
@@ -1927,7 +2030,7 @@ function ParamsActionDialog({actionEval: actionEval, instanceId: instanceId, act
 }
 
 function ParamsActionButton({actionEval: actionEval, instanceId: instanceId, activity: activity, chrome: chrome}) {
-    const [open, setOpen] = useState(!1), btn = actionButtonTone({
+    const [open, setOpen] = useState(!1), btn = actionButtonFace({
         actionEval: actionEval,
         activityName: activity
     });
@@ -1936,6 +2039,7 @@ function ParamsActionButton({actionEval: actionEval, instanceId: instanceId, act
         children: [ 
         /* @__PURE__ */ jsx(Button, {
             fontSize: 1,
+            ...actionIconProps(btn.icon),
             mode: chrome?.mode ?? btn.mode,
             onClick: e => {
                 chrome?.inButtonCard === !0 && e.stopPropagation(), setOpen(!0);
@@ -2761,7 +2865,7 @@ function ReadOnlyDocRefs({entry: entry}) {
             padding: 2,
             radius: 2,
             children: /* @__PURE__ */ jsx(PreviewOrId, {
-                id: extractDocumentId(ref.id),
+                id: toBareId(ref.id),
                 type: ref.type
             })
         }, ref.id))
@@ -4125,7 +4229,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,
@@ -4133,17 +4242,23 @@ function ActionMenuItem({actionEval: actionEval, instanceId: instanceId, activit
     });
     return rowKind.kind === "disabled" ? /* @__PURE__ */ jsx(MenuItem, {
         disabled: !0,
-        text: label
+        ...iconProp,
+        text: label,
+        tone: tone
     }) : rowKind.kind === "plain" ? /* @__PURE__ */ jsx(MenuItem, {
         disabled: pending,
+        ...iconProp,
         onClick: () => {
             fire();
         },
-        text: label
+        text: label,
+        tone: tone
     }) : /* @__PURE__ */ jsx(MenuItem, {
         disabled: pending,
+        ...iconProp,
         onClick: onCollectParams,
-        text: label
+        text: label,
+        tone: tone
     });
 }
 
@@ -4256,6 +4371,7 @@ function FittedActions({actions: actions, activity: activity, instanceId: instan
         children: [ 
         /* @__PURE__ */ jsx(MeasureRow, {
             actions: actions,
+            activity: activity,
             onElement: setMeasureEl
         }), 
         /* @__PURE__ */ jsxs(FooterRow, {
@@ -4275,7 +4391,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 jsx("div", {
         "aria-hidden": !0,
@@ -4289,12 +4405,20 @@ function MeasureRow({actions: actions, onElement: onElement}) {
                 display: "inline-flex",
                 whiteSpace: "nowrap"
             },
-            children: [ actions.map(a => /* @__PURE__ */ jsx(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 jsx(Button, {
+                    as: "span",
+                    fontSize: 1,
+                    ...actionIconProps(icon),
+                    padding: 2,
+                    text: actionTriggerLabel(a)
+                }, a.action.name);
+            }), 
             /* @__PURE__ */ jsx(Button, {
                 ...ACTIONS_MENU_TRIGGER,
                 as: "span",
@@ -4576,7 +4700,26 @@ function CountedLabel({count: count, label: label}) {
     });
 }
 
-function GroupHeading({count: count, title: title, end: end}) {
+function SpinnerSlot({busy: busy, size: size}) {
+    /* @__PURE__ */
+    return jsx(Flex, {
+        align: "center",
+        flex: "none",
+        justify: "center",
+        style: {
+            width: 19,
+            height: 19
+        },
+        children: busy ? /* @__PURE__ */ jsx(Spinner, {
+            muted: !0,
+            ...size !== void 0 ? {
+                size: size
+            } : {}
+        }) : null
+    });
+}
+
+function GroupHeading({busy: busy, count: count, title: title, end: end}) {
     /* @__PURE__ */
     return jsxs(Flex, {
         align: "center",
@@ -4591,6 +4734,9 @@ function GroupHeading({count: count, title: title, end: end}) {
                 weight: "semibold",
                 children: title
             })
+        }), busy === void 0 ? null : /* @__PURE__ */ jsx(SpinnerSlot, {
+            busy: busy,
+            size: 1
         }), end === void 0 ? null : /* @__PURE__ */ jsxs(Fragment, {
             children: [ 
             /* @__PURE__ */ jsx(Flex, {
@@ -4713,6 +4859,18 @@ function TabSwitch({ariaControls: ariaControls, idPrefix: idPrefix, options: opt
     });
 }
 
+function useDelayedFlag(active, delayMs) {
+    const [held, setHeld] = useState(!1);
+    return 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;
 }
@@ -5551,9 +5709,16 @@ function instanceNotice(entry) {
             size: 1,
             children: "This workflow didn’t finish starting — use Start workflow to continue it"
         })
-    }) : pending ? /* @__PURE__ */ jsx(LoadingRow, {
-        label: "Loading…",
-        padding: 4
+    }) : pending ? /* @__PURE__ */ jsx(WorkRow, {
+        lead: /* @__PURE__ */ jsx(Spinner, {
+            muted: !0,
+            size: 1
+        }),
+        children: /* @__PURE__ */ jsx(Text, {
+            muted: !0,
+            size: 1,
+            children: "Loading…"
+        })
     }) : null;
 }
 
@@ -6617,20 +6782,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__ */ jsxs(Flex, {
-        align: "center",
-        gap: 2,
-        style: badgeTrim,
-        children: [ 
-        /* @__PURE__ */ jsx(AbortedBadge, {
-            instance: instance
-        }), settled ? null : /* @__PURE__ */ jsx(OlderDefinitionBadge, {
-            instance: instance
-        }), !ready && entry.invalid === void 0 ? /* @__PURE__ */ jsx(Spinner, {
-            muted: !0,
-            size: 1
-        }) : null ]
-    });
+    const definition = useDefinition(entry), {instance: instance} = entry, settled = !isLiveEntry(entry), title = instanceTitle(instance, definition), badgeTrim = useBadgeCapTrim();
     /* @__PURE__ */
     return jsx(CollapsibleBand, {
         defaultOpen: defaultOpen ?? !settled,
@@ -6653,7 +6805,18 @@ function InstanceAccordion({entry: entry, children: children, defaultOpen: defau
                     textOverflow: "ellipsis",
                     weight: "medium",
                     children: title
-                }), status ]
+                }), 
+                /* @__PURE__ */ jsxs(Flex, {
+                    align: "center",
+                    gap: 2,
+                    style: badgeTrim,
+                    children: [ 
+                    /* @__PURE__ */ jsx(AbortedBadge, {
+                        instance: instance
+                    }), settled ? null : /* @__PURE__ */ jsx(OlderDefinitionBadge, {
+                        instance: instance
+                    }) ]
+                }) ]
             }), 
             /* @__PURE__ */ jsx(TrailingHairline, {}), 
             /* @__PURE__ */ jsx(InstanceDebugMenu, {
@@ -6671,7 +6834,7 @@ function InstanceAccordion({entry: entry, children: children, defaultOpen: defau
 }
 
 function PartOfBand({instance: instance}) {
-    const parentRef = instance.ancestors.at(-1), parentId = parentRef ? extractDocumentId(parentRef.id) : null, parentEntry = useWorkflowInstanceEntry(parentId), parentDefinition = useDefinition(parentEntry);
+    const parentRef = instance.ancestors.at(-1), parentId = parentRef ? toBareId(parentRef.id) : null, parentEntry = useWorkflowInstanceEntry(parentId), parentDefinition = useDefinition(parentEntry);
     if (!parentId) return null;
     const title = parentEntry ? instanceTitle(parentEntry.instance, parentDefinition) : parentId;
     /* @__PURE__ */
@@ -7228,11 +7391,9 @@ const VIEW_TAB_CODEC = workflowsTabCodec([ "overview", "for-me" ]), WorkflowsVie
 };
 
 function DiscoverySpinner() {
-    const [visible, setVisible] = useState(!1);
-    return useEffect(() => {
-        const timer = setTimeout(() => setVisible(!0), 1e3);
-        return () => clearTimeout(timer);
-    }, []), /* @__PURE__ */ jsx(Flex, {
+    const visible = useDelayedFlag(!0, 1e3);
+    /* @__PURE__ */
+    return jsx(Flex, {
         align: "center",
         height: "fill",
         justify: "center",
@@ -7242,7 +7403,7 @@ function DiscoverySpinner() {
     });
 }
 
-const GROUP_GAP = 1;
+const BOOT_CUE_DELAY_MS = 400, GROUP_GAP = 1;
 
 function useWorkflowsTab() {
     const {params: params, setParams: setParams} = usePaneRouter();
@@ -7267,7 +7428,7 @@ function useOpenActivity(entries) {
 }
 
 function WorkflowsPanel({entries: entries, documentId: documentId, docTypeMappings: docTypeMappings, initialValue: initialValue}) {
-    const identity = useAssignmentIdentity(), panelId = useId(), {params: params} = 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] = useState(() => focusedLanding(params?.[WORKFLOWS_FOCUS_PARAM], entries.map(e => e.instance._id))), assignedWorkUnknown = active.some(e => e.invalid !== void 0), sectionFor = e => /* @__PURE__ */ jsx(WorkflowInstanceSection, {
+    const identity = useAssignmentIdentity(), panelId = useId(), {params: params} = 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] = 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__ */ jsx(WorkflowInstanceSection, {
         defaultOpen: landingDefaultOpen(landing, e.instance._id),
         entry: e,
         onOpenActivity: activityName => setOpenActivity({
@@ -7288,6 +7449,7 @@ function WorkflowsPanel({entries: entries, documentId: documentId, docTypeMappin
             padding: 3,
             children: [ 
             /* @__PURE__ */ jsx(GroupHeading, {
+                busy: booting,
                 count: active.length,
                 end: 
                 /* @__PURE__ */ jsx(Box, {
@@ -7423,10 +7585,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) {
@@ -7439,26 +7599,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(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(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
         });
@@ -7474,35 +7620,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,
@@ -7528,11 +7654,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 (!isStartableDefinition(definition)) return `autoStart: "${docType}" → workflow "${name}" is spawn-only, not startable — skipped.`;
-    if (!acceptsDocumentType({
-        fields: [ ...definition.fields ?? [] ]
-    }, docType)) return `autoStart: "${docType}" → workflow "${name}" has no subject accepting "${docType}" — skipped.`;
-    const subject = (definition.fields ?? []).find(isSubjectEntry);
-    if (subject !== void 0 && !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 (!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) {
@@ -7552,20 +7676,31 @@ const EMPTY_SNAPSHOT = {
 };
 
 function useDiscoveryState(args) {
-    const {registered: registered, requested: requested, contentResource: contentResource} = args, watching = registered.length + requested.length > 0, [latest, setLatest] = useState(EMPTY_SNAPSHOT), [resolved, setResolved] = useState(EMPTY_SNAPSHOT), onSnapshot = useCallback(snapshot => {
-        setLatest(snapshot), snapshot.instances !== void 0 && setResolved(snapshot);
-    }, []);
-    useEffect(() => {
-        watching || (setLatest(EMPTY_SNAPSHOT), setResolved(EMPTY_SNAPSHOT));
-    }, [ watching ]);
-    const filter = useMemo(() => ({
-        documents: registered.map(id => 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 = useMemo(() => documentWatching ? {
+        documents: observed.map(id => gdrFromResource(contentResource, id)),
+        includeCompleted: !0
+    } : void 0, [ documentWatching, observed, contentResource ]), requestedFilter = useMemo(() => requestedWatching ? {
         ids: requested,
         includeCompleted: !0
-    }), [ registered, requested, contentResource ]);
+    } : void 0, [ requestedWatching, requested ]), resolved = 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] = useState(EMPTY_SNAPSHOT), [resolved, setResolved] = useState(EMPTY_SNAPSHOT), onSnapshot = useCallback(snapshot => {
+        setLatest(snapshot), snapshot.instances !== void 0 && setResolved(snapshot);
+    }, []);
+    return 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,
@@ -7573,18 +7708,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 = gdrFromResource(contentResource, bareId), watching = ordered.filter(inst => 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 = 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 => [ 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;
 }
@@ -7608,7 +7787,7 @@ function entryOf(inst, report) {
         instance: report?.evaluation?.instance ?? inst,
         committed: inst,
         evaluation: report?.evaluation,
-        ready: report?.ready ?? !1,
+        ready: report?.ready ?? terminalState(inst) !== "in-flight",
         invalid: report?.invalid,
         guards: report?.guards
     };
@@ -7701,7 +7880,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 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");
@@ -7729,10 +7920,11 @@ class InstanceEvaluatorBoundary extends 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} = 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} = useWorkflowSession({
         engine: engine,
         instanceId: instanceId,
-        grantsFromPath: grantsFromPath
+        grantsFromPath: grantsFromPath,
+        guardScope: guardScope
     });
     return useEffect(() => {
         onReport(instanceId, {
@@ -7775,9 +7967,9 @@ function engineOptionsFrom(config) {
 }
 
 function WorkflowProvider(props) {
-    const {config: config} = props, studioClient = useClient({
+    const {config: config} = props, defaultLayout = useDefaultLayout(props), studioClient = useClient({
         apiVersion: WORKFLOW_API_VERSION
-    }), schema = useSchema(), {name: workspaceName} = useWorkspace(), {projectId: projectId, dataset: contentDataset} = workspaceParts(studioClient.config()), workflowDataset = config.workflowDataset ?? contentDataset, binding = useMemo(() => ({
+    }), schema = useSchema(), {projectId: projectId, dataset: contentDataset} = workspaceParts(studioClient.config()), workflowDataset = config.workflowDataset ?? contentDataset, binding = useMemo(() => ({
         engineResource: {
             type: "dataset",
             id: `${projectId}.${workflowDataset}`
@@ -7795,7 +7987,15 @@ function WorkflowProvider(props) {
     }), grantsFromPath = aclPathForResource({
         type: "dataset",
         id: `${projectId}.${workflowDataset}`
-    }), {ids: registered, acquire: register, release: unregister} = useRefcountedIds(), {ids: requested, acquire: requestInstance, release: releaseInstance} = useRefcountedIds(), [seeded, setSeeded] = useState(/* @__PURE__ */ new Map), seedInstance = useCallback(instance => {
+    }), {ids: registered, acquire: registerActive, release: unregisterActive} = useRefcountedIds(), {ids: observed, acquire: retainRegistration, release: releaseRegistration} = useRefcountedIds({
+        releaseDelayMs: DEMAND_RELEASE_GRACE_MS
+    }), register = useCallback(id => {
+        registerActive(id), retainRegistration(id);
+    }, [ registerActive, retainRegistration ]), unregister = useCallback(id => {
+        unregisterActive(id), releaseRegistration(id);
+    }, [ unregisterActive, releaseRegistration ]), {ids: requested, acquire: requestInstance, release: releaseInstance} = useRefcountedIds(), {ids: evaluationDemand, acquire: requestEvaluation, release: releaseEvaluation} = useRefcountedIds({
+        releaseDelayMs: DEMAND_RELEASE_GRACE_MS
+    }), [seeded, setSeeded] = useState(/* @__PURE__ */ new Map), seedInstance = useCallback(instance => {
         setSeeded(prev => new Map(prev).set(instance._id, instance));
     }, []), [startRequest2, setStartRequest] = useState(void 0), openStartDialog = useCallback(r => setStartRequest(r), []), closeStartDialog = useCallback(() => setStartRequest(void 0), []), [entriesStore] = useState(createEntriesStore);
     useEffect(() => () => entriesStore.dispose(), [ entriesStore ]);
@@ -7846,15 +8046,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} = useMemo(() => indexDiscoveredInstances({
+    }), discoveryIndexer = useMemo(createDiscoveryIndexer, []), {instances: discovered, index: docIndex} = useMemo(() => discoveryIndexer.index({
         instances: resolved.instances ?? [],
         registered: resolved.registered,
         contentResource: binding.contentResource
-    }), [ resolved, binding.contentResource ]), resolvedDocs = useMemo(() => new Set(resolved.registered), [ resolved.registered ]);
+    }), [ discoveryIndexer, resolved, binding.contentResource ]), {evaluated: evaluated, guardScope: guardScope} = useMemo(() => sessionPlan({
+        discovered: discovered,
+        demanded: evaluationDemand
+    }), [ discovered, evaluationDemand ]), resolvedDocs = useMemo(() => new Set(resolved.registered), [ resolved.registered ]);
     useEffect(() => {
         setSeeded(prev => {
             const kept = [ ...prev ].filter(([id]) => !discovered.has(id));
@@ -7867,15 +8070,13 @@ function WorkflowProvider(props) {
             docIndex: docIndex
         });
     }, [ entriesStore, seeded, discovered, docIndex ]);
-    const isDocResolved = useCallback(docId => resolvedDocs.has(docId), [ resolvedDocs ]), schemaContentTypes = useMemo(() => new Set(contentDocumentTypes(schema)), [ schema ]), {issues: issues, starts: starts, fields: fields, latestVersions: latestVersions, autoStartByType: autoStartByType, autoStartDefinitions: autoStartDefinitions} = useDeployedDefinitions({
+    const isDocResolved = useCallback(docId => resolvedDocs.has(docId), [ resolvedDocs ]), schemaContentTypes = 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 = useMemo(() => ({
         register: register,
         unregister: unregister,
@@ -7883,6 +8084,8 @@ function WorkflowProvider(props) {
         entries: entriesStore,
         requestInstance: requestInstance,
         releaseInstance: releaseInstance,
+        requestEvaluation: requestEvaluation,
+        releaseEvaluation: releaseEvaluation,
         seedInstance: seedInstance,
         openStartDialog: openStartDialog,
         closeStartDialog: closeStartDialog,
@@ -7897,7 +8100,7 @@ function WorkflowProvider(props) {
         completeEffectFor: completeEffectFor,
         engine: engine,
         binding: binding,
-        mappings: config.mappings,
+        mappings: mappings,
         mappingIssues: issues,
         mappingStarts: starts,
         mappingFields: fields,
@@ -7905,24 +8108,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 jsxs(WorkflowContext.Provider, {
         value: value,
-        children: [ watching ? /* @__PURE__ */ jsx(DiscoverySubscription, {
+        children: [ documentFilter ? /* @__PURE__ */ jsx(DiscoverySubscription, {
             engine: engine,
-            filter: filter,
-            onSnapshot: onSnapshot,
+            filter: documentFilter,
+            onSnapshot: onDocumentSnapshot,
             registered: registered
-        }) : null, [ ...discovered.values() ].map(inst => /* @__PURE__ */ jsx(InstanceEvaluatorBoundary, {
+        }) : null, requestedFilter ? /* @__PURE__ */ jsx(DiscoverySubscription, {
+            engine: engine,
+            filter: requestedFilter,
+            onSnapshot: onRequestedSnapshot,
+            registered: NO_REGISTERED_DOCUMENTS
+        }) : null, evaluated.map(inst => /* @__PURE__ */ jsx(InstanceEvaluatorBoundary, {
             instanceId: inst._id,
             children: /* @__PURE__ */ 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 ]
     });
 }
 
@@ -7932,14 +8141,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] = useState(/* @__PURE__ */ new Map), [starts, setStarts] = useState(/* @__PURE__ */ new Map), [fields, setFields] = useState(/* @__PURE__ */ new Map), [latestVersions, setLatestVersions] = useState(/* @__PURE__ */ new Map), [autoStartByType, setAutoStartByType] = useState(
+    const {engine: engine, overrides: overrides, contentResource: contentResource, schemaContentTypes: schemaContentTypes, startRequest: startRequest2, schema: schema} = args, [mappings, setMappings] = useState([]), [issues, setIssues] = useState(/* @__PURE__ */ new Map), [starts, setStarts] = useState(/* @__PURE__ */ new Map), [fields, setFields] = useState(/* @__PURE__ */ new Map), [latestVersions, setLatestVersions] = useState(/* @__PURE__ */ new Map), [autoStartByType, setAutoStartByType] = useState(
     /* @__PURE__ */ new Map), [autoStartDefinitions, setAutoStartDefinitions] = useState(/* @__PURE__ */ new Map), logged = useRef(/* @__PURE__ */ new Set);
     return 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
@@ -7949,32 +8169,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(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,
@@ -8760,7 +8978,7 @@ function isFreshDocument(value) {
 }
 
 function subjectEntry(definition) {
-    return (definition.fields ?? []).find(isSubjectEntry);
+    return documentSubjectEntry(definition);
 }
 
 function autoStartInputs(args) {
@@ -8787,11 +9005,11 @@ function pendingWorkflows(workflows, live) {
 }
 
 function extraRequiredInputs(definition) {
-    const fields = definition.fields ?? [], subjectNames = new Set(fields.filter(isSubjectEntry).map(entry => entry.name)), requiredNames = new Set(missingRequiredInputs({
+    const fields = definition.fields ?? [], subjectName = subjectEntry(definition)?.name, requiredNames = new Set(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) {
@@ -8839,7 +9057,7 @@ function AutoStartDriver(props) {
     const pending = useMemo(() => pendingWorkflows(workflows, new Set(entries.map(entry => entry.instance.definition))), [ workflows, entries ]), inputs = useMemo(() => autoStartInputs({
         workflows: pending,
         definitions: autoStartDefinitions
-    }), [ pending, autoStartDefinitions ]), pendingRef = useRef(pending);
+    }), [ pending, autoStartDefinitions ]), definitionsResolved = workflows.every(name => autoStartDefinitions.has(name)), pendingRef = useRef(pending);
     pendingRef.current = pending;
     const instanceIds = useRef(/* @__PURE__ */ new Map), instanceIdFor = useCallback(workflow => {
         const held = instanceIds.current.get(workflow);
@@ -8883,7 +9101,7 @@ function AutoStartDriver(props) {
     }, [ autoStartDefinitions, docId, docType, binding, engine, observer, seedInstance, instanceIdFor, selectedReleaseId ]), retry = 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,
@@ -9305,6 +9523,61 @@ function TaskCountSpinner({entry: entry}) {
     });
 }
 
+function stagePillState(instance) {
+    const definition = definitionSnapshotOf(instance), stage = definition?.stages.find(candidate => candidate.name === instance.currentStage), state = terminalState(instance);
+    return {
+        title: stageTitle(definition, instance.currentStage),
+        terminal: stage !== void 0 && 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__ */ jsx(StagePill, {
+            entry: lead,
+            extraLive: extraLive
+        }) : props.status
+    });
+}
+
+function StagePill({entry: entry, extraLive: extraLive}) {
+    /* @__PURE__ */
+    return jsxs(Flex, {
+        align: "center",
+        gap: 2,
+        children: [ 
+        /* @__PURE__ */ jsx(LeadBadge, {
+            entry: entry
+        }), extraLive > 0 ? /* @__PURE__ */ jsxs(Badge, {
+            fontSize: 1,
+            mode: "outline",
+            tone: "default",
+            children: [ "+", extraLive ]
+        }) : null ]
+    });
+}
+
+function LeadBadge({entry: entry}) {
+    const {instance: instance} = entry;
+    if (isUnprimed(instance)) /* @__PURE__ */ return jsx(StartIncompleteBadge, {});
+    const pill = stagePillState(instance);
+    /* @__PURE__ */
+    return jsxs(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__ */ jsx(StartWorkflowDialog, {
@@ -9377,7 +9650,8 @@ function withWorkflowLock(Action, guardAction) {
     Locked;
 }
 
-const workflowStudioPlugin = definePlugin(config => ({
+const workflowStudioPlugin = definePlugin(config => (assertUniqueWorkflowMappings(config.mappings ?? []), 
+{
     name: "workflow-studio-plugin",
     tools: prev => [ ...prev, workflowsTool ],
     studio: {
@@ -9391,82 +9665,35 @@ const workflowStudioPlugin = definePlugin(config => ({
     },
     form: {
         components: {
-            input: props => {
-                if (props.id === "root" && isObjectInputProps(props)) {
-                    const docTypeMappings = mappingsForDocType(config.mappings, props.schemaType.name), fallback = docTypeMappings.length > 0 ? /* @__PURE__ */ jsx(WorkflowFormStrip, {
-                        ...props,
-                        mappings: docTypeMappings
-                    }) : props.renderDefault(props);
-                    /* @__PURE__ */
-                    return jsx(AutoStartGate, {
-                        ...props,
-                        fallback: fallback
-                    });
-                }
-                return props.renderDefault(props);
-            }
+            preview: WorkflowStagePreview,
+            input: props => props.id === "root" && isObjectInputProps(props) ? /* @__PURE__ */ 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__ */ jsx(WorkflowFormStrip, {
         ...props,
-        status: lead ? /* @__PURE__ */ jsx(StagePill, {
-            entry: lead,
-            extraLive: extraLive
-        }) : props.status
-    });
-}
-
-function StagePill({entry: entry, extraLive: extraLive}) {
+        mappings: docTypeMappings
+    }) : props.renderDefault(props);
     /* @__PURE__ */
-    return jsxs(Flex, {
-        align: "center",
-        gap: 2,
-        children: [ 
-        /* @__PURE__ */ jsx(LeadBadge, {
-            entry: entry
-        }), extraLive > 0 ? /* @__PURE__ */ jsxs(Badge, {
-            fontSize: 1,
-            mode: "outline",
-            tone: "default",
-            children: [ "+", extraLive ]
-        }) : null ]
-    });
-}
-
-function LeadBadge({entry: entry}) {
-    const {instance: instance, evaluation: evaluation} = entry;
-    if (isUnprimed(instance)) /* @__PURE__ */ return jsx(StartIncompleteBadge, {});
-    const stage = evaluation?.currentStage?.stage, title = stage?.title ?? stageTitle(definitionSnapshotOf(instance), instance.currentStage), state = terminalState(instance), isTerminal = (stage ? isTerminalStage(stage) : !1) || state !== "in-flight";
-    /* @__PURE__ */
-    return jsxs(Badge, {
-        fontSize: 1,
-        mode: isTerminal ? "default" : "outline",
-        tone: pillTone({
-            state: state,
-            isTerminal: isTerminal,
-            stageKnown: stage !== void 0
-        }),
-        children: [ title, state === "completed" ? " ✓" : "" ]
+    return jsx(AutoStartGate, {
+        ...props,
+        fallback: fallback
     });
 }
 
-function pillTone(args) {
-    return args.state === "aborted" ? "critical" : args.isTerminal ? "positive" : args.stageKnown ? "primary" : "default";
-}
-
-export { AbortedBadge, ActivitiesList, ActivityDetailDialog, ActivityRow, BreadcrumbTail, CollapsibleBand, DismissablePopover, DocPreviewLink, DocRefFace, GroupHeading, HoverHint, InvalidDocNotice, LinkChip, LoadingRow, StageChip, StageFace, StaleLock, TabSwitch, TodoItemsList, TrailingHairline, UnreadableDocsNote, WorkflowStagePreview, activityRowProps, assigneeUserIdsOf, committedRowFace, dateControlKind, dateControlValue, definitionSnapshotOf, describeError, editTargetOf, findActivity, findActivityNode, formatDate, gdrLocality, instanceBreadcrumb, instanceNotice, instanceTitle, isActivityAssignedTo, isEvaluationStale, isOpenActivityStatus, mappingForDocType, openActivityGone, parseDateFieldValue, parseStoredDateValue, readDeployedDefinitions, rowAssignControlState, rowDateControlState, serializeDateFieldValue, stageTitle, stateByActivity, stopRowClick, stopRowMouseDown, useAssignmentIdentity, useDefinition, useProjectMembers, useSaveField, useUserDisplays, useWorkflowContext, useWorkflowInstanceEntry, workflowDefaultDocumentNode, workflowDocTypes, workflowStudioPlugin, workflowsTabCodec, workflowsView };
+export { AbortedBadge, ActivitiesList, ActivityDetailDialog, ActivityRow, BreadcrumbTail, CollapsibleBand, DismissablePopover, DocPreviewLink, DocRefFace, GroupHeading, HoverHint, InvalidDocNotice, LinkChip, LoadingRow, SpinnerSlot, StageChip, StageFace, StaleLock, TabSwitch, TodoItemsList, TrailingHairline, UnreadableDocsNote, activityRowProps, assigneeUserIdsOf, committedRowFace, dateControlKind, dateControlValue, definitionSnapshotOf, describeError, editTargetOf, findActivity, findActivityNode, formatDate, gdrLocality, instanceBreadcrumb, instanceNotice, instanceTitle, isActivityAssignedTo, isEvaluationStale, isOpenActivityStatus, openActivityGone, parseDateFieldValue, parseStoredDateValue, readDeployedDefinitions, rowAssignControlState, rowDateControlState, serializeDateFieldValue, stageTitle, stateByActivity, stopRowClick, stopRowMouseDown, useAssignmentIdentity, useDefinition, useProjectMembers, useSaveField, useUserDisplays, useWorkflowContext, useWorkflowInstanceEntry, workflowDefaultDocumentNode, workflowStudioPlugin, workflowsTabCodec, workflowsView };