@openhands/extensions 0.18.0 → 0.20.0

package/skills/ticket-to-code-change/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: ticket-to-code-change
+description: >
+  Set up a ticket-to-code-change automation using Jira or Linear as the issue
+  tracker and GitHub, GitLab, or Bitbucket as the source-control provider.
+  Watches for implementation-ready tickets, starts an OpenHands conversation
+  to implement and test the request, opens a pull or merge request, and links
+  the result back to the ticket.
+triggers:
+  - /ticket-to-code-change:setup
+---
+
+# Ticket to code change
+
+Create an automation that turns implementation-ready tickets into tested pull
+requests or merge requests.
+
+## Information to collect
+
+Ask the user for:
+
+1. The issue tracker: Jira Cloud or Linear.
+2. The source-control provider: GitHub, GitLab, or Bitbucket Cloud.
+3. The project or team to watch and the label or workflow state that means
+   "implementation ready".
+4. How a ticket identifies its target repository and base branch.
+5. The polling schedule or issue event to use.
+6. The ticket state to set when work starts and when the change request opens.
+7. Whether linked dependencies must be completed before dispatch.
+
+## Setup workflow
+
+1. Verify that both required integrations are connected and can read the
+   selected project and repository.
+2. Prefer an issue event trigger when the deployment can receive events;
+   otherwise use cron polling with durable issue-ID deduplication.
+3. Limit each run to a small configurable number of new tickets. On initial
+   deployment, establish a baseline instead of dispatching the entire backlog.
+4. Build a prompt that includes the full ticket, acceptance criteria,
+   dependency status, repository, base branch, and provider-specific request
+   terminology. Require the agent to run the repository's tests before opening
+   the pull request or merge request.
+5. Create the automation through the Automation backend described in
+   `<RUNTIME_SERVICES>`. Use its prompt-preset endpoint and authenticate with
+   the runtime-provided automation API key.
+6. Configure the automation to post the OpenHands conversation URL immediately
+   and the resulting pull-request or merge-request URL back to the ticket.
+
+Do not dispatch tickets with unresolved dependencies or without an unambiguous
+target repository; comment on the ticket with the missing information instead.

package/skills/ticket-to-code-change/commands/ticket-to-code-change-setup.md

@@ -0,0 +1,8 @@
+---
+# auto-generated by sync_extensions.py
+description: Set up a ticket-to-code-change automation using Jira or Linear as the issue tracker and GitHub, GitLab, or Bitbucket as the source-control provider. Watches for implementation-ready tickets, starts an OpenHands conversation to implement and test the request, opens a pull or merge request, and links the result back to the ticket.
+---
+
+Read and follow the complete instructions in the SKILL.md file located in this skill's directory.
+
+$ARGUMENTS

package/tests/fixtures/automations/custom-automation.json

