@openhands/extensions 0.21.0 → 0.22.1

package/automations/catalog/github-delivery-watchdog/manifest.json

@@ -0,0 +1,79 @@
+{
+  "id": "github-delivery-watchdog",
+  "version": "1.0.0",
+  "name": "GitHub delivery watchdog",
+  "category": "Project management",
+  "description": "Periodically check pull requests and merge only current heads with independent review, tests, and passing CI.",
+  "requires": {
+    "integrations": {},
+    "features": [
+      "customTarball"
+    ]
+  },
+  "estimatedSetupMinutes": 3,
+  "exampleImplementation": "Run a deterministic scheduled scanner using its configured GitHub credential. It creates no agent or conversation. For each managed PR, it rechecks the exact head, independent review and test statuses, GitHub Actions, base freshness, and mergeability before issuing a SHA-pinned squash merge.",
+  "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 Agent Server secret. Enter its name, not its value.",
+          "default": "GITHUB_PERSONAL_ACCESS_TOKEN",
+          "required": true
+        },
+        "branchPrefix": {
+          "type": "text",
+          "label": "Delivery branch prefix",
+          "help": "Only merge branches with this prefix and an issue number. Match the developer and reviewer settings.",
+          "default": "openhands/issue",
+          "required": true
+        }
+      }
+    },
+    "bundle": {
+      "version": "1.0.0",
+      "entrypoint": "python3 worker.py",
+      "timeout": 300,
+      "files": {
+        "worker.py": "skills/github-delivery-watchdog/scripts/worker.py",
+        "github_client.py": "skills/github/scripts/github_client.py"
+      },
+      "config": {
+        "repos": "{{form.repositories}}",
+        "github_token_secret": "{{form.githubTokenSecret}}",
+        "branch_prefix": "{{form.branchPrefix}}"
+      }
+    },
+    "message": "Configure the repositories, credential name, delivery branch prefix, and schedule."
+  },
+  "popularityRank": 80
+}

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

@@ -2,20 +2,17 @@
   "id": "github-issue-to-pr",
   "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.",
+  "description": "Implement ready GitHub issues, address pull request feedback, and publish tested changes for review.",
   "requires": {
-    "integrations": {
-      "github": {
-        "message": "Used to read labelled issues, push the branch, and open the pull request."
-      }
-    },
+    "integrations": {},
     "features": [
-      "customTarball"
+      "customTarball",
+      "agentProfiles"
     ]
   },
   "popularityRank": 95,
   "estimatedSetupMinutes": 4,
-  "exampleImplementation": "Trigger: cron polling for open GitHub issues with a configured label such as openhands\nRequired secret: GITHUB_PERSONAL_ACCESS_TOKEN, with permission to write contents, issues, and pull requests\n\n1. Read the repositories, trigger label, branch prefix, draft mode, and polling schedule from setup.\n2. Poll each repository independently, with its own state, so issue numbers never collide.\n3. List open labelled issues, drop pull requests, and find the latest matching GitHub labeled issue 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 draft pull request titled after the issue, 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.",
+  "exampleImplementation": "A scheduled scanner selects every ready issue and each pull request whose exact head failed review. It submits one idempotent subject turn for each item. The profile-backed agent then clones the repository in its own runtime, implements or revises the change, tests it, pushes it, and requests independent review.",
   "impact": {
     "basis": "completed-runs",
     "one": "1 issue sweep completed",
@@ -90,24 +87,35 @@
               "label": "Ready for review"
             }
           ]
