@openhands/extensions 0.10.0 → 0.12.0

package/automations/index.js

@@ -1,20 +1,23 @@
-import github_pr_reviewer from "./catalog/github-pr-reviewer.json" with { type: "json" };
-import github_repo_monitor from "./catalog/github-repo-monitor.json" with { type: "json" };
-import slack_standup_digest from "./catalog/slack-standup-digest.json" with { type: "json" };
-import slack_channel_monitor from "./catalog/slack-channel-monitor.json" with { type: "json" };
-import linear_triage_assistant from "./catalog/linear-triage-assistant.json" with { type: "json" };
-import research_brief_writer from "./catalog/research-brief-writer.json" with { type: "json" };
-import incident_retrospective_drafter from "./catalog/incident-retrospective-drafter.json" with { type: "json" };
-import jira_issue_to_pr from "./catalog/jira-issue-to-pr.json" with { type: "json" };
+/**
+ * Runtime automation catalog.
+ *
+ * The source of truth is the hand-authored `automations/catalog/<id>/manifest.json`
+ * directory. `catalog-index.js` is generated from that directory so the JS
+ * package can statically import each JSON file without an aggregate JSON asset.
+ */
+import { AUTOMATION_CATALOG_ENTRIES } from "./catalog-index.js";
+
+const clone = (value) => JSON.parse(JSON.stringify(value));
+const AUTOMATIONS = AUTOMATION_CATALOG_ENTRIES;
+const AUTOMATION_BY_ID = new Map(AUTOMATIONS.map((entry) => [entry.id, entry]));
+
+export const listAutomationCatalog = () => clone(AUTOMATIONS);
+
+export const getAutomationCatalogEntry = (id) => {
+  const entry = AUTOMATION_BY_ID.get(id);
+  return entry ? clone(entry) : undefined;
+};
+
+export const AUTOMATION_CATALOG = clone(AUTOMATIONS);
 
-export const AUTOMATION_CATALOG = [
-  github_pr_reviewer,
-  github_repo_monitor,
-  slack_standup_digest,
-  slack_channel_monitor,
-  linear_triage_assistant,
-  research_brief_writer,
-  incident_retrospective_drafter,
-  jira_issue_to_pr,
-];
 export default AUTOMATION_CATALOG;

package/index.d.ts

@@ -14,6 +14,21 @@ export {
   type OAuthProviderRegistrationDefaults,
 } from "./integrations/index.js";
 export { AUTOMATION_CATALOG } from "./automations/index.js";
-export type { RecommendedAutomation } from "./automations/index.js";
+export type {
+  AutomationFieldConstraints,
+  AutomationFieldOption,
+  AutomationFieldType,
+  AutomationForm,
+  AutomationFormField,
+  AutomationFormFields,
+  AutomationGitProvider,
+  AutomationIntegrationRequirement,
+  AutomationPrerequisites,
+  AutomationSetup,
+  AutomationSetupMode,
+  AutomationTriggerForm,
+  AutomationTriggerKind,
+  RecommendedAutomation,
+} from "./automations/index.js";
 export { SKILLS_CATALOG } from "./skills/index.js";
 export type { SkillCatalogEntry } from "./skills/index.js";

package/integrations/catalog/atlassian-rovo.json

@@ -0,0 +1,44 @@
+{
+  "id": "atlassian-rovo",
+  "name": "Atlassian Rovo",
+  "description": "Search, create, and update Jira issues, Confluence pages, Bitbucket repos, and Jira Service Management tickets - all through Atlassian's official hosted MCP server, powered by your Teamwork Graph.",
+  "categories": [
+    "Project management",
+    "Documentation",
+    "Engineering"
+  ],
+  "appUrl": "https://www.atlassian.com/rovo",
+  "docsUrl": "https://support.atlassian.com/atlassian-rovo-mcp-server/docs/getting-started-with-the-atlassian-remote-mcp-server/",
+  "notes": "OAuth 2.1 is handled entirely by the Atlassian Rovo MCP server. No client credentials required - sign in with your Atlassian account when the authentication flow starts.",
+  "iconBg": "#0052CC",
+  "logoUrl": "https://cdn.simpleicons.org/atlassian/FFFFFF",
+  "keywords": [
+    "atlassian",
+    "rovo",
+    "jira",
+    "confluence",
+    "bitbucket",
+    "jsm",
+    "tickets",
+    "wiki",
+    "issues",
+    "sprint",
+    "mcp"
+  ],
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.atlassian.com/v1/mcp/authv2"
+      },
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "clientAuthentication": "none"
+        }
+      }
+    }
+  ]
+}

