@openhands/extensions 0.16.0 → 0.18.0

package/skills/openhands-sdk/SKILL.md

@@ -196,6 +196,8 @@ Source: [`examples/`](https://github.com/OpenHands/software-agent-sdk/tree/main/
 - [`53_client_defined_tools.py`](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/01_standalone_sdk/53_client_defined_tools.py)
 - [`54_goal_completion_loop.py`](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/01_standalone_sdk/54_goal_completion_loop.py)
 - [`55_persistent_memory.py`](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/01_standalone_sdk/55_persistent_memory.py)
+- [`56_structured_output.py`](https://github.com/OpenHands/software-agent-sdk/blob/main/examples/01_standalone_sdk/56_structured_output.py)
+- [`57_prompt_hooks`](https://github.com/OpenHands/software-agent-sdk/tree/main/examples/01_standalone_sdk/57_prompt_hooks)
 
 ### [`02_remote_agent_server/`](https://github.com/OpenHands/software-agent-sdk/tree/main/examples/02_remote_agent_server)
 

package/skills/skill-creator/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: skill-creator
-description: This skill should be used when the user wants to "create a skill", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices.
+description: This skill should be used when the user wants to "add a skill", "create a skill", "make a new skill", "write a new skill", "improve skill description", "organize skill content", or needs guidance on skill structure, progressive disclosure, or skill development best practices. Use this (not add-skill) when authoring a new skill from scratch rather than importing one from a GitHub URL.
 ---
 
 # Skill Creator

package/skills/slack-channel-monitor/scripts/main.py

@@ -932,7 +932,8 @@ def _process_trigger_message(
         f"interactions and are NOT directed at you. Do not act on them unless "
         f"the user request explicitly refers to them.\n\n"
         f"When you are finished, summarise what you did clearly — that summary "
-        f"will be posted back to the Slack thread."
+        f"will be posted back to the Slack thread. "
+        f"Understand that your response will be displayed in Slack. Format links so they stay clickable in Slack: never wrap a URL in asterisks or backticks, never bold or otherwise style a link, and always output the bare URL as plain text (e.g. https://example.com/path, not **https://example.com/path** or <https://example.com/path>). You can always use Slack format for link text and address."
     )
 
     try:
@@ -1001,7 +1002,7 @@ def _check_conversation_completion(
                 + (f"\n\n{final}" if final else "")
             )
         else:
-            summary = f"✅ Done!\n\n{final}" if final else "✅ Task complete (no summary available)."
+            summary = final if final else "Success (no message available)."
 
         ts_back = post_message(slack_token, channel_id, summary, thread_ts=thread_ts)
         if ts_back:

package/tests/fixtures/automations/capabilities.json

@@ -46,6 +46,7 @@
         },
         "features": [
           "conversationDispatch",
+          "customTarball",
           "mcpTools",
           "presetPlugin",
           "presetPrompt",
@@ -70,12 +71,41 @@
         },
         "features": [
           "conversationDispatch",
+          "customTarball",
           "mcpTools",
           "presetPrompt",
           "repoClone"
         ]
       }
     },