@@ -0,0 +1,398 @@
+{
+  "automationId": "custom-automation",
+  "description": "Direct generic setup. One catalog entry can create prompt, plugin, or uploaded-tarball automations; selectedAction and selectedTrigger record the host UI variants chosen for each scenario.",
+  "capabilities": "supported",
+  "blockedBy": [
+    "notReady"
+  ],
+  "scenarios": [
+    {
+      "id": "scheduled-prompt",
+      "description": "A custom prompt automation that runs on a weekday schedule and clones one repository.",
+      "selectedAction": "prompt",
+      "selectedTrigger": "cron",
+      "formValues": {
+        "name": "Daily extensions summary",
+        "prompt": "Summarize recent changes in the OpenHands/extensions repository and save a concise report in the workspace.",
+        "repository": "OpenHands/extensions",
+        "ref": "main",
+        "model": "fast",
+        "timeout": 900,
+        "schedule": "0 9 * * 1-5",
+        "timezone": "UTC"
+      },
+      "preflight": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/validate",
+          "body": {
+            "automationId": "custom-automation",
+            "endpoint": "/v1/preset/prompt",
+            "draft": {
+              "name": "Daily extensions summary",
+              "prompt": "Summarize recent changes in the OpenHands/extensions repository and save a concise report in the workspace.",
+              "model": "fast",
+              "timeout": 900,
+              "repos": [
+                {
+                  "url": "OpenHands/extensions",
+                  "provider": "github",
+                  "ref": "main"
+                }
+              ],
+              "trigger": {
+                "type": "cron",
+                "schedule": "0 9 * * 1-5",
+                "timezone": "UTC"
+              }
+            }
+          }
+        },
+        "response": {
+          "status": 200,
+          "body": {
+            "valid": true,
+            "errors": []
+          }
+        }
+      },
+      "create": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/preset/prompt",
+          "body": {
+            "name": "Daily extensions summary",
+            "prompt": "Summarize recent changes in the OpenHands/extensions repository and save a concise report in the workspace.",
+            "model": "fast",
+            "timeout": 900,
+            "repos": [
+              {
+                "url": "OpenHands/extensions",
+                "provider": "github",
+                "ref": "main"
+              }
+            ],
+            "trigger": {
+              "type": "cron",
+              "schedule": "0 9 * * 1-5",
+              "timezone": "UTC"
+            }
+          }
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "1c0b7ea0-0000-4000-8000-000000000001",
+            "model": "fast",
+            "name": "Daily extensions summary",
+            "prompt": "Summarize recent changes in the OpenHands/extensions repository and save a concise report in the workspace.",
+            "trigger": {
+              "type": "cron",
+              "schedule": "0 9 * * 1-5",
+              "timezone": "UTC"
+            },
+            "timeout": 900,
+            "enabled": true
+          }
+        }
+      }
+    },
+    {
+      "id": "event-prompt",
+      "description": "A custom prompt automation that runs on a GitHub comment event.",
+      "selectedAction": "prompt",
+      "selectedTrigger": "event",
+      "formValues": {
+        "name": "OpenHands mention responder",
+        "prompt": "When triggered, read the GitHub issue or pull request context and draft a helpful response for the user.",
+        "repository": "OpenHands/extensions",
+        "ref": "main",
+        "model": "",
+        "timeout": 600,
+        "source": "github",
+        "on": "issue_comment.created",
+        "filter": "glob(repository.full_name, 'OpenHands/extensions') && icontains(comment.body, '@openhands')"
+      },
+      "preflight": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/validate",
+          "body": {
+            "automationId": "custom-automation",
+            "endpoint": "/v1/preset/prompt",
+            "draft": {
+              "name": "OpenHands mention responder",
+              "prompt": "When triggered, read the GitHub issue or pull request context and draft a helpful response for the user.",
+              "timeout": 600,
+              "repos": [
+                {
+                  "url": "OpenHands/extensions",
+                  "provider": "github",
+                  "ref": "main"
+                }
+              ],
+              "trigger": {
+                "type": "event",
+                "source": "github",
+                "on": "issue_comment.created",
+                "filter": "glob(repository.full_name, 'OpenHands/extensions') && icontains(comment.body, '@openhands')"
+              }
+            }
+          }
+        },
+        "response": {
+          "status": 200,
+          "body": {
+            "valid": true,
+            "errors": []
+          }
+        }
+      },
+      "create": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/preset/prompt",
+          "body": {
+            "name": "OpenHands mention responder",
+            "prompt": "When triggered, read the GitHub issue or pull request context and draft a helpful response for the user.",
+            "timeout": 600,
+            "repos": [
+              {
+                "url": "OpenHands/extensions",
+                "provider": "github",
+                "ref": "main"
+              }
+            ],
+            "trigger": {
+              "type": "event",
+              "source": "github",
+              "on": "issue_comment.created",
+              "filter": "glob(repository.full_name, 'OpenHands/extensions') && icontains(comment.body, '@openhands')"
+            }
+          }
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "1c0b7ea0-0000-4000-8000-000000000002",
+            "model": null,
+            "name": "OpenHands mention responder",
+            "prompt": "When triggered, read the GitHub issue or pull request context and draft a helpful response for the user.",
+            "trigger": {
+              "type": "event",
+              "source": "github",
+              "on": "issue_comment.created",
+              "filter": "glob(repository.full_name, 'OpenHands/extensions') && icontains(comment.body, '@openhands')"
+            },
+            "timeout": 600,
+            "enabled": true
+          }
+        }
+      }
+    },
+    {
+      "id": "scheduled-plugin",
+      "description": "A custom plugin automation that loads an OpenHands plugin and runs a prompt.",
+      "selectedAction": "plugin",
+      "selectedTrigger": "cron",
+      "formValues": {
+        "name": "Weekly plugin check",
+        "plugins": [
+          {
+            "source": "github:OpenHands/extensions",
+            "repo_path": "plugins/qa-changes",
+            "ref": "main"
+          }
+        ],
+        "prompt": "Use the plugin to QA recent changes and produce a concise report.",
+        "repository": "OpenHands/OpenHands",
+        "ref": "main",
+        "model": "balanced",
+        "timeout": 1200,
+        "schedule": "0 10 * * 1",
+        "timezone": "UTC"
+      },
+      "preflight": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/validate",
+          "body": {
+            "automationId": "custom-automation",
+            "endpoint": "/v1/preset/plugin",
+            "draft": {
+              "name": "Weekly plugin check",
+              "prompt": "Use the plugin to QA recent changes and produce a concise report.",
+              "plugins": [
+                {
+                  "source": "github:OpenHands/extensions",
+                  "repo_path": "plugins/qa-changes",
+                  "ref": "main"
+                }
+              ],
+              "model": "balanced",
+              "timeout": 1200,
+              "repos": [
+                {
+                  "url": "OpenHands/OpenHands",
+                  "provider": "github",
+                  "ref": "main"
+                }
+              ],
+              "trigger": {
+                "type": "cron",
+                "schedule": "0 10 * * 1",
+                "timezone": "UTC"
+              }
+            }
+          }
+        },
+        "response": {
+          "status": 200,
+          "body": {
+            "valid": true,
+            "errors": []
+          }
+        }
+      },
+      "create": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/preset/plugin",
+          "body": {
+            "name": "Weekly plugin check",
+            "prompt": "Use the plugin to QA recent changes and produce a concise report.",
+            "plugins": [
+              {
+                "source": "github:OpenHands/extensions",
+                "repo_path": "plugins/qa-changes",
+                "ref": "main"
+              }
+            ],
+            "model": "balanced",
+            "timeout": 1200,
+            "repos": [
+              {
+                "url": "OpenHands/OpenHands",
+                "provider": "github",
+                "ref": "main"
+              }
+            ],
+            "trigger": {
+              "type": "cron",
+              "schedule": "0 10 * * 1",
+              "timezone": "UTC"
+            }
+          }
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "1c0b7ea0-0000-4000-8000-000000000003",
+            "model": "balanced",
+            "name": "Weekly plugin check",
+            "prompt": "Use the plugin to QA recent changes and produce a concise report.",
+            "trigger": {
+              "type": "cron",
+              "schedule": "0 10 * * 1",
+              "timezone": "UTC"
+            },
+            "timeout": 1200,
+            "enabled": true
+          }
+        }
+      }
+    },
+    {
+      "id": "scheduled-upload",
+      "description": "A custom upload automation that uploads a tarball and creates through the raw endpoint.",
+      "selectedAction": "upload",
+      "selectedTrigger": "cron",
+      "formValues": {
+        "name": "Uploaded maintenance script",
+        "tarball": "oh-internal://uploads/1c0b7ea0-0000-4000-8000-000000000004",
+        "entrypoint": "python3 main.py",
+        "setupScript": "setup.sh",
+        "model": "",
+        "timeout": 300,
+        "schedule": "30 2 * * *",
+        "timezone": "UTC"
+      },
+      "upload": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/uploads?name=Uploaded%20maintenance%20script"
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "1c0b7ea0-0000-4000-8000-000000000004",
+            "status": "COMPLETED",
+            "tarball_path": "oh-internal://uploads/1c0b7ea0-0000-4000-8000-000000000004"
+          }
+        }
+      },
+      "preflight": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/validate",
+          "body": {
+            "automationId": "custom-automation",
+            "endpoint": "/v1",
+            "draft": {
+              "name": "Uploaded maintenance script",
+              "timeout": 300,
+              "trigger": {
+                "type": "cron",
+                "schedule": "30 2 * * *",
+                "timezone": "UTC"
+              },
+              "tarball_path": "oh-internal://uploads/00000000-0000-0000-0000-000000000000",
+              "entrypoint": "python3 main.py",
+              "setup_script_path": "setup.sh"
+            }
+          }
+        },
+        "response": {
+          "status": 200,
+          "body": {
+            "valid": true,
+            "errors": []
+          }
+        }
+      },
+      "create": {
+        "request": {
+          "method": "POST",
+          "path": "/v1",
+          "body": {
+            "name": "Uploaded maintenance script",
+            "timeout": 300,
+            "trigger": {
+              "type": "cron",
+              "schedule": "30 2 * * *",
+              "timezone": "UTC"
+            },
+            "tarball_path": "oh-internal://uploads/1c0b7ea0-0000-4000-8000-000000000004",
+            "entrypoint": "python3 main.py",
+            "setup_script_path": "setup.sh"
+          }
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "1c0b7ea0-0000-4000-8000-000000000004",
+            "model": null,
+            "name": "Uploaded maintenance script",
+            "trigger": {
+              "type": "cron",
+              "schedule": "30 2 * * *",
+              "timezone": "UTC"
+            },
+            "timeout": 300,
+            "enabled": true
+          }
+        }
+      }
+    }
+  ]
+}

