[cueweb] Collapse Pause/Unpause to a single state-aware toggle

- Job context menu now shows one entry instead of two: label and icon flip with the row's isPaused flag (Pause when running, Unpause when paused).
- Existing destructiveActive flag already handles the disabled cases (FINISHED jobs and the global Disable Job Interaction safety flag), so no new gating logic is needed.
- Toolbar buttons are unchanged - the multi-row selection can mix paused and running jobs, so it still needs both Pause Jobs and Unpause Jobs.
- Docs updated: reference + developer-guide carry the state matrix and code snippet; user-guide, tutorial, quick-start, and other-guides describe the user-facing toggle behavior.

Author: ramonfigueiredo

cueweb/components/ui/context_menus/action-context-menu.tsx

@@ -228,6 +228,12 @@ export const JobContextMenu: React.FC<JobContextMenuProps> = ({
   const editable = !jobInteractionDisabled;
   const grayIfDisabled = (active: boolean) => (active ? undefined : "gray");
 
+  // Pause/Unpause is a single toggle (CueGUI parity): show "Unpause" when
+  // the job is paused, "Pause" otherwise. destructiveActive already
+  // disables the entry on FINISHED jobs and when the global safety flag
+  // is set, so In Progress / Failing / Dependency all behave correctly.
+  const isJobPaused = !!contextMenuState.row?.original.isPaused;
+
   // CueGUI parity: order + grouping mirror cuegui.MenuActions.JobActions
   const menuItems: MenuItem[] = [
     // -- Top group: identity + lookup actions ----------------------
@@ -376,18 +382,16 @@ export const JobContextMenu: React.FC<JobContextMenuProps> = ({
 
     sep("group-pause"),
 
-    // -- Pause / Unpause ------------------------------------------
-    {
-      label: "Pause",
-      onClick: pauseJobGivenRow,
-      isActive: destructiveActive,
-      component: <TbPlayerPause className="mr-1" size={14} color={grayIfDisabled(destructiveActive)} />,
-    },
+    // -- Pause / Unpause (single toggle) --------------------------
     {
-      label: "Unpause",
-      onClick: unpauseJobGivenRow,
+      label: isJobPaused ? "Unpause" : "Pause",
+      onClick: isJobPaused ? unpauseJobGivenRow : pauseJobGivenRow,
       isActive: destructiveActive,
-      component: <TbPlayerPlay className="mr-1" size={14} color={grayIfDisabled(destructiveActive)} />,
+      component: isJobPaused ? (
+        <TbPlayerPlay className="mr-1" size={14} color={grayIfDisabled(destructiveActive)} />
+      ) : (
+        <TbPlayerPause className="mr-1" size={14} color={grayIfDisabled(destructiveActive)} />
+      ),
     },
 
     sep("group-eat-kill"),

docs/_docs/developer-guide/cueweb-development.md

@@ -527,6 +527,81 @@ If the fetch rejects, `layers` is set to `[]` and the prelude reads `(no layers
 
 ---
 
+## Pause / Unpause Toggle (Job Context Menu)
+
+The job context menu's **Pause / Unpause** entry is a single toggle: the
+label, icon, and click handler all flip based on the row's `isPaused`
+flag. CueGUI's `MonitorJobs` widget does the same thing, so this is a
+parity item.
+
+Files involved:
+
+```bash
+cueweb/
+├── app/utils/action_utils.ts                              # pauseJobGivenRow / unpauseJobGivenRow
+└── components/ui/context_menus/action-context-menu.tsx    # The toggle entry
+```
+
+### State derivation
+
+Inside `JobContextMenu` (`components/ui/context_menus/action-context-menu.tsx`):
+
+```tsx
+const isJobPaused = !!contextMenuState.row?.original.isPaused;
+```
+
+### The toggle entry
+
+The menuItems array contains a single Pause/Unpause entry instead of two
+static ones:
+
+```tsx
+{
+  label: isJobPaused ? "Unpause" : "Pause",
+  onClick: isJobPaused ? unpauseJobGivenRow : pauseJobGivenRow,
+  isActive: destructiveActive,
+  component: isJobPaused ? (
+    <TbPlayerPlay className="mr-1" size={14} color={grayIfDisabled(destructiveActive)} />
+  ) : (
+    <TbPlayerPause className="mr-1" size={14} color={grayIfDisabled(destructiveActive)} />
+  ),
+},
+```
+
+### Disabled-state matrix
+
+`destructiveActive` is already defined as:
+
+```tsx
+const isActive = contextMenuState.row ? contextMenuState.row.original.state !== "FINISHED" : false;
+const destructiveActive = isActive && !jobInteractionDisabled;
+```
+
+So the toggle resolves like this:
+
+| Job state | `isPaused` | Label shown | Active? |
+|-----------|------------|-------------|---------|
+| In Progress | `false` | **Pause** | yes |
+| Failing | `false` | **Pause** | yes |
+| Dependency | `false` | **Pause** | yes |
+| Paused | `true` | **Unpause** | yes |
+| Finished | `false` | **Pause** | no (state-gated) |
+| Any state + global safety flag on | - | shown label | no (flag-gated) |
+
+No additional code is needed to handle Finished or the global safety flag
+- both fall out of the existing `destructiveActive` boolean.
+
+### Toolbar buttons
+
+The Jobs toolbar still surfaces separate **Pause Jobs** / **Unpause Jobs**
+buttons (`pauseJobsFromSelectedRows` / `unpauseJobsFromSelectedRows` in
+`action_utils.ts`) because the toolbar acts on the multi-row checkbox
+selection - those rows can have mixed `isPaused` states, so a single
+toggle would be ambiguous. Only the single-row right-click menu collapses
+to one entry.
+
+---
+
 ## Development Workflow
 
 ### Running in Development Mode

docs/_docs/other-guides/cueweb.md

@@ -88,7 +88,7 @@ CueWeb replicates the core functionality of [CueGUI](https://www.opencue.io/docs
 17. **CueWeb actions and context menu (CueGUI parity):**
    - Right-clicking any row in the Jobs, Layers, or Frames tables opens a context menu that mirrors the CueGUI Monitor Jobs / Monitor Job Details menus.
    - On touch devices, every row has a small **`⋮` Actions** button as its leftmost cell. Tapping it opens the same menu the desktop right-click opens.
-   - **Job actions** include: Unmonitor, View Job, **View Job Details** (opens the tabbed `/jobs/<jobName>` page with Overview / Layers / Frames / Comments / Dependencies), **Copy Job Name**, Email Artist, Request Cores, Subscribe to Job, Comments, View Dependencies, Dependency Wizard, Drop External / Internal Dependencies, Set / Clear User Color, **Set Priority...** (themed 1-100 slider + number input), Set Max Retries, Reorder / Stagger Frames, Pause / Unpause, Auto-Eat On / Off, Retry / Eat Dead Frames, Unbook, Kill, Show Progress Bar.
+   - **Job actions** include: Unmonitor, View Job, **View Job Details** (opens the tabbed `/jobs/<jobName>` page with Overview / Layers / Frames / Comments / Dependencies), **Copy Job Name**, Email Artist, Request Cores, Subscribe to Job, Comments, View Dependencies, Dependency Wizard, Drop External / Internal Dependencies, Set / Clear User Color, **Set Priority...** (themed 1-100 slider + number input), Set Max Retries, Reorder / Stagger Frames, **Pause / Unpause** (single toggle - the label and icon flip with the job's paused state, and the entry is grayed out for Finished jobs), Auto-Eat On / Off, Retry / Eat Dead Frames, Unbook, Kill, Show Progress Bar.
    - **Layer actions** include: View Layer, **Copy Layer Name**, dependency items, Reorder / Stagger Frames, Properties, Kill, Eat, Retry, Retry Dead Frames.
    - **Frame actions** include: **Tail Log / View Log** (in-browser viewer), **View Log on \<editor\>** (external editor - see item 23), **Copy Log Path**, **Copy Frame Name**, View Host, dependency items, Filter Selected Layers, Reorder, Preview All, Retry, Eat, Kill, Eat and Mark done, View Processes.
    - All copy actions work whether CueWeb is reached at `localhost` or at a LAN IP over plain HTTP.
@@ -427,7 +427,9 @@ Selecting **Other -> Show Shortcuts** opens an overlay listing the available key
 
 ### CueWeb Actions for Jobs / Layers / Frames
 
-The CueWeb system includes actions like `eat dead frames`, `retry dead frames`, `pause`, `unpause`, and `kill` for selected jobs in the table. Also, the ability to right-click jobs, layers, and frames to get a context menu popup with actions for that object type. 
+The CueWeb system includes actions like `eat dead frames`, `retry dead frames`, `pause`, `unpause`, and `kill` for selected jobs in the table. Also, the ability to right-click jobs, layers, and frames to get a context menu popup with actions for that object type.
+
+The Pause / Unpause entry in the job context menu is a single toggle: it reads **Pause** when the job is running (In Progress, Failing, Dependency), **Unpause** when the job is already paused, and is shown disabled (grayed) when the job is Finished.
 
 Figure 52 shows the `job` context menu with options to `un-monitor`, `comments`, `pause`, `retry dead frames`, `eat dead frames` and `kill` jobs and Figure 53 shows the successful message after selecting `kill` a job.
 

docs/_docs/quick-starts/quick-start-cueweb.md

@@ -214,7 +214,7 @@ Click a job row to reveal the inline Layers and Frames panels below the jobs tab
 
 ### Job Management
 
-- **Pause/Resume**: Click the pause/play button for individual jobs
+- **Pause/Resume**: Right-click a job and pick **Pause** (or **Unpause** if the job is already paused). The same entry toggles between the two labels based on the job's current state, and is grayed out for Finished jobs.
 - **Kill Jobs**: Use the stop button to terminate jobs
 - **Job Details (inline)**: Click on a job row to reveal the inline Layers + Frames panel below the Jobs table.
 - **Job Details (tabbed page)**: Right-click a job and choose **View Job Details** to open the tabbed `/jobs/<jobName>` page with Overview / Layers / Frames / Comments / Dependencies tabs. The active tab is stored in the URL so the page is bookmarkable.

docs/_docs/reference/cueweb.md

@@ -420,7 +420,7 @@ All three context menus (`JobContextMenu`, `LayerContextMenu`, `FrameContextMenu
 | **Set Priority...** | Open a themed dialog with a 1-100 slider + number input to adjust the job's dispatch priority. Higher numbers dispatch first; default is 100. After Apply the Jobs table updates the Priority column optimistically (no wait for the 5s poll). |
 | **Set Max Retries** | Edit the per-frame retry budget. |
 | **Reorder Frames** / **Stagger Frames** | Open the reorder / stagger dialogs. *(placeholder)* |
-| **Pause** / **Unpause** | Pause or resume the job. |
+| **Pause** / **Unpause** | Single toggle entry: shows **Pause** when the job is running and **Unpause** when the job is already paused. The label, icon (`TbPlayerPause` / `TbPlayerPlay`) and dispatched action all flip on the row's `isPaused` flag. The entry is shown disabled (grayed) when the job's `state === "FINISHED"` (a terminal state can't be paused), and when the global *Disable Job Interaction* safety flag is on. Active in all other states (In Progress, Failing, Dependency). |
 | **Auto-Eat On** / **Auto-Eat Off** | Toggle Auto-Eat. |
 | **Retry Dead Frames** | Retry every dead frame. |
 | **Eat Dead Frames** | Mark every dead frame as eaten. |
@@ -906,9 +906,10 @@ When the flag is on:
   Pause, Unpause, Kill) disable themselves visually and ignore clicks.
   *Unmonitor* is non-destructive and remains active.
 - The right-click context menus on **job**, **layer**, and **frame** rows
-  dim every destructive item (Pause / Retry / Retry Dead Frames / Eat /
-  Eat Dead Frames / Kill). *Unmonitor* and *Comments* on the job menu
-  remain active.
+  dim every destructive item (Pause / Unpause / Retry / Retry Dead Frames
+  / Eat / Eat Dead Frames / Kill). The Pause/Unpause entry is a single
+  toggle whose label flips on `isPaused` - both flavors are dimmed the
+  same way. *Unmonitor* and *Comments* on the job menu remain active.
 
 ![CueWeb read-only banner when job interaction is disabled](/assets/images/cueweb/cueweb_file_disable_job_interaction_enabled.png)
 

docs/_docs/tutorials/cueweb-tutorial.md

@@ -146,27 +146,42 @@ Jobs are color-coded for quick identification:
 
 ### Pausing and Resuming Jobs
 
-Sometimes you need to pause jobs to free up resources or fix issues.
+Sometimes you need to pause jobs to free up resources or fix issues. The
+context menu shows a single Pause/Unpause entry whose label reflects the
+job's current state - **Pause** when the job is running, **Unpause** when
+the job is already paused, and grayed out when the job is Finished.
 
 #### Pause a Job
 
-1. Find the job you want to pause
-2. Click the **Pause** button in the Actions menu
-3. The job status should change to "PAUSED" with a blue indicator
+1. Find the job you want to pause (anything that is not already Finished
+   or Paused).
+2. Right-click the row - the entry will read **Pause**.
+3. Click **Pause**.
+4. The job status changes to "Paused" with a blue indicator, and the next
+   time you right-click the row the same entry will read **Unpause**.
 
 #### Resume a Job
 
-1. Find a paused job (blue indicator)
-2. Click the **Unpause** button in the Actions menu
-3. The job should return to "PENDING" or "RUNNING"
+1. Find a paused job (blue indicator).
+2. Right-click the row - the entry will read **Unpause**.
+3. Click **Unpause**.
+4. The job returns to In Progress (or Failing / Dependency if it has dead
+   frames or unmet dependencies).
+
+#### What you'll see in other states
+
+- **In Progress, Failing, Dependency**: entry reads **Pause** and is active.
+- **Paused**: entry reads **Unpause** and is active.
+- **Finished**: entry reads **Pause** but is grayed out - a completed job
+  cannot be paused.
 
 ### Pause and Resume Practice
 
-1. Find an active job with running frames
-2. Pause the job and watch the status change
-3. Wait 30 seconds for the interface to refresh
-4. Resume the job
-5. Observe how the job returns to the queue
+1. Find an active job with running frames.
+2. Right-click and choose **Pause** - watch the status change to Paused.
+3. Wait 30 seconds for the interface to refresh.
+4. Right-click again - the entry now reads **Unpause**.
+5. Choose **Unpause** and observe how the job returns to the queue.
 
 ### Adjusting Priority
 

docs/_docs/user-guides/cueweb-user-guide.md

@@ -290,8 +290,20 @@ Jobs are color-coded by status:
 
 #### Pause/Resume Jobs
 
-1. **Single Job**: Click the `Pause`/`Unpause` button in the Actions menu
-2. **Multiple Jobs**: Select jobs using checkboxes, then use the `Pause`/`Unpause` button
+The right-click menu shows a single entry that reflects the job's current
+state:
+
+- The entry reads **Pause** when the job is running (In Progress, Failing,
+  or Dependency) - clicking it pauses the job.
+- The entry reads **Unpause** when the job is already paused - clicking
+  it resumes the job.
+- The entry is shown disabled (grayed) when the job is Finished, since a
+  completed job cannot be paused.
+
+1. **Single Job**: Right-click the row and pick **Pause** / **Unpause**, or
+   click the toolbar button in the Actions menu.
+2. **Multiple Jobs**: Select jobs using checkboxes, then use the
+   **Pause Jobs** / **Unpause Jobs** toolbar buttons.
 
 #### Kill Jobs
 
@@ -316,7 +328,7 @@ Jobs can be added or removed from monitoring:
 
 Right-click on a job, layer, or frame row to open a CueGUI-parity context menu. The full menu structure for each type is listed in the reference doc; common entries:
 
-- **Job menu**: Unmonitor, **View Job Details** (tabbed detail page with Overview / Layers / Frames / Comments / Dependencies), **Copy Job Name**, Comments, Pause / Unpause, Retry / Eat Dead Frames, Kill, **Set Priority...**, Set Max Retries, Auto-Eat On / Off, Drop External / Internal Dependencies.
+- **Job menu**: Unmonitor, **View Job Details** (tabbed detail page with Overview / Layers / Frames / Comments / Dependencies), **Copy Job Name**, Comments, **Pause / Unpause** (single toggle - the label flips with the job's paused state and is grayed out for Finished jobs), Retry / Eat Dead Frames, Kill, **Set Priority...**, Set Max Retries, Auto-Eat On / Off, Drop External / Internal Dependencies.
 
 ### Adjusting job priority (Set Priority)