@sanity/workflow-studio-plugin 0.28.0 → 0.30.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, isRevisionConflict, 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";
 
@@ -18,7 +18,7 @@ import { CloseIcon } from "@sanity/icons/Close";
 
 import { formatDistanceToNow } from "date-fns/formatDistanceToNow";
 
-import { sameAssignee, projectMemberRow, ClearableDatePicker, AssigneePicker as AssigneePicker$1, MemberPicker as MemberPicker$1, MemberAvatar, AssigneeBadges as AssigneeBadges$1, AssigneeBadge as AssigneeBadge$1, ProgressBar, memberRoleFor, AssigneeStack, roleLabel, clampProgress, MemberAvatarGroup, progressCaption, DatePicker, roleLabelFor, roleListLabel } from "@sanity/workflow-components";
+import { sameAssignee, projectMemberRow, providerTitle, ClearableDatePicker, AssigneePicker as AssigneePicker$1, MemberPicker as MemberPicker$1, MemberAvatar, AssigneeBadges as AssigneeBadges$1, AssigneeBadge as AssigneeBadge$1, ProgressBar, memberRoleFor, AssigneeStack, roleLabel, clampProgress, MemberAvatarGroup, progressCaption, DatePicker, roleLabelFor, roleListLabel } from "@sanity/workflow-components";
 
 import { getPublishedId, getDraftId } from "@sanity/client/csm";
 
@@ -26,7 +26,7 @@ import { defineEvent } from "@sanity/telemetry";
 
 import { useStudioProjectUsers, useStudioObserver, useWorkflowEngine, useWorkflowInstances, useWorkflowSession } from "@sanity/workflow-studio";
 
-import { useCurrentUser, Preview, SanityDefaultPreview, useValuePreview, useClient, useSchema, useWorkspace, TextWithTone, usePerspective, useIsReleaseActive, useDocumentPreviewStore, useActiveReleases, useTemplates, useInitialValueResolverContext, resolveInitialValue, definePlugin, isObjectInputProps } from "sanity";
+import { useCurrentUser, Preview, useValuePreview, SanityDefaultPreview, useClient, useSchema, useWorkspace, TextWithTone, usePerspective, useIsReleaseActive, useDocumentPreviewStore, useActiveReleases, useTemplates, useInitialValueResolverContext, resolveInitialValue, definePlugin, isObjectInputProps } from "sanity";
 
 import { CalendarIcon } from "@sanity/icons/Calendar";
 
@@ -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";
@@ -78,8 +80,6 @@ import { CogIcon } from "@sanity/icons/Cog";
 
 import { ArrowUpIcon } from "@sanity/icons/ArrowUp";
 
-import { ErrorOutlineIcon } from "@sanity/icons/ErrorOutline";
-
 import { of } from "rxjs";
 
 import { switchMap, distinctUntilChanged } from "rxjs/operators";
@@ -367,7 +367,7 @@ function landingDefaultOpen(landing, instanceId) {
     if (!(landing === void 0 || !landing.instanceIds.includes(instanceId))) return instanceId === landing.focusedId;
 }
 
