feat: add contextual Seqera Platform action buttons

Add Cancel, Resume, and Relaunch Slack buttons alongside View in Seqera
Platform with link and interactive modes, configuration, tests, and docs.

Partially addresses #65

Generated by Codex

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: adamrtalbot

CHANGELOG.md

@@ -7,6 +7,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- **Seqera Platform action buttons**: Contextual Cancel, Resume, and Relaunch buttons alongside View in Seqera Platform. Link mode (default) opens the Platform run page; interactive mode emits `action_id` values for external Slack interactivity handlers ([#65](https://github.com/seqeralabs/nf-slack/issues/65))
+
 ## [0.5.1] - 2026-02-19
 
 ### Fixed

docs/reference/api.md

@@ -175,9 +175,21 @@ Configuration for workflow error notifications.
 
 ### `slack.seqeraPlatform`
 
-| Property  | Type      | Default | Description                                               |
-| --------- | --------- | ------- | --------------------------------------------------------- |
-| `enabled` | `Boolean` | `true`  | Enable Seqera Platform deep link buttons in notifications |
+| Property        | Type      | Default | Description                                             |
+| --------------- | --------- | ------- | ------------------------------------------------------- |
+| `enabled`       | `Boolean` | `true`  | Enable Seqera Platform action buttons in notifications  |
+| `actionButtons` | `Map`     | `{}`    | Cancel/Resume/Relaunch button configuration (see below) |
+
+#### `slack.seqeraPlatform.actionButtons`
+
+| Property   | Type      | Default  | Description                                                       |
+| ---------- | --------- | -------- | ----------------------------------------------------------------- |
+| `mode`     | `String`  | `'link'` | `'link'` for URL buttons, `'interactive'` for `action_id` buttons |
+| `cancel`   | `Boolean` | `true`   | Show Cancel on running/start/progress messages                    |
+| `resume`   | `Boolean` | `true`   | Show Resume on failure messages                                   |
+| `relaunch` | `Boolean` | `true`   | Show Relaunch on failure and completion messages                  |
+
+Interactive mode requires an external Slack interactivity endpoint that verifies the signing secret and calls Seqera Platform APIs. The plugin only emits button payloads.
 
 ---
 

docs/usage/guide.md

@@ -241,7 +241,7 @@ File paths are relative to the pipeline launch directory.
 
 ## Seqera Platform Integration
 
-If you run pipelines through [Seqera Platform](https://seqera.io/platform/), nf-slack can automatically add deep links to the Platform run page:
+If you run pipelines through [Seqera Platform](https://seqera.io/platform/), nf-slack can automatically add contextual action buttons to Slack notifications:
 
 ```groovy
 slack {
@@ -251,10 +251,30 @@ slack {
     }
     seqeraPlatform {
         enabled = true
+        actionButtons {
+            mode = 'link'      // default: URL buttons open the Platform run page
+            cancel = true      // show Cancel while running
+            resume = true      // show Resume on failure
+            relaunch = true    // show Relaunch on failure/completion
+        }
     }
 }
 ```
 
+### Button behavior by workflow phase
+
+| Phase                    | Buttons                |
+| ------------------------ | ---------------------- |
+| Running (start/progress) | View, Cancel           |
+| Failed (error)           | View, Resume, Relaunch |
+| Completed                | View, Relaunch         |
+
+In **link mode** (default), Cancel/Resume/Relaunch open the same Platform run page where those actions are available in the UI. One-click API execution from Slack requires an external interactivity handler.
+
+### Interactive mode (advanced)
+
+Set `actionButtons.mode = 'interactive'` to emit Slack buttons with `action_id` values (`seqera_platform_view`, `seqera_platform_cancel`, `seqera_platform_resume`, `seqera_platform_relaunch`) and the workflow run ID in `value`. A separate HTTP endpoint (with Slack signing secret verification) must call Seqera Platform APIs — this cannot run inside the Nextflow plugin during `nextflow run`.
+
 ## Custom Messages from Code
 
 Send messages from anywhere in your Nextflow pipeline code using the `slackMessage()` and `slackFileUpload()` functions.

src/main/groovy/nextflow/slack/SeqeraMessagePhase.groovy

@@ -0,0 +1,29 @@
+/*
+ * Copyright 2025, Seqera Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package nextflow.slack
+
+import groovy.transform.CompileStatic
+
+/**
+ * Workflow phase used to select contextual Seqera Platform action buttons.
+ */
+@CompileStatic
+enum SeqeraMessagePhase {
+    RUNNING,
+    COMPLETED,
+    FAILED
+}

src/main/groovy/nextflow/slack/SeqeraPlatformActionButtonsConfig.groovy

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2025, Seqera Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package nextflow.slack
+
+import groovy.transform.CompileStatic
+
+/**
+ * Configuration for Seqera Platform action buttons in Slack messages.
+ *
+ * <p>Link mode (default) emits URL buttons that open the Platform run page.
+ * Interactive mode emits action_id buttons for an external Slack interactivity handler.
+ */
+@CompileStatic
+class SeqeraPlatformActionButtonsConfig {
+
+    static final String MODE_LINK = 'link'
+    static final String MODE_INTERACTIVE = 'interactive'
+
+    final String mode
+    final boolean cancel
+    final boolean resume
+    final boolean relaunch
+
+    SeqeraPlatformActionButtonsConfig(Map config) {
+        config = config ?: [:]
+        this.mode = (config.mode as String ?: MODE_LINK).toLowerCase()
+        this.cancel = config.cancel != null ? config.cancel as boolean : true
+        this.resume = config.resume != null ? config.resume as boolean : true
+        this.relaunch = config.relaunch != null ? config.relaunch as boolean : true
+    }
+
+    boolean isLinkMode() {
+        return mode == MODE_LINK
+    }
+
+    boolean isInteractiveMode() {
+        return mode == MODE_INTERACTIVE
+    }
+}

src/main/groovy/nextflow/slack/SeqeraPlatformConfig.groovy

@@ -21,8 +21,9 @@ import groovy.transform.CompileStatic
 /**
  * Configuration for Seqera Platform deep link integration.
  *
- * When Seqera Platform (Tower) is configured, adds a "View in Seqera Platform"
- * button to Slack notifications that links directly to the workflow run.
+ * When Seqera Platform (Tower) is configured, adds contextual action buttons
+ * to Slack notifications that link to the workflow run (or emit interactive
+ * action IDs for external handlers).
  *
  * @author Adam Talbot <adam.talbot@seqera.io>
  */
@@ -34,7 +35,14 @@ class SeqeraPlatformConfig {
      */
     final boolean enabled
 
+    /**
+     * Action button configuration (View / Cancel / Resume / Relaunch)
+     */
+    final SeqeraPlatformActionButtonsConfig actionButtons
+
     SeqeraPlatformConfig(Map config) {
-        this.enabled = config?.enabled != null ? config.enabled as boolean : true
+        config = config ?: [:]
+        this.enabled = config.enabled != null ? config.enabled as boolean : true
+        this.actionButtons = new SeqeraPlatformActionButtonsConfig(config.actionButtons as Map)
     }
 }

src/main/groovy/nextflow/slack/SeqeraPlatformUrlBuilder.groovy

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2025, Seqera Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package nextflow.slack
+
+import groovy.transform.CompileStatic
+
+/**
+ * Helpers for parsing Seqera Platform watch URLs returned by TowerClient.
+ */
+@CompileStatic
+class SeqeraPlatformUrlBuilder {
+
+    /**
+     * Extract the workflow run ID from a Platform watch URL.
+     * Example: https://cloud.seqera.io/orgs/foo/workspaces/bar/watch/abc123 -> abc123
+     */
+    static String extractWorkflowRunId(String watchUrl) {
+        if (!watchUrl) return null
+        def marker = '/watch/'
+        def start = watchUrl.indexOf(marker)
+        if (start < 0) return null
+        def idPart = watchUrl.substring(start + marker.length())
+        def end = idPart.findIndexOf { it == '?' || it == '/' }
+        return end >= 0 ? idPart.substring(0, end) : idPart
+    }
+}

src/main/groovy/nextflow/slack/SeqeraWatchContext.groovy

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2025, Seqera Labs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package nextflow.slack
+
+import groovy.transform.CompileStatic
+
+/**
+ * Parsed Seqera Platform watch URL and workflow run identifier.
+ */
+@CompileStatic
+class SeqeraWatchContext {
+
+    final String watchUrl
+    final String workflowRunId
+
+    SeqeraWatchContext(String watchUrl, String workflowRunId) {
+        this.watchUrl = watchUrl
+        this.workflowRunId = workflowRunId
+    }
+
+    static SeqeraWatchContext fromWatchUrl(String watchUrl) {
+        if (!watchUrl) return null
+        def workflowRunId = SeqeraPlatformUrlBuilder.extractWorkflowRunId(watchUrl)
+        return new SeqeraWatchContext(watchUrl, workflowRunId)
+    }
+}