From cb5351bda0827db257b6dd515824334e77010e3c Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 30 Dec 2025 01:17:19 +0000 Subject: [PATCH 1/3] Initial plan From 843fb29a38825c2b0e3f9e321da7016610e0f89f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 30 Dec 2025 01:25:27 +0000 Subject: [PATCH 2/3] Add inline examples to 6 major workflow configuration fields Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com> --- pkg/parser/schemas/main_workflow_schema.json | 60 ++++++++++++++++++++ 1 file changed, 60 insertions(+) diff --git a/pkg/parser/schemas/main_workflow_schema.json b/pkg/parser/schemas/main_workflow_schema.json index 36f5e4255c..d3e6e87189 100644 --- a/pkg/parser/schemas/main_workflow_schema.json +++ b/pkg/parser/schemas/main_workflow_schema.json @@ -115,6 +115,13 @@ }, "on": { "description": "Workflow triggers that define when the agentic workflow should run. Supports standard GitHub Actions trigger events plus special command triggers for /commands (required)", + "examples": [ + {"issues": {"types": ["opened"]}}, + {"pull_request": {"types": ["opened", "synchronize"]}}, + "workflow_dispatch", + {"schedule": "daily at 9am"}, + "/my-bot" + ], "oneOf": [ { "type": "string", @@ -2330,6 +2337,13 @@ ] }, "examples": [ + [ + {"prompt": "Analyze the issue and create a plan"} + ], + [ + {"uses": "actions/checkout@v4"}, + {"prompt": "Review the code and suggest improvements"} + ], [ { "name": "Download logs from last 24 hours", @@ -2388,11 +2402,33 @@ "engine": { "description": "AI engine configuration that specifies which AI processor interprets and executes the markdown content of the workflow. Defaults to 'copilot'.", "default": "copilot", + "examples": [ + "copilot", + "claude", + "codex", + {"id": "copilot", "version": "beta"}, + {"id": "claude", "model": "claude-3-5-sonnet-20241022", "max-turns": 15} + ], "$ref": "#/$defs/engine_config" }, "mcp-servers": { "type": "object", "description": "MCP server definitions", + "examples": [ + { + "filesystem": { + "type": "stdio", + "command": "npx", + "args": ["-y", "@modelcontextprotocol/server-filesystem"] + } + }, + { + "custom-server": { + "type": "http", + "url": "https://api.example.com/mcp" + } + } + ], "patternProperties": { "^[a-zA-Z0-9_-]+$": { "oneOf": [ @@ -2410,6 +2446,12 @@ "tools": { "type": "object", "description": "Tools and MCP (Model Context Protocol) servers available to the AI engine for GitHub API access, browser automation, file editing, and more", + "examples": [ + {"playwright": {"version": "v1.41.0"}}, + {"github": {"mode": "remote"}}, + {"github": {"mode": "local", "version": "latest"}}, + {"bash": null} + ], "properties": { "github": { "description": "GitHub API tools for repository operations (issues, pull requests, content management)", @@ -3326,6 +3368,24 @@ "type": "object", "$comment": "Required if workflow creates or modifies GitHub resources. Operations requiring safe-outputs: add-comment, add-labels, add-reviewer, assign-milestone, assign-to-agent, close-discussion, close-issue, close-pull-request, create-agent-task, create-code-scanning-alert, create-discussion, create-issue, create-pull-request, create-pull-request-review-comment, hide-comment, link-sub-issue, missing-tool, noop, push-to-pull-request-branch, threat-detection, update-discussion, update-issue, update-project, update-pull-request, update-release, upload-asset. See documentation for complete details.", "description": "Safe output processing configuration that automatically creates GitHub issues, comments, and pull requests from AI workflow output without requiring write permissions in the main job", + "examples": [ + { + "create-issue": { + "title-prefix": "[AI] ", + "labels": ["automation", "ai-generated"] + } + }, + { + "create-pull-request": { + "title-prefix": "[Bot] ", + "labels": ["bot"] + } + }, + { + "add-comment": null, + "create-issue": null + } + ], "properties": { "allowed-domains": { "type": "array", From e60b850be910ab7f7d8dbddd45fd48de6c030112 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Tue, 30 Dec 2025 01:31:14 +0000 Subject: [PATCH 3/3] Apply prettier formatting to schema examples Co-authored-by: mnkiefer <8320933+mnkiefer@users.noreply.github.com> --- pkg/parser/schemas/main_workflow_schema.json | 32 +++----------------- 1 file changed, 5 insertions(+), 27 deletions(-) diff --git a/pkg/parser/schemas/main_workflow_schema.json b/pkg/parser/schemas/main_workflow_schema.json index d3e6e87189..471920ca3f 100644 --- a/pkg/parser/schemas/main_workflow_schema.json +++ b/pkg/parser/schemas/main_workflow_schema.json @@ -115,13 +115,7 @@ }, "on": { "description": "Workflow triggers that define when the agentic workflow should run. Supports standard GitHub Actions trigger events plus special command triggers for /commands (required)", - "examples": [ - {"issues": {"types": ["opened"]}}, - {"pull_request": {"types": ["opened", "synchronize"]}}, - "workflow_dispatch", - {"schedule": "daily at 9am"}, - "/my-bot" - ], + "examples": [{ "issues": { "types": ["opened"] } }, { "pull_request": { "types": ["opened", "synchronize"] } }, "workflow_dispatch", { "schedule": "daily at 9am" }, "/my-bot"], "oneOf": [ { "type": "string", @@ -2337,13 +2331,8 @@ ] }, "examples": [ - [ - {"prompt": "Analyze the issue and create a plan"} - ], - [ - {"uses": "actions/checkout@v4"}, - {"prompt": "Review the code and suggest improvements"} - ], + [{ "prompt": "Analyze the issue and create a plan" }], + [{ "uses": "actions/checkout@v4" }, { "prompt": "Review the code and suggest improvements" }], [ { "name": "Download logs from last 24 hours", @@ -2402,13 +2391,7 @@ "engine": { "description": "AI engine configuration that specifies which AI processor interprets and executes the markdown content of the workflow. Defaults to 'copilot'.", "default": "copilot", - "examples": [ - "copilot", - "claude", - "codex", - {"id": "copilot", "version": "beta"}, - {"id": "claude", "model": "claude-3-5-sonnet-20241022", "max-turns": 15} - ], + "examples": ["copilot", "claude", "codex", { "id": "copilot", "version": "beta" }, { "id": "claude", "model": "claude-3-5-sonnet-20241022", "max-turns": 15 }], "$ref": "#/$defs/engine_config" }, "mcp-servers": { @@ -2446,12 +2429,7 @@ "tools": { "type": "object", "description": "Tools and MCP (Model Context Protocol) servers available to the AI engine for GitHub API access, browser automation, file editing, and more", - "examples": [ - {"playwright": {"version": "v1.41.0"}}, - {"github": {"mode": "remote"}}, - {"github": {"mode": "local", "version": "latest"}}, - {"bash": null} - ], + "examples": [{ "playwright": { "version": "v1.41.0" } }, { "github": { "mode": "remote" } }, { "github": { "mode": "local", "version": "latest" } }, { "bash": null }], "properties": { "github": { "description": "GitHub API tools for repository operations (issues, pull requests, content management)",