@openhands/extensions 0.18.0 → 0.19.0

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

@@ -0,0 +1,72 @@
+{
+  "id": "qa-changes",
+  "name": "QA Changes Agent",
+  "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": {
+    "integrations": {
+      "github": {
+        "message": "Used to read the pull request, check the author's commit history, and edit the PR description."
+      }
+    },
+    "features": [
+      "repoClone",
+      "presetPrompt",
+      "webhookDelivery"
+    ]
+  },
+  "popularityRank": 85,
+  "estimatedSetupMinutes": 5,
+  "skill": "qa-changes",
+  "exampleImplementation": "Trigger: GitHub pull_request.opened and pull_request.ready_for_review events\nRequired secret: GITHUB_TOKEN\n\n1. Receive a GitHub pull_request event (opened or ready_for_review).\n2. Filter: the PR must not be a draft (draft == false), the PR description must not already contain a QA Agent section, and the PR author must have more than 3 commits already in main.\n3. Start an OpenHands conversation that clones the repo, checks out the PR head, and runs the /qa-changes methodology: understand the change, set up the environment, exercise the changed behavior as a real user would.\n4. Instead of posting a review comment, edit the PR description to append a horizontal rule followed by a QA Agent section containing the structured QA report.",
+  "setup": {
+    "version": "1.0",
+    "mode": "direct",
+    "form": {
+      "triggers": {
+        "event": {
+          "on": {
+            "type": "select",
+            "label": "Trigger on",
+            "help": "Which GitHub pull request event starts a QA run. Opened fires when a non-draft PR is created; Ready for review fires when a draft PR is marked ready.",
+            "default": "pull_request.opened",
+            "required": true,
+            "options": [
+              {
+                "value": "pull_request.opened",
+                "label": "Pull request opened"
+              },
+              {
+                "value": "pull_request.ready_for_review",
+                "label": "Pull request ready for review"
+              }
+            ]
+          }
+        }
+      },
+      "args": {
+        "repository": {
+          "type": "repo-picker",
+          "label": "Repository",
+          "help": "The repository whose pull requests will be QA'd.",
+          "provider": "github",
+          "required": true
+        },
+        "ref": {
+          "type": "text",
+          "label": "Base branch",
+          "help": "Branch checked out when the agent runs QA.",
+          "default": "main",
+          "required": true,
+          "constraints": {
+            "minLength": 1,
+            "maxLength": 255
+          }
+        }
+      }
+    },
+    "prompt": "A pull request was opened or marked ready for review in {{form.repository}}. Before doing any QA work, run these gate checks and stop immediately (making no changes) if any fails:\n\n1. The PR must not be a draft — it must be open for review. If the PR is a draft, stop.\n2. The PR author (the human who opened it) must have more than 3 commits already merged into the {{form.ref}} branch. Use the GitHub API to count the author's commits in {{form.ref}}. If the count is 3 or fewer, stop without making any changes.\n3. The PR description must not already contain a section named QA Agent (i.e., a header like ## QA Agent or ### QA Agent). If that section already exists, stop without making any changes or starting a conversation.\n\nIf all gate checks pass, proceed with the QA validation using the /qa-changes skill methodology:\n\n- Phase 1: Understand the change. Read the PR diff, title, and description. Identify the goal of the PR. Classify every changed file. Form a hypothesis about what the PR should achieve.\n- Phase 2: Set up the environment. Read the repo's bootstrap instructions, install dependencies, and build if needed. Note CI status but do not re-run tests.\n- Phase 3: Exercise the changed behavior. Actually run the software the way a real user would — start servers, run CLI commands, make HTTP requests, open browsers. Do NOT run the test suite, linters, or code analysis. For bug fixes, reproduce the bug before and after the fix. Show before/after evidence.\n- Phase 4: Report results.\n\nIMPORTANT — how to post your report:\nDo NOT post a new comment, review, or inline review comment. Instead, EDIT the PR description (the pull request body) to append your QA report at the very end, after a horizontal rule (---), under a new section titled QA Agent. Use the GitHub API (PATCH /repos/{owner}/{repo}/pulls/{pr_number} with a body field) to update the PR description. Append the following structure to the existing PR body:\n\n---\n\n## QA Agent\n\n{Your full QA report following the /qa-changes skill report format: verdict, summary, Does this PR achieve its stated goal? section, status table, collapsible evidence in details blocks, and issues found.}\n\nDo not make any other changes to the PR description — only append the QA Agent section at the end. Do not post any comments or reviews.",
+    "filter": "!pull_request.draft && !icontains(pull_request.body, 'QA Agent') && glob(repository.full_name, '{{form.repository}}')",
+    "message": "This deployment cannot run the webhook-driven QA automation directly. Set it up in this conversation instead: confirm the repository to QA, the base branch, and the PR event to trigger on, then create the automation."
+  }
+}

package/automations/catalog/slack-github-linear-daily-organization.json

@@ -0,0 +1,27 @@
+{
+  "id": "slack-github-linear-daily-organization",
+  "name": "Slack + GitHub + Linear daily organization",
+  "category": "Personal productivity",
+  "description": "Every morning, reconcile your open GitHub PRs with Linear issues, align active work, surface relevant Slack context, and send yourself a concise daily plan.",
+  "exampleImplementation": "Trigger: cron, every morning at 7:00 AM in the configured timezone\nRequired integrations: GitHub, Linear, Slack\n\n1. Verify access to all three services before making changes.\n2. Reconcile open GitHub PRs with issues and import missing issues into Linear.\n3. Align active Linear work with open PRs and recent Slack context.\n4. Send a concise, prioritized daily plan to the configured Slack recipient.",
+  "requiredIntegrationIds": [
+    "slack",
+    "github",
+    "linear"
+  ],
+  "popularityRank": 88,
+  "estimatedSetupMinutes": 10,
+  "suggestedTrigger": {
+    "type": "cron",
+    "schedule": "0 7 * * *",
+    "timezone": "[IANA_TIMEZONE]"
+  },
+  "placeholders": [
+    "[GITHUB_USERNAME]",
+    "[LINEAR_ASSIGNEE_QUERY]",
+    "[GITHUB_ORG_OR_REPO_SCOPE]",
+    "[SLACK_RECIPIENT_QUERY]",
+    "[IANA_TIMEZONE]"
+  ],
+  "prompt": "You are running a daily GitHub/Linear/Slack organization automation.\n\nSchedule context:\n- This automation runs every morning at 7:00 AM in [IANA_TIMEZONE].\n- Treat \"today\" and \"past 1-3 days\" in [IANA_TIMEZONE].\n\nImportant safety and access rules:\n1. First, verify that you have working access to GitHub, Linear, and Slack using the available official tools/APIs. A minimal successful read for each service is enough.\n2. If any one of GitHub, Linear, or Slack is unavailable, missing credentials, or returns an authorization error, stop immediately. Do not make partial updates. If Slack is available, send the configured Slack recipient a short message saying which service was unavailable and that no changes were made; otherwise finish with that error.\n3. Prefer official APIs/MCP tools over browser interaction. Do not browse web UIs unless no API/tool path exists.\n4. When posting to Slack or creating/updating human-readable external-service content, include a short disclosure that the content was generated by an AI agent (OpenHands) on behalf of the user.\n\nIdentity and scope:\n- GitHub user to inspect: [GITHUB_USERNAME].\n- GitHub issue scope: [GITHUB_ORG_OR_REPO_SCOPE]. Examples: visible repositories in one or more organizations, or an explicit allowlist of repositories.\n- Linear assignee: resolve by searching for [LINEAR_ASSIGNEE_QUERY]. Do not guess an ID if multiple plausible matches exist.\n- Slack recipient for the final daily plan: resolve by searching for [SLACK_RECIPIENT_QUERY], or use the current authenticated Slack user if that is the intended recipient.\n\nTask 1 — Ensure the user's open PRs are associated with GitHub issues:\n1. Find all open pull requests authored by [GITHUB_USERNAME] across the configured GitHub scope.\n2. For each PR, determine whether it is already associated with a GitHub issue. Count an association if the PR body has a clear issue reference or closing keyword (for example, #123, owner/repo#123, fixes, closes, or resolves), or if GitHub's API exposes linked/closing issues.\n3. If a PR has no associated issue:\n   a. Search open issues in the same repository for an obvious matching issue using the PR title, branch name, and summary. Only treat an issue as obvious if the title/topic clearly matches; do not force weak matches.\n   b. If an obvious open issue exists, use that issue.\n   c. If none exists, create a new GitHub issue in the same repository summarizing the PR's purpose and linking back to the PR. Include an AI disclosure in the issue body.\n   d. Update the PR description to include a non-closing association such as \"Related issue: #123\" or \"Related issue: owner/repo#123\" for cross-repo references. Preserve the existing PR description. Avoid \"Fixes\", \"Closes\", or \"Resolves\" unless the PR already used a closing keyword or the issue clearly should close when the PR merges.\n\nTask 2 — Ensure GitHub issues are represented in Linear:\n1. Find all open GitHub issues, excluding PRs, in the configured GitHub issue scope.\n2. For each issue, verify that it has a corresponding Linear issue. Match by GitHub issue URL first, then by exact repository/name/number and title if needed.\n3. If no Linear issue exists, create one in the appropriate Linear team/project using the GitHub issue title, URL, repository, labels, and a concise summary. Include an AI disclosure in the Linear issue description. Choose an appropriate priority for newly created Linear issues using this rubric:\n   - Urgent: security, production outage, data loss, severe user-blocking regression, active incident.\n   - High: important bug/regression, release blocker, broadly affecting users, high-value requested work.\n   - Medium: normal feature/bug/task with moderate impact.\n   - Low: cleanup, docs, nice-to-have, unclear/low-impact backlog.\n   - No priority only if there is insufficient information.\n4. For every GitHub issue that has one or more open PRs associated with it, ensure the corresponding Linear issue is assigned to the configured Linear assignee and has a started/In Progress status. If the Linear issue is already completed or canceled, do not reopen it; mention this in the final report instead.\n5. Do not downgrade or otherwise change priorities of existing Linear issues merely because they seem wrong. If an existing priority is missing and the issue is actively in progress due to an open PR, you may set a reasonable priority. If a priority seems unclear or incorrect, flag it in the final Slack report rather than changing it.\n\nTask 3 — Check Slack context for active Linear issues:\n1. Inspect active Linear issues assigned to the configured assignee and not completed/canceled, especially urgent, high-priority, and in-progress issues.\n2. Search Slack public content and, if available in the tool configuration, private/DM-accessible content for the last 1-3 days for requests, mentions, or discussions related to those Linear issue identifiers, issue titles, linked GitHub issues/PRs, and relevant repository names.\n3. Summarize actionable Slack requests/discussions. Include links to Slack messages/threads when the Slack tooling provides them.\n4. Do not expose private Slack content beyond what is necessary for the configured recipient's own daily plan.\n\nTask 4 — Produce and send the daily plan:\n1. Review all active Linear issues assigned to the configured assignee, prioritizing Urgent then High then Medium then Low, while also considering Slack requests, open PR status, blockers, and issue age.\n2. Create a concise plan for what the recipient should work on today, focusing on the most urgent and important issues first.\n3. Include:\n   - Top 3-5 recommended focus items with Linear identifiers/titles and links.\n   - Any GitHub PR issue-association work performed.\n   - Any GitHub issues imported into Linear.\n   - Any Linear issues moved to In Progress or assigned to the configured assignee because an open PR exists.\n   - Any Slack requests/discussions from the past 1-3 days relevant to active Linear issues.\n   - Any issue priorities that are unclear or appear incorrect; explicitly say you did not change those priorities.\n   - Any access or matching limitations.\n4. Send the report to the configured Slack recipient as a DM if possible. If DM is not possible, use the best available Slack destination for that recipient. Include the AI disclosure in the message.\n5. Finish with a short execution summary including counts of PRs checked, PRs updated, GitHub issues created, GitHub issues imported to Linear, Linear issues updated, and Slack discussions found.\n\nBe careful and conservative: avoid duplicate GitHub issues, duplicate Linear issues, weak associations, or broad destructive changes."
+}