-const WORKFLOWS_TOOL_NAME = "workflows", WORKFLOW_INTENT = "workflow";
+const WORKFLOWS_TOOL_NAME = "workflows", WORKFLOW_INTENT = "workflow", RUN_SEARCH_PARAM = "run";
 
 function pathSegmentName(args) {
     return args.names.find(name => name === args.segment);
@@ -379,9 +379,10 @@ function handlesWorkflowIntent(intent, params) {
 
 function workflowIntentState(intent, params) {
     const instanceId = params.instanceId;
-    return intent === WORKFLOW_INTENT && typeof instanceId == "string" ? {
-        instanceId: instanceId
-    } : null;
+    return intent !== WORKFLOW_INTENT || typeof instanceId != "string" ? null : {
+        workflowsTab: "overview",
+        _searchParams: [ [ RUN_SEARCH_PARAM, instanceId ] ]
+    };
 }
 
 const pad2 = n => String(n).padStart(2, "0"), DUE_DATE_FIELD_KINDS = [ "dueDate", "dueDatetime" ], DATE_FIELD_KINDS = [ "date", "datetime", ...DUE_DATE_FIELD_KINDS ], DATE_FIELD_KIND_SET = new Set(DATE_FIELD_KINDS), DUE_DATE_FIELD_KIND_SET = new Set(DUE_DATE_FIELD_KINDS);
@@ -409,16 +410,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) {
@@ -469,14 +479,19 @@ function formatTimeAgo(value) {
 }
 
 function formatShortAgo(value, now) {
+    const span = formatShortSpan(value, now);
+    return span === "—" ? "—" : span === "now" ? "just now" : `${span} ago`;
+}
+
+function formatShortSpan(value, now) {
     const d = new Date(value);
     if (Number.isNaN(d.getTime())) return "—";
     const seconds = Math.floor((now.getTime() - d.getTime()) / 1e3);
-    if (seconds < 60) return "just now";
+    if (seconds < 60) return "now";
     const minutes = Math.floor(seconds / 60);
-    if (minutes < 60) return `${minutes}m ago`;
+    if (minutes < 60) return `${minutes}m`;
     const hours = Math.floor(minutes / 60);
-    return hours < 24 ? `${hours}h ago` : `${Math.floor(hours / 24)}d ago`;
+    return hours < 24 ? `${hours}h` : `${Math.floor(hours / 24)}d`;
 }
 
 function stampFace(verb, at) {
@@ -599,7 +614,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) {
@@ -700,7 +715,7 @@ function todoFieldEditability(args) {
 }
 
 function itemRow(args) {
-    const {item: item, items: items, field: field, source: source, ticks: ticks, editability: editability} = args, tick = ticks.get(tickKey(field.name, item._key));
+    const {item: item, items: items, field: field, source: source, ticks: ticks, editability: editability} = args, tick = ticks.get(tickKey(field.name, item._key)), eligibleAssigneeRoles = field.of.find(column => column.name === "assignee" && column.type === "assignee")?.roles;
     return {
         item: item,
         items: items,
@@ -715,6 +730,9 @@ function itemRow(args) {
         ...editability.editDisabledReason ? {
             editDisabledReason: editability.editDisabledReason
         } : {},
+        ...eligibleAssigneeRoles === void 0 ? {} : {
+            eligibleAssigneeRoles: eligibleAssigneeRoles
+        },
         ...tick ? {
             tick: tick
         } : {}
@@ -920,7 +938,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
@@ -931,6 +949,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 {
@@ -938,7 +965,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",
@@ -1105,24 +1132,10 @@ function dateValuesOf(state, matches) {
     return state.filter(entry => matches(entry._type)).map(entry => entry.value).filter(value => typeof value == "string" && value !== "");
 }
 
-function datesOf(state) {
-    return dateValuesOf(state, isDateFieldKind);
-}
-
 function dueDatesOf(state) {
     return dateValuesOf(state, isDueDateFieldKind);
 }
 
-function committedRowFace(row) {
-    return {
-        activityName: row.activityName,
-        title: row.title,
-        status: row.status,
-        automated: !1,
-        blocked: !1
-    };
-}
-
 function activityRowProps(args) {
     const {activityEval: activityEval, activityState: activityState, editableFields: editableFields} = args, state = activityState.get(activityEval.activity.name) ?? [], controlArgs = {
         activity: activityEval.activity,
@@ -1221,15 +1234,15 @@ function useWorkflowInstanceEntry(instanceId, options = {}) {
 }
 
 const WorkflowToolOpened = defineEvent({
-    name: "Editorial Workflows Studio Plugin Tool Opened",
-    version: 2,
+    name: "Workflows Studio Plugin Tool Opened",
+    version: 3,
     description: "The Workflows tool was opened or its tab was switched"
 }), WorkflowDocumentViewOpened = defineEvent({
-    name: "Editorial Workflows Studio Plugin Document View Opened",
+    name: "Workflows Studio Plugin Document View Opened",
     version: 1,
     description: "The Workflows document view was opened or its tab was switched"
 }), WorkflowInstanceDetailViewed = defineEvent({
-    name: "Editorial Workflows Studio Plugin Instance Detail Viewed",
+    name: "Workflows Studio Plugin Instance Detail Viewed",
     version: 1,
     description: "The Workflows tool's per-instance detail view was opened"
 });
@@ -1242,67 +1255,63 @@ function definitionFingerprint(definition) {
 }
 
 const WorkflowDefinitionDetailViewed = defineEvent({
-    name: "Editorial Workflows Studio Plugin Definition Detail Viewed",
+    name: "Workflows Studio Plugin Definition Detail Viewed",
     version: 1,
     description: "A workflow's definition page was opened in the Workflows tool"
 }), WorkflowFormStripClicked = defineEvent({
-    name: "Editorial Workflows Studio Plugin Form Strip Clicked",
+    name: "Workflows Studio Plugin Form Strip Clicked",
     version: 1,
     description: "The form strip's instance line was clicked, opening the document view"
 }), WorkflowDocumentLinkClicked = defineEvent({
-    name: "Editorial Workflows Studio Plugin Document Link Clicked",
-    version: 2,
+    name: "Workflows Studio Plugin Document Link Clicked",
+    version: 3,
     description: "A document link was clicked, opening the referenced document's editor"
 }), WorkflowStartDialogOpened = defineEvent({
-    name: "Editorial Workflows Studio Plugin Start Dialog Opened",
+    name: "Workflows Studio Plugin Start Dialog Opened",
     version: 1,
     description: "The start-workflow dialog was opened"
 }), WorkflowStartDialogSubmitted = defineEvent({
-    name: "Editorial Workflows Studio Plugin Start Dialog Submitted",
+    name: "Workflows Studio Plugin Start Dialog Submitted",
     version: 1,
     description: "The start-workflow dialog's confirm was pressed"
 }), WorkflowAutoStartRan = defineEvent({
-    name: "Editorial Workflows Studio Plugin Auto Start Ran",
+    name: "Workflows Studio Plugin Auto Start Ran",
     version: 1,
     description: "A fresh document's auto-start ran — one start request per configured workflow"
 }), WorkflowActionControlUsed = defineEvent({
-    name: "Editorial Workflows Studio Plugin Action Control Used",
-    version: 2,
+    name: "Workflows Studio Plugin Action Control Used",
+    version: 3,
     description: "An action-firing control was used, attributed to its UI surface"
 }), WorkflowFieldControlUsed = defineEvent({
-    name: "Editorial Workflows Studio Plugin Field Control Used",
-    version: 1,
+    name: "Workflows Studio Plugin Field Control Used",
+    version: 2,
     description: "A field-editing control committed an edit, attributed to its UI surface"
 }), WorkflowActivityDialogOpened = defineEvent({
-    name: "Editorial Workflows Studio Plugin Activity Dialog Opened",
-    version: 1,
+    name: "Workflows Studio Plugin Activity Dialog Opened",
+    version: 2,
     description: "The activity detail dialog was opened"
-}), WorkflowTaskFiltersApplied = defineEvent({
-    name: "Editorial Workflows Studio Plugin Task Filters Applied",
-    version: 1,
-    description: "The tool's task-filter menu closed with a changed selection"
 }), WorkflowBoardWorkflowSelected = defineEvent({
-    name: "Editorial Workflows Studio Plugin Board Workflow Selected",
-    version: 2,
-    description: "The workflow documents page settled on the workflow it's showing"
+    name: "Workflows Studio Plugin Board Workflow Selected",
+    version: 3,
+    description: "The Overview's board display settled on the workflow it's showing"
 }), WorkflowTitleSeedDrifted = defineEvent({
-    name: "Editorial Workflows Studio Plugin Title Seed Drifted",
+    name: "Workflows Studio Plugin Title Seed Drifted",
     version: 1,
     description: "A cold-start seeded preview title diverged from the live preview pipeline"
 }), WorkflowTodoToggled = defineEvent({
-    name: "Editorial Workflows Studio Plugin Todo Toggled",
+    name: "Workflows Studio Plugin Todo Toggled",
     version: 1,
     description: "A todo checkbox was toggled, attributed to its UI surface and write seam"
 }), WorkflowTodoEdited = defineEvent({
-    name: "Editorial Workflows Studio Plugin Todo Edited",
+    name: "Workflows Studio Plugin Todo Edited",
     version: 1,
     description: "A non-toggle todo-list write, attributed to its UI surface and gesture"
 }), WorkflowAbortDialogOpened = defineEvent({
-    name: "Editorial Workflows Studio Plugin Abort Dialog Opened",
+    name: "Workflows Studio Plugin Abort Dialog Opened",
     version: 1,
     description: "The abort-workflow confirm was opened"
 }), WorkflowAbortDialogSubmitted = defineEvent({
-    name: "Editorial Workflows Studio Plugin Abort Dialog Submitted",
+    name: "Workflows Studio Plugin Abort Dialog Submitted",
     version: 1,
     description: "The abort-workflow confirm was submitted, carrying the attempt's outcome"
 });
@@ -1338,6 +1347,12 @@ function scalarValidationIssue(args) {
     return issues === void 0 ? void 0 : `${args.label}: ${issues.join("; ")}`;
 }
 
+function countBy(rows, keysOf) {
+    const counts = /* @__PURE__ */ new Map;
+    for (const row of rows) for (const key of keysOf(row)) counts.set(key, (counts.get(key) ?? 0) + 1);
+    return counts;
+}
+
 function personActor(user) {
     const roles = user.roles.map(role => typeof role == "string" ? role : role.name);
     return {
@@ -1369,10 +1384,16 @@ function userDisplayFor(args) {
     return {
         id: args.id,
         name: member?.displayName ?? self?.name ?? args.id,
-        imageUrl: member?.imageUrl ?? self?.profileImage ?? void 0
+        imageUrl: member?.imageUrl ?? self?.profileImage ?? void 0,
+        loginProvider: member?.loginProvider
     };
 }
 
+function disambiguatedNames(displays) {
+    const counts = countBy(displays, display => [ display.name ]);
+    return displays.map(display => (counts.get(display.name) ?? 0) < 2 || display.loginProvider === void 0 ? display.name : `${display.name} (${providerTitle(display.loginProvider) ?? display.loginProvider})`);
+}
+
 function useUserDisplays(ids) {
     const {members: members} = useProjectMembers(), {users: users} = useStudioProjectUsers(), meRaw = useCurrentUser(), me = useMemo(() => meRaw === null ? null : {
         ...meRaw,
@@ -1405,21 +1426,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() {
@@ -1428,13 +1460,26 @@ 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;
+}
+
+function useCurrentUserId() {
+    return identityOf(useAssignmentIdentity())?.userId;
+}
+
 const projectMembersByUsers = /* @__PURE__ */ new WeakMap;
 
 function projectMembersFrom(users) {
@@ -1542,6 +1587,8 @@ function buildParams(decls, values) {
     };
 }
 
+const LOADING_CUE_DELAY_MS = 400;
+
 function useDelayedFlag(active, delayMs) {
     const [held, setHeld] = useState(!1);
     return useEffect(() => {
@@ -1823,23 +1870,27 @@ function MemberPicker({selectedIds: selectedIds, onSelect: onSelect, unassignRow
     });
 }
 
-function AssigneePicker({value: value, onChange: onChange}) {
+function AssigneePicker({value: value, onChange: onChange, eligibleRoles: eligibleRoles, roleAliases: roleAliases}) {
     const state = useProjectMembers();
     /* @__PURE__ */
     return jsx(AssigneePicker$1, {
         ...state,
+        eligibleRoles: eligibleRoles,
         onChange: onChange,
+        roleAliases: roleAliases,
         value: value
     });
 }
 
-function SingleAssigneePicker({current: current, onPick: onPick}) {
+function SingleAssigneePicker({current: current, onPick: onPick, eligibleRoles: eligibleRoles, roleAliases: roleAliases}) {
     /* @__PURE__ */
     return jsx(AssigneePicker, {
+        eligibleRoles: eligibleRoles,
         onChange: next => {
             const picked = singleAssigneePick(current, next);
             picked !== void 0 && onPick(picked);
         },
+        roleAliases: roleAliases,
         value: current ? [ current ] : []
     });
 }
@@ -2152,7 +2203,6 @@ const TOAST_ID = {
     effectResolve: "workflow-effect-resolve",
     effectsDrain: "workflow-effects-drain",
     effectsIncomplete: "workflow-effects-incomplete",
-    orphanSettle: "workflow-orphan-settle",
     start: "workflow-start"
 };
 
@@ -2549,11 +2599,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) {
@@ -3013,8 +3062,7 @@ function PendingDocFace({bareId: bareId, layout: layout}) {
             children: id
         });
     }
-    return compact ? 
-    /* @__PURE__ */ jsxs(Flex, {
+    return compact ? /* @__PURE__ */ jsxs(Flex, {
         align: "center",
         gap: 2,
         children: [ 
@@ -3688,9 +3736,11 @@ function AssigneeField({field: field, instanceId: instanceId, onSave: onSave, on
         children: /* @__PURE__ */ jsx(DismissablePopover, {
             content: /* @__PURE__ */ jsx(SingleAssigneePicker, {
                 current: cur,
+                eligibleRoles: field.roles,
                 onPick: picked => {
                     setOpen(!1), pick(picked);
-                }
+                },
+                roleAliases: field.roleAliases
             }),
             onDismiss: () => setOpen(!1),
             open: open,
@@ -4021,6 +4071,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, {
@@ -4108,6 +4419,12 @@ function useSpaceToken(index) {
     return value;
 }
 
+function useRadiusToken(index) {
+    const value = useTheme_v2().radius[index];
+    if (value === void 0) throw new Error(`theme is missing radius token ${index}`);
+    return value;
+}
+
 function useContainerToken(index) {
     const value = useTheme_v2().container[index];
     if (value === void 0) throw new Error(`theme is missing container token ${index}`);
@@ -4148,10 +4465,9 @@ function useBadgeCapTrim() {
     };
 }
 
-function SpinnerSlot({busy: busy}) {
-    const size = useTextIconSize(), trim = useCapTrimFor(size);
-    /* @__PURE__ */
-    return jsx(Flex, {
+function SpinnerSlot({busy: busy, reserve: reserve = !0}) {
+    const size = useTextIconSize(), trim = useCapTrimFor(size), spinning = useDelayedFlag(busy, LOADING_CUE_DELAY_MS);
+    return !spinning && !reserve ? null : /* @__PURE__ */ jsx(Flex, {
         align: "center",
         flex: "none",
         justify: "center",
@@ -4161,7 +4477,7 @@ function SpinnerSlot({busy: busy}) {
             marginTop: trim,
             width: size
         },
-        children: busy ? /* @__PURE__ */ jsx(Spinner, {
+        children: spinning ? /* @__PURE__ */ jsx(Spinner, {
             muted: !0,
             size: 1
         }) : null
@@ -4169,6 +4485,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",
@@ -4179,12 +4496,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 ]
     });
 }
 
@@ -4245,8 +4561,7 @@ function RowAssignees({assignees: assignees, hint: hint}) {
     const bothKinds = roles.length > 0 && displays.length > 0;
     /* @__PURE__ */
     return jsx(HoverHint, {
-        content: 
-        /* @__PURE__ */ jsxs(Stack, {
+        content: /* @__PURE__ */ jsxs(Stack, {
             gap: 3,
             children: [ roles.length > 0 ? /* @__PURE__ */ jsx(HintSection, {
                 names: roles.map(roleLabel),
@@ -4254,7 +4569,7 @@ function RowAssignees({assignees: assignees, hint: hint}) {
                     label: "Roles"
                 } : {}
             }) : null, displays.length > 0 ? /* @__PURE__ */ jsx(HintSection, {
-                names: displays.map(display => display.name),
+                names: disambiguatedNames(displays),
                 ...bothKinds ? {
                     label: "Members"
                 } : {}
@@ -4333,8 +4648,7 @@ function AssignActivityControl({instanceId: instanceId, state: state, surface: s
         }
     }, handleClick = e => {
         e.stopPropagation(), setOpen(v => !v);
-    }, button = assignees.length > 0 ? 
-    /* @__PURE__ */ jsx(AvatarButton, {
+    }, button = assignees.length > 0 ? /* @__PURE__ */ jsx(AvatarButton, {
         "aria-label": "Assignees",
         as: "span",
         avatar: /* @__PURE__ */ jsx(RowAssignees, {
@@ -4364,9 +4678,11 @@ function AssignActivityControl({instanceId: instanceId, state: state, surface: s
                 label: "Loading…",
                 padding: 3
             }) : /* @__PURE__ */ jsx(AssigneePicker, {
+                eligibleRoles: state.field.roles,
                 onChange: next => {
                     change(next);
                 },
+                roleAliases: state.field.roleAliases,
                 value: current
             })
         }),
@@ -4451,49 +4767,39 @@ 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
         })
     });
 }
@@ -4524,24 +4830,12 @@ function CheckboxSlot({children: children}) {
     /* @__PURE__ */
     return jsx(Flex, {
         align: "center",
-        justify: "center",
-        style: {
-            lineHeight: 0,
-            margin: trim
-        },
-        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)
+        justify: "center",
+        style: {
+            lineHeight: 0,
+            margin: trim
+        },
+        children: children
     });
 }
 
@@ -4564,8 +4858,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, {
@@ -4576,18 +4871,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",
@@ -4601,13 +4892,10 @@ function DueDateControl({item: item, editable: editable, onPatch: onPatch}) {
                 radius: 2
             })
         })
-    }) : display && overdue ? /* @__PURE__ */ jsx(HoverHint, {
-        text: "Now overdue",
-        children: display
     }) : display;
 }
 
-function AssigneeControl({item: item, editable: editable, onPatch: onPatch}) {
+function AssigneeControl({item: item, editable: editable, eligibleRoles: eligibleRoles, onPatch: onPatch, roleAliases: roleAliases}) {
     const [open, setOpen] = useState(!1), current = item.assignee ?? null, chip = current ? /* @__PURE__ */ jsx(RowAssignees, {
         assignees: [ current ]
     }) : null;
@@ -4615,11 +4903,13 @@ function AssigneeControl({item: item, editable: editable, onPatch: onPatch}) {
         content: 
         /* @__PURE__ */ jsx(SingleAssigneePicker, {
             current: current,
+            eligibleRoles: eligibleRoles,
             onPick: picked => {
                 setOpen(!1), onPatch({
                     assignee: picked
                 });
-            }
+            },
+            roleAliases: roleAliases
         }),
         onDismiss: () => setOpen(!1),
         open: open,
@@ -4721,8 +5011,7 @@ function BreadcrumbTail({segments: segments, style: style}) {
 }
 
 function WorkRow({lead: lead, children: children, end: end, onOpen: onOpen}) {
-    const frame = 
-    /* @__PURE__ */ jsxs(Flex, {
+    const frame = /* @__PURE__ */ jsxs(Flex, {
         align: "center",
         children: [ 
         /* @__PURE__ */ jsx(Flex, {
@@ -4756,8 +5045,7 @@ function WorkRow({lead: lead, children: children, end: end, onOpen: onOpen}) {
         padding: 1,
         radius: 3,
         children: frame
-    }) : 
-    /* @__PURE__ */ jsx(Card, {
+    }) : /* @__PURE__ */ jsx(Card, {
         as: "button",
         onClick: onOpen,
         padding: 1,
@@ -4769,7 +5057,7 @@ function WorkRow({lead: lead, children: children, end: end, onOpen: onOpen}) {
     });
 }
 
-function TodoItemRowView({breadcrumb: breadcrumb, row: row, onToggle: onToggle, onPatch: onPatch, onRemove: onRemove}) {
+function TodoItemRowView({breadcrumb: breadcrumb, row: row, onToggle: onToggle, onPatch: onPatch, onRemove: onRemove, roleAliases: roleAliases}) {
     const {canClick: canClick, hint: hint} = rowInteractivity(row), editable = row.editTarget !== void 0, checkbox = /* @__PURE__ */ jsx(TodoCheckbox, {
         canClick: canClick,
         checked: isTodoDone(row.item),
@@ -4786,8 +5074,10 @@ function TodoItemRowView({breadcrumb: breadcrumb, row: row, onToggle: onToggle,
             }), 
             /* @__PURE__ */ jsx(AssigneeControl, {
                 editable: editable,
+                eligibleRoles: row.eligibleAssigneeRoles,
                 item: row.item,
-                onPatch: onPatch
+                onPatch: onPatch,
+                roleAliases: roleAliases
             }), onRemove === void 0 ? null : /* @__PURE__ */ jsx(RemoveItemButton, {
                 onClick: onRemove
             }) ]
@@ -4964,6 +5254,7 @@ function TodoItemsList({breadcrumb: breadcrumb, entry: entry, filter: filter, sh
                 onToggle: () => {
                     toggleRow(row);
                 },
+                roleAliases: definition?.roleAliases,
                 row: row
             }, rowKey(row)))
         }), addControl === null ? null : /* @__PURE__ */ jsx(Flex, {
@@ -5256,9 +5547,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, {
@@ -5299,7 +5596,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,
@@ -5480,6 +5777,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, {
@@ -5488,13 +5797,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, {
@@ -5506,21 +5811,85 @@ 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, label: label, tone: tone}) {
+    /* @__PURE__ */
+    return jsx(HoverHint, {
+        text: hint,
+        children: /* @__PURE__ */ jsx(TextWithTone, {
+            size: 1,
+            tone: tone,
+            children: /* @__PURE__ */ jsx(Icon, {
+                ...label === void 0 ? {} : {
+                    "aria-label": label,
+                    role: "img"
+                },
+                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,
@@ -5529,8 +5898,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,
@@ -5566,7 +5935,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,
@@ -5574,7 +5943,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",
@@ -5664,12 +6033,11 @@ 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, {
-        end: 
-        /* @__PURE__ */ jsxs(Fragment, {
+        end: /* @__PURE__ */ jsxs(Fragment, {
             children: [ 
             /* @__PURE__ */ jsx(ActivityDateControl, {
                 dueDates: dueDates,
@@ -5697,6 +6065,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"
@@ -5712,9 +6084,8 @@ 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);
-    return activities.length === 0 ? 
-    /* @__PURE__ */ jsx(Box, {
+    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,
         paddingY: 3,
         children: /* @__PURE__ */ jsx(Text, {
@@ -5730,6 +6101,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
@@ -5739,8 +6113,7 @@ function ActivitiesList({entry: entry, onOpenActivity: onOpenActivity, surface:
 
 function instanceNotice(entry) {
     const {instance: instance, committed: committed, evaluation: evaluation} = entry, state = terminalState(instance);
-    if (state !== "in-flight") 
-    /* @__PURE__ */
+    if (state !== "in-flight") /* @__PURE__ */
     return jsx(Box, {
         paddingX: 1,
         paddingY: 2,
@@ -5876,7 +6249,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));
@@ -5925,7 +6301,7 @@ function UserAvatar({id: id}) {
 function UserAvatarGroup({ids: ids, hint: hint}) {
     const displays = useUserDisplays(ids);
     return displays.length === 0 ? null : /* @__PURE__ */ jsx(HoverHint, {
-        text: displays.map(d => d.name).join(", "),
+        text: disambiguatedNames(displays).join(", "),
         ...hint === void 0 ? {} : {
             description: hint
         },
@@ -5984,8 +6360,7 @@ function FieldPills({entry: entry, scope: scope, definition: definition, surface
             pill: pill,
             scope: scope,
             surface: surface
-        }, pill.name)), overflow > 0 ? 
-        /* @__PURE__ */ jsx(Button, {
+        }, pill.name)), overflow > 0 ? /* @__PURE__ */ jsx(Button, {
             mode: "bleed",
             onClick: () => setExpanded(v => !v),
             padding: 2,
@@ -6424,9 +6799,11 @@ function AssigneePill({entry: entry, pill: pill, editability: editability, surfa
     return jsx(PillPopover, {
         content: /* @__PURE__ */ jsx(SingleAssigneePicker, {
             current: current,
+            eligibleRoles: editability.roles,
             onPick: picked => {
                 setOpen(!1), pick(picked);
-            }
+            },
+            roleAliases: editability.roleAliases
         }),
         onDismiss: () => setOpen(!1),
         onToggle: () => setOpen(v => !v),
@@ -6440,13 +6817,15 @@ function AssigneesPill({entry: entry, pill: pill, editability: editability, surf
         entry: entry,
         editability: editability,
         surface: surface
-    }), current = pill.face.kind === "assignees" ? pill.face.assignees : [];
+    }), current = pill.face.kind === "assignees" ? pill.face.assignees : [], change = next => {
+        saving || save(() => set(next));
+    };
     /* @__PURE__ */
     return jsx(PillPopover, {
         content: /* @__PURE__ */ jsx(AssigneePicker, {
-            onChange: next => {
-                saving || save(() => set(next));
-            },
+            eligibleRoles: editability.roles,
+            onChange: change,
+            roleAliases: editability.roleAliases,
             value: current
         }),
         onDismiss: () => setOpen(!1),
@@ -7032,6 +7411,24 @@ function historyLine(h, titles) {
     return historyLiner[h._type](h, titles);
 }
 
+function AgoStamp({at: at, now: now}) {
+    /* @__PURE__ */
+    return jsx(Flex, {
+        align: "center",
+        children: /* @__PURE__ */ jsx(HoverHint, {
+            text: formatShortDateTime(at),
+            children: /* @__PURE__ */ jsx(Text, {
+                muted: !0,
+                size: 1,
+                style: {
+                    whiteSpace: "nowrap"
+                },
+                children: formatShortAgo(at, now)
+            })
+        })
+    });
+}
+
 function CodeChip({value: value}) {
     /* @__PURE__ */
     return jsx("code", {
@@ -7066,6 +7463,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 {
@@ -7075,28 +7493,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,
@@ -7115,18 +7515,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))
     });
@@ -7210,12 +7612,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
     });
@@ -7257,16 +7654,9 @@ function FeedStamp({at: at, now: now}) {
             size: 1,
             children: "·"
         }), 
-        /* @__PURE__ */ jsx(HoverHint, {
-            text: formatDateTime(at),
-            children: /* @__PURE__ */ jsx(Text, {
-                muted: !0,
-                size: 1,
-                style: {
-                    whiteSpace: "nowrap"
-                },
-                children: formatShortAgo(at, now)
-            })
+        /* @__PURE__ */ jsx(AgoStamp, {
+            at: at,
+            now: now
         }) ]
     });
 }
@@ -7318,12 +7708,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
     });
 }
@@ -7378,8 +7765,7 @@ function InstanceCardMenu({entry: entry, title: title}) {
     return jsxs(Fragment, {
         children: [ 
         /* @__PURE__ */ jsx(MenuButton, {
-            button: 
-            /* @__PURE__ */ jsx(Button, {
+            button: /* @__PURE__ */ jsx(Button, {
                 "aria-label": `More options for ${title}`,
                 fontSize: 1,
                 icon: EllipsisHorizontalIcon,
@@ -7700,8 +8086,7 @@ function StageOverviewCard({overview: overview}) {
                     size: 1,
                     weight: "medium",
                     children: overview.title
-                }), overview.description === void 0 ? null : 
-                /* @__PURE__ */ jsx(Text, {
+                }), overview.description === void 0 ? null : /* @__PURE__ */ jsx(Text, {
                     muted: !0,
                     size: 1,
                     style: {
@@ -7731,7 +8116,6 @@ function StageOverviewCard({overview: overview}) {
 }
 
 function AdvanceCard({advance: advance}) {
-    const {font: font} = useTheme_v2();
     /* @__PURE__ */
     return jsx(Card, {
         padding: 3,
@@ -7743,14 +8127,10 @@ 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) => 
-            /* @__PURE__ */ jsx(Text, {
+            }), advance.kind !== "conditions" ? null : advance.lines.map((line, index) => /* @__PURE__ */ jsx(Text, {
                 muted: !0,
                 size: 1,
                 style: {
@@ -8804,8 +9184,7 @@ const VIEW_TAB_CODEC = workflowsTabCodec([ "overview", "for-me" ]), WorkflowsVie
         children: /* @__PURE__ */ jsx(InvalidDocNotice, {
             invalid: discoveryInvalid
         })
-    }) : resolved ? 
-    /* @__PURE__ */ jsx(Flex, {
+    }) : resolved ? /* @__PURE__ */ jsx(Flex, {
         direction: "column",
         height: "fill",
         padding: 4,
@@ -8854,7 +9233,7 @@ function DiscoverySpinner() {
     });
 }
 
-const BOOT_CUE_DELAY_MS = 400, GROUP_GAP = 2;
+const GROUP_GAP = 2;
 
 function useWorkflowsTab() {
     const {params: params, setParams: setParams} = usePaneRouter();
@@ -8879,7 +9258,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({
@@ -9107,7 +9486,10 @@ function resolveEntry(args) {
         }
         valid.push(name), definition && definitions.push({
             name: name,
-            fields: definition.fields
+            fields: definition.fields,
+            ...definition.roleAliases === void 0 ? {} : {
+                roleAliases: definition.roleAliases
+            }
         });
     }
     return {
@@ -9624,6 +10006,7 @@ function WorkflowProvider(props) {
         engine: engine,
         binding: binding,
         mappings: mappings,
+        previewHydration: config.previewHydration,
         mappingIssues: issues,
         mappingStarts: starts,
         mappingFields: fields,
@@ -9631,7 +10014,7 @@ function WorkflowProvider(props) {
         effectHandlers: engine.effectHandlers,
         autoStartByType: autoStartByType,
         autoStartDefinitions: autoStartDefinitions
-    }), [ register, unregister, isDocResolved, entriesStore, actualTypes, 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 ]);
+    }), [ register, unregister, isDocResolved, entriesStore, actualTypes, requestInstance, releaseInstance, requestEvaluation, releaseEvaluation, seedInstance, openStartDialog, closeStartDialog, startRequest2, loading, discoveryInvalid, fireActionFor, editFieldFor, previewFieldFor, discardFieldPreviewFor, drainEffectsFor, completeEffectFor, engine, binding, mappings, config.previewHydration, issues, starts, fields, latestVersions, autoStartByType, autoStartDefinitions ]);
     /* @__PURE__ */
     return jsxs(WorkflowContext.Provider, {
         value: value,
@@ -9733,7 +10116,7 @@ function logOnce(messages, logged) {
     for (const message of messages) logged.has(message) || (logged.add(message), console.warn(`[workflow-studio-plugin] ${message}`));
 }
 
-function AssigneesInput({value: value, onChange: onChange}) {
+function AssigneesInput({value: value, onChange: onChange, eligibleRoles: eligibleRoles, roleAliases: roleAliases}) {
     const [open, setOpen] = useState(!1), remove = index => onChange(value.filter((_, i) => i !== index));
     /* @__PURE__ */
     return jsxs(Stack, {
@@ -9767,7 +10150,9 @@ function AssigneesInput({value: value, onChange: onChange}) {
             wrap: "wrap",
             children: /* @__PURE__ */ jsx(DismissablePopover, {
                 content: /* @__PURE__ */ jsx(AssigneePicker, {
+                    eligibleRoles: eligibleRoles,
                     onChange: next => onChange([ ...next ]),
+                    roleAliases: roleAliases,
                     value: value
                 }),
                 onDismiss: () => setOpen(!1),
@@ -9836,11 +10221,29 @@ function ChecklistInput({value: value, onChange: onChange}) {
     });
 }
 
-function ReleasePicker({value: value, onChange: onChange}) {
-    const {binding: binding} = useWorkflowContext(), {data: data, loading: loading, error: error} = useActiveReleases(), releases = useMemo(() => data.filter(release => release.state === "active").map(release => ({
+function titleOf(release) {
+    return release.metadata.title ?? release.name;
+}
+
+function useReleaseTitles() {
+    const {data: data} = useActiveReleases();
+    return useMemo(() => new Map(data.map(release => [ release.name, titleOf(release) ])), [ data ]);
+}
+
+function useActiveReleaseOptions() {
+    const {data: data, loading: loading, error: error} = useActiveReleases(), releases = useMemo(() => data.filter(release => release.state === "active").map(release => ({
         name: release.name,
-        title: release.metadata.title ?? release.name
-    })).toSorted((a, b) => a.title.localeCompare(b.title)), [ data ]), labelOf = useMemo(() => {
+        title: titleOf(release)
+    })).toSorted((a, b) => a.title.localeCompare(b.title)), [ data ]);
+    return {
+        error: error,
+        loading: loading,
+        releases: releases
+    };
+}
+
+function ReleasePicker({value: value, onChange: onChange}) {
+    const {binding: binding} = useWorkflowContext(), {error: error, loading: loading, releases: releases} = useActiveReleaseOptions(), labelOf = useMemo(() => {
         const m = new Map(releases.map(r => [ r.name, r.title ]));
         return name => m.get(name) ?? name;
     }, [ releases ]);
@@ -10108,8 +10511,10 @@ const docRefInput = ({entry: entry, docType: docType, releaseId: releaseId, valu
         onChange: onChange,
         value: value ?? []
     }),
-    assignees: ({value: value, onChange: onChange}) => /* @__PURE__ */ jsx(AssigneesInput, {
+    assignees: ({entry: entry, roleAliases: roleAliases, value: value, onChange: onChange}) => /* @__PURE__ */ jsx(AssigneesInput, {
+        eligibleRoles: entry.roles,
         onChange: onChange,
+        roleAliases: roleAliases,
         value: value ?? []
     }),
     array: ({entry: entry, value: value, onChange: onChange}) => {
@@ -10151,7 +10556,7 @@ function FieldInput(props) {
     });
 }
 
-function InitFieldRow({entry: entry, docType: docType, releaseId: releaseId, value: value, onChange: onChange}) {
+function InitFieldRow({entry: entry, docType: docType, releaseId: releaseId, roleAliases: roleAliases, value: value, onChange: onChange}) {
     const label = entry.title ?? entry.name;
     /* @__PURE__ */
     return jsxs(Stack, {
@@ -10175,6 +10580,7 @@ function InitFieldRow({entry: entry, docType: docType, releaseId: releaseId, val
             entry: entry,
             onChange: onChange,
             releaseId: releaseId,
+            roleAliases: roleAliases,
             value: value
         }) ]
     });
@@ -10224,7 +10630,7 @@ function StartFooter({canStart: canStart, starting: starting, startLabel: startL
     });
 }
 
-function StartInputList({initFields: initFields, mapping: mapping, releaseId: releaseId, values: values, onChange: onChange}) {
+function StartInputList({initFields: initFields, mapping: mapping, releaseId: releaseId, roleAliases: roleAliases, values: values, onChange: onChange}) {
     return initFields.length === 0 ? /* @__PURE__ */ jsx(Text, {
         muted: !0,
         size: 1,
@@ -10235,6 +10641,7 @@ function StartInputList({initFields: initFields, mapping: mapping, releaseId: re
             entry: entry,
             onChange: v => onChange(entry.name, v),
             releaseId: releaseId,
+            roleAliases: roleAliases,
             value: values[entry.name] ?? null
         }, entry.name))
     });
@@ -10365,6 +10772,7 @@ function StartWorkflowForm({request: request, onClose: onClose}) {
             mapping: mapping,
             onChange: setValue,
             releaseId: releaseId,
+            roleAliases: definition.roleAliases,
             values: values
         }), 
         /* @__PURE__ */ jsx(StartFooter, {
@@ -10419,11 +10827,12 @@ function AutoStartInputDialog(props) {
                 }), 
                 /* @__PURE__ */ jsx(Stack, {
                     gap: 4,
-                    children: inputs.map(({entry: entry}) => /* @__PURE__ */ jsx(InitFieldRow, {
+                    children: inputs.map(({entry: entry, roleAliases: roleAliases}) => /* @__PURE__ */ jsx(InitFieldRow, {
                         docType: docType,
                         entry: entry,
                         onChange: value => setValue(entry.name, value),
                         releaseId: void 0,
+                        roleAliases: roleAliases,
                         value: values[entry.name] ?? null
                     }, entry.name))
                 }), 
@@ -10452,23 +10861,65 @@ function subjectEntry(definition) {
     return documentSubjectEntry(definition);
 }
 
-function autoStartInputs(args) {
+function autoStartInputPlan(args) {
     const byName = /* @__PURE__ */ new Map;
     for (const name of args.workflows) {
         const definition = args.definitions.get(name);
         if (definition !== void 0) for (const entry of extraRequiredInputs(definition)) {
-            const existing = byName.get(entry.name);
-            existing === void 0 ? byName.set(entry.name, {
+            const conflict = mergeAutoStartInput(byName, {
                 entry: entry,
-                workflows: [ name ]
-            }) : existing.workflows.push(name);
+                workflow: name,
+                roleAliases: definition.roleAliases
+            });
+            if (conflict !== void 0) return {
+                inputs: [],
+                conflict: conflict
+            };
         }
     }
-    return [ ...byName.values() ];
+    return {
+        inputs: [ ...byName.values() ]
+    };
+}
+
+function mergeAutoStartInput(byName, args) {
+    const existing = byName.get(args.entry.name);
+    if (existing === void 0) {
+        byName.set(args.entry.name, {
+            entry: args.entry,
+            workflows: [ args.workflow ],
+            ...args.roleAliases === void 0 ? {} : {
+                roleAliases: args.roleAliases
+            }
+        });
+        return;
+    }
+    if (!sameRoleSet(existing.entry.roles, args.entry.roles)) return `Auto-start input "${args.entry.name}" is shared by workflows "${existing.workflows.join('", "')}" and "${args.workflow}" with different role constraints`;
+    existing.workflows.push(args.workflow), sameRoleAliases(existing.roleAliases, args.roleAliases) || delete existing.roleAliases;
+}
+
+function sameRoleSet(left, right) {
+    return roleSetKey(left) === roleSetKey(right);
+}
+
+function roleSetKey(roles) {
+    return roles === void 0 ? void 0 : JSON.stringify(sortedUnique(roles));
+}
+
+function sameRoleAliases(left, right) {
+    return roleAliasesKey(left) === roleAliasesKey(right);
+}
+
+function roleAliasesKey(aliases) {
+    if (aliases !== void 0) return JSON.stringify(Object.entries(aliases).map(([role, fulfillers]) => [ role, sortedUnique(fulfillers) ]).toSorted(([left], [right]) => left.localeCompare(right)));
+}
+
+function sortedUnique(values) {
+    return [ ...new Set(values) ].toSorted();
 }
 
 function autoStartAction(args) {
-    return args.fired ? args.settled ? "reveal" : "starting" : args.pendingCount === 0 ? "reveal" : args.resolved ? args.needsInput ? "collect" : "silent-start" : "wait";
+    return args.fired ? args.settled ? "reveal" : "starting" : args.blocked || args.pendingCount === 0 ? "reveal" : args.resolved ? args.needsInput ? "collect" : "silent-start" : "wait";
 }
 
 function pendingWorkflows(workflows, live) {
@@ -10525,10 +10976,14 @@ function AutoStartDriver(props) {
         engine: engine
     }), {selectedReleaseId: selectedReleaseId} = usePerspective(), {entries: entries} = useWorkflowsForDocument(rawDocId), docId = getPublishedId(rawDocId), valueRef = useRef(value);
     valueRef.current = value;
-    const pending = useMemo(() => pendingWorkflows(workflows, new Set(entries.map(entry => entry.instance.definition))), [ workflows, entries ]), inputs = useMemo(() => autoStartInputs({
+    const pending = useMemo(() => pendingWorkflows(workflows, new Set(entries.map(entry => entry.instance.definition))), [ workflows, entries ]), inputPlan = useMemo(() => autoStartInputPlan({
         workflows: pending,
         definitions: autoStartDefinitions
-    }), [ pending, autoStartDefinitions ]), definitionsResolved = workflows.every(name => autoStartDefinitions.has(name)), pendingRef = useRef(pending);
+    }), [ pending, autoStartDefinitions ]), inputs = inputPlan.inputs;
+    useEffect(() => {
+        inputPlan.conflict !== void 0 && console.warn(`[Workflows] Auto-start skipped. ${inputPlan.conflict}`);
+    }, [ inputPlan.conflict ]);
+    const 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);
@@ -10580,6 +11035,7 @@ function AutoStartDriver(props) {
         resolved: definitionsResolved && isDocResolved(docId),
         pendingCount: pending.length,
         needsInput: inputs.length > 0,
+        blocked: inputPlan.conflict !== void 0,
         fired: fired,
         settled: settled
     });
@@ -10822,6 +11278,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));
@@ -10909,7 +11387,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, {
@@ -10968,28 +11446,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)
@@ -11015,19 +11481,13 @@ function StartWorkflowDialogHost() {
 }
 
 const TOOL_TAB_LABELS = {
-    overview: "Workflows",
-    "all-documents": "All documents",
-    "for-me": "For me"
+    overview: "Overview",
+    "for-me": "For me",
+    definitions: "Definitions"
 }, TOOL_TAB_VALUES = Object.keys(TOOL_TAB_LABELS), TOOL_TABS = TOOL_TAB_VALUES.map(value => ({
     value: value,
     label: TOOL_TAB_LABELS[value]
-})), LANDING_TAB = "overview", TASKS_TAB = "all-documents", WORKFLOW_PAGE_LABELS = {
-    workflow: "Documents",
-    definition: "Definition"
-}, WORKFLOW_PAGE_VALUES = Object.keys(WORKFLOW_PAGE_LABELS), DEFAULT_WORKFLOW_PAGE = "workflow", WORKFLOW_PAGES = WORKFLOW_PAGE_VALUES.filter(page => page !== DEFAULT_WORKFLOW_PAGE), WORKFLOW_PAGE_TABS = WORKFLOW_PAGE_VALUES.map(value => ({
-    value: value,
-    label: WORKFLOW_PAGE_LABELS[value]
-})), toolRouter = route.create("/", [ route.create("/instance/:instanceId"), route.create(`/${LANDING_TAB}/:workflowName`, [ route.create("/:workflowPage") ]), route.create("/:workflowsTab") ]);
+})), LANDING_TAB = "overview", DEFINITIONS_TAB = "definitions", toolRouter = route.create("/", [ route.create(`/${DEFINITIONS_TAB}/:workflowName`), route.create("/:workflowsTab") ]);
 
 function toolTabState(tab) {
     return {
@@ -11045,39 +11505,17 @@ function workflowState(workflowName) {
     };
 }
 
-function instanceState(instanceId) {
-    return {
-        instanceId: instanceId
-    };
-}
-
 function tabSelectionNavigates(current, tab) {
     return !(current.kind === "home" && tab === current.tab);
 }
 
-function toolTabLabel(tab) {
-    return TOOL_TAB_LABELS[tab];
-}
-
-function backToTabLabel(tab) {
-    return `Back to ${toolTabLabel(tab)}`;
-}
-
-function workflowPageState(page, workflowName) {
-    return page === DEFAULT_WORKFLOW_PAGE ? workflowState(workflowName) : {
-        ...workflowState(workflowName),
-        workflowPage: page
-    };
-}
-
 function toolRoute(state) {
-    const {instanceId: instanceId, workflowName: workflowName} = state;
-    if (typeof instanceId == "string") return {
-        kind: "instance",
-        instanceId: instanceId,
-        tab: TASKS_TAB
+    const {workflowName: workflowName} = state;
+    if (typeof workflowName == "string") return {
+        kind: "definition",
+        workflowName: workflowName,
+        tab: DEFINITIONS_TAB
     };
-    if (typeof workflowName == "string") return workflowRoute(workflowName, state.workflowPage);
     const tab = pathSegmentName({
         segment: state.workflowsTab,
         names: TOOL_TAB_VALUES
@@ -11091,24 +11529,11 @@ function toolRoute(state) {
     };
 }
 
-function workflowRoute(workflowName, pageSegment) {
-    if (pageSegment === void 0) return {
-        kind: "workflow",
-        workflowName: workflowName,
-        tab: LANDING_TAB
-    };
-    const page = pathSegmentName({
-        segment: pageSegment,
-        names: WORKFLOW_PAGES
-    });
-    return page === void 0 ? {
-        kind: "unnamed",
-        tab: LANDING_TAB
-    } : {
-        kind: page,
-        workflowName: workflowName,
-        tab: LANDING_TAB
+function definitionsRouteOf(route2) {
+    if (route2.kind === "definition") return {
+        workflowName: route2.workflowName
     };
+    if (route2.kind === "home" && route2.tab === "definitions") return {};
 }
 
 const WorkflowsToolRoot = lazy(() => import("./workflows-tool-root.js"));
@@ -11220,4 +11645,4 @@ function WorkflowRootInput(props) {
     });
 }
 
-export { AbortWorkflowDialog, ActivityDetailDialog, ActivityLog, ActivityRow, BreadcrumbTail, CodeChip, CountedLabel, DismissablePopover, DocPreviewLink, DocRefFace, EmptyState, ForMeEmptyState, Hairline, HoverHint, InstanceSnapshotBody, InvalidDocNotice, LinkChip, LoadingRow, LogEventOnMount, MetaRow, 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, findActivityNode, formatDate, formatShortDateTime, formatTimeAgo, gdrLocality, instanceBreadcrumb, instanceState, instanceTitle, isActivityAssignedTo, isEvaluationStale, isLiveEntry, isOpenActivityStatus, isRoleAssignedTo, 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, AgoStamp, AlertGlyph, CodeChip, CountedHeading, DismissablePopover, DocPreviewLink, DocRefFace, EmptyState, HoverHint, InstanceFaultNote, InstanceSnapshotBody, InvalidDocNotice, LoadingRow, LogEventOnMount, MetaRow, MetricPair, NoteBanner, RUN_SEARCH_PARAM, RoleAssignedNotice, RowAssignees, SpinnerSlot, TOOL_TABS, TabSwitch, UnreadableDocsNote, WORKFLOW_API_VERSION, WorkflowBoardWorkflowSelected, WorkflowDefinitionDetailViewed, WorkflowInstanceDetailViewed, WorkflowTitleSeedDrifted, WorkflowToolOpened, assigneesOf, countBy, definitionFingerprint, definitionsRouteOf, describeError, dueDatesOf, findActivity, formatShortDateTime, formatTimeAgo, gdrLocality, identityOf, instanceBreadcrumb, instanceTitle, isDueDatePast, isEvaluationStale, isLiveEntry, isOpenActivityStatus, landingState, mappingIssueDetail, namesNoDeployedDefinition, openActivityGone, openableSchemaType, parseStoredDateValue, readDeployedDefinitions, stageTitle, tabSelectionNavigates, toolRoute, toolTabState, useAssignmentIdentity, useAvatarSize, useCapTrimFor, useContainerToken, useCurrentUserId, useDefinition, useLogEventOnMount, useMinuteClock, useProjectMembers, useRadiusToken, useReleaseTitles, useSpaceToken, useTextIconSize, useUserDisplays, useWorkflowContext, useWorkflowInstanceEntry, workflowDefaultDocumentNode, workflowState, workflowStudioPlugin, workflowsView };