+    "noCustomTarball": {
+      "description": "A ready deployment running a service that predates bundle support, so it can run a preset but not a tarball the client supplies. An entry whose setup ships a bundle is blocked here even though every trigger kind it needs is available.",
+      "status": 200,
+      "body": {
+        "ready": true,
+        "triggerKinds": ["cron", "event"],
+        "eventSources": ["github"],
+        "eventTypes": ["pull_request.labeled"],
+        "triggers": {
+          "cron": {
+            "minIntervalSeconds": 300,
+            "timezones": ["UTC"]
+          },
+          "event": {
+            "filterLanguage": "jmespath",
+            "filterFunctions": ["contains", "icontains"]
+          }
+        },
+        "features": [
+          "conversationDispatch",
+          "mcpTools",
+          "presetPlugin",
+          "presetPrompt",
+          "repoClone",
+          "webhookDelivery"
+        ]
+      }
+    },
     "notReady": {
       "description": "The automation service is reachable but not accepting work. It offers no features and no trigger kinds, so every setup block is blocked.",
       "status": 200,

package/tests/fixtures/automations/github-pr-reviewer.json

@@ -1,8 +1,9 @@
 {
   "automationId": "github-pr-reviewer",
-  "description": "Direct scheduled setup. Every create request body below is verified against the live CreatePromptAutomationRequest model in OpenHands/automation (openhands/automation/preset_router.py).",
+  "description": "Direct scheduled setup that ships a script bundle rather than a prompt. The host packs the entry's files with a rendered config.json, uploads them, and creates from what came back, so a scenario that reaches creation records an upload step first. A preflight draft carries a stand-in tarball path instead: preflight runs while the form is being filled in, before anything is uploaded. Every create request body below is verified against the live CreateAutomationRequest model in OpenHands/automation (openhands/automation/schemas.py).",
   "capabilities": "supported",
   "blockedBy": [
+    "noCustomTarball",
     "notReady"
   ],
   "scenarios": [
@@ -10,11 +11,36 @@
       "id": "happy-path",
       "description": "Defaults plus a repository and a thorough review tone. Preflight passes, the automation is created.",
       "formValues": {
-        "repository": "OpenHands/agent-server-gui",
         "triggerLabel": "openhands-review",
         "reviewTone": "thorough",
         "schedule": "*/15 * * * *",
-        "timezone": "UTC"
+        "timezone": "UTC",
+        "repositories": [
+          "OpenHands/agent-server-gui"
+        ]
+      },
+      "upload": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/uploads",
+          "query": {
+            "name": "github-pr-reviewer"
+          },
+          "contentType": "application/gzip",
+          "packs": [
+            "config.json",
+            "main.py"
+          ]
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "name": "github-pr-reviewer",
+            "status": "COMPLETED",
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34"
+          }
+        }
       },
       "preflight": {
         "request": {
@@ -22,20 +48,27 @@
           "path": "/v1/validate",
           "body": {
             "automationId": "github-pr-reviewer",
-            "endpoint": "/v1/preset/prompt",
+            "endpoint": "/v1",
             "draft": {
               "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
-              "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: thorough.",
-              "repos": [
-                {
-                  "url": "OpenHands/agent-server-gui",
-                  "provider": "github"
-                }
-              ],
               "trigger": {
                 "type": "cron",
                 "schedule": "*/15 * * * *",
                 "timezone": "UTC"
+              },
+              "tarball_path": "oh-internal://uploads/00000000-0000-0000-0000-000000000000",
+              "entrypoint": "python3 main.py",
+              "timeout": 600,
+              "template": {
+                "id": "github-pr-reviewer",
+                "version": "1.0.0",
+                "config": {
+                  "repos": [
+                    "OpenHands/agent-server-gui"
+                  ],
+                  "trigger_label": "openhands-review",
+                  "review_tone": "thorough"
+                }
               }
             }
           }
@@ -51,20 +84,27 @@
       "create": {
         "request": {
           "method": "POST",
-          "path": "/v1/preset/prompt",
+          "path": "/v1",
           "body": {
             "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
-            "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: thorough.",
-            "repos": [
-              {
-                "url": "OpenHands/agent-server-gui",
-                "provider": "github"
-              }
-            ],
             "trigger": {
               "type": "cron",
               "schedule": "*/15 * * * *",
               "timezone": "UTC"
+            },
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "entrypoint": "python3 main.py",
+            "timeout": 600,
+            "template": {
+              "id": "github-pr-reviewer",
+              "version": "1.0.0",
+              "config": {
+                "repos": [
+                  "OpenHands/agent-server-gui"
+                ],
+                "trigger_label": "openhands-review",
+                "review_tone": "thorough"
+              }
             }
           }
         },
@@ -95,15 +135,162 @@
         }
       }
     },
