@openhands/extensions 0.19.0 → 0.21.0

package/automations/catalog/custom-automation/manifest.json

@@ -0,0 +1,229 @@
+{
+  "id": "custom-automation",
+  "name": "Custom automation",
+  "category": "Custom",
+  "icon": "sparkles",
+  "description": "Create a custom automation from a prompt, plugin-powered prompt, or uploaded script tarball.",
+  "requires": {
+    "integrations": {
+      "github": {
+        "message": "Optional. Used when you choose a GitHub repository to clone or trigger from GitHub events.",
+        "required": false
+      }
+    }
+  },
+  "popularityRank": 99,
+  "estimatedSetupMinutes": 5,
+  "skill": "openhands-automation",
+  "exampleImplementation": "Action: a user-selected prompt, plugin, or uploaded tarball creation path\nTrigger: a user-selected cron schedule or event source and event type\n\n1. Ask whether the automation should run a prompt, run a prompt with plugins, or upload a tarball.\n2. Render only the fields for the selected creation path.\n3. Create prompt automations through /v1/preset/prompt, plugin automations through /v1/preset/plugin, and uploaded tarball automations by uploading to /v1/uploads then creating through /v1.\n4. The selected trigger and common run settings are shared by all creation paths.",
+  "setup": {
+    "version": "1.0",
+    "mode": "direct",
+    "form": {
+      "note": "Choose whether this custom automation runs a plain prompt, a prompt with plugins, or your own uploaded tarball. Prompt and plugin runs use the LLM; uploaded tarballs are best for deterministic scripts.",
+      "triggers": {
+        "cron": {
+          "schedule": {
+            "type": "cron",
+            "label": "Schedule",
+            "help": "How often this automation should run.",
+            "default": "0 9 * * *",
+            "required": true
+          },
+          "timezone": {
+            "type": "timezone",
+            "label": "Timezone",
+            "help": "Timezone used to evaluate the schedule.",
+            "default": "UTC",
+            "required": true
+          }
+        },
+        "event": {
+          "source": {
+            "type": "event-source",
+            "label": "Event source",
+            "help": "Webhook source that starts the automation.",
+            "default": "github",
+            "required": true
+          },
+          "on": {
+            "type": "event-type",
+            "label": "Event type",
+            "help": "Event key or wildcard pattern that starts the automation.",
+            "placeholder": "issue_comment.created",
+            "required": true
+          },
+          "filter": {
+            "type": "textarea",
+            "label": "Event filter",
+            "help": "Optional JMESPath expression evaluated against the event payload.",
+            "placeholder": "glob(repository.full_name, 'OpenHands/*')",
+            "required": false,
+            "constraints": {
+              "maxLength": 2000
+            }
+          }
+        }
+      },
+      "args": {
+        "name": {
+          "type": "text",
+          "label": "Automation name",
+          "help": "Name shown in the automations list.",
+          "placeholder": "Daily repository summary",
+          "required": true,
+          "constraints": {
+            "minLength": 1,
+            "maxLength": 500
+          }
+        },
+        "model": {
+          "type": "llm-profile",
+          "label": "LLM profile",
+          "help": "Optional model profile used for automation runs. Leave blank to use the active profile.",
+          "required": false
+        },
+        "timeout": {
+          "type": "number",
+          "label": "Timeout (seconds)",
+          "help": "Maximum time a single run may take. Leave blank for the service default.",
+          "required": false,
+          "constraints": {
+            "min": 1,
+            "max": 1800
+          }
+        }
+      }
+    },
+    "actions": {
+      "prompt": {
+        "label": "Prompt",
+        "help": "Run a natural-language prompt with the default OpenHands agent.",
+        "features": [
+          "presetPrompt"
+        ],
+        "args": {
+          "prompt": {
+            "type": "textarea",
+            "label": "Prompt",
+            "help": "Instructions the agent follows every time the automation runs.",
+            "placeholder": "Summarize recent repository activity and post the result to Slack.",
+            "required": true,
+            "constraints": {
+              "minLength": 1,
+              "maxLength": 50000
+            }
+          },
+          "repository": {
+            "type": "repo-picker",
+            "label": "Repository",
+            "help": "Optional GitHub repository to clone before each run.",
+            "provider": "github",
+            "required": false
+          },
+          "ref": {
+            "type": "text",
+            "label": "Branch or ref",
+            "help": "Branch, tag, or commit to check out when a repository is selected.",
+            "placeholder": "main",
+            "required": false,
+            "constraints": {
+              "minLength": 1,
+              "maxLength": 255
+            }
+          }
+        },
+        "prompt": "{{form.prompt}}"
+      },
+      "plugin": {
+        "label": "Plugin",
+        "help": "Run a prompt with one or more OpenHands plugins loaded.",
+        "features": [
+          "presetPlugin"
+        ],
+        "args": {
+          "plugins": {
+            "type": "plugin-sources",
+            "label": "Plugins",
+            "help": "One or more plugin sources to load. Each source may include an optional ref and repository path.",
+            "required": true
+          },
+          "prompt": {
+            "type": "textarea",
+            "label": "Prompt",
+            "help": "Instructions the agent follows after loading the plugins.",
+            "placeholder": "Use the plugin commands to inspect the repository and summarize findings.",
+            "required": true,
+            "constraints": {
+              "minLength": 1,
+              "maxLength": 50000
+            }
+          },
+          "repository": {
+            "type": "repo-picker",
+            "label": "Repository",
+            "help": "Optional GitHub repository to clone before each run.",
+            "provider": "github",
+            "required": false
+          },
+          "ref": {
+            "type": "text",
+            "label": "Branch or ref",
+            "help": "Branch, tag, or commit to check out when a repository is selected.",
+            "placeholder": "main",
+            "required": false,
+            "constraints": {
+              "minLength": 1,
+              "maxLength": 255
+            }
+          }
+        },
+        "prompt": "{{form.prompt}}",
+        "plugins": "{{form.plugins}}"
+      },
+      "upload": {
+        "label": "Upload tarball",
+        "help": "Upload a .tar or .tar.gz containing the automation code to run.",
+        "features": [
+          "customTarball"
+        ],
+        "args": {
+          "tarball": {
+            "type": "tarball-upload",
+            "label": "Tarball",
+            "help": "A .tar or .tar.gz archive containing the automation code. Maximum size is enforced by the automation service.",
+            "required": true
+          },
+          "entrypoint": {
+            "type": "text",
+            "label": "Entrypoint",
+            "help": "Command to run after the tarball is extracted.",
+            "default": "python3 main.py",
+            "placeholder": "python3 main.py",
+            "required": true,
+            "constraints": {
+              "minLength": 1,
+              "maxLength": 500
+            }
+          },
+          "setupScript": {
+            "type": "text",
+            "label": "Setup script",
+            "help": "Optional path inside the tarball to run before the entrypoint.",
+            "placeholder": "setup.sh",
+            "required": false,
+            "constraints": {
+              "minLength": 1,
+              "maxLength": 255
+            }
+          }
+        },
+        "tarballPath": "{{form.tarball}}",
+        "entrypoint": "{{form.entrypoint}}",
+        "setupScript": "{{form.setupScript}}"
+      }
+    },
+    "filter": "{{form.filter}}",
+    "message": "This deployment cannot create custom automations directly. Set it up in this conversation instead: choose prompt, plugin, or uploaded tarball mode; confirm the selected trigger, model profile, timeout, and mode-specific fields; then create the automation."
+  }
+}