+        },
+        "githubTokenSecret": {
+          "type": "text",
+          "label": "GitHub token secret",
+          "help": "Name of a saved Agent Server secret. Include it in the selected profile so the delegated agent can use GitHub.",
+          "default": "GITHUB_PERSONAL_ACCESS_TOKEN",
+          "required": true
         }
       }
     },
     "bundle": {
-      "version": "1.0.0",
-      "entrypoint": "python3 main.py",
-      "timeout": 900,
+      "version": "1.2.1",
+      "entrypoint": "python3 worker.py",
+      "timeout": 300,
       "files": {
         "main.py": "skills/github-issue-to-pr/scripts/main.py",
-        "github_client.py": "skills/github/scripts/github_client.py"
+        "agent_conversation.py": "skills/github/scripts/agent_conversation.py",
+        "github_client.py": "skills/github/scripts/github_client.py",
+        "worker.py": "skills/github-issue-to-pr/scripts/worker.py"
       },
       "config": {
         "repos": "{{form.repositories}}",
         "trigger_label": "{{form.triggerLabel}}",
         "branch_prefix": "{{form.branchPrefix}}",
-        "pull_request_mode": "{{form.pullRequestMode}}"
+        "pull_request_mode": "{{form.pullRequestMode}}",
+        "github_token_secret": "{{form.githubTokenSecret}}"
       }
     },
-    "message": "This deployment cannot run the scheduled issue-to-PR automation directly. Set it up in this conversation instead: confirm the repositories to watch, the trigger label, the branch prefix, whether pull requests open as drafts, and the polling schedule, then create the automation."
-  }
+    "message": "Configure the repositories, labels, branch prefix, pull request mode, agent profile, and schedule."
+  },
+  "version": "1.2.1"
 }

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

@@ -1,6 +1,6 @@
 {
   "id": "github-issue-triage",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "name": "GitHub issue triage",
   "category": "Project management",
   "description": "Prioritize open issues and establish acceptance criteria before marking them ready for development.",
@@ -54,11 +54,12 @@
       }
     },
     "bundle": {
-      "version": "1.0.0",
+      "version": "1.1.1",
       "entrypoint": "python3 worker.py",
-      "timeout": 3000,
+      "timeout": 300,
       "files": {
         "worker.py": "skills/github-issue-triage/scripts/worker.py",
+        "agent_conversation.py": "skills/github/scripts/agent_conversation.py",
         "github_client.py": "skills/github/scripts/github_client.py"
       },
       "config": {

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

@@ -1,22 +1,19 @@
 {
   "id": "github-pr-reviewer",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "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.",
+  "description": "Review labeled pull-request heads, publish readable findings, and record exact-head test and review decisions.",
   "requires": {
-    "integrations": {
-      "github": {
-        "message": "Used to read pull requests and post review comments."
-      }
-    },
+    "integrations": {},
     "features": [
-      "customTarball"
+      "customTarball",
+      "agentProfiles"
     ]
   },
   "popularityRank": 100,
   "estimatedSetupMinutes": 4,
-  "exampleImplementation": "Trigger: cron polling for open GitHub PRs with a configured label such as openhands-review\nRequired secret: GITHUB_PERSONAL_ACCESS_TOKEN, with permission to write pull request reviews\n\n1. Read the repositories, trigger label, review tone, and polling schedule from setup.\n2. Poll each repository independently, with its own state, so PR numbers never collide.\n3. List open PRs and find the latest matching GitHub labeled issue event for each labeled PR.\n4. Deduplicate on the label event ID so every label application queues exactly one review.\n5. Extract the PR head commit into a directory of its own and start an OpenHands conversation with that directory as its workspace, so the agent reviews the exact commit without cloning anything.\n6. Post an acknowledgement with the conversation link, then confirm on GitHub that the review was published for that head SHA, falling back to posting the agent's text as a comment.\n7. Remove the checkout once the conversation has stopped, so nothing accumulates between runs.",
+  "exampleImplementation": "A scheduled scanner selects every labeled PR head and submits an idempotent subject turn. The profile-backed agent clones that exact head in its runtime, reuses the established review workflow, runs appropriate tests, publishes a readable native review, and records exact-head review and test statuses.",
   "impact": {
     "basis": "completed-runs",
     "one": "1 PR review sweep completed",
@@ -84,23 +81,33 @@
               "label": "Friendly"
             }
           ]
+        },
+        "githubTokenSecret": {
+          "type": "text",
+          "label": "GitHub token secret",
+          "help": "Name of a saved Agent Server secret. Include it in the selected profile so the delegated agent can use GitHub.",
+          "default": "GITHUB_PERSONAL_ACCESS_TOKEN",
+          "required": true
         }
       }
     },
     "bundle": {
-      "version": "1.0.0",
-      "entrypoint": "python3 main.py",
-      "timeout": 600,
+      "version": "1.1.1",
+      "entrypoint": "python3 worker.py",
+      "timeout": 300,
       "files": {
         "main.py": "skills/github-pr-reviewer/scripts/main.py",
-        "github_client.py": "skills/github/scripts/github_client.py"
+        "agent_conversation.py": "skills/github/scripts/agent_conversation.py",
+        "github_client.py": "skills/github/scripts/github_client.py",
+        "worker.py": "skills/github-pr-reviewer/scripts/worker.py"
       },
       "config": {
         "repos": "{{form.repositories}}",
         "trigger_label": "{{form.triggerLabel}}",
-        "review_tone": "{{form.reviewTone}}"
+        "review_tone": "{{form.reviewTone}}",
+        "github_token_secret": "{{form.githubTokenSecret}}"
       }
     },
-    "message": "This deployment cannot run the scheduled review automation directly. Set it up in this conversation instead: confirm the repository to review, the trigger label, the review tone, and the polling schedule, then create the automation."
+    "message": "Configure the repositories, review label, tone, credential name, agent profile, and schedule."
   }
 }

package/automations/catalog-index.js

@@ -19,10 +19,11 @@ import entry13 from "./catalog/jira-issue-to-gitlab-mr/manifest.json" with { typ
 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" };
+import entry17 from "./catalog/github-delivery-watchdog/manifest.json" with { type: "json" };
+import entry18 from "./catalog/github-issue-triage/manifest.json" with { type: "json" };
+import entry19 from "./catalog/upstream-fork-sync/manifest.json" with { type: "json" };
+import entry20 from "./catalog/incident-retrospective-drafter/manifest.json" with { type: "json" };
+import entry21 from "./catalog/news-digest/manifest.json" with { type: "json" };
 
 export const AUTOMATION_CATALOG_ENTRIES = [
   entry0,
@@ -46,4 +47,5 @@ export const AUTOMATION_CATALOG_ENTRIES = [
   entry18,
   entry19,
   entry20,
+  entry21,
 ];

package/marketplaces/openhands-extensions.json

@@ -870,6 +870,12 @@
       "source": "./skills/github-issue-triage",
       "description": "Prioritize open issues and establish acceptance criteria before marking them ready for development.",
       "category": "automations"
+    },
+    {
+      "name": "github-delivery-watchdog",
+      "source": "./skills/github-delivery-watchdog",
+      "description": "Periodically check pull requests and merge only current heads with independent review, tests, and passing CI.",
+      "category": "automations"
     }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/extensions",
-  "version": "0.21.0",
+  "version": "0.22.1",
   "description": "Public OpenHands extension catalogs for skills, plugins, integrations, and automation templates.",
   "license": "MIT",
   "type": "module",

package/plugins/city-weather/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "city-weather",
+  "version": "1.0.0",
+  "description": "Get current weather, time, and precipitation forecast for any city",
+  "author": {
+    "name": "JP Shackelford",
+    "email": "jpshackelford@users.noreply.github.com"
+  },
+  "homepage": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "repository": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "license": "MIT",
+  "keywords": ["weather", "time", "forecast", "temperature", "precipitation"]
+}

package/plugins/city-weather/.codex-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "city-weather",
+  "version": "1.0.0",
+  "description": "Get current weather, time, and precipitation forecast for any city",
+  "author": {
+    "name": "JP Shackelford",
+    "email": "jpshackelford@users.noreply.github.com"
+  },
+  "homepage": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "repository": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "license": "MIT",
+  "keywords": ["weather", "time", "forecast", "temperature", "precipitation"]
+}

