Add inline examples to major workflow configuration fields

pkg/parser/schemas/main_workflow_schema.json

@@ -115,6 +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"],
       "oneOf": [
         {
           "type": "string",
@@ -2330,6 +2331,8 @@
             ]
           },
           "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 +2391,27 @@
     "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 +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 }],
       "properties": {
         "github": {
           "description": "GitHub API tools for repository operations (issues, pull requests, content management)",
@@ -3326,6 +3346,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",