package/integrations/catalog/datadog.json

@@ -7,7 +7,7 @@
     "Operations"
   ],
   "appUrl": "https://www.datadoghq.com",
-  "docsUrl": "https://docs.datadoghq.com/bits_ai/mcp_server/setup/",
+  "docsUrl": "https://docs.datadoghq.com/mcp_server/setup/",
   "notes": "Uses Datadog's official hosted MCP server. The MCP endpoint host is site-specific: use https://mcp.<site>.datadoghq.com/v1/mcp for your Datadog site (e.g. mcp.us5.datadoghq.com for US5). The default URL below targets US1 and can be edited in the install dialog.",
   "popularityRank": 35,
   "installHint": "The Datadog MCP URL is site-specific. Edit the URL to https://mcp.<site>.datadoghq.com/v1/mcp for your Datadog site (for example https://mcp.us5.datadoghq.com/v1/mcp for US5, https://mcp.eu.datadoghq.com/v1/mcp for EU). Find your site at Organization Settings → Site in Datadog.",
@@ -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/github.json

@@ -61,7 +61,7 @@
         "strategy": "api_key",
         "credentialLabel": "Personal access token",
         "credentialPlaceholder": "github_pat_...",
-        "credentialHelp": "Classic or fine-grained personal access token from GitHub settings.",
+        "credentialHelp": "Create a token in [GitHub settings](https://github.com/settings/personal-access-tokens): classic tokens need the repo and read:user scopes; fine-grained tokens need read access to Contents, Issues, and Pull requests for the repositories you use.",
         "credentialSecretName": "GITHUB_PERSONAL_ACCESS_TOKEN",
         "saveCredentialAsSecretByDefault": true
       }

package/integrations/catalog/linear.json

@@ -52,7 +52,7 @@
         "apiKeyOptional": true,
         "credentialLabel": "Linear API key",
         "credentialPlaceholder": "Paste your Linear API key",
-        "credentialHelp": "Optional when the endpoint accepts your OAuth session; otherwise sent as Authorization: Bearer <token>."
+        "credentialHelp": "Create a personal API key (grant at least read access) under Security & access in [Linear settings](https://linear.app/settings/account/security). Sent as Authorization: Bearer <token>; optional when the endpoint accepts your OAuth session."
       }
     }
   ],

package/integrations/catalog/slack.json

@@ -8,7 +8,7 @@
   ],
   "appUrl": "https://slack.com",
   "docsUrl": "https://github.com/zencoderai/slack-mcp-server",
-  "notes": "Uses Slack's official hosted MCP server with confidential OAuth user-token auth.",
+  "notes": "The OAuth option uses Slack's official hosted MCP server (confidential OAuth user-token auth); the local option runs the open-source zencoderai stdio server with a bot token.",
   "popularityRank": 95,
   "connectionOptions": [
     {
@@ -101,5 +101,5 @@
     "messaging",
     "team"
   ],
-  "installHint": "Create a Slack app with the required scopes, then paste its bot token below."
+  "installHint": "Create a Slack app with bot token scopes channels:history, channels:read, chat:write, reactions:write, users:read, and users.profile:read, then paste its bot token below."
 }

package/integrations/catalog-index.js

@@ -48,34 +48,35 @@ import entry42 from "./catalog/google-drive.json" with { type: "json" };
 import entry43 from "./catalog/figma.json" with { type: "json" };
 import entry44 from "./catalog/google-docs.json" with { type: "json" };
 import entry45 from "./catalog/apify.json" with { type: "json" };