package/tests/fixtures/automations/github-pr-reviewer.json

@@ -50,7 +50,7 @@
             "automationId": "github-pr-reviewer",
             "endpoint": "/v1",
             "draft": {
-              "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
+              "name": "GitHub code review - OpenHands/agent-server-gui",
               "trigger": {
                 "type": "cron",
                 "schedule": "*/15 * * * *",
@@ -86,7 +86,7 @@
           "method": "POST",
           "path": "/v1",
           "body": {
-            "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
+            "name": "GitHub code review - OpenHands/agent-server-gui",
             "trigger": {
               "type": "cron",
               "schedule": "*/15 * * * *",
@@ -115,7 +115,7 @@
             "user_id": "1a2b3c4d-0000-4000-8000-000000000001",
             "org_id": "1a2b3c4d-0000-4000-8000-000000000002",
             "model": null,
-            "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
+            "name": "GitHub code review - OpenHands/agent-server-gui",
             "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: thorough.",
             "trigger": {
               "type": "cron",
@@ -179,7 +179,7 @@
             "automationId": "github-pr-reviewer",
             "endpoint": "/v1",
             "draft": {
-              "name": "GitHub Code Review Agent - 2 repositories",
+              "name": "GitHub code review - 2 repositories",
               "trigger": {
                 "type": "cron",
                 "schedule": "*/15 * * * *",
@@ -216,7 +216,7 @@
           "method": "POST",
           "path": "/v1",
           "body": {
-            "name": "GitHub Code Review Agent - 2 repositories",
+            "name": "GitHub code review - 2 repositories",
             "trigger": {
               "type": "cron",
               "schedule": "*/15 * * * *",
@@ -246,7 +246,7 @@
             "user_id": "1a2b3c4d-0000-4000-8000-000000000001",
             "org_id": "1a2b3c4d-0000-4000-8000-000000000002",
             "model": null,
-            "name": "GitHub Code Review Agent - 2 repositories",
+            "name": "GitHub code review - 2 repositories",
             "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: thorough.",
             "trigger": {
               "type": "cron",
@@ -300,7 +300,7 @@
             "automationId": "github-pr-reviewer",
             "endpoint": "/v1",
             "draft": {
-              "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
+              "name": "GitHub code review - OpenHands/agent-server-gui",
               "trigger": {
                 "type": "cron",
                 "schedule": "*/1 * * * *",
@@ -381,7 +381,7 @@
           "method": "POST",
           "path": "/v1",
           "body": {
-            "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
+            "name": "GitHub code review - OpenHands/agent-server-gui",
             "trigger": {
               "type": "cron",
               "schedule": "0 0 31 2 *",
@@ -465,7 +465,7 @@
           "method": "POST",
           "path": "/v1",
           "body": {
-            "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
+            "name": "GitHub code review - OpenHands/agent-server-gui",
             "trigger": {
               "type": "cron",
               "schedule": "*/15 * * * *",