@sanity/workflow-studio-plugin 0.27.0 → 0.29.0

package/dist/_chunks-es/index.js

@@ -2,7 +2,7 @@ import { jsx, jsxs, Fragment } from "react/jsx-runtime";
 
 import { TimelineIcon } from "@sanity/icons/Timeline";
 
-import { Popover, Tooltip, Box, Stack, Text, useClickOutsideEvent, Flex, TextInput, Button, Select, Checkbox, Autocomplete, Card, TextArea, useToast, Dialog, Switch, TextSkeleton, Code, useTheme_v2, Spinner, Badge, MenuButton, Menu, MenuItem, useElementSize, MenuDivider, TabList, Tab, TabPanel } from "@sanity/ui";
+import { Popover, Tooltip, Box, Stack, Text, useClickOutsideEvent, Flex, TextInput, Button, Select, Checkbox, Autocomplete, Card, TextArea, useToast, Dialog, Switch, TextSkeleton, Code, Badge, useTheme_v2, Spinner, MenuButton, Menu, MenuItem, useElementSize, MenuDivider, TabList, Tab, TabPanel } from "@sanity/ui";
 
 import { editFieldTarget, useWorkflowTelemetry, useRefcountedIds } from "@sanity/workflow-react";
 
@@ -10,7 +10,7 @@ import { createContext, useContext, useEffect, useSyncExternalStore, useCallback
 
 import { usePaneRouter } from "sanity/structure";
 
-import { WORKFLOW_INSTANCE_TYPE, WORKFLOW_DEFINITION_TYPE, GUARD_DOC_TYPE, tryParseGdr, resourceFromParsed, latestDeployedDefinitions, isStartableDefinition, isSubjectEntry, isInputSourced, acceptsDocumentType, initialFieldIssues, gdrRef, releaseRef, refKindAcceptsTypes, rejectedRefTypes, ActionDisabledError, MutationGuardDeniedError, EditFieldDeniedError, errorMessage, terminalState, findOpenStageEntry, actionRendering, isTodoListEntry, isTodoListItem, isTerminalActivityStatus, describeCondition, sentenceCase, checklistLines, findCurrentActivityEntry, ENGINE_API_VERSION, scalarValidationIssues, classifyPrincipalId, userLoginProvider, toBareId, isSingleDocRefEntry, isGdr, resolveFieldEntry, isSingleDocRefKind, isNotesEntry, parseDefinitionSnapshot, isUnprimed, isTerminalStage, DEFAULT_TRANSITION_WHEN, instancesQuery, assertReadableModel, projectStartSliceRow, StartNotSettledError, StartNotAllowedError, humanize, unboundRequirementReads, explainStartRequirement, singleSubjectRequirementRefused, evaluateStartFilter, startKindOf, hasSingleSubjectRequirement, readsRootDocument, latestDefinitionsGroq, gdrFromResource, subscriptionDocumentsForInstance, aclPathForResource, definitionLookupGroq, instanceDocId, missingRequiredInputs, documentActionDenials } from "@sanity/workflow-engine";
+import { WORKFLOW_INSTANCE_TYPE, WORKFLOW_DEFINITION_TYPE, GUARD_DOC_TYPE, tryParseGdr, resourceFromParsed, latestDeployedDefinitions, isStartableDefinition, isSubjectEntry, isInputSourced, acceptsDocumentType, initialFieldIssues, gdrRef, releaseRef, refKindAcceptsTypes, rejectedRefTypes, ActionDisabledError, MutationGuardDeniedError, EditFieldDeniedError, errorMessage, terminalState, findOpenStageEntry, actionRendering, isTodoListEntry, isTodoListItem, isTerminalActivityStatus, describeCondition, sentenceCase, checklistLines, findCurrentActivityEntry, ENGINE_API_VERSION, scalarValidationIssues, classifyPrincipalId, userLoginProvider, toBareId, findStageNode, findActivityNode, isSingleDocRefEntry, isGdr, resolveFieldEntry, isSingleDocRefKind, isNotesEntry, remediationsFor, diagnoseInstance, diagnoseInputFromEvaluation, documentStuckCause, parseDefinitionSnapshot, isUnprimed, isTerminalStage, DEFAULT_TRANSITION_WHEN, instancesQuery, assertReadableModel, projectStartSliceRow, StartNotSettledError, StartNotAllowedError, isRevisionConflict, humanize, unboundRequirementReads, explainStartRequirement, singleSubjectRequirementRefused, evaluateStartFilter, startKindOf, hasSingleSubjectRequirement, readsRootDocument, latestDefinitionsGroq, gdrFromResource, subscriptionDocumentsForInstance, aclPathForResource, definitionLookupGroq, instanceDocId, missingRequiredInputs, documentActionDenials } from "@sanity/workflow-engine";
 
 import { CheckmarkIcon } from "@sanity/icons/Checkmark";
 
@@ -52,6 +52,8 @@ import { isDocumentSchemaType } from "@sanity/types";
 
 import { LaunchIcon } from "@sanity/icons/Launch";
 
+import { ErrorOutlineIcon } from "@sanity/icons/ErrorOutline";
+
 import { EmptyIcon } from "@sanity/icons/Empty";
 
 import { ErrorFilledIcon } from "@sanity/icons/ErrorFilled";
@@ -407,16 +409,25 @@ function parseLocalDate(value) {
     return parsed2.getFullYear() === year && parsed2.getMonth() === (month ?? NaN) - 1 && parsed2.getDate() === day ? parsed2 : /* @__PURE__ */ new Date(NaN);
 }
 
+function storedDateKind(value) {
+    return /^\d{4}-\d{2}-\d{2}$/.test(value) ? "date" : "datetime";
+}
+
 function parseStoredDateValue(value) {
-    if (typeof value != "string") return;
-    const kind = /^\d{4}-\d{2}-\d{2}$/.test(value) ? "date" : "datetime";
-    return parseDateFieldValue(value, kind);
+    if (typeof value == "string") return parseDateFieldValue(value, storedDateKind(value));
 }
 
 function serializeDateFieldValue(date, kind) {
     return hasTimeOfDay(kind) ? date.toISOString() : `${date.getFullYear()}-${pad2(date.getMonth() + 1)}-${pad2(date.getDate())}`;
 }
 
+function isDueDatePast(value, now) {
+    const kind = storedDateKind(value);
+    if (!hasTimeOfDay(kind)) return value < serializeDateFieldValue(now, kind);
+    const due = parseDateFieldValue(value, kind);
+    return due !== void 0 && due.getTime() < now.getTime();
+}
+
 class EffectsIncompleteError extends Error {
     reason;
     constructor(reason, options) {
@@ -597,7 +608,7 @@ function isLiveEntry(entry) {
 const isTodoDone = item => item.status === "done", toggledTodoStatus = item => isTodoDone(item) ? "open" : "done";
 
 function isTodoOverdue(item, today = /* @__PURE__ */ new Date) {
-    return !item.dueDate || isTodoDone(item) ? !1 : item.dueDate < serializeDateFieldValue(today, "date");
+    return !item.dueDate || isTodoDone(item) ? !1 : isDueDatePast(item.dueDate, today);
 }
 
 function todoEditKind(patch) {
@@ -796,13 +807,25 @@ function isItemAssignedTo(item, who) {
     return item.assignee != null && assigneeMatches(item.assignee, who);
 }
 
+function matchingAssignees(state, who) {
+    return state.flatMap(entry => entry._type === "assignees" ? entry.value.filter(a => assigneeMatches(a, who)) : entry._type === "assignee" && entry.value !== null && assigneeMatches(entry.value, who) ? [ entry.value ] : []);
+}
+
 function isActivityAssignedTo(args) {
-    return args.state.some(entry => entry._type === "assignees" ? entry.value.some(a => assigneeMatches(a, args.who)) : entry._type === "assignee" ? entry.value !== null && assigneeMatches(entry.value, args.who) : !1);
+    return matchingAssignees(args.state, args.who).length > 0;
+}
+
+function isRoleAssignedTo(args) {
+    return matchingAssignees(args.state, args.who).some(member => member.type === "role");
+}
+
+function isItemRoleAssignedTo(item, who) {
+    return isItemAssignedTo(item, who) && item.assignee?.type === "role";
 }
 
 function assignedWork(args) {
-    const {instance: instance, committed: committed, who: who} = args, evaluation = args.staleEvaluation === "keep" || isEvaluationCurrent(args) ? args.evaluation : void 0, byActivity = stateByActivity(instance), activities = (evaluation?.currentStage.activities ?? []).filter(t => isActivityAssignedTo({
-        state: byActivity.get(t.activity.name) ?? [],
+    const {instance: instance, committed: committed, who: who} = args, evaluation = args.staleEvaluation === "keep" || isEvaluationCurrent(args) ? args.evaluation : void 0, byActivity = stateByActivity(instance), stateOf = t => byActivity.get(t.activity.name) ?? [], activities = (evaluation?.currentStage.activities ?? []).filter(t => isActivityAssignedTo({
+        state: stateOf(t),
         who: who
     })), items = deriveTodoItems({
         instance: instance,
@@ -812,7 +835,11 @@ function assignedWork(args) {
     return {
         activities: activities,
         openItems: items.filter(row => !isTodoDone(row.item)),
-        doneItems: items.filter(row => isTodoDone(row.item))
+        doneItems: items.filter(row => isTodoDone(row.item)),
+        roleMatched: activities.some(t => isRoleAssignedTo({
+            state: stateOf(t),
+            who: who
+        })) || items.some(row => isItemRoleAssignedTo(row.item, who))
     };
 }
 
@@ -861,7 +888,8 @@ function forMeWorkOf(entries, identity) {
     return {
         work: work,
         count: work.reduce((n, {count: count}) => n + count, 0),
-        hasRows: work.some(({shown: shown}) => hasAssignedRows(shown))
+        hasRows: work.some(({shown: shown}) => hasAssignedRows(shown)),
+        hasRoleMatched: work.some(({shown: shown}) => shown.roleMatched)
     };
 }
 
@@ -901,7 +929,7 @@ function concludesHere(actionEval, activityName) {
     return changesOwnStatus(actionEval.action, activityName) || actionEval.firing?.exitsStage === !0;
 }
 
-const SEMANTIC_FACE = {
+const DECISION_SEMANTIC_FACE = {
     "decision.accept": {
         tone: "positive",
         icon: CheckmarkIcon
@@ -912,6 +940,15 @@ const SEMANTIC_FACE = {
     }
 };
 
+function isDecisionSemantic(value) {
+    return Object.hasOwn(DECISION_SEMANTIC_FACE, value);
+}
+
+function decisionSemanticFace(semantics) {
+    const semantic = semantics.find(isDecisionSemantic);
+    return semantic === void 0 ? void 0 : DECISION_SEMANTIC_FACE[semantic];
+}
+
 function actionButtonFace(args) {
     const mode = concludesHere(args.actionEval, args.activityName) ? "default" : "ghost";
     if (actionAdvanceStatus(args.actionEval.action, args.activityName) === "failed") return {
@@ -919,7 +956,7 @@ function actionButtonFace(args) {
         tone: "critical",
         icon: void 0
     };
-    const [semantic] = args.actionEval.semantics ?? [], face = semantic === void 0 ? void 0 : SEMANTIC_FACE[semantic];
+    const face = decisionSemanticFace(args.actionEval.semantics ?? []);
     return {
         mode: mode,
         tone: face?.tone ?? "default",
@@ -1386,21 +1423,32 @@ function bridgedSelfId(users, meId) {
     return users.find(user => user.membership.id === meId)?.profile?.sanityUserId ?? classified.globalId ?? (classified.namespace === "project" ? void 0 : meId);
 }
 
-function useBridgedSelf() {
+function useSelfState() {
     const me = useCurrentUser(), {users: users, loading: loading, error: error} = useStudioProjectUsers();
-    if (!me) return;
-    const id = bridgedSelfId(users, me.id);
-    if (id !== void 0) return {
-        id: id,
-        roles: me.roles ?? []
+    if (!me) return {
+        kind: "unavailable"
     };
-    if (!loading) {
-        if (error !== void 0) {
-            warnSelfUnavailableOnce(`load:${me.id}`, `workflow: the project member directory failed to load ("${errorMessage(error)}") — the logged-in user ("${me.id}") is project-scoped, and only that directory maps it to the account-global identity the engine stores, so workflow assignment and authoring controls stay disabled. A mounted view does not retry on its own; the next consumer to ask reloads the directory once its backoff has passed.`);
-            return;
+    const id = bridgedSelfId(users, me.id);
+    return id !== void 0 ? {
+        kind: "resolved",
+        self: {
+            id: id,
+            roles: me.roles ?? []
         }
-        warnSelfUnavailableOnce(`unresolved:${me.id}`, `workflow: the project member directory cannot resolve the logged-in user ("${me.id}") to an account-global identity — the engine stores account-global user ids only, so workflow assignment and authoring controls stay disabled. Typically this user is not a member of this project.`);
-    }
+    } : loading ? {
+        kind: "pending"
+    } : error !== void 0 ? (warnSelfUnavailableOnce(`load:${me.id}`, `workflow: the project member directory failed to load ("${errorMessage(error)}") — the logged-in user ("${me.id}") is project-scoped, and only that directory maps it to the account-global identity the engine stores, so workflow assignment and authoring controls stay disabled. A mounted view does not retry on its own; the next consumer to ask reloads the directory once its backoff has passed.`), 
+    {
+        kind: "unavailable"
+    }) : (warnSelfUnavailableOnce(`unresolved:${me.id}`, `workflow: the project member directory cannot resolve the logged-in user ("${me.id}") to an account-global identity — the engine stores account-global user ids only, so workflow assignment and authoring controls stay disabled. Typically this user is not a member of this project.`), 
+    {
+        kind: "unavailable"
+    });
+}
+
+function useBridgedSelf() {
+    const state = useSelfState();
+    return state.kind === "resolved" ? state.self : void 0;
 }
 
 function useSelfActor() {
@@ -1409,13 +1457,22 @@ function useSelfActor() {
 }
 
 function useAssignmentIdentity() {
-    const self = useBridgedSelf();
-    if (self !== void 0) return {
-        userId: self.id,
-        roles: self.roles.map(r => r.name)
+    const state = useSelfState();
+    if (state.kind !== "resolved") return state;
+    const {id: id, roles: roles} = state.self;
+    return {
+        kind: "resolved",
+        identity: {
+            userId: id,
+            roles: roles.map(r => r.name)
+        }
     };
 }
 
+function identityOf(state) {
+    return state.kind === "resolved" ? state.identity : void 0;
+}
+
 const projectMembersByUsers = /* @__PURE__ */ new WeakMap;
 
 function projectMembersFrom(users) {
@@ -1435,9 +1492,10 @@ function projectMembersFrom(users) {
 }
 
 function useProjectMembers() {
-    const {users: users, loading: loading, error: error} = useStudioProjectUsers();
+    const {users: users, roles: roles, loading: loading, error: error} = useStudioProjectUsers();
     return {
         members: useMemo(() => projectMembersFrom(users), [ users ]),
+        roles: roles,
         loading: loading,
         error: error === void 0 ? void 0 : errorMessage(error)
     };
@@ -1522,6 +1580,8 @@ function buildParams(decls, values) {
     };
 }
 
+const LOADING_CUE_DELAY_MS = 400;
+
 function useDelayedFlag(active, delayMs) {
     const [held, setHeld] = useState(!1);
     return useEffect(() => {
@@ -1791,10 +1851,12 @@ function PickedValueRow({children: children, onRequestChange: onRequestChange})
 }
 
 function MemberPicker({selectedIds: selectedIds, onSelect: onSelect, unassignRow: unassignRow = !1}) {
-    const state = useProjectMembers();
+    const {error: error, loading: loading, members: members} = useProjectMembers();
     /* @__PURE__ */
     return jsx(MemberPicker$1, {
-        ...state,
+        error: error,
+        loading: loading,
+        members: members,
         onSelect: onSelect,
         selectedIds: selectedIds,
         unassignRow: unassignRow
@@ -2527,11 +2589,10 @@ function Separator() {
 }
 
 function stageTitle(definition, stageName) {
-    return definition?.stages.find(stage => stage.name === stageName)?.title ?? stageName;
-}
-
-function findActivityNode(args) {
-    return args.definition?.stages.find(s => s.name === args.stageName)?.activities?.find(a => a.name === args.activityName);
+    return findStageNode({
+        definition: definition,
+        stageName: stageName
+    })?.title ?? stageName;
 }
 
 function findActivity(args) {
@@ -2578,20 +2639,20 @@ function noteRow(args) {
 }
 
 function AssigneeBadge({assignee: assignee}) {
-    const {members: members} = useProjectMembers();
+    const vocabulary = useProjectMembers();
     /* @__PURE__ */
     return jsx(AssigneeBadge$1, {
         assignee: assignee,
-        members: members
+        vocabulary: vocabulary
     });
 }
 
 function AssigneeBadges({assignees: assignees}) {
-    const {members: members} = useProjectMembers();
+    const vocabulary = useProjectMembers();
     /* @__PURE__ */
     return jsx(AssigneeBadges$1, {
         assignees: assignees,
-        members: members
+        vocabulary: vocabulary
     });
 }
 
@@ -3999,6 +4060,267 @@ function EditableField({field: field, entry: entry, description: description, in
     });
 }
 
+function useDrainEffects(instanceId) {
+    const {drainEffectsFor: drainEffectsFor} = useWorkflowContext(), toast = useWorkflowToast(), [busy, setBusy] = useState(!1);
+    return {
+        busy: busy,
+        run: async () => {
+            setBusy(!0);
+            try {
+                await drainEffectsFor(instanceId), toast.push({
+                    id: TOAST_ID.effectsDrain,
+                    status: "info",
+                    title: "Ran the registered handlers"
+                });
+            } catch (err) {
+                toast.push({
+                    id: TOAST_ID.effectsDrain,
+                    status: "error",
+                    title: "Failed to run pending effects",
+                    description: describeError(err)
+                });
+            } finally {
+                setBusy(!1);
+            }
+        }
+    };
+}
+
+function isRunnable(verb) {
+    return verb === "drain-effects";
+}
+
+function effectLabel(effect) {
+    return effect.title ?? effect.name;
+}
+
+const ACTION_LABEL = {
+    "drain-effects": "Run the step again"
+}, REMEDY_TEXT = {
+    "retry-effect": "The step has to run again before this workflow can continue.",
+    "reset-activity": "Reset the task to try it again, or skip it.",
+    "set-stage": "Move the workflow on to its next stage yourself."
+};
+
+function detailOf(cause) {
+    switch (cause.kind) {
+      case "failed-effect":
+        return `The step “${effectLabel(cause.effect)}” failed`;
+
+      case "hung-effect":
+        return `The step “${effectLabel(cause.effect)}” didn’t finish`;
+
+      case "failed-activity":
+        return "This task failed";
+
+      default:
+        return summaryOf(cause);
+    }
+}
+
+function summaryOf(cause) {
+    switch (cause.kind) {
+      case "failed-effect":
+        return "An automated step failed";
+
+      case "hung-effect":
+        return "An automated step didn’t finish";
+
+      case "failed-activity":
+        return "A task failed";
+
+      case "no-transition-fires":
+        return "Every task is done, but nothing moves this workflow on";
+
+      case "transition-unevaluable":
+        return "This workflow is waiting on something it can’t read yet, and will move on by itself";
+    }
+}
+
+function activityDeclaringEffect(args) {
+    return findStageNode(args)?.activities?.find(activity => (activity.actions ?? []).some(action => (action.effects ?? []).some(effect => effect.name === args.effectName)))?.name;
+}
+
+function faultingActivity(args) {
+    const {cause: cause} = args;
+    if (cause.kind === "failed-activity") return cause.activity;
+    if (cause.kind === "failed-effect" || cause.kind === "hung-effect") return activityDeclaringEffect({
+        definition: args.definition,
+        effectName: cause.effect.name,
+        stageName: args.stageName
+    });
+}
+
+function isRecoverable(cause) {
+    return cause.kind === "transition-unevaluable";
+}
+
+function diagnosisOf(args) {
+    if (args.evaluation !== void 0) return diagnoseInstance(diagnoseInputFromEvaluation(args.evaluation));
+    const cause = documentStuckCause({
+        instance: args.instance,
+        definition: args.definition
+    });
+    return cause === void 0 ? void 0 : {
+        state: "stuck",
+        cause: cause
+    };
+}
+
+function instanceFault(args) {
+    const diagnosis = diagnosisOf(args);
+    if (diagnosis === void 0 || diagnosis.state !== "stuck") return;
+    const verbs = remediationsFor(diagnosis).map(remediation2 => remediation2.verb);
+    return {
+        activity: faultingActivity({
+            cause: diagnosis.cause,
+            definition: args.definition,
+            stageName: args.instance.currentStage
+        }),
+        detail: detailOf(diagnosis.cause),
+        summary: summaryOf(diagnosis.cause),
+        remedies: verbs.flatMap(verb => REMEDY_TEXT[verb] ?? []),
+        actions: verbs.flatMap(verb => isRunnable(verb) ? [ {
+            verb: verb,
+            label: ACTION_LABEL[verb]
+        } ] : []),
+        recoverable: isRecoverable(diagnosis.cause)
+    };
+}
+
+function looksLikeDefinition(value) {
+    return typeof value == "object" && value !== null && Array.isArray(value.stages);
+}
+
+const parsed = /* @__PURE__ */ new WeakMap;
+
+function definitionSnapshotOf(instance) {
+    if (parsed.has(instance)) return parsed.get(instance);
+    let definition;
+    try {
+        const candidate = parseDefinitionSnapshot(instance);
+        if (!looksLikeDefinition(candidate)) throw new Error(`definitionSnapshot on "${instance._id}" parsed to a non-definition shape`);
+        definition = candidate;
+    } catch (err) {
+        console.error("[workflow-studio-plugin] unreadable definitionSnapshot:", err), definition = void 0;
+    }
+    return parsed.set(instance, definition), definition;
+}
+
+function useDefinition(entry) {
+    return useMemo(() => {
+        if (entry) return entry.evaluation ? entry.evaluation.definition : definitionSnapshotOf(entry.instance);
+    }, [ entry ]);
+}
+
+function AbortedBadge({instance: instance}) {
+    return terminalState(instance) !== "aborted" ? null : /* @__PURE__ */ jsx(Badge, {
+        fontSize: 1,
+        tone: "critical",
+        children: "Aborted"
+    });
+}
+
+function OlderDefinitionBadge({instance: instance}) {
+    const {latestDefinitionVersions: latestDefinitionVersions} = useWorkflowContext(), latest = latestDefinitionVersions.get(instance.definition);
+    return latest === void 0 || latest <= instance.pinnedVersion ? null : /* @__PURE__ */ jsx(HoverHint, {
+        description: "Running workflows keep the version they started on",
+        text: `Started on v${instance.pinnedVersion}, latest is now v${latest}`,
+        textWeight: "medium",
+        children: /* @__PURE__ */ jsx(Badge, {
+            fontSize: 1,
+            tone: "caution",
+            children: "Older version"
+        })
+    });
+}
+
+function useInstanceFault(entry) {
+    return instanceFault({
+        definition: useDefinition(entry),
+        evaluation: entry.evaluation,
+        instance: entry.instance
+    });
+}
+
+function InstanceFaultNote({entry: entry, scope: scope}) {
+    const fault = useInstanceFault(entry);
+    if (fault === void 0 || scope.kind === "task" && fault.activity !== scope.activityName) return null;
+    const Icon = fault.recoverable ? WarningOutlineIcon : ErrorOutlineIcon;
+    /* @__PURE__ */
+    return jsx(Card, {
+        padding: 3,
+        radius: 3,
+        tone: fault.recoverable ? "caution" : "critical",
+        children: /* @__PURE__ */ jsxs(Flex, {
+            align: "flex-start",
+            gap: 3,
+            children: [ 
+            /* @__PURE__ */ jsx(Text, {
+                size: 1,
+                children: /* @__PURE__ */ jsx(Icon, {})
+            }), 
+            /* @__PURE__ */ jsxs(Stack, {
+                flex: 1,
+                gap: 3,
+                children: [ 
+                /* @__PURE__ */ jsx(Text, {
+                    size: 1,
+                    weight: "medium",
+                    children: scope.kind === "run" ? fault.summary : fault.detail
+                }), scope.kind === "run" ? /* @__PURE__ */ jsx(RunControl, {
+                    activity: fault.activity,
+                    onOpenActivity: scope.onOpenActivity
+                }) : /* @__PURE__ */ jsx(TaskControls, {
+                    actions: fault.actions,
+                    instanceId: entry.instance._id,
+                    remedies: fault.remedies
+                }) ]
+            }) ]
+        })
+    });
+}
+
+function RunControl({activity: activity, onOpenActivity: onOpenActivity}) {
+    return activity === void 0 ? null : /* @__PURE__ */ jsx(Flex, {
+        children: /* @__PURE__ */ jsx(Button, {
+            fontSize: 1,
+            mode: "ghost",
+            onClick: () => onOpenActivity(activity),
+            padding: 2,
+            text: "View task"
+        })
+    });
+}
+
+const RUN_VERB = {
+    "drain-effects": drain => drain.run()
+};
+
+function TaskControls({actions: actions, instanceId: instanceId, remedies: remedies}) {
+    const drain = useDrainEffects(instanceId);
+    /* @__PURE__ */
+    return jsxs(Fragment, {
+        children: [ remedies.length === 0 ? null : /* @__PURE__ */ jsx(Text, {
+            muted: !0,
+            size: 1,
+            children: remedies.join(" ")
+        }), actions.length === 0 ? null : /* @__PURE__ */ jsx(Flex, {
+            gap: 2,
+            children: actions.map(action => /* @__PURE__ */ jsx(Button, {
+                disabled: drain.busy,
+                fontSize: 1,
+                mode: "ghost",
+                onClick: () => {
+                    RUN_VERB[action.verb](drain);
+                },
+                padding: 2,
+                text: action.label
+            }, action.verb))
+        }) ]
+    });
+}
+
 function MetaRow({children: children, fillHeight: fillHeight, label: label}) {
     /* @__PURE__ */
     return jsxs(Flex, {
@@ -4127,7 +4449,7 @@ function useBadgeCapTrim() {
 }
 
 function SpinnerSlot({busy: busy}) {
-    const size = useTextIconSize(), trim = useCapTrimFor(size);
+    const size = useTextIconSize(), trim = useCapTrimFor(size), spinning = useDelayedFlag(busy, LOADING_CUE_DELAY_MS);
     /* @__PURE__ */
     return jsx(Flex, {
         align: "center",
@@ -4139,7 +4461,7 @@ function SpinnerSlot({busy: busy}) {
             marginTop: trim,
             width: size
         },
-        children: busy ? /* @__PURE__ */ jsx(Spinner, {
+        children: spinning ? /* @__PURE__ */ jsx(Spinner, {
             muted: !0,
             size: 1
         }) : null
@@ -4147,6 +4469,7 @@ function SpinnerSlot({busy: busy}) {
 }
 
 function LoadingRow({label: label, padding: padding}) {
+    const announced = useDelayedFlag(!0, LOADING_CUE_DELAY_MS);
     /* @__PURE__ */
     return jsxs(Flex, {
         align: "center",
@@ -4157,12 +4480,11 @@ function LoadingRow({label: label, padding: padding}) {
         children: [ 
         /* @__PURE__ */ jsx(SpinnerSlot, {
             busy: !0
-        }), 
-        /* @__PURE__ */ jsx(Text, {
+        }), announced ? /* @__PURE__ */ jsx(Text, {
             muted: !0,
             size: 1,
             children: label
-        }) ]
+        }) : null ]
     });
 }
 
@@ -4218,7 +4540,7 @@ function AvatarButton({avatar: avatar, onClick: onClick, onMouseDown: onMouseDow
 }
 
 function RowAssignees({assignees: assignees, hint: hint}) {
-    const ids = assignees.flatMap(item => item.type === "user" ? [ item.id ] : []), {members: members} = useProjectMembers(), roles = assignees.flatMap(item => item.type === "role" ? [ memberRoleFor(members, item.role) ] : []), displays = useUserDisplays(ids);
+    const ids = assignees.flatMap(item => item.type === "user" ? [ item.id ] : []), vocabulary = useProjectMembers(), roles = assignees.flatMap(item => item.type === "role" ? [ memberRoleFor(vocabulary, item.role) ] : []), displays = useUserDisplays(ids);
     if (ids.length === 0 && roles.length === 0) return null;
     const bothKinds = roles.length > 0 && displays.length > 0;
     /* @__PURE__ */
@@ -4429,49 +4751,40 @@ function ForMeEmptyState() {
     });
 }
 
-function looksLikeDefinition(value) {
-    return typeof value == "object" && value !== null && Array.isArray(value.stages);
-}
-
-const parsed = /* @__PURE__ */ new WeakMap;
-
-function definitionSnapshotOf(instance) {
-    if (parsed.has(instance)) return parsed.get(instance);
-    let definition;
-    try {
-        const candidate = parseDefinitionSnapshot(instance);
-        if (!looksLikeDefinition(candidate)) throw new Error(`definitionSnapshot on "${instance._id}" parsed to a non-definition shape`);
-        definition = candidate;
-    } catch (err) {
-        console.error("[workflow-studio-plugin] unreadable definitionSnapshot:", err), definition = void 0;
-    }
-    return parsed.set(instance, definition), definition;
-}
+const OVERDUE_HINT = "Now overdue";
 
-function useDefinition(entry) {
-    return useMemo(() => {
-        if (entry) return entry.evaluation ? entry.evaluation.definition : definitionSnapshotOf(entry.instance);
-    }, [ entry ]);
+function hintFace(args) {
+    return args.overdue ? args.reason === void 0 ? {
+        text: OVERDUE_HINT
+    } : {
+        text: OVERDUE_HINT,
+        description: args.reason
+    } : args.reason === void 0 ? void 0 : {
+        text: args.reason
+    };
 }
 
-function AbortedBadge({instance: instance}) {
-    return terminalState(instance) !== "aborted" ? null : /* @__PURE__ */ jsx(Badge, {
-        fontSize: 1,
-        tone: "critical",
-        children: "Aborted"
+function DueDate({dueDate: dueDate, hintDisabled: hintDisabled, overdue: overdue, reason: reason}) {
+    const face = hintFace({
+        overdue: overdue,
+        reason: reason
+    }), text = overdue ? 
+    /* @__PURE__ */ jsx(TextWithTone, {
+        size: 1,
+        tone: "caution",
+        children: formatDate(dueDate)
+    }) : /* @__PURE__ */ jsx(Text, {
+        muted: !0,
+        size: 1,
+        children: formatDate(dueDate)
     });
-}
-
-function OlderDefinitionBadge({instance: instance}) {
-    const {latestDefinitionVersions: latestDefinitionVersions} = useWorkflowContext(), latest = latestDefinitionVersions.get(instance.definition);
-    return latest === void 0 || latest <= instance.pinnedVersion ? null : /* @__PURE__ */ jsx(HoverHint, {
-        description: "Running workflows keep the version they started on",
-        text: `Started on v${instance.pinnedVersion}, latest is now v${latest}`,
-        textWeight: "medium",
-        children: /* @__PURE__ */ jsx(Badge, {
-            fontSize: 1,
-            tone: "caution",
-            children: "Older version"
+    return face === void 0 ? text : 
+    /* @__PURE__ */ jsx(Flex, {
+        align: "center",
+        children: /* @__PURE__ */ jsx(HoverHint, {
+            ...face,
+            disabled: hintDisabled === !0,
+            children: text
         })
     });
 }
@@ -4511,18 +4824,6 @@ function CheckboxSlot({children: children}) {
     });
 }
 
-function DueDateText({dueDate: dueDate, overdue: overdue}) {
-    return overdue ? /* @__PURE__ */ jsx(TextWithTone, {
-        size: 1,
-        tone: "caution",
-        children: formatDate(dueDate)
-    }) : /* @__PURE__ */ jsx(Text, {
-        muted: !0,
-        size: 1,
-        children: formatDate(dueDate)
-    });
-}
-
 function DueDateEditor({dueDate: dueDate, onDone: onDone, onPatch: onPatch}) {
     /* @__PURE__ */
     return jsx(ClearableDatePicker, {
@@ -4542,8 +4843,9 @@ function DueDateEditor({dueDate: dueDate, onDone: onDone, onPatch: onPatch}) {
 }
 
 function DueDateControl({item: item, editable: editable, onPatch: onPatch}) {
-    const [open, setOpen] = useState(!1), overdue = isTodoOverdue(item), display = item.dueDate ? /* @__PURE__ */ jsx(DueDateText, {
+    const [open, setOpen] = useState(!1), overdue = isTodoOverdue(item), display = item.dueDate ? /* @__PURE__ */ jsx(DueDate, {
         dueDate: item.dueDate,
+        hintDisabled: open,
         overdue: overdue
     }) : null;
     return editable ? /* @__PURE__ */ jsx(DismissablePopover, {
@@ -4554,18 +4856,14 @@ function DueDateControl({item: item, editable: editable, onPatch: onPatch}) {
         }),
         onDismiss: () => setOpen(!1),
         open: open,
-        children: display ? /* @__PURE__ */ jsx(HoverHint, {
-            disabled: !overdue || open,
-            text: "Now overdue",
-            children: /* @__PURE__ */ jsx(Button, {
-                "aria-label": "Change due date",
-                fontSize: 1,
-                mode: "bleed",
-                onClick: () => setOpen(v => !v),
-                padding: 2,
-                tone: overdue ? "caution" : "default",
-                children: display
-            })
+        children: display ? /* @__PURE__ */ jsx(Button, {
+            "aria-label": "Change due date",
+            fontSize: 1,
+            mode: "bleed",
+            onClick: () => setOpen(v => !v),
+            padding: 2,
+            tone: overdue ? "caution" : "default",
+            children: display
         }) : /* @__PURE__ */ jsx(HoverHint, {
             disabled: open,
             text: "Set due date",
@@ -4579,9 +4877,6 @@ function DueDateControl({item: item, editable: editable, onPatch: onPatch}) {
                 radius: 2
             })
         })
-    }) : display && overdue ? /* @__PURE__ */ jsx(HoverHint, {
-        text: "Now overdue",
-        children: display
     }) : display;
 }
 
@@ -5234,9 +5529,15 @@ function ActivityDetailDialog({entry: entry, activityName: activityName, breadcr
     const detail = deriveActivityDetail({
         entry: entry,
         activityName: activityName
-    });
+    }), faultingActivity2 = useInstanceFault(entry)?.activity;
     if (!detail) return null;
-    const instanceId = entry.instance._id, notice = blockedNotice(detail), hasBody = detail.state.length > 0 || notice !== void 0;
+    const instanceId = entry.instance._id, notice = blockedNotice(detail), fault = /* @__PURE__ */ jsx(InstanceFaultNote, {
+        entry: entry,
+        scope: {
+            kind: "task",
+            activityName: activityName
+        }
+    }), faulted = faultingActivity2 === activityName, hasBody = detail.state.length > 0 || notice !== void 0 || faulted;
     /* @__PURE__ */
     return jsxs(Dialog, {
         footer: detail.presentation.terminalActions.length > 0 ? /* @__PURE__ */ jsx(TerminalFooter, {
@@ -5277,7 +5578,7 @@ function ActivityDetailDialog({entry: entry, activityName: activityName, breadcr
             padding: 4,
             children: /* @__PURE__ */ jsxs(Stack, {
                 gap: 5,
-                children: [ detail.state.map(field => /* @__PURE__ */ jsx(FieldRow, {
+                children: [ fault, detail.state.map(field => /* @__PURE__ */ jsx(FieldRow, {
                     activityName: activityName,
                     detail: detail,
                     entry: entry,
@@ -5458,6 +5759,18 @@ function CountedLabel({count: count, label: label}) {
     });
 }
 
+function CountedHeading({count: count, title: title}) {
+    /* @__PURE__ */
+    return jsx(CountedLabel, {
+        count: count,
+        label: /* @__PURE__ */ jsx(Text, {
+            size: 1,
+            weight: "semibold",
+            children: title
+        })
+    });
+}
+
 function GroupHeading({busy: busy, count: count, title: title, end: end}) {
     /* @__PURE__ */
     return jsxs(Flex, {
@@ -5466,13 +5779,9 @@ function GroupHeading({busy: busy, count: count, title: title, end: end}) {
         paddingLeft: 2,
         paddingY: end === void 0 ? 3 : 1,
         children: [ 
-        /* @__PURE__ */ jsx(CountedLabel, {
+        /* @__PURE__ */ jsx(CountedHeading, {
             count: count,
-            label: /* @__PURE__ */ jsx(Text, {
-                size: 1,
-                weight: "semibold",
-                children: title
-            })
+            title: title
         }), busy === void 0 ? null : /* @__PURE__ */ jsx(SpinnerSlot, {
             busy: busy
         }), end === void 0 ? null : /* @__PURE__ */ jsxs(Fragment, {
@@ -5484,21 +5793,81 @@ function GroupHeading({busy: busy, count: count, title: title, end: end}) {
     });
 }
 
+const EMPTY_METRIC_OPACITY = .5;
+
+function MetricText({children: children, tone: tone}) {
+    return tone === void 0 ? /* @__PURE__ */ jsx(Text, {
+        muted: !0,
+        size: 1,
+        children: children
+    }) : /* @__PURE__ */ jsx(TextWithTone, {
+        size: 1,
+        tone: tone,
+        children: children
+    });
+}
+
+function MetricPair({Icon: Icon, empty: empty, face: face, tone: tone, value: value}) {
+    /* @__PURE__ */
+    return jsx(HoverHint, {
+        ...face,
+        children: /* @__PURE__ */ jsxs(Flex, {
+            align: "center",
+            gap: 2,
+            style: empty ? {
+                opacity: EMPTY_METRIC_OPACITY
+            } : void 0,
+            children: [ 
+            /* @__PURE__ */ jsx(MetricText, {
+                tone: tone,
+                children: /* @__PURE__ */ jsx(Icon, {
+                    style: {
+                        color: "inherit"
+                    }
+                })
+            }), 
+            /* @__PURE__ */ jsx(MetricText, {
+                tone: tone,
+                children: value
+            }) ]
+        })
+    });
+}
+
+function AlertGlyph({Icon: Icon, hint: hint, tone: tone}) {
+    /* @__PURE__ */
+    return jsx(HoverHint, {
+        text: hint,
+        children: /* @__PURE__ */ jsx(TextWithTone, {
+            size: 1,
+            tone: tone,
+            children: /* @__PURE__ */ jsx(Icon, {
+                style: {
+                    color: "inherit"
+                }
+            })
+        })
+    });
+}
+
 function ActivityDateControl({instanceId: instanceId, state: state, surface: surface, dueDates: dueDates}) {
     const editField = useEditField(surface), {save: save} = useSaveField({
         instanceId: instanceId
     }), [open, setOpen] = useState(!1), raw = dateControlValue({
         state: state,
         dueDates: dueDates
-    }), display = raw === void 0 ? null : /* @__PURE__ */ jsx(Text, {
-        muted: !0,
-        size: 1,
-        children: formatDate(raw)
+    }), overdue = raw !== void 0 && isDueDatePast(raw, /* @__PURE__ */ new Date), dueDate = reason => raw === void 0 ? null : /* @__PURE__ */ jsx(DueDate, {
+        dueDate: raw,
+        hintDisabled: open,
+        overdue: overdue,
+        ...reason === void 0 ? {} : {
+            reason: reason
+        }
     });
-    if (state.kind === "none") return display;
-    if (state.kind === "closed") return display === null ? null : /* @__PURE__ */ jsx(HoverHint, {
-        text: state.reason,
-        children: /* @__PURE__ */ jsx(Button, {
+    if (state.kind === "none") return dueDate();
+    if (state.kind === "closed") {
+        const display = dueDate(state.reason);
+        return display === null ? null : /* @__PURE__ */ jsx(Button, {
             "aria-label": "Date",
             as: "span",
             fontSize: 1,
@@ -5507,8 +5876,8 @@ function ActivityDateControl({instanceId: instanceId, state: state, surface: sur
             onMouseDown: stopRowMouseDown,
             padding: 2,
             children: display
-        })
-    });
+        });
+    }
     const kind = dateControlKind(state), commit = (mode, value) => {
         state.kind === "editable" && save(() => editField({
             instanceId: instanceId,
@@ -5544,7 +5913,7 @@ function ActivityDateControl({instanceId: instanceId, state: state, surface: sur
         }),
         onDismiss: () => setOpen(!1),
         open: open,
-        children: display ? /* @__PURE__ */ jsx(Button, {
+        children: raw !== void 0 ? /* @__PURE__ */ jsx(Button, {
             "aria-label": "Change date",
             as: "span",
             fontSize: 1,
@@ -5552,7 +5921,7 @@ function ActivityDateControl({instanceId: instanceId, state: state, surface: sur
             onClick: handleClick,
             onMouseDown: stopRowMouseDown,
             padding: 2,
-            children: display
+            children: dueDate()
         }) : /* @__PURE__ */ jsx(HoverHint, {
             disabled: open,
             text: "Set date",
@@ -5642,7 +6011,7 @@ function TitleTag({hint: hint, tone: tone, children: children}) {
     });
 }
 
-function ActivityRow({face: face, breadcrumb: breadcrumb, assignees: assignees, assignState: assignState, dateState: dateState, dueDates: dueDates, instanceId: instanceId, onOpen: onOpen, surface: surface, terminalActions: terminalActions = []}) {
+function ActivityRow({face: face, breadcrumb: breadcrumb, assignees: assignees, assignState: assignState, dateState: dateState, dueDates: dueDates, faultHint: faultHint, instanceId: instanceId, onOpen: onOpen, surface: surface, terminalActions: terminalActions = []}) {
     const settled = isTerminalActivityStatus(face.status), dimmed = settledDim(settled);
     /* @__PURE__ */
     return jsxs(WorkRow, {
@@ -5675,6 +6044,10 @@ function ActivityRow({face: face, breadcrumb: breadcrumb, assignees: assignees,
         /* @__PURE__ */ jsx(ActivityRowTitle, {
             dimmed: dimmed,
             children: face.title
+        }), faultHint === void 0 || face.status === "failed" ? null : /* @__PURE__ */ jsx(AlertGlyph, {
+            Icon: ErrorOutlineIcon,
+            hint: faultHint,
+            tone: "critical"
         }), face.automated ? /* @__PURE__ */ jsx(TitleTag, {
             hint: "Completes on its own — no user action is needed",
             children: "Automated"
@@ -5690,7 +6063,7 @@ function ActivityRow({face: face, breadcrumb: breadcrumb, assignees: assignees,
 }
 
 function ActivitiesList({entry: entry, onOpenActivity: onOpenActivity, surface: surface}) {
-    const activities = (entry.evaluation?.currentStage.activities ?? []).filter(t => !t.scopedOut), activityState = stateByActivity(entry.instance);
+    const activities = (entry.evaluation?.currentStage.activities ?? []).filter(t => !t.scopedOut), activityState = stateByActivity(entry.instance), fault = useInstanceFault(entry);
     return activities.length === 0 ? 
     /* @__PURE__ */ jsx(Box, {
         paddingX: 1,
@@ -5708,6 +6081,9 @@ function ActivitiesList({entry: entry, onOpenActivity: onOpenActivity, surface:
                 activityState: activityState,
                 editableFields: entry.evaluation?.editableFields
             }),
+            ...fault?.activity === t.activity.name ? {
+                faultHint: fault.summary
+            } : {},
             instanceId: entry.instance._id,
             onOpen: () => onOpenActivity(t.activity.name),
             surface: surface
@@ -5854,7 +6230,10 @@ function progressFillPercent(face) {
 }
 
 function deriveFieldPills(args) {
-    const {scope: scope, definition: definition, instance: instance, committed: committed, evaluation: evaluation} = args, declared = scope === "workflow" ? definition?.fields ?? [] : definition?.stages.find(s => s.name === instance.currentStage)?.fields ?? [], entries = scope === "workflow" ? instance.fields : findOpenStageEntry(instance)?.fields ?? [], entriesByName = new Map(entries.map(entry => [ entry.name, entry ])), editables = isEvaluationCurrent({
+    const {scope: scope, definition: definition, instance: instance, committed: committed, evaluation: evaluation} = args, declared = scope === "workflow" ? definition?.fields ?? [] : findStageNode({
+        definition: definition,
+        stageName: instance.currentStage
+    })?.fields ?? [], entries = scope === "workflow" ? instance.fields : findOpenStageEntry(instance)?.fields ?? [], entriesByName = new Map(entries.map(entry => [ entry.name, entry ])), editables = isEvaluationCurrent({
         committed: committed,
         evaluation: evaluation
     }) ? editablesByName(evaluation, scope) : /* @__PURE__ */ new Map, declaredNames = new Set(declared.map(d => d.name));
@@ -6088,7 +6467,7 @@ function AvatarCapAligned({children: children}) {
 }
 
 function AssigneesFace({assignees: assignees}) {
-    const {members: members} = useProjectMembers(), userIds = assignees.flatMap(a => a.type === "user" ? [ a.id ] : []), roles = assignees.flatMap(a => a.type === "role" ? [ roleLabelFor(members, a.role) ] : []);
+    const vocabulary = useProjectMembers(), userIds = assignees.flatMap(a => a.type === "user" ? [ a.id ] : []), roles = assignees.flatMap(a => a.type === "role" ? [ roleLabelFor(vocabulary, a.role) ] : []);
     /* @__PURE__ */
     return jsxs(Fragment, {
         children: [ userIds.length > 0 ? /* @__PURE__ */ jsx(AvatarCapAligned, {
@@ -7044,6 +7423,27 @@ function HintedMenuButton({hint: hint, ...menuButtonProps}) {
     });
 }
 
+function InlineEmphasis({children: children}) {
+    const {font: font} = useTheme_v2();
+    /* @__PURE__ */
+    return jsx("span", {
+        style: {
+            fontWeight: font.text.weights.medium
+        },
+        children: children
+    });
+}
+
+const MINUTE_MS = 6e4;
+
+function useMinuteClock() {
+    const [now, setNow] = useState(() => /* @__PURE__ */ new Date);
+    return useEffect(() => {
+        const timer = setInterval(() => setNow(/* @__PURE__ */ new Date), MINUTE_MS);
+        return () => clearInterval(timer);
+    }, []), now;
+}
+
 function historyWindow(args) {
     const {entries: entries, expanded: expanded} = args;
     return {
@@ -7053,28 +7453,10 @@ function historyWindow(args) {
 }
 
 function PendingEffectRows({instance: instance, now: now}) {
-    const {drainEffectsFor: drainEffectsFor, completeEffectFor: completeEffectFor, effectHandlers: effectHandlers} = useWorkflowContext(), toast = useWorkflowToast(), [busy, setBusy] = useState(!1), pending = instance.pendingEffects ?? [];
+    const {completeEffectFor: completeEffectFor, effectHandlers: effectHandlers} = useWorkflowContext(), toast = useWorkflowToast(), drain = useDrainEffects(instance._id), [resolving, setResolving] = useState(!1), pending = instance.pendingEffects ?? [];
     if (pending.length === 0) return null;
-    const runRegistered = async () => {
-        setBusy(!0);
-        try {
-            await drainEffectsFor(instance._id), toast.push({
-                id: TOAST_ID.effectsDrain,
-                status: "info",
-                title: "Ran the registered handlers"
-            });
-        } catch (err) {
-            toast.push({
-                id: TOAST_ID.effectsDrain,
-                status: "error",
-                title: "Failed to run pending effects",
-                description: describeError(err)
-            });
-        } finally {
-            setBusy(!1);
-        }
-    }, resolve = async (effectKey, status) => {
-        setBusy(!0);
+    const resolve = async (effectKey, status) => {
+        setResolving(!0);
         try {
             await completeEffectFor(instance._id, {
                 effectKey: effectKey,
@@ -7093,18 +7475,20 @@ function PendingEffectRows({instance: instance, now: now}) {
                 description: describeError(err)
             });
         } finally {
-            setBusy(!1);
+            setResolving(!1);
         }
     };
     /* @__PURE__ */
     return jsx(Fragment, {
         children: pending.map(fx => /* @__PURE__ */ jsx(PendingEffectRow, {
-            busy: busy,
+            busy: drain.busy || resolving,
             effect: fx,
             instanceId: instance._id,
             now: now,
             onResolve: status => resolve(fx._key, status),
-            onRunHandlers: runRegistered,
+            onRunHandlers: () => {
+                drain.run();
+            },
             registered: fx.name in effectHandlers
         }, fx._key))
     });
@@ -7188,12 +7572,7 @@ function PendingEffectRow({busy: busy, effect: effect, instanceId: instanceId, n
 }
 
 function ActivityLog({instance: instance, definition: definition, windowed: windowed = !0}) {
-    const titles = useMemo(() => makeTitleResolver(definition), [ definition ]), entries = useMemo(() => instance.history.toReversed(), [ instance.history ]), [now, setNow] = useState(() => /* @__PURE__ */ new Date), [expanded, setExpanded] = useState(!1);
-    useEffect(() => {
-        const timer = setInterval(() => setNow(/* @__PURE__ */ new Date), 6e4);
-        return () => clearInterval(timer);
-    }, []);
-    const history = historyWindow({
+    const titles = useMemo(() => makeTitleResolver(definition), [ definition ]), entries = useMemo(() => instance.history.toReversed(), [ instance.history ]), now = useMinuteClock(), [expanded, setExpanded] = useState(!1), history = historyWindow({
         entries: entries,
         expanded: expanded || !windowed
     });
@@ -7296,12 +7675,9 @@ function HistoryRow({entry: entry, now: now, titles: titles}) {
 }
 
 function ActorNameSpan({id: id}) {
-    const {name: name} = useUserDisplay(id), {font: font} = useTheme_v2();
+    const {name: name} = useUserDisplay(id);
     /* @__PURE__ */
-    return jsx("span", {
-        style: {
-            fontWeight: font.text.weights.medium
-        },
+    return jsx(InlineEmphasis, {
         children: name
     });
 }
@@ -7709,7 +8085,6 @@ function StageOverviewCard({overview: overview}) {
 }
 
 function AdvanceCard({advance: advance}) {
-    const {font: font} = useTheme_v2();
     /* @__PURE__ */
     return jsx(Card, {
         padding: 3,
@@ -7721,10 +8096,7 @@ function AdvanceCard({advance: advance}) {
             /* @__PURE__ */ jsxs(Text, {
                 size: 1,
                 children: [ "Advances to ", 
-                /* @__PURE__ */ jsx("span", {
-                    style: {
-                        fontWeight: font.text.weights.medium
-                    },
+                /* @__PURE__ */ jsx(InlineEmphasis, {
                     children: advance.toTitle
                 }), ADVANCE_TAILS[advance.kind] ]
             }), advance.kind !== "conditions" ? null : advance.lines.map((line, index) => 
@@ -7848,18 +8220,23 @@ function StageSection({entry: entry, onOpenActivity: onOpenActivity, surface: su
     });
 }
 
-function CautionNote({action: action, label: label}) {
+const BANNER_PADDING = 3, ICONS = {
+    caution: /* @__PURE__ */ jsx(WarningOutlineIcon, {}),
+    critical: /* @__PURE__ */ jsx(ErrorOutlineIcon, {})
+};
+
+function NoteBanner({action: action, label: label, tone: tone = "caution"}) {
     /* @__PURE__ */
     return jsxs(Card, {
         paddingLeft: 3,
         paddingRight: 2,
-        paddingY: 3,
+        paddingY: BANNER_PADDING,
         radius: 3,
         style: {
             alignItems: "center",
             display: "flex"
         },
-        tone: "caution",
+        tone: tone,
         children: [ 
         /* @__PURE__ */ jsxs(Flex, {
             align: "center",
@@ -7869,7 +8246,7 @@ function CautionNote({action: action, label: label}) {
             /* @__PURE__ */ jsx(Text, {
                 muted: !0,
                 size: 1,
-                children: /* @__PURE__ */ jsx(WarningOutlineIcon, {})
+                children: ICONS[tone]
             }), 
             /* @__PURE__ */ jsx(Text, {
                 muted: !0,
@@ -7906,7 +8283,7 @@ function UnreadableDocsNote({unreadable: unreadable}) {
     if (unreadable.length === 0) return null;
     const label = unreadable.length === 1 ? "1 workflow document isn’t listed — this Studio can’t read it. Share the details with your Studio maintainers." : `${unreadable.length} workflow documents aren’t listed — this Studio can’t read them. Share the details with your Studio maintainers.`;
     /* @__PURE__ */
-    return jsx(CautionNote, {
+    return jsx(NoteBanner, {
         action: /* @__PURE__ */ jsx(CopyDetailsButton, {
             unreadable: unreadable
         }),
@@ -7952,6 +8329,21 @@ function InvalidDocNotice({invalid: invalid}) {
     });
 }
 
+function RoleAssignedNotice() {
+    /* @__PURE__ */
+    return jsx(Box, {
+        padding: 2,
+        children: /* @__PURE__ */ jsx(Text, {
+            muted: !0,
+            size: 1,
+            style: {
+                fontStyle: "italic"
+            },
+            children: "Including tasks assigned to your role"
+        })
+    });
+}
+
 function TabSwitch({ariaControls: ariaControls, idPrefix: idPrefix, options: options, selected: selected, onSelect: onSelect}) {
     /* @__PURE__ */
     return jsx(TabList, {
@@ -8216,8 +8608,15 @@ function presentedResumeEntry(args) {
     if (!args.startNew) return findResumeEntry(args);
 }
 
+function settledByAnotherWriter(cause, instance) {
+    return isRevisionConflict(cause) && terminalState(instance) === "completed";
+}
+
 function classifyStartError(err) {
-    return err instanceof StartNotSettledError ? {
+    return err instanceof StartNotSettledError ? err.instance !== void 0 && settledByAnotherWriter(err.cause, err.instance) ? {
+        kind: "started-settled-elsewhere",
+        instance: err.instance
+    } : {
         kind: "started-not-settled",
         instance: err.instance,
         description: describeError(err.cause)
@@ -8230,8 +8629,16 @@ function classifyStartError(err) {
     };
 }
 
+function startProducedRun(outcome) {
+    return outcome.kind === "started-not-settled" || outcome.kind === "started-settled-elsewhere";
+}
+
 function startOutcomeToast(outcome, label) {
-    return outcome.kind === "started-not-settled" ? {
+    return outcome.kind === "started-settled-elsewhere" ? {
+        id: TOAST_ID.start,
+        status: "info",
+        title: `“${label}” started and finished`
+    } : outcome.kind === "started-not-settled" ? {
         id: TOAST_ID.start,
         status: "warning",
         title: `“${label}” started but didn’t finish`,
@@ -8797,7 +9204,7 @@ function DiscoverySpinner() {
     });
 }
 
-const BOOT_CUE_DELAY_MS = 400, GROUP_GAP = 2;
+const GROUP_GAP = 2;
 
 function useWorkflowsTab() {
     const {params: params, setParams: setParams} = usePaneRouter();
@@ -8822,7 +9229,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(), telemetry = useWorkflowTelemetry(), {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, {
+    const identity = useAssignmentIdentity(), panelId = useId(), {params: params} = usePaneRouter(), {view: view, setView: setView} = useWorkflowsTab(), telemetry = useWorkflowTelemetry(), {openActivity: openActivity, setOpenActivity: setOpenActivity, dialogEntry: dialogEntry} = useOpenActivity(entries), active = entries.filter(isLiveEntry), finished = entries.filter(e => !isLiveEntry(e)), forMe = forMeWorkOf(active, identityOf(identity)), [landing] = useState(() => focusedLanding(params?.[WORKFLOWS_FOCUS_PARAM], entries.map(e => e.instance._id))), assignedWorkUnknown = active.some(e => e.invalid !== void 0), booting = active.some(e => !e.ready && e.invalid === void 0), sectionFor = e => /* @__PURE__ */ jsx(WorkflowInstanceSection, {
         defaultOpen: landingDefaultOpen(landing, e.instance._id),
         entry: e,
         onOpenActivity: activityName => setOpenActivity({
@@ -8962,10 +9369,10 @@ function OverviewEmptyState({mappings: mappings, docId: docId, initialValue: ini
 }
 
 function ForMeTab({forMe: forMe, assignedWorkUnknown: assignedWorkUnknown, onOpenActivity: onOpenActivity}) {
-    return forMe.hasRows ? /* @__PURE__ */ jsx(Stack, {
+    return forMe.hasRows ? /* @__PURE__ */ jsxs(Stack, {
         gap: GROUP_GAP,
         paddingBottom: 4,
-        children: forMe.work.map(({entry: entry, who: who, shown: shown}) => /* @__PURE__ */ jsx(ForMeList, {
+        children: [ forMe.hasRoleMatched ? /* @__PURE__ */ jsx(RoleAssignedNotice, {}) : null, forMe.work.map(({entry: entry, who: who, shown: shown}) => /* @__PURE__ */ jsx(ForMeList, {
             entry: entry,
             identity: who,
             work: shown,
@@ -8974,7 +9381,7 @@ function ForMeTab({forMe: forMe, assignedWorkUnknown: assignedWorkUnknown, onOpe
                 activityName: activityName,
                 stage: entry.instance.currentStage
             })
-        }, entry.instance._id))
+        }, entry.instance._id)) ]
     }) : assignedWorkUnknown ? null : /* @__PURE__ */ jsx(ForMeEmptyState, {});
 }
 
@@ -10211,7 +10618,7 @@ function ResumeNote({onStartNew: onStartNew}) {
 
 function handleStartError(args) {
     const {label: label, toast: toast, seedInstance: seedInstance, onClose: onClose} = args, outcome = classifyStartError(args.err);
-    toast.push(startOutcomeToast(outcome, label)), outcome.kind === "started-not-settled" && (outcome.instance !== void 0 && seedInstance(outcome.instance), 
+    toast.push(startOutcomeToast(outcome, label)), startProducedRun(outcome) && (outcome.instance !== void 0 && seedInstance(outcome.instance), 
     onClose());
 }
 
@@ -10564,7 +10971,7 @@ async function startRequest(engine, request) {
         };
     } catch (err) {
         const outcome = classifyStartError(err);
-        return outcome.kind === "started-not-settled" ? outcome.instance ? {
+        return startProducedRun(outcome) ? outcome.instance ? {
             instance: outcome.instance
         } : {} : outcome.kind === "not-allowed" ? {} : {
             failure: outcome.description
@@ -10765,6 +11172,28 @@ function unassignedLineHint(args) {
     };
 }
 
+function taskCountState(args) {
+    const {entry: entry, identity: identity} = args, freshness = entry.invalid === void 0 ? evaluationFreshness({
+        committed: entry.committed,
+        evaluation: entry.evaluation
+    }) : void 0;
+    return identity.kind === "unavailable" ? {
+        kind: "unknowable"
+    } : identity.kind === "pending" || freshness === "pending" ? {
+        kind: "pending"
+    } : freshness === "stale" ? {
+        kind: "stale"
+    } : {
+        kind: "ready",
+        tasks: assignedTaskCount({
+            instance: entry.instance,
+            committed: entry.committed,
+            evaluation: entry.evaluation,
+            who: identity.identity
+        })
+    };
+}
+
 function WorkflowFormStrip(props) {
     const {mappings: mappings} = props, {isDocResolved: isDocResolved, discoveryInvalid: discoveryInvalid} = useWorkflowContext(), {docId: docId, entries: entries} = useWorkflowsForDocument(props.value?._id ?? null), {params: params, setParams: setParams} = usePaneRouter(), telemetry = useWorkflowTelemetry(), openWorkflowsView = focusId => {
         telemetry.log(WorkflowFormStripClicked), setParams(focusedViewParams(params, focusId));
@@ -10852,7 +11281,7 @@ function InstanceLine({entry: entry, onOpen: onOpen}) {
         aside: unprimed ? void 0 : /* @__PURE__ */ jsx(TaskCountSpinner, {
             entry: entry
         }),
-        hint: lineHint(entry, identity),
+        hint: lineHint(entry, identityOf(identity)),
         onOpen: onOpen,
         children: [ 
         /* @__PURE__ */ jsx(Flex, {
@@ -10911,28 +11340,16 @@ function finishedHint(instance) {
 }
 
 function useTaskCountState(entry) {
-    const identity = useAssignmentIdentity(), freshness = entry.invalid === void 0 ? evaluationFreshness({
-        committed: entry.committed,
-        evaluation: entry.evaluation
-    }) : void 0;
-    return !identity || freshness === "pending" ? {
-        kind: "pending"
-    } : freshness === "stale" ? {
-        kind: "stale"
-    } : {
-        kind: "ready",
-        tasks: assignedTaskCount({
-            instance: entry.instance,
-            committed: entry.committed,
-            evaluation: entry.evaluation,
-            who: identity
-        })
-    };
+    const identity = useAssignmentIdentity();
+    return taskCountState({
+        entry: entry,
+        identity: identity
+    });
 }
 
 function TaskCountText({entry: entry}) {
     const state = useTaskCountState(entry);
-    return state.kind === "pending" || state.kind === "ready" && state.tasks === 0 ? null : /* @__PURE__ */ jsx(Text, {
+    return state.kind === "pending" || state.kind === "unknowable" || state.kind === "ready" && state.tasks === 0 ? null : /* @__PURE__ */ jsx(Text, {
         muted: !0,
         size: 1,
         children: state.kind === "stale" ? "Updating…" : pluralize("assigned task", state.tasks, !0)
@@ -11163,4 +11580,4 @@ function WorkflowRootInput(props) {
     });
 }
 
-export { AbortWorkflowDialog, ActivityDetailDialog, ActivityLog, ActivityRow, BreadcrumbTail, CautionNote, CodeChip, CountedLabel, DismissablePopover, DocPreviewLink, DocRefFace, EmptyState, ForMeEmptyState, Hairline, HoverHint, InstanceSnapshotBody, InvalidDocNotice, LinkChip, LoadingRow, LogEventOnMount, MetaRow, SpinnerSlot, StageFace, StaleLock, TOAST_ID, TOOL_TABS, TabSwitch, UnreadableDocsNote, WORKFLOW_API_VERSION, WORKFLOW_PAGE_TABS, WorkflowBoardWorkflowSelected, WorkflowDefinitionDetailViewed, WorkflowInstanceDetailViewed, WorkflowTaskFiltersApplied, WorkflowTitleSeedDrifted, WorkflowToolOpened, activityRowProps, assigneesOf, backToTabLabel, committedRowFace, createSubscribers, datesOf, definitionFingerprint, definitionSnapshotOf, describeError, dueDatesOf, findActivity, findActivityNode, formatDate, formatShortDateTime, formatTimeAgo, gdrLocality, instanceBreadcrumb, instanceState, instanceTitle, isActivityAssignedTo, isEvaluationStale, isLiveEntry, isOpenActivityStatus, landingState, mappingIssueDetail, namesNoDeployedDefinition, openActivityGone, openableSchemaType, parseStoredDateValue, readDeployedDefinitions, rowAssignControlState, rowDateControlState, stageTitle, stateByActivity, tabSelectionNavigates, toolRoute, toolTabState, useAssignmentIdentity, useBadgeCapTrim, useContainerToken, useDefinition, useDelayedFlag, useLogEventOnMount, useProjectMembers, useSpaceToken, useUserDisplays, useWorkflowContext, useWorkflowInstanceEntry, useWorkflowToast, workflowDefaultDocumentNode, workflowPageState, workflowState, workflowStudioPlugin, workflowsView };
+export { AbortWorkflowDialog, ActivityDetailDialog, ActivityLog, ActivityRow, AlertGlyph, BreadcrumbTail, CodeChip, CountedHeading, DismissablePopover, DocPreviewLink, DocRefFace, EmptyState, ForMeEmptyState, Hairline, HoverHint, InlineEmphasis, InstanceFaultNote, InstanceSnapshotBody, InvalidDocNotice, LinkChip, LoadingRow, LogEventOnMount, MetaRow, MetricPair, NoteBanner, RoleAssignedNotice, SpinnerSlot, StageFace, StaleLock, TOAST_ID, TOOL_TABS, TabSwitch, UnreadableDocsNote, WORKFLOW_API_VERSION, WORKFLOW_PAGE_TABS, WorkflowBoardWorkflowSelected, WorkflowDefinitionDetailViewed, WorkflowInstanceDetailViewed, WorkflowTaskFiltersApplied, WorkflowTitleSeedDrifted, WorkflowToolOpened, activityRowProps, assigneesOf, backToTabLabel, committedRowFace, createSubscribers, datesOf, definitionFingerprint, definitionSnapshotOf, describeError, dueDatesOf, findActivity, formatDate, formatShortAgo, formatShortDateTime, formatTimeAgo, gdrLocality, identityOf, instanceBreadcrumb, instanceState, instanceTitle, isActivityAssignedTo, isDueDatePast, isEvaluationStale, isLiveEntry, isOpenActivityStatus, isRoleAssignedTo, landingState, mappingIssueDetail, namesNoDeployedDefinition, openActivityGone, openableSchemaType, parseStoredDateValue, readDeployedDefinitions, rowAssignControlState, rowDateControlState, stageTitle, stateByActivity, tabSelectionNavigates, toolRoute, toolTabState, useAssignmentIdentity, useContainerToken, useDefinition, useLogEventOnMount, useMinuteClock, useProjectMembers, useSpaceToken, useUserDisplays, useWorkflowContext, useWorkflowInstanceEntry, useWorkflowToast, workflowDefaultDocumentNode, workflowPageState, workflowState, workflowStudioPlugin, workflowsView };