-import entry46 from "./catalog/brave-search.json" with { type: "json" };
-import entry47 from "./catalog/browser-mcp.json" with { type: "json" };
-import entry48 from "./catalog/clickhouse.json" with { type: "json" };
-import entry49 from "./catalog/cloudflare-bindings.json" with { type: "json" };
-import entry50 from "./catalog/cloudflare-browser-rendering.json" with { type: "json" };
-import entry51 from "./catalog/cloudflare-builds.json" with { type: "json" };
-import entry52 from "./catalog/cloudflare-docs.json" with { type: "json" };
-import entry53 from "./catalog/cloudflare-observability.json" with { type: "json" };
-import entry54 from "./catalog/deepwiki.json" with { type: "json" };
-import entry55 from "./catalog/everything.json" with { type: "json" };
-import entry56 from "./catalog/exa.json" with { type: "json" };
-import entry57 from "./catalog/fetch.json" with { type: "json" };
-import entry58 from "./catalog/filesystem.json" with { type: "json" };
-import entry59 from "./catalog/firecrawl.json" with { type: "json" };
-import entry60 from "./catalog/git.json" with { type: "json" };
-import entry61 from "./catalog/huggingface.json" with { type: "json" };
-import entry62 from "./catalog/kagi.json" with { type: "json" };
-import entry63 from "./catalog/memory.json" with { type: "json" };
-import entry64 from "./catalog/mongodb.json" with { type: "json" };
-import entry65 from "./catalog/neon.json" with { type: "json" };
-import entry66 from "./catalog/obsidian.json" with { type: "json" };
-import entry67 from "./catalog/paypal.json" with { type: "json" };
-import entry68 from "./catalog/playwright.json" with { type: "json" };
-import entry69 from "./catalog/redis.json" with { type: "json" };
-import entry70 from "./catalog/resend.json" with { type: "json" };
-import entry71 from "./catalog/sequential-thinking.json" with { type: "json" };
-import entry72 from "./catalog/superhuman-mail.json" with { type: "json" };
-import entry73 from "./catalog/time.json" with { type: "json" };
+import entry46 from "./catalog/atlassian-rovo.json" with { type: "json" };
+import entry47 from "./catalog/brave-search.json" with { type: "json" };
+import entry48 from "./catalog/browser-mcp.json" with { type: "json" };
+import entry49 from "./catalog/clickhouse.json" with { type: "json" };
+import entry50 from "./catalog/cloudflare-bindings.json" with { type: "json" };
+import entry51 from "./catalog/cloudflare-browser-rendering.json" with { type: "json" };
+import entry52 from "./catalog/cloudflare-builds.json" with { type: "json" };
+import entry53 from "./catalog/cloudflare-docs.json" with { type: "json" };
+import entry54 from "./catalog/cloudflare-observability.json" with { type: "json" };
+import entry55 from "./catalog/deepwiki.json" with { type: "json" };
+import entry56 from "./catalog/everything.json" with { type: "json" };
+import entry57 from "./catalog/exa.json" with { type: "json" };
+import entry58 from "./catalog/fetch.json" with { type: "json" };
+import entry59 from "./catalog/filesystem.json" with { type: "json" };
+import entry60 from "./catalog/firecrawl.json" with { type: "json" };
+import entry61 from "./catalog/git.json" with { type: "json" };
+import entry62 from "./catalog/huggingface.json" with { type: "json" };
+import entry63 from "./catalog/kagi.json" with { type: "json" };
+import entry64 from "./catalog/memory.json" with { type: "json" };
+import entry65 from "./catalog/mongodb.json" with { type: "json" };
+import entry66 from "./catalog/neon.json" with { type: "json" };
+import entry67 from "./catalog/obsidian.json" with { type: "json" };
+import entry68 from "./catalog/paypal.json" with { type: "json" };
+import entry69 from "./catalog/playwright.json" with { type: "json" };
+import entry70 from "./catalog/redis.json" with { type: "json" };
+import entry71 from "./catalog/resend.json" with { type: "json" };
+import entry72 from "./catalog/sequential-thinking.json" with { type: "json" };
+import entry73 from "./catalog/superhuman-mail.json" with { type: "json" };
+import entry74 from "./catalog/time.json" with { type: "json" };
 
 export const INTEGRATION_CATALOG_ENTRIES = [
   entry0,
@@ -152,4 +153,5 @@ export const INTEGRATION_CATALOG_ENTRIES = [
   entry71,
   entry72,
   entry73,
+  entry74,
 ];

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

@@ -729,6 +729,15 @@
         "automation"
       ]
     },
