Skip to content

feat: Warning message when no workers are available for a task list#1168

Merged
YoavLev merged 3 commits intocadence-workflow:masterfrom
YoavLev:validate-tasklist-workers-webform
Feb 17, 2026
Merged

feat: Warning message when no workers are available for a task list#1168
YoavLev merged 3 commits intocadence-workflow:masterfrom
YoavLev:validate-tasklist-workers-webform

Conversation

@YoavLev
Copy link
Contributor

@YoavLev YoavLev commented Feb 16, 2026

Problem

When starting a workflow through the web UI, users had no visibility into whether the specified task list had active workers. This could lead to workflows being started against task lists with no workers (or missing activity/decision handlers), resulting in stuck or failed workflows with no immediate feedback.

Solution

Added a debounced task list lookup that validates the entered task list name against the cluster in real-time. A warning banner is displayed when:

  • The task list has no workers at all
  • The task list is missing activity workers
  • The task list is missing decision workers
  • A loading spinner is shown in the input while the lookup is in progress, and an error caption appears if the API call fails.

Changes Made

  • useDescribeTaskList hook — New hook that debounces the task list name input (300ms) and calls the describe-task-list API. Properly handles cleanup on unmount and reports a unified isLoading state that accounts for both debounce pending and fetch in-flight.
  • TaskListWorkersInfo component — Renders a warning banner when the task list is missing decision handlers, activity handlers, or has no workers at all.
  • workflow-action-start-form.tsx — Integrated the new hook and component into the Task List field. Added a loading spinner via endEnhancer, error state feedback, and real-time trimming of whitespace on input change. Now destructures and passes domain prop to the hook.

Examples

Loading state

image

Error state

image

Warning

image

Signed-off-by: Yoav Levy <yoavlev2@gmail.com>
@YoavLev YoavLev force-pushed the validate-tasklist-workers-webform branch from 2d6ad54 to 1f14741 Compare February 16, 2026 11:54
@Assem-Uber
Copy link
Contributor

Assem-Uber commented Feb 16, 2026

Design comments:

  • Banner is more suitable for whole form/page errors and not for a single field issue. Would recommend using styles similar to Form control caption.
  • Banner (the message) should be aligned with the input
  • I see that we are showing a caption if the task list request fails, can you add a screenshot for that one
  • Can you add screenshot for loading state

@YoavLev YoavLev force-pushed the validate-tasklist-workers-webform branch 3 times, most recently from 717606a to e8c1a13 Compare February 16, 2026 14:37
@YoavLev YoavLev force-pushed the validate-tasklist-workers-webform branch from e8c1a13 to 8bca85e Compare February 16, 2026 15:57
@YoavLev YoavLev merged commit eecc1b8 into cadence-workflow:master Feb 17, 2026
3 checks passed
Assem-Uber pushed a commit to Assem-Uber/cadence-web that referenced this pull request Feb 19, 2026
Assem-Uber added a commit that referenced this pull request Feb 20, 2026
* fix decode params in cluster methods

* fix url decode in worfklow actions APIs

