@openhands/extensions 0.19.0 → 0.20.0

package/automations/catalog.schema.json

@@ -108,6 +108,10 @@
         "message": {
           "description": "Setup context handed to the agent conversation that finishes setup. Required for assisted mode. Optional for direct mode, where it seeds the fallback conversation the host offers when the deployment cannot run the direct path. The command that opens it comes from the skill, so it is not repeated here. Capped so this never becomes a channel for runtime instructions.",
           "allOf": [{ "$ref": "#/$defs/templateCopy" }, { "maxLength": 2000 }]
+        },
+        "actions": {
+          "description": "direct only, and the alternative to prompt or bundle. User-selectable creation paths for one setup card; the key maps to a known automation service endpoint.",
+          "$ref": "#/$defs/actions"
         }
       },
       "allOf": [
@@ -118,8 +122,9 @@
           },
           "then": {
             "oneOf": [
-              { "required": ["prompt"], "not": { "required": ["bundle"] } },
-              { "required": ["bundle"], "not": { "required": ["prompt"] } }
+              { "required": ["prompt"], "not": { "anyOf": [{ "required": ["bundle"] }, { "required": ["actions"] }] } },
+              { "required": ["bundle"], "not": { "anyOf": [{ "required": ["prompt"] }, { "required": ["actions"] }] } },
+              { "required": ["actions"], "not": { "anyOf": [{ "required": ["prompt"] }, { "required": ["bundle"] }] } }
             ]
           }
         },
@@ -133,7 +138,8 @@
             "allOf": [
               { "not": { "required": ["prompt"] } },
               { "not": { "required": ["bundle"] } },
-              { "not": { "required": ["filter"] } }
+              { "not": { "required": ["filter"] } },
+              { "not": { "required": ["actions"] } }
             ]
           }
         },
@@ -157,6 +163,63 @@
         }
       ]
     },
