Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/aw/actions-lock.json
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@
"github/codeql-action/upload-sarif@v3": {
"repo": "github/codeql-action/upload-sarif",
"version": "v3",
"sha": "901f0fdebfadabaa0664a07bd572cbd2ff90b07e"
"sha": "5ad83d3202da6e473f763d732b591299ae4e380c"
},
"haskell-actions/setup@v2": {
"repo": "haskell-actions/setup",
Expand Down
4,944 changes: 4,944 additions & 0 deletions .github/workflows/test-assign-to-agent.lock.yml

Large diffs are not rendered by default.

51 changes: 51 additions & 0 deletions .github/workflows/test-assign-to-agent.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
---
name: Test Assign to Agent
description: Test workflow for assign_to_agent safe output feature
on:
issues:
types: [labeled]
workflow_dispatch:
inputs:
issue_number:
description: 'Issue number to test with'
required: true
type: string

permissions:
actions: write
contents: write
issues: write
pull-requests: write

# NOTE: Assigning Copilot agents requires:
# 1. A Personal Access Token (PAT) with repo scope
# - The standard GITHUB_TOKEN does NOT have permission to assign bot agents
# - Create a PAT at: https://github.com/settings/tokens
# - Add it as a repository secret named COPILOT_GITHUB_TOKEN
# - Required scopes: repo (full control)
#
# 2. All four workflow permissions declared above (for the safe output job)
#
# 3. Repository Settings > Actions > General > Workflow permissions:
# Must be set to "Read and write permissions"

engine: copilot
timeout-minutes: 5
github-token: ${{ secrets.COPILOT_GITHUB_TOKEN }}

safe-outputs:
assign-to-agent:
max: 5
default-agent: copilot
---

# Assign to Agent Test Workflow

This workflow tests the `assign_to_agent` safe output feature, which allows AI agents to assign GitHub Copilot agents to issues.

## Task

**For workflow_dispatch:**
Assign the Copilot agent to issue #${{ github.event.inputs.issue_number }} using the `assign_to_agent` tool from the `safeoutputs` MCP server.

Do not use GitHub tools. The assign_to_agent tool will handle the actual assignment.
16 changes: 16 additions & 0 deletions .github/workflows/test-copilot-assign-milestone.lock.yml

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

32 changes: 32 additions & 0 deletions pkg/parser/schemas/main_workflow_schema.json
Original file line number Diff line number Diff line change
Expand Up @@ -3125,6 +3125,38 @@
}
]
},
"assign-to-agent": {
"oneOf": [
{
"type": "null",
"description": "Null configuration uses default agent (copilot)"
},
{
"type": "object",
"description": "Configuration for assigning GitHub Copilot agents to issues from agentic workflow output",
"properties": {
"default-agent": {
"type": "string",
"description": "Default agent name to assign (default: 'copilot')"
},
"max": {
"type": "integer",
"description": "Optional maximum number of agent assignments (default: 1)",
"minimum": 1
},
"target-repo": {
"type": "string",
"description": "Target repository in format 'owner/repo' for cross-repository agent assignment. Takes precedence over trial target repo settings."
},
"github-token": {
"$ref": "#/$defs/github_token",
"description": "GitHub token to use for this specific output type. Overrides global github-token if specified."
}
},
"additionalProperties": false
}
]
},
"update-issue": {
"oneOf": [
{
Expand Down
5 changes: 5 additions & 0 deletions pkg/workflow/.github/aw/actions-lock.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,11 @@
"version": "v4",
"sha": "08eba0b27e820071cde6df949e0beb9ba4906955"
},
"actions/checkout@v5": {
"repo": "actions/checkout",
"version": "v5",
"sha": "93cb6efe18208431cddfb8368fd83d5badbf9bfd"
},
"actions/setup-node@v4": {
"repo": "actions/setup-node",
"version": "v4",
Expand Down
85 changes: 85 additions & 0 deletions pkg/workflow/assign_to_agent.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,85 @@
package workflow

import (
"fmt"
)

// AssignToAgentConfig holds configuration for assigning agents to issues from agent output
type AssignToAgentConfig struct {
BaseSafeOutputConfig `yaml:",inline"`
DefaultAgent string `yaml:"default-agent,omitempty"` // Default agent to assign (e.g., "copilot")
Target string `yaml:"target,omitempty"` // Target for agent assignment: "triggering" (default) or explicit issue number
TargetRepoSlug string `yaml:"target-repo,omitempty"` // Target repository in format "owner/repo" for cross-repository assignments
}

// buildAssignToAgentJob creates the assign_to_agent job
func (c *Compiler) buildAssignToAgentJob(data *WorkflowData, mainJobName string) (*Job, error) {
if data.SafeOutputs == nil || data.SafeOutputs.AssignToAgent == nil {
return nil, fmt.Errorf("safe-outputs.assign-to-agent configuration is required")
}

// Handle case where AssignToAgent is not nil
defaultAgent := "copilot"
maxCount := 1

if data.SafeOutputs.AssignToAgent.DefaultAgent != "" {
defaultAgent = data.SafeOutputs.AssignToAgent.DefaultAgent
}
if data.SafeOutputs.AssignToAgent.Max > 0 {
maxCount = data.SafeOutputs.AssignToAgent.Max
}

// Build custom environment variables specific to assign-to-agent
var customEnvVars []string

// Pass the default agent
customEnvVars = append(customEnvVars, fmt.Sprintf(" GH_AW_AGENT_DEFAULT: %q\n", defaultAgent))

// Pass the max limit
customEnvVars = append(customEnvVars, fmt.Sprintf(" GH_AW_AGENT_MAX_COUNT: %d\n", maxCount))

// Pass the GitHub token as GH_TOKEN for gh CLI (falls back to GITHUB_TOKEN)
var tokenValue string
if data.SafeOutputs.AssignToAgent.GitHubToken != "" {
tokenValue = data.SafeOutputs.AssignToAgent.GitHubToken
} else if data.SafeOutputs.GitHubToken != "" {
tokenValue = data.SafeOutputs.GitHubToken
} else if data.GitHubToken != "" {
tokenValue = data.GitHubToken
} else {
tokenValue = "${{ secrets.GH_AW_GITHUB_TOKEN || secrets.GITHUB_TOKEN }}"
}
customEnvVars = append(customEnvVars, fmt.Sprintf(" GH_TOKEN: %s\n", tokenValue))

// Pass the target configuration

// Add standard environment variables (metadata + staged/target repo)
customEnvVars = append(customEnvVars, c.buildStandardSafeOutputEnvVars(data, data.SafeOutputs.AssignToAgent.TargetRepoSlug)...)

// Get token from config
var token string
if data.SafeOutputs.AssignToAgent != nil {
token = data.SafeOutputs.AssignToAgent.GitHubToken
}

// Create outputs for the job
outputs := map[string]string{
"assigned_agents": "${{ steps.assign_to_agent.outputs.assigned_agents }}",
}

// Use the shared builder function to create the job
// Note: replaceActorsForAssignable GraphQL mutation requires all four write permissions
return c.buildSafeOutputJob(data, SafeOutputJobConfig{
JobName: "assign_to_agent",
StepName: "Assign to Agent",
StepID: "assign_to_agent",
MainJobName: mainJobName,
CustomEnvVars: customEnvVars,
Script: getAssignToAgentScript(),
Permissions: NewPermissionsActionsWriteContentsWriteIssuesWritePRWrite(),
Outputs: outputs,
Token: token,
Condition: BuildSafeOutputType("assign_to_agent"),
TargetRepoSlug: data.SafeOutputs.AssignToAgent.TargetRepoSlug,
})
}
1 change: 1 addition & 0 deletions pkg/workflow/compiler.go
Original file line number Diff line number Diff line change
Expand Up @@ -270,6 +270,7 @@ type SafeOutputsConfig struct {
AddLabels *AddLabelsConfig `yaml:"add-labels,omitempty"`
AddReviewer *AddReviewerConfig `yaml:"add-reviewer,omitempty"`
AssignMilestone *AssignMilestoneConfig `yaml:"assign-milestone,omitempty"`
AssignToAgent *AssignToAgentConfig `yaml:"assign-to-agent,omitempty"`
UpdateIssues *UpdateIssuesConfig `yaml:"update-issues,omitempty"`
PushToPullRequestBranch *PushToPullRequestBranchConfig `yaml:"push-to-pull-request-branch,omitempty"`
UploadAssets *UploadAssetsConfig `yaml:"upload-assets,omitempty"`
Expand Down
18 changes: 18 additions & 0 deletions pkg/workflow/compiler_jobs.go
Original file line number Diff line number Diff line change
Expand Up @@ -375,6 +375,24 @@ func (c *Compiler) buildSafeOutputsJobs(data *WorkflowData, jobName, markdownPat
safeOutputJobNames = append(safeOutputJobNames, assignMilestoneJob.Name)
}

// Build assign_to_agent job if output.assign-to-agent is configured
if data.SafeOutputs.AssignToAgent != nil {
assignToAgentJob, err := c.buildAssignToAgentJob(data, jobName)
if err != nil {
return fmt.Errorf("failed to build assign_to_agent job: %w", err)
}
// Safe-output jobs should depend on agent job (always) AND detection job (if enabled)
if threatDetectionEnabled {
assignToAgentJob.Needs = append(assignToAgentJob.Needs, constants.DetectionJobName)
// Add detection success check to the job condition
assignToAgentJob.If = AddDetectionSuccessCheck(assignToAgentJob.If)
}
if err := c.jobManager.AddJob(assignToAgentJob); err != nil {
return fmt.Errorf("failed to add assign_to_agent job: %w", err)
}
safeOutputJobNames = append(safeOutputJobNames, assignToAgentJob.Name)
}

// Build update_issue job if output.update-issue is configured
if data.SafeOutputs.UpdateIssues != nil {
updateIssueJob, err := c.buildCreateOutputUpdateIssueJob(data, jobName)
Expand Down
8 changes: 7 additions & 1 deletion pkg/workflow/copilot_engine.go
Original file line number Diff line number Diff line change
Expand Up @@ -245,7 +245,13 @@ COPILOT_CLI_INSTRUCTION="$(cat /tmp/gh-aw/aw-prompts/prompt.txt)"
}

// Use COPILOT_GITHUB_TOKEN with fallback to legacy COPILOT_CLI_TOKEN
copilotGitHubToken := "${{ secrets.COPILOT_GITHUB_TOKEN || secrets.COPILOT_CLI_TOKEN }}"
// If github-token is specified at workflow level, use that instead
var copilotGitHubToken string
if workflowData.GitHubToken != "" {
copilotGitHubToken = workflowData.GitHubToken
} else {
copilotGitHubToken = "${{ secrets.COPILOT_GITHUB_TOKEN || secrets.COPILOT_CLI_TOKEN }}"
}

env := map[string]string{
"XDG_CONFIG_HOME": "/home/runner",
Expand Down
2 changes: 1 addition & 1 deletion pkg/workflow/data/action_pins.json
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@
"github/codeql-action/upload-sarif@v3": {
"repo": "github/codeql-action/upload-sarif",
"version": "v3",
"sha": "901f0fdebfadabaa0664a07bd572cbd2ff90b07e"
"sha": "5ad83d3202da6e473f763d732b591299ae4e380c"
},
"haskell-actions/setup@v2": {
"repo": "haskell-actions/setup",
Expand Down
Loading