From 947381f83f9d01da8aec1f91acd49eb49c83eb55 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 7 Mar 2026 04:14:39 +0000 Subject: [PATCH 1/2] docs: document GITHUB_STEP_SUMMARY support for agents in sandbox Document the agent step summary feature introduced in #19821: - GITHUB_STEP_SUMMARY is forwarded into the AWF sandbox for all engines - Content is appended to the real step summary after secret redaction - First 2000 characters are included with truncation notice if longer Co-Authored-By: Claude Sonnet 4.6 --- .../docs/reference/environment-variables.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/docs/src/content/docs/reference/environment-variables.md b/docs/src/content/docs/reference/environment-variables.md index 431fa178ff0..6cd1d3782e4 100644 --- a/docs/src/content/docs/reference/environment-variables.md +++ b/docs/src/content/docs/reference/environment-variables.md @@ -80,6 +80,24 @@ safe-outputs: --- ``` +## Agent Step Summary (`GITHUB_STEP_SUMMARY`) + +Agents can write markdown content to the `$GITHUB_STEP_SUMMARY` environment variable to publish a formatted summary visible in the GitHub Actions run view. + +Inside the AWF sandbox, `$GITHUB_STEP_SUMMARY` is redirected to a file at `/tmp/gh-aw/agent-step-summary.md`. After agent execution completes, the framework automatically appends the contents of that file to the real GitHub step summary. Secret redaction runs before the content is published. + +> [!NOTE] +> The first 2000 characters of the summary are appended. If the content is longer, a `[truncated: ...]` notice is included. Write your most important content first. + +Example: an agent writing a brief analysis result to the step summary: + +```bash +echo "## Analysis complete" >> "$GITHUB_STEP_SUMMARY" +echo "Found 3 issues across 12 files." >> "$GITHUB_STEP_SUMMARY" +``` + +The output appears in the **Summary** tab of the GitHub Actions workflow run. + ## Precedence Rules Environment variables follow a **most-specific-wins** model, consistent with GitHub Actions. Variables at more specific scopes completely override variables with the same name at less specific scopes. From 40b7aefe687e026d9cf34476573695f21f2694d6 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Sat, 7 Mar 2026 04:16:15 +0000 Subject: [PATCH 2/2] ci: trigger checks