package/plugins/cobol-modernization/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "cobol-modernization",
+  "version": "1.0.0",
+  "description": "End-to-end COBOL to Java migration workflow. Handles build setup, mainframe dependency removal, and code migration with test validation.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "cobol",
+    "java",
+    "migration",
+    "mainframe",
+    "modernization"
+  ]
+}

package/plugins/cobol-modernization/.codex-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "cobol-modernization",
+  "version": "1.0.0",
+  "description": "End-to-end COBOL to Java migration workflow. Handles build setup, mainframe dependency removal, and code migration with test validation.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "cobol",
+    "java",
+    "migration",
+    "mainframe",
+    "modernization"
+  ]
+}

package/plugins/issue-duplicate-checker/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "issue-duplicate-checker",
+  "version": "0.1.0",
+  "description": "Detect duplicate GitHub issues with OpenHands Cloud and manage duplicate-candidate lifecycle automation.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": ["issues", "duplicates", "github", "automation"]
+}

package/plugins/issue-duplicate-checker/.codex-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "issue-duplicate-checker",
+  "version": "0.1.0",
+  "description": "Detect duplicate GitHub issues with OpenHands Cloud and manage duplicate-candidate lifecycle automation.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": ["issues", "duplicates", "github", "automation"]
+}

package/plugins/magic-test/.claude-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "magic-test",
+  "version": "1.0.0",
+  "description": "A simple test plugin with a magic word skill for verifying plugin loading",
+  "author": {
+    "name": "OpenHands Test",
+    "email": "test@openhands.dev"
+  },
+  "homepage": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "repository": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "license": "MIT",
+  "keywords": ["test", "magic", "plugin", "verification"]
+}

package/plugins/magic-test/.codex-plugin/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "magic-test",
+  "version": "1.0.0",
+  "description": "A simple test plugin with a magic word skill for verifying plugin loading",
+  "author": {
+    "name": "OpenHands Test",
+    "email": "test@openhands.dev"
+  },
+  "homepage": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "repository": "https://github.com/jpshackelford/openhands-sample-plugins",
+  "license": "MIT",
+  "keywords": ["test", "magic", "plugin", "verification"]
+}

package/plugins/migration-scoring/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "migration-scoring",
+  "version": "1.0.0",
+  "description": "Evaluate code migration quality with coverage, correctness, and style scoring. Generates executive reports with actionable recommendations.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "migration",
+    "scoring",
+    "quality",
+    "evaluation",
+    "reporting"
+  ]
+}

package/plugins/migration-scoring/.codex-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "migration-scoring",
+  "version": "1.0.0",
+  "description": "Evaluate code migration quality with coverage, correctness, and style scoring. Generates executive reports with actionable recommendations.",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "migration",
+    "scoring",
+    "quality",
+    "evaluation",
+    "reporting"
+  ]
+}

package/plugins/onboarding/.claude-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "onboarding",
+  "version": "1.0.0",
+  "description": "Assess repository agent-readiness across five pillars, propose high-impact fixes, and generate repo-specific AGENTS.md files",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "onboarding",
+    "readiness",
+    "agents-md",
+    "agent-readiness",
+    "assessment",
+    "ai-readiness"
+  ]
+}

package/plugins/onboarding/.codex-plugin/plugin.json

@@ -0,0 +1,20 @@
+{
+  "name": "onboarding",
+  "version": "1.0.0",
+  "description": "Assess repository agent-readiness across five pillars, propose high-impact fixes, and generate repo-specific AGENTS.md files",
+  "author": {
+    "name": "OpenHands",
+    "email": "contact@all-hands.dev"
+  },
+  "homepage": "https://github.com/OpenHands/extensions",
+  "repository": "https://github.com/OpenHands/extensions",
+  "license": "MIT",
+  "keywords": [
+    "onboarding",
+    "readiness",
+    "agents-md",
+    "agent-readiness",
+    "assessment",
+    "ai-readiness"
+  ]
+}