From ee8ed704f29118929f39a2d8bd08a45afdde1eb6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 16 May 2026 11:02:21 +0000 Subject: [PATCH 1/2] [docs] Document centralized slash-command dispatch input behavior and @copilot mention default - command-triggers.md: note that workflow_dispatch.inputs.required is normalized to false under strategy: centralized (from #32480) - safe-outputs.md: note that @copilot is always preserved as a default allowed mention alias in add-comment (from #32487) --- docs/src/content/docs/reference/command-triggers.md | 2 ++ docs/src/content/docs/reference/safe-outputs.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/docs/src/content/docs/reference/command-triggers.md b/docs/src/content/docs/reference/command-triggers.md index 7b03f0b579a..010daa4a9fe 100644 --- a/docs/src/content/docs/reference/command-triggers.md +++ b/docs/src/content/docs/reference/command-triggers.md @@ -84,6 +84,8 @@ on: **Note**: With default inline strategy, you cannot combine `slash_command` with `issues`, `issue_comment`, or `pull_request` as they would conflict. With `strategy: centralized`, non-slash events are preserved because slash matching is handled in the generated central trigger workflow. +**`workflow_dispatch` inputs under centralized routing**: Centralized slash-command workflows are invoked by the generated router rather than by manual `workflow_dispatch` callers. To keep router-dispatched runs compatible, any `workflow_dispatch.inputs..required: true` declared in a centralized workflow's source frontmatter is normalized to `required: false` in the compiled lock file. Inputs remain available — they just are not enforced as required by the dispatch schema. + **Exception for Label-Only Events**: You CAN combine `slash_command` with `issues` or `pull_request` if those events are configured for label-only triggers (`labeled` or `unlabeled` types only). This allows workflows to respond to slash commands while also reacting to label changes. ### Combining `slash_command` with `bots:` diff --git a/docs/src/content/docs/reference/safe-outputs.md b/docs/src/content/docs/reference/safe-outputs.md index 80f6a6f1bb7..c0d9d4feba3 100644 --- a/docs/src/content/docs/reference/safe-outputs.md +++ b/docs/src/content/docs/reference/safe-outputs.md @@ -269,6 +269,8 @@ safe-outputs: The author of the parent issue, PR, or discussion receiving the comment is automatically preserved as an allowed mention. This means `@username` references to the issue/PR/discussion author are not neutralized when the workflow posts a reply. +`@copilot` is always preserved as a default allowed mention alias and is never neutralized by mention filtering, so workflows can invoke Copilot from agent-authored comments without configuring `allowed-aliases`. + #### Hide Older Comments Set `hide-older-comments: true` to minimize previous comments from the same workflow (identified by `GITHUB_WORKFLOW`) before posting new ones. Useful for status updates. Allowed reasons: `spam`, `abuse`, `off_topic`, `outdated` (default), `resolved`, `low_quality`. From 2e79dc1b260b7546cefcc46495d979534878a3ea Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Sat, 16 May 2026 13:41:24 +0000 Subject: [PATCH 2/2] docs: remove incorrect @copilot mention-preservation note Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- docs/src/content/docs/reference/safe-outputs.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/src/content/docs/reference/safe-outputs.md b/docs/src/content/docs/reference/safe-outputs.md index c0d9d4feba3..80f6a6f1bb7 100644 --- a/docs/src/content/docs/reference/safe-outputs.md +++ b/docs/src/content/docs/reference/safe-outputs.md @@ -269,8 +269,6 @@ safe-outputs: The author of the parent issue, PR, or discussion receiving the comment is automatically preserved as an allowed mention. This means `@username` references to the issue/PR/discussion author are not neutralized when the workflow posts a reply. -`@copilot` is always preserved as a default allowed mention alias and is never neutralized by mention filtering, so workflows can invoke Copilot from agent-authored comments without configuring `allowed-aliases`. - #### Hide Older Comments Set `hide-older-comments: true` to minimize previous comments from the same workflow (identified by `GITHUB_WORKFLOW`) before posting new ones. Useful for status updates. Allowed reasons: `spam`, `abuse`, `off_topic`, `outdated` (default), `resolved`, `low_quality`.