* refactor: Move history scroll handlers to dedicated hook (#1156)

* Move code for Workflow History V2 scroll handlers (scroll to event, scroll up, scroll down) and variables (Virtuoso refs) to dedicated React hook
* Fix a minor bug with scrollToEvent where it would not work with the first event

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* refactor: rename onClickEvent to onClickShowInTable in Workflow History Timeline (#1157)

* To prepare for moving the click handling for events to a dedicated "Show in table" button, this PR renames the onClickEvent handler to onClickShowInTable

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* Lift timeline state up to workflow history root (#1158)

Lift timeline state up from WorkflowHistoryHeader to WorkflowHistoryV2, allowing sub-components in the list to open the timeline if necessary.

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* refactor: Use groupId from Event Groups entries instead of firstEventId in Workflow History Timeline (#1160)

Instead of setting the row ID as the firstEventId for Workflow History Timeline rows, this PR passes the groupId (which, in practice, is the exact same thing) to the getTimelineRowFromEventGroup helper

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: Show correct error banner message when failing to load domains from some clusters  (#1162)

Problem
When the Cadence UI fails to connect to some clusters to load domains, we show an error banner with the list of problematic clusters. However, this banner currently lists all clusters instead of just the problematic ones. This is due to a mistake in the logic for evaluating problematic clusters.

Solution
Fix the logic for evaluating problematic clusters
Break the getAllDomains helper up into separate helpers for better testability

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: Add cron schedule descriptions to Workflow History V2 components (#1163)

Add natural-language Cron descriptions (implemented in #1151) to Workflow History V2 details parsers config

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: Use ClustersConfigs type in getAllDomains unit test (#1165)

* Use server-side ClustersConfigs type and existing clusters configs fixtures in unit test for getAllDomains, to prevent getConfigValue's spy from assuming that it's of type PublicClustersConfigs (client-side)
* Rename setup param to clustersConfigs from clusterConfigs, to match the type

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: Add explicit "Copy link" text to history event link copy button (#1166)

* Add explicit "Copy link" text to history event link copy button in accordance with existing designs, to make the button's intent clearer without needing to hover on it
* Remove the "Copy link to event" tooltip that shows up when user initially hovers on the link button

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* feat: Add timeline scroll handler & target to useWorkflowHistoryScroll (#1167)

* Add timeline Virtuoso ref, scroll handler and scroll target (event group) to useWorkflowHistoryScroll, to use for timeline <-> table integration

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* feat: Warning message when no workers are available for a task list (#1168)

Signed-off-by: Yoav Levy <yoavlev2@gmail.com>

* feat: Add "Show in Timeline" button to event groups in grouped Workflow History table (#1169)

* Add timeline scroll handler in useWorkflowHistoryScroll hook with similar pattern to existing table scroll
* Add "Show in timeline" button in event group details panel that scrolls to and highlights the group in the timeline
* Implement animation effect for highlighted timeline rows using 2-second fade transition

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* feat: Add "Show in Table" button to event groups in Workflow History Timeline (#1171)

* Add "Show in Table" button to event groups in Workflow History Timeline, to highlight event groups in the Workflow History tables
* Remove the onClick functionality from the timeline event bar
* Increase tooltip entry time to 600ms (and define it in a constant instead of hardcoding it)
* Increase spacing between event tabs and action buttons from scale400 (12px) to scale1200 (48px)

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* feat: Add "Show in Timeline" button to events in ungrouped Workflow History table (#1170)

* Add the Show in Timeline button (added in #1169) to the ungrouped Workflow History table
* Add groupId to UngroupedEventsInfo
* Move createUngroupedEventsInfo test util to fixtures directory

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: Improper wrapping & overflow on Workflow Summary page (#1174)

* Rewrite the styles to use a simpler grid-based layout, distributing the space evenly between the summary details and the JSON panels
* Allow the workflow title to overflow onto multiple lines

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: Constrain size of group details tooltip in Workflow History timeline (#1176)

* Constrain max width of the tooltip to 800px
* Add an isScrollable prop to WorkflowHistoryEventDetails, constraining the height of non-panel details to 250px and making them scrollable if true
* Pass this prop through from WorkflowHistoryTimelineEventGroup

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* feat: Dynamically resize history timeline for running workflows (#1172)

* Add hook useCurrentTimeMs to accurately calculate the current time every second, instead of letting it be recalculated only on rerenders.
* Add hook useSteppedDomainMaxMs to calculate the timeline's max domain based on events and current time
Change the implementation of getTimelineMaxTimeMs to take current time as a parameter instead of calling Date.now() inside it
* For running events without an end time (so, any running events besides timers), use current time as the bar's end point, so that bars smoothly expand
* Add an outline to the timeline component
* Move header padding to timeline container margin (still size400/16px)
* Remove border between header cells

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: double decode params in cluster methods middleware (#1180)

* fix decode params in cluster methods

* fix double decoding

* add search attribute api

* fix: Stop click propagation when clicking on Workflow History summarized details (#1175)

* Add new field hasClickableContent to details row item config, which is set if the item is meant to be clickable
* Set this field to true for all existing links
* Call e.stopPropagation() in the details entry onClick handler to prevent the click from propagating to parents, if hasClickableContent is true


Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* refactor: Move types from workflow-history.types.ts to workflow-history-v2.types.ts (#1177)

* Move Workflow History types from v1 folder to v2 folder, to prepare for changes to history event group computation
* Refactor v2 code to use the types from workflow-history-v2.types.ts

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>

* fix: Double decode issue for summary page (#1183)

* fix decode params in cluster methods

* fix double decoding

* fix double encoding for summary page

* revert search attributes changes

---------

Signed-off-by: Adhitya Mamallan <adhitya.mamallan@uber.com>
Signed-off-by: Yoav Levy <yoavlev2@gmail.com>
Co-authored-by: Adhitya Mamallan <adhitya.mamallan@uber.com>
Co-authored-by: Yoav Levy <yoavlev2@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants