@openhands/extensions 0.11.0 → 0.13.0

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/extensions",
-  "version": "0.11.0",
+  "version": "0.13.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,10 @@
       "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",
+    "./automations/interface.json": "./automations/interface.json",
+    "./automations/interface.schema.json": "./automations/interface.schema.json",
     "./integrations": {
       "types": "./integrations/index.d.ts",
       "import": "./integrations/index.js",
@@ -50,6 +54,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.11.0"
+version = "0.13.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.11.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.13.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