+    "actionFeatures": {
+      "description": "Deployment capabilities needed only for this selectable action variant.",
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "promptAction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "help", "features", "args", "prompt"],
+      "properties": {
+        "label": { "$ref": "#/$defs/copy" },
+        "help": { "$ref": "#/$defs/copy" },
+        "features": { "$ref": "#/$defs/actionFeatures" },
+        "args": { "$ref": "#/$defs/formFields" },
+        "prompt": { "$ref": "#/$defs/templateValue" }
+      }
+    },
+    "pluginAction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "help", "features", "args", "prompt", "plugins"],
+      "properties": {
+        "label": { "$ref": "#/$defs/copy" },
+        "help": { "$ref": "#/$defs/copy" },
+        "features": { "$ref": "#/$defs/actionFeatures" },
+        "args": { "$ref": "#/$defs/formFields" },
+        "prompt": { "$ref": "#/$defs/templateValue" },
+        "plugins": { "$ref": "#/$defs/templateValue" }
+      }
+    },
+    "uploadAction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["label", "help", "features", "args", "tarballPath", "entrypoint"],
+      "properties": {
+        "label": { "$ref": "#/$defs/copy" },
+        "help": { "$ref": "#/$defs/copy" },
+        "features": { "$ref": "#/$defs/actionFeatures" },
+        "args": { "$ref": "#/$defs/formFields" },
+        "tarballPath": { "$ref": "#/$defs/templateValue" },
+        "entrypoint": { "$ref": "#/$defs/templateValue" },
+        "setupScript": { "$ref": "#/$defs/templateValue" }
+      }
+    },
+    "actions": {
+      "description": "Selectable direct-setup creation paths: prompt -> /v1/preset/prompt, plugin -> /v1/preset/plugin, upload -> /v1/uploads then /v1.",
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "prompt": { "$ref": "#/$defs/promptAction" },
+        "plugin": { "$ref": "#/$defs/pluginAction" },
+        "upload": { "$ref": "#/$defs/uploadAction" }
+      }
+    },
     "bundle": {
       "description": "What the host packs into a .tar.gz and uploads before creating the automation. It names files inside this repository and the command that runs them - never a host, a URL, or code to evaluate.",
       "type": "object",
@@ -303,7 +366,7 @@
       "properties": {
         "note": { "$ref": "#/$defs/copy" },
         "triggers": {
-          "description": "Inputs that decide when the automation runs, keyed by trigger kind. The key set is the trigger kinds the deployment must support, so it is not restated anywhere else.",
+          "description": "Inputs that decide when the automation runs, keyed by trigger kind. Multiple keys are selectable variants; a deployment can offer any variant whose trigger kind it supports.",
           "type": "object",
           "additionalProperties": false,
           "minProperties": 1,
@@ -331,20 +394,29 @@
       "required": ["type", "label", "help", "required"],
       "properties": {
         "type": {
-          "description": "Semantic field types. The host renders a cron field without knowing what cron means to an automation, and resolves the deployment's schedule limits and timezone list for the cron and timezone types, so an entry never restates them.",
+          "description": "Semantic field types. The host renders cron, timezone, llm-profile, event-source, and event-type fields from deployment capabilities or user settings rather than entry-owned option lists.",
           "enum": [
             "text",
             "textarea",
             "select",
+            "number",
             "cron",
             "timezone",
-            "repo-picker"
+            "repo-picker",
+            "llm-profile",
+            "event-source",
+            "event-type",
+            "plugin-sources",
+            "tarball-upload"
           ]
         },
         "label": { "$ref": "#/$defs/copy" },
         "help": { "$ref": "#/$defs/copy" },
         "placeholder": { "$ref": "#/$defs/copy" },
-        "default": { "type": "string" },
+        "default": {
+          "description": "Initial value for fields whose defaults are entry-owned. Semantic fields may ignore it.",
+          "type": ["string", "number", "boolean", "null"]
+        },
         "required": { "type": "boolean" },
         "provider": { "enum": ["github", "gitlab", "bitbucket"] },
         "multiple": {
@@ -371,6 +443,8 @@
           "properties": {
             "minLength": { "type": "integer", "minimum": 0 },
             "maxLength": { "type": "integer", "minimum": 1 },
+            "min": { "type": "integer", "minimum": 0 },
+            "max": { "type": "integer", "minimum": 1 },
             "format": {
               "description": "A host-implemented check, named from a closed set. Setup blocks cannot supply their own regex, so one cannot hand the host a pathological pattern. safeExpressionLiteral marks a value that is interpolated into a filter expression string literal, so quotes and backslashes must be rejected before they can break the expression.",
               "enum": ["safeExpressionLiteral"]

package/automations/index.d.ts

@@ -70,9 +70,15 @@ export type AutomationFieldType =
   | "text"
   | "textarea"
   | "select"
+  | "number"
   | "cron"
   | "timezone"
-  | "repo-picker";
+  | "repo-picker"
+  | "llm-profile"
+  | "event-source"
+  | "event-type"
+  | "plugin-sources"
+  | "tarball-upload";
 export type AutomationGitProvider = "github" | "gitlab" | "bitbucket";
 export type AutomationTriggerKind = "cron" | "event";
 
@@ -84,6 +90,8 @@ export interface AutomationFieldOption {
 export interface AutomationFieldConstraints {
   minLength?: number;
   maxLength?: number;
+  min?: number;
+  max?: number;
   /** Host-implemented check, named from a closed set. Entries supply no regex. */
   format?: "safeExpressionLiteral";
 }
@@ -93,7 +101,7 @@ export interface AutomationFormField {
   label: string;
   help: string;
   placeholder?: string;
-  default?: string;
+  default?: string | number | boolean | null;
   required: boolean;
   provider?: AutomationGitProvider;
   /**
@@ -160,6 +168,46 @@ export interface AutomationBundle {
   config: Record<string, AutomationBundleConfigValue>;
 }
 
+
+export interface AutomationPromptAction {
+  label: string;
+  help: string;
+  features: string[];
+  args: AutomationFormFields;
+  /** Prompt sent to /v1/preset/prompt. */
+  prompt: string;
+}
+
+export interface AutomationPluginAction {
+  label: string;
+  help: string;
+  features: string[];
+  args: AutomationFormFields;
+  /** Prompt sent to /v1/preset/plugin. */
+  prompt: string;
+  /** PluginSource list sent to /v1/preset/plugin, usually {{form.plugins}}. */
+  plugins: string;
+}
+
+export interface AutomationUploadAction {
+  label: string;
+  help: string;
+  features: string[];
+  args: AutomationFormFields;
+  /** tarball_path produced by uploading the selected tarball file. */
+  tarballPath: string;
+  /** Entrypoint command sent to /v1. */
+  entrypoint: string;
+  /** Optional setup_script_path sent to /v1. */
+  setupScript?: string;
+}
+
+export interface AutomationSetupActions {
+  prompt?: AutomationPromptAction;
+  plugin?: AutomationPluginAction;
+  upload?: AutomationUploadAction;
+}
+
 export interface AutomationSetup {
   version: "1.0";
   mode: AutomationSetupMode;
@@ -168,6 +216,8 @@ export interface AutomationSetup {
   prompt?: string;
   /** direct only, and the alternative to `prompt`. Exactly one is present. */
   bundle?: AutomationBundle;
+  /** direct only, and the alternative to `prompt` or `bundle`. */
+  actions?: AutomationSetupActions;
   /** direct only, event trigger only. Which delivered events belong to it. */
   filter?: string;
   /**

package/automations/interface.json

@@ -153,7 +153,8 @@
     "github-agents-md-maintainer",
     "news-digest",
     "github-issue-to-pr",
-    "slack-channel-monitor"
+    "slack-channel-monitor",
+    "custom-automation"
   ],
   "responderIntegrationIds": ["github", "slack"]
 }

package/integrations/catalog/gitlab.json

@@ -1,14 +1,14 @@
 {
   "id": "gitlab",
   "name": "GitLab",
-  "description": "Repositories, issues, merge requests, and CI/CD workflows through the GitLab API.",
+  "description": "Access projects, issues, merge requests, and CI/CD workflows through GitLab's official MCP server or 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.",
+  "docsUrl": "https://docs.gitlab.com/user/model_context_protocol/mcp_server/",
+  "notes": "Supports GitLab.com through either the official MCP server (beta) with OAuth or the API with a personal access token. For the OAuth MCP connection to work on GitLab.com, MCP server access must be enabled for a top-level group you belong to (set GitLab Duo availability to Always on or On by default for the top-level group, turn on beta and experimental features, and allow access to the MCP server); otherwise GitLab rejects the connection with a 404 after OAuth, which the client reports as 'Session terminated'. For GitLab Self-Managed, edit the MCP URL to your instance's server and the OAuth flow discovers the host-specific endpoints.",
   "popularityRank": 60,
   "connectionOptions": [
     {
@@ -27,6 +27,25 @@
         "apiBaseUrl": "https://gitlab.com/api/v4",
         "openApiUrl": "https://gitlab.com/gitlab-org/gitlab/-/raw/master/doc/api/openapi/openapi_v2.yaml"
       }
+    },
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "scopes": [
+            "mcp"
+          ],
+          "pkce": true,
+          "clientAuthentication": "none"
+        }
+      },
+      "transport": {
+        "kind": "shttp",
+        "url": "https://gitlab.com/api/v4/mcp",
+        "urlEditable": true
+      }
     }
   ],
   "iconBg": "var(--oh-surface)",
@@ -36,6 +55,9 @@
     "merge request",
     "repo",
     "issues",
-    "code"
-  ]
+    "code",
+    "mr",
+    "devops"
+  ],
+  "installHint": "The GitLab MCP server supports OAuth 2.0. Before installing, make sure an admin has enabled 'MCP client access' for the top-level GitLab group you belong to. If this prerequisite isn't met, GitLab returns 404 after OAuth and the connection fails with 'Session terminated'. For GitLab Self-Managed, edit the URL to https://<your-instance>/api/v4/mcp and make sure MCP server access is enabled for the instance."
 }

package/package.json

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

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openhands-extensions"
-version = "0.19.0"
+version = "0.20.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.19.0"  # x-release-please-version
+_FALLBACK_VERSION = "0.20.0"  # x-release-please-version
 
 try:
     __version__: str = version("openhands-extensions")