package/automations/catalog-index.js

@@ -8,12 +8,18 @@ import entry2 from "./catalog/github-issue-to-pr/manifest.json" with { type: "js
 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/jira-issue-to-pr/manifest.json" with { type: "json" };
-import entry7 from "./catalog/research-brief-writer/manifest.json" with { type: "json" };
-import entry8 from "./catalog/github-agents-md-maintainer/manifest.json" with { type: "json" };
-import entry9 from "./catalog/upstream-fork-sync/manifest.json" with { type: "json" };
-import entry10 from "./catalog/incident-retrospective-drafter/manifest.json" with { type: "json" };
-import entry11 from "./catalog/news-digest/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" };
 
 export const AUTOMATION_CATALOG_ENTRIES = [
   entry0,
@@ -28,4 +34,10 @@ export const AUTOMATION_CATALOG_ENTRIES = [
   entry9,
   entry10,
   entry11,
+  entry12,
+  entry13,
+  entry14,
+  entry15,
+  entry16,
+  entry17,
 ];

package/automations/catalog.schema.json

@@ -46,9 +46,34 @@
       "type": "string",
       "minLength": 1
     },
+    "impact": {
+      "description": "The value statement the host renders from an installed automation's run history. Declare it only when its basis honestly backs the phrase: for completed-runs, one completed run must always perform exactly one of the stated units of work, manually dispatched runs included, so a poller that can complete having produced nothing must phrase the run itself, never the downstream outcome.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["basis", "one", "other"],
+      "properties": {
+        "basis": {
+          "description": "What the statement counts. The only basis today is the automation's lifetime COMPLETED-run count; a host that meets a basis it does not know renders nothing.",
+          "const": "completed-runs"
+        },
+        "one": { "$ref": "#/$defs/impactCopy" },
+        "other": {
+          "$comment": "The plural phrase must show the number; the singular may spell it out instead.",
+          "allOf": [{ "$ref": "#/$defs/impactCopy" }],
+          "pattern": "\\{\\{count\\}\\}"
+        }
+      }
+    },
     "setup": { "$ref": "#/$defs/setup" }
   },
   "$defs": {
+    "impactCopy": {
+      "description": "One value-statement phrase. Markup-free, and the only placeholder it may open is {{count}}, which the host substitutes with the formatted run count.",
+      "allOf": [
+        { "$ref": "#/$defs/copy" },
+        { "not": { "pattern": "\\{\\{(?!count\\}\\})" } }
+      ]
+    },
     "setup": {
       "description": "The extension-owned configuration experience for this automation: what the deployment must support, what must be connected first, what the user is asked, how a draft is validated, what request is sent, and which analytics stages are emitted. It never describes what the automation does at runtime - that is the preset, owned by OpenHands/automation. It is data, not code - there is no key that accepts JavaScript, no markup in copy, no free-form URL, and no secret value.",
       "type": "object",

package/automations/index.d.ts

@@ -30,10 +30,26 @@ export interface RecommendedAutomation {
    */
   skill?: string;
   exampleImplementation: string;
+  /**
+   * The value statement the host renders from an installed automation's run
+   * history. Declared only when its basis honestly backs the phrase: for
+   * `completed-runs`, one completed run must always perform exactly one of
+   * the stated units of work, manually dispatched runs included, so a poller
+   * that can complete having produced nothing phrases the run itself, never
+   * the downstream outcome. `{{count}}` is the host-substituted run count; a
+   * host that meets a basis it does not know renders nothing.
+   */
+  impact?: AutomationImpact;
   /** Present when this automation ships an extension-owned setup experience. */
   setup?: AutomationSetup;
 }
 
+export interface AutomationImpact {
+  basis: "completed-runs";
+  one: string;
+  other: string;
+}
+
 /**
  * The extension-owned configuration experience for one automation.
  *

package/integrations/catalog/datadog.json

@@ -43,7 +43,7 @@
         "urlEditable": true,
         "headerFields": [
           {
-            "key": "DD_API_KEY",
+            "key": "DD-API-KEY",
             "label": "Datadog API key",
             "type": "password",
             "required": true,
@@ -51,7 +51,7 @@
             "helperText": "Created in Datadog under Organization Settings → API Keys. Used to authenticate to the Datadog MCP server. See the [setup docs](https://docs.datadoghq.com/mcp_server/setup/?tab=other#authentication)."
           },
           {
-            "key": "DD_APPLICATION_KEY",
+            "key": "DD-APPLICATION-KEY",
             "label": "Datadog Application key",
             "type": "password",
             "required": true,

package/integrations/catalog/gitlab.json

@@ -0,0 +1,41 @@
+{
+  "id": "gitlab",
+  "name": "GitLab",
+  "description": "Repositories, issues, merge requests, and CI/CD workflows through the GitLab API.",
+  "categories": [
+    "Engineering",
+    "Source control"
+  ],
+  "appUrl": "https://gitlab.com",
+  "docsUrl": "https://docs.gitlab.com/api/",
+  "notes": "Supports GitLab.com projects through a personal access token.",
+  "popularityRank": 60,
+  "connectionOptions": [
+    {
+      "id": "api",
+      "provider": "http",
+      "auth": {
+        "strategy": "api_key",
+        "apiKeyHeaderName": "PRIVATE-TOKEN",
+        "credentialLabel": "Personal access token",
+        "credentialPlaceholder": "glpat-...",
+        "credentialHelp": "Create a token in [GitLab access token settings](https://gitlab.com/-/user_settings/personal_access_tokens) with the api scope.",
+        "credentialSecretName": "GITLAB_TOKEN",
+        "saveCredentialAsSecretByDefault": true
+      },
+      "http": {
+        "apiBaseUrl": "https://gitlab.com/api/v4",
+        "openApiUrl": "https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/openapi/openapi_v2.yaml"
+      }
+    }
+  ],
+  "iconBg": "var(--oh-surface)",
+  "logoUrl": "https://cdn.simpleicons.org/gitlab/FC6D26",
+  "keywords": [
+    "git",
+    "merge request",
+    "repo",
+    "issues",
+    "code"
+  ]
+}

package/integrations/catalog/notion.json

@@ -52,7 +52,7 @@
         ],
         "envFields": [
           {
-            "key": "NOTION_API_KEY",
+            "key": "NOTION_TOKEN",
             "label": "Internal integration token",
             "type": "password",
             "placeholder": "ntn_...",

package/integrations/catalog-index.js

@@ -9,75 +9,76 @@ import entry3 from "./catalog/atlassian.json" with { type: "json" };
 import entry4 from "./catalog/linear.json" with { type: "json" };
 import entry5 from "./catalog/notion.json" with { type: "json" };
 import entry6 from "./catalog/vanta.json" with { type: "json" };
-import entry7 from "./catalog/ordinal.json" with { type: "json" };
-import entry8 from "./catalog/elevenlabs.json" with { type: "json" };
-import entry9 from "./catalog/bitbucket.json" with { type: "json" };
-import entry10 from "./catalog/xero.json" with { type: "json" };
-import entry11 from "./catalog/quickbooks.json" with { type: "json" };
-import entry12 from "./catalog/sonarqube.json" with { type: "json" };
-import entry13 from "./catalog/okta.json" with { type: "json" };
-import entry14 from "./catalog/netlify.json" with { type: "json" };
-import entry15 from "./catalog/vercel.json" with { type: "json" };
-import entry16 from "./catalog/supabase.json" with { type: "json" };
-import entry17 from "./catalog/posthog.json" with { type: "json" };
-import entry18 from "./catalog/sentry.json" with { type: "json" };
-import entry19 from "./catalog/datadog.json" with { type: "json" };
-import entry20 from "./catalog/canva.json" with { type: "json" };
-import entry21 from "./catalog/miro.json" with { type: "json" };
-import entry22 from "./catalog/webflow.json" with { type: "json" };
-import entry23 from "./catalog/zoom.json" with { type: "json" };
-import entry24 from "./catalog/discord.json" with { type: "json" };
-import entry25 from "./catalog/stripe.json" with { type: "json" };
-import entry26 from "./catalog/intercom.json" with { type: "json" };
-import entry27 from "./catalog/hubspot.json" with { type: "json" };
-import entry28 from "./catalog/salesforce.json" with { type: "json" };
-import entry29 from "./catalog/sharepoint.json" with { type: "json" };
-import entry30 from "./catalog/onedrive.json" with { type: "json" };
-import entry31 from "./catalog/microsoft-teams.json" with { type: "json" };
-import entry32 from "./catalog/microsoft-outlook.json" with { type: "json" };
-import entry33 from "./catalog/box.json" with { type: "json" };
-import entry34 from "./catalog/airtable.json" with { type: "json" };
-import entry35 from "./catalog/monday.json" with { type: "json" };
-import entry36 from "./catalog/trello.json" with { type: "json" };
-import entry37 from "./catalog/asana.json" with { type: "json" };
-import entry38 from "./catalog/confluence.json" with { type: "json" };
-import entry39 from "./catalog/jira.json" with { type: "json" };
-import entry40 from "./catalog/google-calendar.json" with { type: "json" };
-import entry41 from "./catalog/gmail.json" with { type: "json" };
-import entry42 from "./catalog/google-sheets.json" with { type: "json" };
-import entry43 from "./catalog/google-drive.json" with { type: "json" };
-import entry44 from "./catalog/figma.json" with { type: "json" };
-import entry45 from "./catalog/google-docs.json" with { type: "json" };
-import entry46 from "./catalog/apify.json" with { type: "json" };
-import entry47 from "./catalog/atlassian-rovo.json" with { type: "json" };
-import entry48 from "./catalog/brave-search.json" with { type: "json" };
-import entry49 from "./catalog/browser-mcp.json" with { type: "json" };
-import entry50 from "./catalog/clickhouse.json" with { type: "json" };
-import entry51 from "./catalog/cloudflare-bindings.json" with { type: "json" };
-import entry52 from "./catalog/cloudflare-browser-rendering.json" with { type: "json" };
-import entry53 from "./catalog/cloudflare-builds.json" with { type: "json" };
-import entry54 from "./catalog/cloudflare-docs.json" with { type: "json" };
-import entry55 from "./catalog/cloudflare-observability.json" with { type: "json" };
-import entry56 from "./catalog/deepwiki.json" with { type: "json" };
-import entry57 from "./catalog/everything.json" with { type: "json" };
-import entry58 from "./catalog/exa.json" with { type: "json" };
-import entry59 from "./catalog/fetch.json" with { type: "json" };
-import entry60 from "./catalog/filesystem.json" with { type: "json" };
-import entry61 from "./catalog/firecrawl.json" with { type: "json" };
-import entry62 from "./catalog/git.json" with { type: "json" };
-import entry63 from "./catalog/huggingface.json" with { type: "json" };
-import entry64 from "./catalog/kagi.json" with { type: "json" };
-import entry65 from "./catalog/memory.json" with { type: "json" };
-import entry66 from "./catalog/mongodb.json" with { type: "json" };
-import entry67 from "./catalog/neon.json" with { type: "json" };
-import entry68 from "./catalog/obsidian.json" with { type: "json" };
-import entry69 from "./catalog/paypal.json" with { type: "json" };
-import entry70 from "./catalog/playwright.json" with { type: "json" };
-import entry71 from "./catalog/redis.json" with { type: "json" };
-import entry72 from "./catalog/resend.json" with { type: "json" };
-import entry73 from "./catalog/sequential-thinking.json" with { type: "json" };
-import entry74 from "./catalog/superhuman-mail.json" with { type: "json" };
-import entry75 from "./catalog/time.json" with { type: "json" };
+import entry7 from "./catalog/gitlab.json" with { type: "json" };
+import entry8 from "./catalog/ordinal.json" with { type: "json" };
+import entry9 from "./catalog/elevenlabs.json" with { type: "json" };
+import entry10 from "./catalog/bitbucket.json" with { type: "json" };
+import entry11 from "./catalog/xero.json" with { type: "json" };
+import entry12 from "./catalog/quickbooks.json" with { type: "json" };
+import entry13 from "./catalog/sonarqube.json" with { type: "json" };
+import entry14 from "./catalog/okta.json" with { type: "json" };
+import entry15 from "./catalog/netlify.json" with { type: "json" };
+import entry16 from "./catalog/vercel.json" with { type: "json" };
+import entry17 from "./catalog/supabase.json" with { type: "json" };
+import entry18 from "./catalog/posthog.json" with { type: "json" };
+import entry19 from "./catalog/sentry.json" with { type: "json" };
+import entry20 from "./catalog/datadog.json" with { type: "json" };
+import entry21 from "./catalog/canva.json" with { type: "json" };
+import entry22 from "./catalog/miro.json" with { type: "json" };
+import entry23 from "./catalog/webflow.json" with { type: "json" };
+import entry24 from "./catalog/zoom.json" with { type: "json" };
+import entry25 from "./catalog/discord.json" with { type: "json" };
+import entry26 from "./catalog/stripe.json" with { type: "json" };
+import entry27 from "./catalog/intercom.json" with { type: "json" };
+import entry28 from "./catalog/hubspot.json" with { type: "json" };
+import entry29 from "./catalog/salesforce.json" with { type: "json" };
+import entry30 from "./catalog/sharepoint.json" with { type: "json" };
+import entry31 from "./catalog/onedrive.json" with { type: "json" };
+import entry32 from "./catalog/microsoft-teams.json" with { type: "json" };
+import entry33 from "./catalog/microsoft-outlook.json" with { type: "json" };
+import entry34 from "./catalog/box.json" with { type: "json" };
+import entry35 from "./catalog/airtable.json" with { type: "json" };
+import entry36 from "./catalog/monday.json" with { type: "json" };
+import entry37 from "./catalog/trello.json" with { type: "json" };
+import entry38 from "./catalog/asana.json" with { type: "json" };
+import entry39 from "./catalog/confluence.json" with { type: "json" };
+import entry40 from "./catalog/jira.json" with { type: "json" };
+import entry41 from "./catalog/google-calendar.json" with { type: "json" };
+import entry42 from "./catalog/gmail.json" with { type: "json" };
+import entry43 from "./catalog/google-sheets.json" with { type: "json" };
+import entry44 from "./catalog/google-drive.json" with { type: "json" };
+import entry45 from "./catalog/figma.json" with { type: "json" };
+import entry46 from "./catalog/google-docs.json" with { type: "json" };
+import entry47 from "./catalog/apify.json" with { type: "json" };
+import entry48 from "./catalog/atlassian-rovo.json" with { type: "json" };
+import entry49 from "./catalog/brave-search.json" with { type: "json" };
+import entry50 from "./catalog/browser-mcp.json" with { type: "json" };
+import entry51 from "./catalog/clickhouse.json" with { type: "json" };
+import entry52 from "./catalog/cloudflare-bindings.json" with { type: "json" };
+import entry53 from "./catalog/cloudflare-browser-rendering.json" with { type: "json" };
+import entry54 from "./catalog/cloudflare-builds.json" with { type: "json" };
+import entry55 from "./catalog/cloudflare-docs.json" with { type: "json" };
+import entry56 from "./catalog/cloudflare-observability.json" with { type: "json" };
+import entry57 from "./catalog/deepwiki.json" with { type: "json" };
+import entry58 from "./catalog/everything.json" with { type: "json" };
+import entry59 from "./catalog/exa.json" with { type: "json" };
+import entry60 from "./catalog/fetch.json" with { type: "json" };
+import entry61 from "./catalog/filesystem.json" with { type: "json" };
+import entry62 from "./catalog/firecrawl.json" with { type: "json" };
+import entry63 from "./catalog/git.json" with { type: "json" };
+import entry64 from "./catalog/huggingface.json" with { type: "json" };
+import entry65 from "./catalog/kagi.json" with { type: "json" };
+import entry66 from "./catalog/memory.json" with { type: "json" };
+import entry67 from "./catalog/mongodb.json" with { type: "json" };
+import entry68 from "./catalog/neon.json" with { type: "json" };
+import entry69 from "./catalog/obsidian.json" with { type: "json" };
+import entry70 from "./catalog/paypal.json" with { type: "json" };
+import entry71 from "./catalog/playwright.json" with { type: "json" };
+import entry72 from "./catalog/redis.json" with { type: "json" };
+import entry73 from "./catalog/resend.json" with { type: "json" };
+import entry74 from "./catalog/sequential-thinking.json" with { type: "json" };
+import entry75 from "./catalog/superhuman-mail.json" with { type: "json" };
+import entry76 from "./catalog/time.json" with { type: "json" };
 
 export const INTEGRATION_CATALOG_ENTRIES = [
   entry0,
@@ -156,4 +157,5 @@ export const INTEGRATION_CATALOG_ENTRIES = [
   entry73,
   entry74,
   entry75,
+  entry76,
 ];

package/integrations/index.d.ts

@@ -17,7 +17,7 @@ export type IntegrationTransport =
       apiKeyOptional?: boolean;
       /**
        * Named request headers the user must supply (e.g. Datadog's
-       * `DD_API_KEY` / `DD_APPLICATION_KEY`). Values are sent verbatim as
+       * `DD-API-KEY` / `DD-APPLICATION-KEY`). Values are sent verbatim as
        * headers on every MCP request. The direct analog of stdio's
        * `envFields`: each entry renders one input in the install modal,
        * `type: "password"` entries are secret-saved by default, and

package/marketplaces/openhands-extensions.json

@@ -5,7 +5,7 @@
     "email": "contact@all-hands.dev"
   },
   "metadata": {
-    "description": "Official skills and plugins for OpenHands \u2014 the open-source AI software engineer.",
+    "description": "Official skills and plugins for OpenHands — the open-source AI software engineer.",
     "maintainer": "OpenHands",
     "homepage": "https://github.com/OpenHands/extensions"
   },
@@ -13,7 +13,7 @@
     {
       "name": "agent-creator",
       "source": "./skills/agent-creator",
-      "description": "Create file-based sub-agents as Markdown files \u2014 no Python code required. Guides the user through a structured interview and generates a ready-to-deploy .md agent file following the OpenHands SDK specification.",
+      "description": "Create file-based sub-agents as Markdown files — no Python code required. Guides the user through a structured interview and generates a ready-to-deploy .md agent file following the OpenHands SDK specification.",
       "category": "agent-authoring",
       "keywords": [
         "agent",
@@ -438,7 +438,7 @@
     {
       "name": "openhands",
       "source": "./plugins/openhands",
-      "description": "Unified OpenHands plugin \u2014 bundles Cloud CLI, REST API (openhands-api), and Automations (openhands-automation) into a single plugin.",
+      "description": "Unified OpenHands plugin — bundles Cloud CLI, REST API (openhands-api), and Automations (openhands-automation) into a single plugin.",
       "category": "openhands",
       "keywords": [
         "openhands",
@@ -480,7 +480,7 @@
     {
       "name": "pr-review",
       "source": "./plugins/pr-review",
-      "description": "Automated PR code review \u2014 analyzes diffs and posts inline review comments via the GitHub API.",
+      "description": "Automated PR code review — analyzes diffs and posts inline review comments via the GitHub API.",
       "category": "code-quality",
       "keywords": [
         "pr-review",
@@ -492,7 +492,7 @@
     {
       "name": "qa-changes",
       "source": "./plugins/qa-changes",
-      "description": "Validate pull request changes by actually running the code \u2014 setting up the environment, exercising changed behavior, and posting a structured QA report.",
+      "description": "Validate pull request changes by actually running the code — setting up the environment, exercising changed behavior, and posting a structured QA report.",
       "category": "quality-assurance",
       "keywords": [
         "qa",
@@ -656,7 +656,7 @@
     {
       "name": "iterate",
       "source": "./skills/iterate",
-      "description": "Iterate on a GitHub pull request \u2014 drive it through CI, code review, and QA until merge-ready. Monitors state, fixes failures, addresses review feedback, retries flaky checks, and pushes fixes in one continuous loop.",
+      "description": "Iterate on a GitHub pull request — drive it through CI, code review, and QA until merge-ready. Monitors state, fixes failures, addresses review feedback, retries flaky checks, and pushes fixes in one continuous loop.",
       "category": "code-quality",
       "keywords": [
         "github",
@@ -819,6 +819,21 @@
         "atom",
         "digest"
       ]
+    },
+    {
+      "name": "ticket-to-code-change",
+      "source": "./skills/ticket-to-code-change",
+      "description": "Set up Jira or Linear ticket-to-code-change automations for GitHub, GitLab, and Bitbucket.",
+      "category": "automations",
+      "keywords": [
+        "jira",
+        "linear",
+        "github",
+        "gitlab",
+        "bitbucket",
+        "pull-request",
+        "automation"
+      ]
     }
   ]
 }

package/package.json

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

package/plugins/pr-review/scripts/prompt.py

@@ -78,6 +78,8 @@ When posting a review, keep the review body brief unless your active review inst
 
 For dependency update PRs, do **NOT** approve a target version that was published less than 7 days ago. First-party packages maintained by the same organization as the reviewed repository are intentionally excluded from this 7-day waiting rule, but still scrutinize them for supply-chain risk.
 
+Before reviewing, you MUST read the repository's own guidance to understand the repo first: read `AGENTS.md` at the repository root (and any nested `AGENTS.md` covering the changed files), plus other relevant docs when present — e.g. `CONTRIBUTING.md`, `CLAUDE.md`, `.cursorrules`, and any review or coding-guideline docs. Apply that guidance to your review.
+
 Review the PR changes below and identify issues that need to be addressed.
 
 ## Pull Request Information

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openhands-extensions"
-version = "0.18.0"
+version = "0.19.0"
 description = "OpenHands extensions, plugins, and skills (Python bindings for the integration catalog)"
 requires-python = ">=3.12"
 dependencies = [

package/python/openhands_extensions/_version.py

@@ -18,7 +18,7 @@ from importlib.metadata import PackageNotFoundError, version
 #: Kept in lock-step with pyproject.toml/package.json by the version test.
 #: release-please only rewrites a semver found on the annotated line itself, so
 #: the annotation must stay on the assignment; on its own line it is a no-op.
-_FALLBACK_VERSION = "0.18.0"  # x-release-please-version
+_FALLBACK_VERSION = "0.19.0"  # x-release-please-version
 
 try:
     __version__: str = version("openhands-extensions")

package/skills/github-pr-reviewer/SKILL.md

@@ -139,7 +139,7 @@ Record as `CRON_SCHEDULE`.
 
 ### Step 6 - Generate the automation script
 
-Read `scripts/main.py` from this skill's directory. Apply exactly five constant
+Read `scripts/main.py` from this skill's directory. Apply exactly six constant
 substitutions near the top of the file:
 
 > The script also reads a `config.json` shipped beside it, if there is one, over
@@ -154,6 +154,7 @@ substitutions near the top of the file:
 | `TRIGGER_LABEL = "openhands-review"` | `TRIGGER_LABEL = "{trigger_label}"` |
 | `REVIEW_TONE = "thorough"` | `REVIEW_TONE = "{review_tone}"` |
 | `REVIEW_STYLE_INSTRUCTIONS = ""` | `REVIEW_STYLE_INSTRUCTIONS = "{style_instructions}"` |
+| `REPO_REVIEW_GUIDE_PATH = ".agents/skills/custom-codereview-guide.md"` | leave unchanged to auto-load a repo review guide at this path, or set to `""` to disable |
 | `DEFAULT_OPENHANDS_URL = "http://localhost:8000"` | leave unchanged unless the user has a preference |
 
 Use a safe string writer such as `json.dumps(value)` when inserting user-provided