+    {
+      "name": "technical-writing",
+      "source": "./skills/technical-writing",
+      "description": "Write and revise technical explanations in flowing, direct, conversational prose that stays concise without becoming fragmented or vague.",
+      "category": "productivity",
+      "keywords": [
+        "technical-writing"
+      ]
+    },
     {
       "name": "plain-english-content",
       "source": "./skills/plain-english-content",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/extensions",
-  "version": "0.10.0",
+  "version": "0.12.0",
   "description": "Public OpenHands extension catalogs for skills, plugins, integrations, and automation templates.",
   "license": "MIT",
   "type": "module",
@@ -11,7 +11,8 @@
   "scripts": {
     "build:skills": "node scripts/build-skills-catalog.mjs",
     "build:integrations": "node scripts/build-integration-catalog.mjs",
-    "build": "npm run build:skills && npm run build:integrations"
+    "build:automations": "node scripts/build-automation-catalog.mjs",
+    "build": "npm run build:skills && npm run build:integrations && npm run build:automations"
   },
   "engines": {
     "node": ">=18.20.0"
@@ -35,7 +36,8 @@
       "import": "./automations/index.js",
       "default": "./automations/index.js"
     },
-    "./automations/catalog/*.json": "./automations/catalog/*.json",
+    "./automations/catalog/*": "./automations/catalog/*",
+    "./automations/catalog.schema.json": "./automations/catalog.schema.json",
     "./integrations": {
       "types": "./integrations/index.d.ts",
       "import": "./integrations/index.js",
@@ -50,6 +52,7 @@
     "./skills/*": "./skills/*",
     "./plugins/*": "./plugins/*",
     "./marketplaces/*.json": "./marketplaces/*.json",
+    "./testing/automations/*.json": "./tests/fixtures/automations/*.json",
     "./package.json": "./package.json"
   }
 }

package/pyproject.toml

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

package/python/openhands_extensions/__init__.py

@@ -12,9 +12,7 @@ from __future__ import annotations
 from ._version import __version__
 from .integrations import (
     INTEGRATION_CATALOG_SNAPSHOT,
-    get_integration_catalog_entry,
     get_integration_catalog_entry_model,
-    list_integration_catalog,
     list_integration_catalog_models,
 )
 from .integration_models import (
@@ -55,8 +53,6 @@ __all__ = [
     "StdioTransport",
     "StreamableHttpTransport",
     "__version__",
-    "get_integration_catalog_entry",
     "get_integration_catalog_entry_model",
-    "list_integration_catalog",
     "list_integration_catalog_models",
 ]

package/python/openhands_extensions/_version.py

@@ -16,8 +16,9 @@ from importlib.metadata import PackageNotFoundError, version
 
 #: Fallback used only when the package is not installed (no dist metadata).
 #: Kept in lock-step with pyproject.toml/package.json by the version test.
-# x-release-please-version
-_FALLBACK_VERSION = "0.10.0"
+#: 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.12.0"  # x-release-please-version
 
 try:
     __version__: str = version("openhands-extensions")

package/python/openhands_extensions/integrations.py

@@ -14,15 +14,12 @@ from importlib import resources
 from pathlib import Path
 from typing import Any, Iterable
 
-from .deprecation import deprecated
 from .integration_models import IntegrationCatalogEntry
 
 
 __all__ = [
     "INTEGRATION_CATALOG_SNAPSHOT",
-    "get_integration_catalog_entry",
     "get_integration_catalog_entry_model",
-    "list_integration_catalog",
     "list_integration_catalog_models",
 ]
 
@@ -81,20 +78,11 @@ def _entry_supports_oauth(entry: dict[str, Any]) -> bool:
     )
 
 