package/automations/catalog/github-agents-md-maintainer/manifest.json

@@ -88,7 +88,8 @@
       "entrypoint": "python3 main.py",
       "timeout": 900,
       "files": {
-        "main.py": "skills/github-agents-md-maintainer/scripts/main.py"
+        "main.py": "skills/github-agents-md-maintainer/scripts/main.py",
+        "github_client.py": "skills/github/scripts/github_client.py"
       },
       "config": {
         "repos": "{{form.repositories}}",

package/automations/catalog/github-issue-to-pr/manifest.json

@@ -1,6 +1,6 @@
 {
   "id": "github-issue-to-pr",
-  "name": "GitHub Issue to PR Agent",
+  "name": "GitHub issue to PR",
   "category": "Software development",
   "description": "Watch for a configurable label on GitHub issues, implement the issue in a clone of the default branch, and open a pull request for each label event.",
   "requires": {
@@ -98,7 +98,8 @@
       "entrypoint": "python3 main.py",
       "timeout": 900,
       "files": {
-        "main.py": "skills/github-issue-to-pr/scripts/main.py"
+        "main.py": "skills/github-issue-to-pr/scripts/main.py",
+        "github_client.py": "skills/github/scripts/github_client.py"
       },
       "config": {
         "repos": "{{form.repositories}}",

package/automations/catalog/github-issue-triage/manifest.json

@@ -0,0 +1,72 @@
+{
+  "id": "github-issue-triage",
+  "version": "1.0.0",
+  "name": "GitHub issue triage",
+  "category": "Project management",
+  "description": "Prioritize open issues and establish acceptance criteria before marking them ready for development.",
+  "requires": {
+    "integrations": {},
+    "features": [
+      "customTarball",
+      "agentProfiles"
+    ]
+  },
+  "estimatedSetupMinutes": 3,
+  "exampleImplementation": "Select an agent profile with Issues: read and write. Run this workflow independently on a schedule.",
+  "setup": {
+    "version": "1.0",
+    "mode": "direct",
+    "form": {
+      "triggers": {
+        "cron": {
+          "schedule": {
+            "type": "cron",
+            "label": "Check frequency",
+            "help": "How often to check repository progress.",
+            "default": "*/5 * * * *",
+            "required": true
+          },
+          "timezone": {
+            "type": "timezone",
+            "label": "Timezone",
+            "help": "Timezone for the schedule.",
+            "default": "UTC",
+            "required": true
+          }
+        }
+      },
+      "args": {
+        "repositories": {
+          "type": "repo-picker",
+          "provider": "github",
+          "multiple": true,
+          "label": "Repositories",
+          "help": "Repositories this automation may work on.",
+          "required": true
+        },
+        "githubTokenSecret": {
+          "type": "text",
+          "label": "GitHub token secret",
+          "help": "Name of a saved secret allowed by the selected agent profile. Enter its name, not its value.",
+          "default": "GITHUB_PERSONAL_ACCESS_TOKEN",
+          "required": true
+        }
+      }
+    },
+    "bundle": {
+      "version": "1.0.0",
+      "entrypoint": "python3 worker.py",
+      "timeout": 3000,
+      "files": {
+        "worker.py": "skills/github-issue-triage/scripts/worker.py",
+        "github_client.py": "skills/github/scripts/github_client.py"
+      },
+      "config": {
+        "repos": "{{form.repositories}}",
+        "github_token_secret": "{{form.githubTokenSecret}}"
+      }
+    },
+    "message": "Select an agent profile and configure this scheduled automation in the conversation."
+  },
+  "popularityRank": 80
+}

package/automations/catalog/github-pr-reviewer/manifest.json

@@ -1,7 +1,7 @@
 {
   "id": "github-pr-reviewer",
   "version": "1.0.0",
-  "name": "GitHub Code Review Agent",
+  "name": "GitHub code review",
   "category": "Code review",
   "description": "Watch for a configurable label on GitHub pull requests, inspect full PR and repository context, and post an AI review comment once per label event.",
   "requires": {
@@ -92,7 +92,8 @@
       "entrypoint": "python3 main.py",
       "timeout": 600,
       "files": {
-        "main.py": "skills/github-pr-reviewer/scripts/main.py"
+        "main.py": "skills/github-pr-reviewer/scripts/main.py",
+        "github_client.py": "skills/github/scripts/github_client.py"
       },
       "config": {
         "repos": "{{form.repositories}}",

package/automations/catalog/gitlab-issue-to-mr/manifest.json

@@ -0,0 +1,124 @@
+{
+  "id": "gitlab-issue-to-mr",
+  "name": "GitLab issue to MR",
+  "category": "Software development",
+  "description": "Watch for a configurable label on GitLab issues, implement the issue in a clone of the default branch, and open a merge request for each label event.",
+  "requires": {
+    "integrations": {
+      "gitlab": {
+        "message": "Used to read labelled issues, push the branch, and open the merge request."
+      }
+    },
+    "features": [
+      "customTarball"
+    ]
+  },
+  "popularityRank": 88,
+  "estimatedSetupMinutes": 4,
+  "exampleImplementation": "Trigger: cron polling for open GitLab issues with a configured label such as openhands\nRequired secret: GITLAB_TOKEN, a personal or project access token with the api scope and at least the Developer role\n\n1. Read the projects, trigger label, branch prefix, merge request mode, GitLab API URL, and polling schedule from setup.\n2. Poll each project independently, with its own state, so issue IIDs never collide.\n3. List open labelled issues and find the latest matching GitLab label resource event for each.\n4. Deduplicate on the label event ID so every label application queues exactly one attempt.\n5. Clone the default branch into a directory of its own, create the working branch, and start an OpenHands conversation with that directory as its workspace. The clone carries no credential and the agent is handed no secrets, because the prompt is built from an issue body that anyone can write.\n6. Comment on the issue with the branch and the conversation link.\n7. Once the conversation has stopped, commit whatever the agent left, push the branch, open a merge request titled after the issue and prefixed with Draft:, and comment the link on the issue. An agent that made no changes gets its answer posted instead.\n8. Remove the clone once the conversation has stopped, so nothing accumulates between runs.",
+  "impact": {
+    "basis": "completed-runs",
+    "one": "1 issue sweep completed",
+    "other": "{{count}} issue sweeps completed"
+  },
+  "setup": {
+    "version": "1.0",
+    "mode": "direct",
+    "form": {
+      "triggers": {
+        "cron": {
+          "schedule": {
+            "type": "cron",
+            "label": "Check frequency",
+            "help": "How often to look for newly labelled issues.",
+            "default": "*/15 * * * *",
+            "required": true
+          },
+          "timezone": {
+            "type": "timezone",
+            "label": "Timezone",
+            "help": "Timezone the schedule is interpreted in.",
+            "default": "UTC",
+            "required": true
+          }
+        }
+      },
+      "args": {
+        "projects": {
+          "type": "repo-picker",
+          "label": "Projects",
+          "help": "The GitLab projects whose labelled issues are implemented. Each is polled independently and keeps its own state, so issue numbers never collide between them.",
+          "provider": "gitlab",
+          "multiple": true,
+          "required": true
+        },
+        "triggerLabel": {
+          "type": "text",
+          "label": "Trigger label",
+          "help": "Only issues carrying this label are worked on.",
+          "default": "openhands",
+          "required": true,
+          "constraints": {
+            "minLength": 1,
+            "maxLength": 50
+          }
+        },
+        "branchPrefix": {
+          "type": "text",
+          "label": "Branch prefix",
+          "help": "Branches are named after this prefix and the issue number, such as openhands/issue-42.",
+          "default": "openhands/issue",
+          "required": true,
+          "constraints": {
+            "minLength": 1,
+            "maxLength": 50
+          }
+        },
+        "mergeRequestMode": {
+          "type": "select",
+          "label": "Merge request mode",
+          "help": "Whether the merge request is opened as a draft or ready for review. GitLab marks a draft by prefixing its title with Draft:.",
+          "default": "draft",
+          "required": true,
+          "options": [
+            {
+              "value": "draft",
+              "label": "Draft"
+            },
+            {
+              "value": "ready",
+              "label": "Ready for review"
+            }
+          ]
+        },
+        "gitlabApiUrl": {
+          "type": "text",
+          "label": "GitLab API URL",
+          "help": "The API root of the GitLab instance. Change it for a self-managed instance, such as https://gitlab.example.com/api/v4.",
+          "default": "https://gitlab.com/api/v4",
+          "required": true,
+          "constraints": {
+            "minLength": 1,
+            "maxLength": 200
+          }
+        }
+      }
+    },
+    "bundle": {
+      "version": "1.0.0",
+      "entrypoint": "python3 main.py",
+      "timeout": 900,
+      "files": {
+        "main.py": "skills/gitlab-issue-to-mr/scripts/main.py"
+      },
+      "config": {
+        "projects": "{{form.projects}}",
+        "trigger_label": "{{form.triggerLabel}}",
+        "branch_prefix": "{{form.branchPrefix}}",
+        "merge_request_mode": "{{form.mergeRequestMode}}",
+        "gitlab_api_url": "{{form.gitlabApiUrl}}"
+      }
+    },
+    "message": "This deployment cannot run the scheduled issue-to-MR automation directly. Set it up in this conversation instead: confirm the GitLab projects to watch, the trigger label, the branch prefix, whether merge requests open as drafts, the GitLab API URL, and the polling schedule, then create the automation."
+  }
+}

package/automations/catalog/qa-changes/manifest.json

@@ -1,6 +1,6 @@
 {
   "id": "qa-changes",
-  "name": "QA Changes Agent",
+  "name": "QA changes",
   "category": "Code review",
   "description": "When a pull request is opened for review, run the QA changes methodology — set up the environment, exercise the changed behavior as a real user would, and post the outcome by editing the PR description with a QA Agent section.",
   "requires": {

package/automations/catalog-index.js

@@ -3,23 +3,26 @@
 // run: npm run build:automations
 
 import entry0 from "./catalog/github-pr-reviewer/manifest.json" with { type: "json" };
-import entry1 from "./catalog/github-repo-monitor/manifest.json" with { type: "json" };
-import entry2 from "./catalog/github-issue-to-pr/manifest.json" with { type: "json" };
-import entry3 from "./catalog/slack-standup-digest/manifest.json" with { type: "json" };
-import entry4 from "./catalog/slack-channel-monitor/manifest.json" with { type: "json" };
-import entry5 from "./catalog/linear-triage-assistant/manifest.json" with { type: "json" };
-import entry6 from "./catalog/linear-issue-to-github-pr/manifest.json" with { type: "json" };
-import entry7 from "./catalog/linear-issue-to-gitlab-mr/manifest.json" with { type: "json" };
-import entry8 from "./catalog/linear-issue-to-bitbucket-pr/manifest.json" with { type: "json" };
-import entry9 from "./catalog/jira-issue-to-pr/manifest.json" with { type: "json" };
-import entry10 from "./catalog/qa-changes/manifest.json" with { type: "json" };
-import entry11 from "./catalog/jira-issue-to-gitlab-mr/manifest.json" with { type: "json" };
-import entry12 from "./catalog/research-brief-writer/manifest.json" with { type: "json" };
-import entry13 from "./catalog/jira-issue-to-bitbucket-pr/manifest.json" with { type: "json" };
-import entry14 from "./catalog/github-agents-md-maintainer/manifest.json" with { type: "json" };
-import entry15 from "./catalog/upstream-fork-sync/manifest.json" with { type: "json" };
-import entry16 from "./catalog/incident-retrospective-drafter/manifest.json" with { type: "json" };
-import entry17 from "./catalog/news-digest/manifest.json" with { type: "json" };
+import entry1 from "./catalog/custom-automation/manifest.json" with { type: "json" };
+import entry2 from "./catalog/github-repo-monitor/manifest.json" with { type: "json" };
+import entry3 from "./catalog/github-issue-to-pr/manifest.json" with { type: "json" };
+import entry4 from "./catalog/slack-standup-digest/manifest.json" with { type: "json" };
+import entry5 from "./catalog/slack-channel-monitor/manifest.json" with { type: "json" };
+import entry6 from "./catalog/linear-triage-assistant/manifest.json" with { type: "json" };
+import entry7 from "./catalog/linear-issue-to-github-pr/manifest.json" with { type: "json" };
+import entry8 from "./catalog/gitlab-issue-to-mr/manifest.json" with { type: "json" };
+import entry9 from "./catalog/linear-issue-to-gitlab-mr/manifest.json" with { type: "json" };
+import entry10 from "./catalog/linear-issue-to-bitbucket-pr/manifest.json" with { type: "json" };
+import entry11 from "./catalog/jira-issue-to-pr/manifest.json" with { type: "json" };
+import entry12 from "./catalog/qa-changes/manifest.json" with { type: "json" };
+import entry13 from "./catalog/jira-issue-to-gitlab-mr/manifest.json" with { type: "json" };
+import entry14 from "./catalog/research-brief-writer/manifest.json" with { type: "json" };
+import entry15 from "./catalog/jira-issue-to-bitbucket-pr/manifest.json" with { type: "json" };
+import entry16 from "./catalog/github-agents-md-maintainer/manifest.json" with { type: "json" };
+import entry17 from "./catalog/github-issue-triage/manifest.json" with { type: "json" };
+import entry18 from "./catalog/upstream-fork-sync/manifest.json" with { type: "json" };
+import entry19 from "./catalog/incident-retrospective-drafter/manifest.json" with { type: "json" };
+import entry20 from "./catalog/news-digest/manifest.json" with { type: "json" };
 
 export const AUTOMATION_CATALOG_ENTRIES = [
   entry0,
@@ -40,4 +43,7 @@ export const AUTOMATION_CATALOG_ENTRIES = [
   entry15,
   entry16,
   entry17,
+  entry18,
+  entry19,
+  entry20,
 ];