+    {
+      "id": "several-repositories",
+      "description": "Two repositories from one automation. The config carries the list the picker collected, and the automation is named by the count rather than by a list of names that would not fit.",
+      "formValues": {
+        "triggerLabel": "openhands-review",
+        "reviewTone": "thorough",
+        "schedule": "*/15 * * * *",
+        "timezone": "UTC",
+        "repositories": [
+          "OpenHands/agent-server-gui",
+          "OpenHands/automation"
+        ]
+      },
+      "upload": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/uploads",
+          "query": {
+            "name": "github-pr-reviewer"
+          },
+          "contentType": "application/gzip",
+          "packs": [
+            "config.json",
+            "main.py"
+          ]
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "name": "github-pr-reviewer",
+            "status": "COMPLETED",
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34"
+          }
+        }
+      },
+      "preflight": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/validate",
+          "body": {
+            "automationId": "github-pr-reviewer",
+            "endpoint": "/v1",
+            "draft": {
+              "name": "GitHub Code Review Agent - 2 repositories",
+              "trigger": {
+                "type": "cron",
+                "schedule": "*/15 * * * *",
+                "timezone": "UTC"
+              },
+              "tarball_path": "oh-internal://uploads/00000000-0000-0000-0000-000000000000",
+              "entrypoint": "python3 main.py",
+              "timeout": 600,
+              "template": {
+                "id": "github-pr-reviewer",
+                "version": "1.0.0",
+                "config": {
+                  "repos": [
+                    "OpenHands/agent-server-gui",
+                    "OpenHands/automation"
+                  ],
+                  "trigger_label": "openhands-review",
+                  "review_tone": "thorough"
+                }
+              }
+            }
+          }
+        },
+        "response": {
+          "status": 200,
+          "body": {
+            "valid": true,
+            "errors": []
+          }
+        }
+      },
+      "create": {
+        "request": {
+          "method": "POST",
+          "path": "/v1",
+          "body": {
+            "name": "GitHub Code Review Agent - 2 repositories",
+            "trigger": {
+              "type": "cron",
+              "schedule": "*/15 * * * *",
+              "timezone": "UTC"
+            },
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "entrypoint": "python3 main.py",
+            "timeout": 600,
+            "template": {
+              "id": "github-pr-reviewer",
+              "version": "1.0.0",
+              "config": {
+                "repos": [
+                  "OpenHands/agent-server-gui",
+                  "OpenHands/automation"
+                ],
+                "trigger_label": "openhands-review",
+                "review_tone": "thorough"
+              }
+            }
+          }
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "6f1b8e64-2f6a-4f0e-9a1c-2b7d0c4e5f11",
+            "user_id": "1a2b3c4d-0000-4000-8000-000000000001",
+            "org_id": "1a2b3c4d-0000-4000-8000-000000000002",
+            "model": null,
+            "name": "GitHub Code Review Agent - 2 repositories",
+            "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: thorough.",
+            "trigger": {
+              "type": "cron",
+              "schedule": "*/15 * * * *",
+              "timezone": "UTC"
+            },
+            "tarball_path": "oh-internal://uploads/8d2c1f90-7e34-4a55-b0d1-6c9e3a2f4b88",
+            "setup_script_path": "setup.sh",
+            "entrypoint": ".venv/bin/python main.py",
+            "timeout": 600,
+            "keep_alive": null,
+            "enabled": true,
+            "last_triggered_at": null,
+            "created_at": "2026-07-27T12:00:00Z",
+            "updated_at": "2026-07-27T12:00:00Z",
+            "preset_metadata": {
+              "template": {
+                "id": "github-pr-reviewer",
+                "version": "1.0.0",
+                "config": {
+                  "repos": [
+                    "OpenHands/agent-server-gui",
+                    "OpenHands/automation"
+                  ],
+                  "trigger_label": "openhands-review",
+                  "review_tone": "thorough"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
     {
       "id": "interval-below-deployment-minimum",
       "description": "A one-minute schedule. The create model accepts it, so only the deployment can reject it - this is precisely why preflight exists and why local validation is not authoritative.",
       "formValues": {
-        "repository": "OpenHands/agent-server-gui",
         "triggerLabel": "openhands-review",
         "reviewTone": "concise",
         "schedule": "*/1 * * * *",
-        "timezone": "UTC"
+        "timezone": "UTC",
+        "repositories": [
+          "OpenHands/agent-server-gui"
+        ]
       },
       "preflight": {
         "request": {
@@ -111,20 +298,27 @@
           "path": "/v1/validate",
           "body": {
             "automationId": "github-pr-reviewer",
-            "endpoint": "/v1/preset/prompt",
+            "endpoint": "/v1",
             "draft": {
               "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
-              "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: concise.",
-              "repos": [
-                {
-                  "url": "OpenHands/agent-server-gui",
-                  "provider": "github"
-                }
-              ],
               "trigger": {
                 "type": "cron",
                 "schedule": "*/1 * * * *",
                 "timezone": "UTC"
+              },
+              "tarball_path": "oh-internal://uploads/00000000-0000-0000-0000-000000000000",
+              "entrypoint": "python3 main.py",
+              "timeout": 600,
+              "template": {
+                "id": "github-pr-reviewer",
+                "version": "1.0.0",
+                "config": {
+                  "repos": [
+                    "OpenHands/agent-server-gui"
+                  ],
+                  "trigger_label": "openhands-review",
+                  "review_tone": "concise"
+                }
               }
             }
           }
@@ -151,29 +345,61 @@
       "id": "unfireable-cron-rejected-at-create",
       "description": "31 February. Syntactically valid, so a local check passes, but the service rejects it. Shows the real 422 body: detail is a list and the loc path carries the trigger discriminator tag.",
       "formValues": {
-        "repository": "OpenHands/agent-server-gui",
         "triggerLabel": "openhands-review",
         "reviewTone": "concise",
         "schedule": "0 0 31 2 *",
-        "timezone": "UTC"
+        "timezone": "UTC",
+        "repositories": [
+          "OpenHands/agent-server-gui"
+        ]
+      },
+      "upload": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/uploads",
+          "query": {
+            "name": "github-pr-reviewer"
+          },
+          "contentType": "application/gzip",
+          "packs": [
+            "config.json",
+            "main.py"
+          ]
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "name": "github-pr-reviewer",
+            "status": "COMPLETED",
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34"
+          }
+        }
       },
       "create": {
         "request": {
           "method": "POST",
-          "path": "/v1/preset/prompt",
+          "path": "/v1",
           "body": {
             "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
-            "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: concise.",
-            "repos": [
-              {
-                "url": "OpenHands/agent-server-gui",
-                "provider": "github"
-              }
-            ],
             "trigger": {
               "type": "cron",
               "schedule": "0 0 31 2 *",
               "timezone": "UTC"
+            },
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "entrypoint": "python3 main.py",
+            "timeout": 600,
+            "template": {
+              "id": "github-pr-reviewer",
+              "version": "1.0.0",
+              "config": {
+                "repos": [
+                  "OpenHands/agent-server-gui"
+                ],
+                "trigger_label": "openhands-review",
+                "review_tone": "concise"
+              }
             }
           }
         },
@@ -200,32 +426,71 @@
       }
     },
     {
-      "id": "short-repo-url-without-provider-is-rejected",
-      "description": "The mapping bug this fixture set exists to prevent. A short owner/repo URL without an explicit provider is a hard 422, because CreatePromptAutomationRequest is extra-forbid and RepoSource requires the provider. The setup block's payload always sets it; this records what happens if that is ever dropped.",
+      "id": "repos-on-the-raw-create-request-is-rejected",
+      "description": "The mapping bug this fixture set exists to prevent, in its bundle form. The raw create endpoint has no repos field and CreateAutomationRequest is extra-forbid, so carrying the preset path's repos across is a hard 422 rather than a silently dropped field. A bundle clones nothing: its script fetches what it needs itself.",
       "formValues": {
-        "repository": "OpenHands/agent-server-gui",
         "triggerLabel": "openhands-review",
         "reviewTone": "concise",
         "schedule": "*/15 * * * *",
-        "timezone": "UTC"
+        "timezone": "UTC",
+        "repositories": [
+          "OpenHands/agent-server-gui"
+        ]
+      },
+      "upload": {
+        "request": {
+          "method": "POST",
+          "path": "/v1/uploads",
+          "query": {
+            "name": "github-pr-reviewer"
+          },
+          "contentType": "application/gzip",
+          "packs": [
+            "config.json",
+            "main.py"
+          ]
+        },
+        "response": {
+          "status": 201,
+          "body": {
+            "id": "2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "name": "github-pr-reviewer",
+            "status": "COMPLETED",
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34"
+          }
+        }
       },
       "create": {
         "request": {
           "method": "POST",
-          "path": "/v1/preset/prompt",
+          "path": "/v1",
           "body": {
             "name": "GitHub Code Review Agent - OpenHands/agent-server-gui",
-            "prompt": "Review pull requests labeled 'openhands-review' in OpenHands/agent-server-gui. Review tone: concise.",
-            "repos": [
-              {
-                "url": "OpenHands/agent-server-gui"
-              }
-            ],
             "trigger": {
               "type": "cron",
               "schedule": "*/15 * * * *",
               "timezone": "UTC"
-            }
+            },
+            "tarball_path": "oh-internal://uploads/2c1f9a70-77c4-4a1e-9a9d-6f1f2b0c1d34",
+            "entrypoint": "python3 main.py",
+            "timeout": 600,
+            "template": {
+              "id": "github-pr-reviewer",
+              "version": "1.0.0",
+              "config": {
+                "repos": [
+                  "OpenHands/agent-server-gui"
+                ],
+                "trigger_label": "openhands-review",
+                "review_tone": "concise"
+              }
+            },
+            "repos": [
+              {
+                "url": "OpenHands/agent-server-gui",
+                "provider": "github"
+              }
+            ]
           }
         },
         "response": {
@@ -233,13 +498,12 @@
           "body": {
             "detail": [
               {
-                "type": "value_error",
+                "type": "extra_forbidden",
                 "loc": [
                   "body",
-                  "repos",
-                  0
+                  "repos"
                 ],
-                "msg": "Value error, Short URL format 'OpenHands/agent-server-gui' requires explicit 'provider' field. Use: {\"url\": \"owner/repo\", \"provider\": \"github\"} or provide a full URL like https://github.com/owner/repo"
+                "msg": "Extra inputs are not permitted"
               }
             ]
           }