-@deprecated(
-    deprecated_in="0.10.0",
-    removed_in="0.12.0",
-    details="Use list_integration_catalog_models() for validated Pydantic models.",
-)
-def list_integration_catalog(
+def _list_catalog_entries(
     mcp: bool | None = None,
     oauth: bool | None = None,
 ) -> list[dict[str, Any]]:
-    """Return raw catalog dictionaries, optionally filtered by connector type.
-
-    Deprecated since v0.10.0 and scheduled for removal in v0.12.0.
-    Use :func:`list_integration_catalog_models` instead.
-    """
+    """Return raw catalog dictionaries, optionally filtered by connector type."""
     result = []
     for entry in _integrations():
         if mcp is not None and _entry_supports_mcp(entry) != mcp:
@@ -111,34 +99,24 @@ def list_integration_catalog_models(
 ) -> list[IntegrationCatalogEntry]:
     """Return typed, validated integration catalog entries.
 
-    ``list_integration_catalog`` remains available for callers that need the
-    original JSON-compatible dictionaries. New Python consumers should prefer
-    this function for a stable, validated contract.
+    This is the supported Python contract for reading the catalog. The raw
+    dictionary accessors it replaced were removed in v0.12.0.
     """
     return [
         IntegrationCatalogEntry.model_validate(entry)
-        for entry in list_integration_catalog(mcp=mcp, oauth=oauth)
+        for entry in _list_catalog_entries(mcp=mcp, oauth=oauth)
     ]
 
 
-@deprecated(
-    deprecated_in="0.10.0",
-    removed_in="0.12.0",
-    details="Use get_integration_catalog_entry_model() for a validated Pydantic model.",
-)
-def get_integration_catalog_entry(id: str) -> dict[str, Any] | None:
-    """Return one raw catalog dictionary by id, or ``None``.
-
-    Deprecated since v0.10.0 and scheduled for removal in v0.12.0.
-    Use :func:`get_integration_catalog_entry_model` instead.
-    """
+def _get_catalog_entry(id: str) -> dict[str, Any] | None:
+    """Return one raw catalog dictionary by id, or ``None``."""
     entry = _integration_by_id().get(id)
     return copy.deepcopy(entry) if entry is not None else None
 
 
 def get_integration_catalog_entry_model(id: str) -> IntegrationCatalogEntry | None:
     """Return one typed catalog entry, or ``None`` when it does not exist."""
-    entry = get_integration_catalog_entry(id)
+    entry = _get_catalog_entry(id)
     return IntegrationCatalogEntry.model_validate(entry) if entry is not None else None
 
 

package/scripts/build-automation-catalog.mjs

@@ -0,0 +1,51 @@
+import { readdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+
+const root = process.cwd();
+const catalogDir = path.join(root, "automations", "catalog");
+const outputPath = path.join(root, "automations", "catalog-index.js");
+
+const directories = (await readdir(catalogDir, { withFileTypes: true }))
+  .filter((entry) => entry.isDirectory())
+  .map((entry) => entry.name)
+  .sort((left, right) => left.localeCompare(right));
+
+const automations = await Promise.all(
+  directories.map(async (directory) => ({
+    directory,
+    entry: JSON.parse(
+      await readFile(path.join(catalogDir, directory, "manifest.json"), "utf8"),
+    ),
+  })),
+);
+
+automations.sort((left, right) => {
+  const rank = (right.entry.popularityRank ?? -1) - (left.entry.popularityRank ?? -1);
+  return rank || left.entry.id.localeCompare(right.entry.id);
+});
+
+const indexedAutomations = automations.map((automation, index) => ({
+  ...automation,
+  importName: `entry${index}`,
+}));
+
+const imports = indexedAutomations
+  .map(
+    ({ directory, importName }) =>
+      `import ${importName} from "./catalog/${directory}/manifest.json" with { type: "json" };`,
+  )
+  .join("\n");
+const entries = indexedAutomations.map(({ importName }) => `  ${importName},`).join("\n");
+
+const header = `// This file is auto-generated by scripts/build-automation-catalog.mjs.
+// Do not edit it manually. To update it after changing automations/catalog/*/manifest.json,
+// run: npm run build:automations
+
+`;
+const body = `${header}${imports}
+
+export const AUTOMATION_CATALOG_ENTRIES = [
+${entries}
+];
+`;
+await writeFile(outputPath, body);

package/skills/bitbucket/SKILL.md

@@ -3,7 +3,6 @@ name: bitbucket
 description: Bitbucket integration hub. Detects whether the repository is on Bitbucket Cloud or Bitbucket Data Center and directs you to the matching detailed skill (bitbucket-cloud or bitbucket-data-center). Use for any Bitbucket repository or pull request task.
 triggers:
 - bitbucket
-- git
 ---
 
 You are working with **Bitbucket**, which ships as two distinct products that behave

package/skills/github/SKILL.md

@@ -3,7 +3,6 @@ name: github
 description: Interact with GitHub repositories, pull requests, issues, and workflows using the GITHUB_TOKEN environment variable and GitHub CLI. Use when working with code hosted on GitHub or managing GitHub resources.
 triggers:
 - github
-- git
 ---
 
 You have access to an environment variable, `GITHUB_TOKEN`, which allows you to interact with

package/skills/gitlab/SKILL.md

@@ -3,7 +3,6 @@ name: gitlab
 description: Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when working with code hosted on GitLab or managing GitLab resources.
 triggers:
 - gitlab
-- git
 ---
 
 You have access to an environment variable, `GITLAB_TOKEN`, which allows you to interact with