openhands-extensions 0.8.0__tar.gz → 0.9.0__tar.gz

openhands_extensions-0.9.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.9.0"
+}

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: openhands-extensions
-Version: 0.8.0
+Version: 0.9.0
 Summary: OpenHands extensions, plugins, and skills (Python bindings for the integration catalog)
 License-File: LICENSE
 Requires-Python: >=3.12

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/README.md

@@ -87,7 +87,7 @@ The JS and Python versions are kept in lock-step by `release-please` and guarded
 ## Extensions Catalog
 
 <!-- BEGIN AUTO-GENERATED CATALOG -->
-This repository contains **2 marketplace(s)** with **61 extensions** (51 skills, 10 plugins).
+This repository contains **2 marketplace(s)** with **62 extensions** (52 skills, 10 plugins).
 
 ### large-codebase
 
@@ -106,7 +106,7 @@ OpenHands skills for interacting, improving, and refactoring large codebases
 
 Official skills and plugins for OpenHands — the open-source AI software engineer.
 
-**57 extensions** (49 skills, 8 plugins)
+**58 extensions** (50 skills, 8 plugins)
 
 | Name | Type | Description | Commands |
 |------|------|-------------|----------|
@@ -137,6 +137,7 @@ Official skills and plugins for OpenHands — the open-source AI software engine
 | gitlab | skill | Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when wor... | — |
 | incident-retrospective | skill | Create an automation that drafts incident retrospectives by gathering incident-channel messages from Slack, collectin... | `/incident-retro:setup` |
 | iterate | skill | Iterate on a GitHub pull request — drive it through CI, code review, and QA until merge-ready. Monitors state, fixes ... | `/iterate`, `/verify`, `/babysit` |
+| jira-issue-to-pr | skill | Deploy a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable lab... | — |
 | jupyter | skill | Read, modify, execute, and convert Jupyter notebooks programmatically. Use when working with .ipynb files for data sc... | — |
 | kubernetes | skill | Set up and manage local Kubernetes clusters using KIND (Kubernetes IN Docker). Use when testing Kubernetes applicatio... | — |
 | learn-from-code-review | skill | Distill code review feedback from GitHub PRs into reusable skills and guidelines. Use when users ask to learn from co... | `/learn-from-reviews` |

openhands_extensions-0.9.0/automations/catalog/jira-issue-to-pr.json

@@ -0,0 +1,14 @@
+{
+  "id": "jira-issue-to-pr",
+  "name": "Jira issue to GitHub PR",
+  "category": "Project management",
+  "description": "Watch a Jira Cloud project for issues with a configurable label and automatically open a GitHub pull request for each new issue found. The target GitHub repo is read from the ticket body - no repo parameter required at deploy time.",
+  "requiredIntegrationIds": [
+    "jira",
+    "github"
+  ],
+  "popularityRank": 85,
+  "estimatedSetupMinutes": 5,
+  "prompt": "Set up a Jira automation to create pull requests",
+  "exampleImplementation": "Trigger: cron polling (e.g. every 5 minutes)\nRequired secrets: Jira API token, GitHub personal access token (repo + workflow scope)\n\n1. Collect Jira base URL, email, API token secret name, label to watch, and cron schedule from the user. No GitHub repo is needed at deploy time - each ticket must include the target repo (owner/repo) in its body.\n2. Poll POST /rest/api/3/search/jql on the Jira Cloud instance to find open issues carrying the configured label.\n3. Deduplicate against a KV-store-backed set of already-processed issue keys so re-runs never create duplicate PRs.\n4. For each new issue, start an independent OpenHands agent conversation that extracts the GitHub repo from the ticket body, clones it, creates a branch named after the Jira key, implements or scaffolds the requested change, and opens a pull request.\n5. Immediately after the conversation is created, post a Jira comment on the issue: 'I'm on it: <conversation URL>'.\n6. Persist the processed issue key immediately after dispatching so the next poll skips it."
+}

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/automations/index.js

@@ -5,6 +5,7 @@ import slack_channel_monitor from "./catalog/slack-channel-monitor.json" with {
 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" };
 
 export const AUTOMATION_CATALOG = [
   github_pr_reviewer,
@@ -14,5 +15,6 @@ export const AUTOMATION_CATALOG = [
   linear_triage_assistant,
   research_brief_writer,
   incident_retrospective_drafter,
+  jira_issue_to_pr,
 ];
 export default AUTOMATION_CATALOG;

openhands_extensions-0.9.0/integrations/catalog/atlassian.json

@@ -0,0 +1,103 @@
+{
+  "id": "atlassian",
+  "name": "Atlassian (Jira & Confluence)",
+  "description": "Search Jira issues, manage tickets, and read Confluence pages from your agent.",
+  "categories": [
+    "Project management",
+    "Documentation"
+  ],
+  "appUrl": "https://www.atlassian.com",
+  "docsUrl": "https://mcp-atlassian.soomiles.com/docs/installation",
+  "iconBg": "#0052CC",
+  "logoUrl": "https://cdn.simpleicons.org/atlassian/FFFFFF",
+  "keywords": [
+    "jira",
+    "confluence",
+    "tickets",
+    "wiki",
+    "issues",
+    "sprint"
+  ],
+  "popularityRank": 88,
+  "installHint": "Paste your Jira and/or Confluence URL and API token. The mcp-atlassian package runs via uvx - no install needed.",
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.atlassian.com/v1/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2"
+      }
+    },
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "mcp-atlassian",
+        "command": "uvx",
+        "args": [
+          "mcp-atlassian"
+        ],
+        "envFields": [
+          {
+            "key": "JIRA_URL",
+            "label": "Jira URL",
+            "type": "text",
+            "placeholder": "https://your-company.atlassian.net",
+            "required": false,
+            "helperText": "Your Atlassian Jira base URL. Omit if using Confluence only."
+          },
+          {
+            "key": "JIRA_USERNAME",
+            "label": "Jira username (email)",
+            "type": "text",
+            "placeholder": "your.email@company.com",
+            "required": false,
+            "helperText": "Email address linked to your Atlassian account."
+          },
+          {
+            "key": "JIRA_API_TOKEN",
+            "label": "Jira API token",
+            "type": "password",
+            "placeholder": "ATATT...",
+            "required": false,
+            "helperText": "Atlassian API token for Jira. Required when JIRA_URL is set.",
+            "helperLink": "https://id.atlassian.com/manage-profile/security/api-tokens"
+          },
+          {
+            "key": "CONFLUENCE_URL",
+            "label": "Confluence URL",
+            "type": "text",
+            "placeholder": "https://your-company.atlassian.net/wiki",
+            "required": false,
+            "helperText": "Your Atlassian Confluence base URL. Omit if using Jira only."
+          },
+          {
+            "key": "CONFLUENCE_USERNAME",
+            "label": "Confluence username (email)",
+            "type": "text",
+            "placeholder": "your.email@company.com",
+            "required": false,
+            "helperText": "Email address linked to your Atlassian account."
+          },
+          {
+            "key": "CONFLUENCE_API_TOKEN",
+            "label": "Confluence API token",
+            "type": "password",
+            "placeholder": "ATATT...",
+            "required": false,
+            "helperText": "Atlassian API token for Confluence. Required when CONFLUENCE_URL is set.",
+            "helperLink": "https://id.atlassian.com/manage-profile/security/api-tokens"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ]
+}

openhands_extensions-0.9.0/integrations/catalog/datadog.json

@@ -0,0 +1,65 @@
+{
+  "id": "datadog",
+  "name": "Datadog",
+  "description": "Logs, metrics, monitors, incidents, and observability workflows.",
+  "categories": [
+    "Observability",
+    "Operations"
+  ],
+  "appUrl": "https://www.datadoghq.com",
+  "docsUrl": "https://docs.datadoghq.com/bits_ai/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.",
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://app.datadoghq.com/oauth2/v1/authorize",
+          "tokenUrl": "https://api.datadoghq.com/oauth2/v1/token",
+          "scopes": [
+            "dashboards_read",
+            "monitors_read"
+          ]
+        }
+      },
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.datadoghq.com/v1/mcp"
+      }
+    },
+    {
+      "id": "api",
+      "provider": "mcp",
+      "auth": {
+        "strategy": "none"
+      },
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.datadoghq.com/v1/mcp",
+        "urlEditable": true,
+        "headerFields": [
+          {
+            "key": "DD-API-KEY",
+            "label": "Datadog API key",
+            "type": "password",
+            "required": true,
+            "placeholder": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "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",
+            "label": "Datadog Application key",
+            "type": "password",
+            "required": true,
+            "placeholder": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+            "helperText": "Created in Datadog under Organization Settings → Application Keys. Grants the MCP server access to your Datadog data. See the [setup docs](https://docs.datadoghq.com/mcp_server/setup/?tab=other#authentication)."
+          }
+        ]
+      }
+    }
+  ]
+}

openhands_extensions-0.9.0/integrations/catalog/superhuman-mail.json

@@ -0,0 +1,36 @@
+{
+  "id": "superhuman-mail",
+  "name": "Superhuman Mail",
+  "description": "Search, read, draft, and send email via Superhuman's hosted MCP server.",
+  "categories": [
+    "Communication",
+    "Email"
+  ],
+  "appUrl": "https://superhuman.com",
+  "docsUrl": "https://github.com/superhuman/mcp-mail",
+  "notes": "OAuth is handled by the Superhuman MCP server itself (mcp-remote). No client credentials required.",
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "mcp",
+      "transport": {
+        "kind": "shttp",
+        "url": "https://mcp.mail.superhuman.com/mcp"
+      },
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "clientAuthentication": "none"
+        }
+      }
+    }
+  ],
+  "iconBg": "#FF5C28",
+  "logoUrl": "https://cdn.simpleicons.org/superhuman/FFFFFF",
+  "keywords": [
+    "email",
+    "mail",
+    "superhuman",
+    "inbox"
+  ]
+}

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/integrations/catalog-index.js

@@ -5,48 +5,48 @@
 import entry0 from "./catalog/github.json" with { type: "json" };
 import entry1 from "./catalog/slack.json" with { type: "json" };
 import entry2 from "./catalog/tavily.json" with { type: "json" };
-import entry3 from "./catalog/linear.json" with { type: "json" };
-import entry4 from "./catalog/notion.json" with { type: "json" };
-import entry5 from "./catalog/ordinal.json" with { type: "json" };
-import entry6 from "./catalog/elevenlabs.json" with { type: "json" };
-import entry7 from "./catalog/bitbucket.json" with { type: "json" };
-import entry8 from "./catalog/xero.json" with { type: "json" };
-import entry9 from "./catalog/quickbooks.json" with { type: "json" };
-import entry10 from "./catalog/okta.json" with { type: "json" };
-import entry11 from "./catalog/netlify.json" with { type: "json" };
-import entry12 from "./catalog/vercel.json" with { type: "json" };
-import entry13 from "./catalog/supabase.json" with { type: "json" };
-import entry14 from "./catalog/posthog.json" with { type: "json" };
-import entry15 from "./catalog/sentry.json" with { type: "json" };
-import entry16 from "./catalog/datadog.json" with { type: "json" };
-import entry17 from "./catalog/canva.json" with { type: "json" };
-import entry18 from "./catalog/miro.json" with { type: "json" };
-import entry19 from "./catalog/webflow.json" with { type: "json" };
-import entry20 from "./catalog/zoom.json" with { type: "json" };
-import entry21 from "./catalog/discord.json" with { type: "json" };
-import entry22 from "./catalog/stripe.json" with { type: "json" };
-import entry23 from "./catalog/intercom.json" with { type: "json" };
-import entry24 from "./catalog/hubspot.json" with { type: "json" };
-import entry25 from "./catalog/salesforce.json" with { type: "json" };
-import entry26 from "./catalog/sharepoint.json" with { type: "json" };
-import entry27 from "./catalog/onedrive.json" with { type: "json" };
-import entry28 from "./catalog/microsoft-teams.json" with { type: "json" };
-import entry29 from "./catalog/microsoft-outlook.json" with { type: "json" };
-import entry30 from "./catalog/box.json" with { type: "json" };
-import entry31 from "./catalog/airtable.json" with { type: "json" };
-import entry32 from "./catalog/monday.json" with { type: "json" };
-import entry33 from "./catalog/trello.json" with { type: "json" };
-import entry34 from "./catalog/asana.json" with { type: "json" };
-import entry35 from "./catalog/confluence.json" with { type: "json" };
-import entry36 from "./catalog/jira.json" with { type: "json" };
-import entry37 from "./catalog/google-calendar.json" with { type: "json" };
-import entry38 from "./catalog/gmail.json" with { type: "json" };
-import entry39 from "./catalog/google-sheets.json" with { type: "json" };
-import entry40 from "./catalog/google-drive.json" with { type: "json" };
-import entry41 from "./catalog/figma.json" with { type: "json" };
-import entry42 from "./catalog/google-docs.json" with { type: "json" };
-import entry43 from "./catalog/apify.json" with { type: "json" };
-import entry44 from "./catalog/atlassian.json" with { type: "json" };
+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/ordinal.json" with { type: "json" };
+import entry7 from "./catalog/elevenlabs.json" with { type: "json" };
+import entry8 from "./catalog/bitbucket.json" with { type: "json" };
+import entry9 from "./catalog/xero.json" with { type: "json" };
+import entry10 from "./catalog/quickbooks.json" with { type: "json" };
+import entry11 from "./catalog/okta.json" with { type: "json" };
+import entry12 from "./catalog/netlify.json" with { type: "json" };
+import entry13 from "./catalog/vercel.json" with { type: "json" };
+import entry14 from "./catalog/supabase.json" with { type: "json" };
+import entry15 from "./catalog/posthog.json" with { type: "json" };
+import entry16 from "./catalog/sentry.json" with { type: "json" };
+import entry17 from "./catalog/datadog.json" with { type: "json" };
+import entry18 from "./catalog/canva.json" with { type: "json" };
+import entry19 from "./catalog/miro.json" with { type: "json" };
+import entry20 from "./catalog/webflow.json" with { type: "json" };
+import entry21 from "./catalog/zoom.json" with { type: "json" };
+import entry22 from "./catalog/discord.json" with { type: "json" };
+import entry23 from "./catalog/stripe.json" with { type: "json" };
+import entry24 from "./catalog/intercom.json" with { type: "json" };
+import entry25 from "./catalog/hubspot.json" with { type: "json" };
+import entry26 from "./catalog/salesforce.json" with { type: "json" };
+import entry27 from "./catalog/sharepoint.json" with { type: "json" };
+import entry28 from "./catalog/onedrive.json" with { type: "json" };
+import entry29 from "./catalog/microsoft-teams.json" with { type: "json" };
+import entry30 from "./catalog/microsoft-outlook.json" with { type: "json" };
+import entry31 from "./catalog/box.json" with { type: "json" };
+import entry32 from "./catalog/airtable.json" with { type: "json" };
+import entry33 from "./catalog/monday.json" with { type: "json" };
+import entry34 from "./catalog/trello.json" with { type: "json" };
+import entry35 from "./catalog/asana.json" with { type: "json" };
+import entry36 from "./catalog/confluence.json" with { type: "json" };
+import entry37 from "./catalog/jira.json" with { type: "json" };
+import entry38 from "./catalog/google-calendar.json" with { type: "json" };
+import entry39 from "./catalog/gmail.json" with { type: "json" };
+import entry40 from "./catalog/google-sheets.json" with { type: "json" };
+import entry41 from "./catalog/google-drive.json" with { type: "json" };
+import entry42 from "./catalog/figma.json" with { type: "json" };
+import entry43 from "./catalog/google-docs.json" with { type: "json" };
+import entry44 from "./catalog/apify.json" with { type: "json" };
 import entry45 from "./catalog/brave-search.json" with { type: "json" };
 import entry46 from "./catalog/browser-mcp.json" with { type: "json" };
 import entry47 from "./catalog/clickhouse.json" with { type: "json" };
@@ -73,7 +73,8 @@ import entry67 from "./catalog/playwright.json" with { type: "json" };
 import entry68 from "./catalog/redis.json" with { type: "json" };
 import entry69 from "./catalog/resend.json" with { type: "json" };
 import entry70 from "./catalog/sequential-thinking.json" with { type: "json" };
-import entry71 from "./catalog/time.json" with { type: "json" };
+import entry71 from "./catalog/superhuman-mail.json" with { type: "json" };
+import entry72 from "./catalog/time.json" with { type: "json" };
 
 export const INTEGRATION_CATALOG_ENTRIES = [
   entry0,
@@ -148,4 +149,5 @@ export const INTEGRATION_CATALOG_ENTRIES = [
   entry69,
   entry70,
   entry71,
+  entry72,
 ];

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/marketplaces/openhands-extensions.json

@@ -737,6 +737,16 @@
       "keywords": [
         "plain-english"
       ]
+    },
+    {
+      "name": "jira-issue-to-pr",
+      "source": "./skills/jira-issue-to-pr",
+      "description": "Deploy a cron-based OpenHands automation that watches a Jira Cloud project for issues labeled with a configurable label (default: create-pr) and spawns an agent conversation to create a GitHub pull request for each new issue found. The target GitHub repo is read from the ticket body - no repo parameter required at deploy time.",
+      "category": "productivity",
+      "keywords": [
+        "jira",
+        "atlassian"
+      ]
     }
   ]
 }

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/package.json

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

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/cobol-modernization/skills/build-setup/SKILL.md

@@ -13,6 +13,7 @@ triggers:
 Set up a build environment and create test fixtures for validating COBOL-to-Java migrations.
 
 To install GnuCOBOL, run: `./scripts/install-gnucobol.sh`
+On Windows, run that shell script from Git Bash/WSL (`bash scripts/install-gnucobol.sh`) or install GnuCOBOL with a Windows package manager and document the chosen command in `build_notes.md`.
 
 ## Phase 1: Build Setup
 

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/cobol-modernization/skills/cobol-modernization/SKILL.md

@@ -37,6 +37,15 @@ export LLM_MODEL="anthropic/claude-3-5-sonnet-20241022"
 uv run python -m lc_sdk_examples.cobol_modernization --src-path /path/to/cobol/project
 ```
 
+PowerShell equivalent for the environment setup:
+
+```powershell
+$env:LLM_API_KEY = "your-api-key"
+$env:LLM_MODEL = "anthropic/claude-3-5-sonnet-20241022"
+
+uv run python -m lc_sdk_examples.cobol_modernization --src-path C:\path\to\cobol\project
+```
+
 ## Workflow Phases
 
 ### Phase 1: Build Setup

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/migration-scoring/skills/migration-scoring/SKILL.md

@@ -39,6 +39,17 @@ uv run python -m lc_sdk_examples.migration_scoring \
   --rubric-path /path/to/style_rubric.txt
 ```
 
+PowerShell equivalent for the environment setup:
+
+```powershell
+$env:LLM_API_KEY = "your-api-key"
+$env:LLM_MODEL = "anthropic/claude-3-5-sonnet-20241022"
+
+uv run python -m lc_sdk_examples.migration_scoring `
+  --src-path C:\path\to\migration\project `
+  --rubric-path C:\path\to\style_rubric.txt
+```
+
 ## Workflow Phases
 
 ### Phase 1: Migration Mapping

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/onboarding/skills/agent-readiness-report/SKILL.md

@@ -51,6 +51,8 @@ Or scan all five at once:
 for s in scripts/scan_*.sh; do bash "$s" /path/to/repo; echo; done
 ```
 
+On Windows, run these `.sh` helpers from Git Bash or WSL and pass a path that environment can read. Native PowerShell cannot execute the shell scripts directly.
+
 **Important**: The scripts are helpers, not scorers.  They find files and
 patterns but do not evaluate quality.  Many features require judgment that only
 reading the actual files can provide — for example, whether a README includes

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/openhands/SKILL.md

@@ -31,6 +31,12 @@ This plugin provides a unified entry point and the CLI integration script.
 command -v openhands &>/dev/null && echo "CLI available" || echo "CLI not found"
 ```
 
+PowerShell check:
+
+```powershell
+if (Get-Command openhands -ErrorAction SilentlyContinue) { "CLI available" } else { "CLI not found" }
+```
+
 2. **If CLI is available**, use it — it manages auth and API keys automatically.
 3. **If CLI is not available**, check for an API key:
    - Preferred env var: `OPENHANDS_CLOUD_API_KEY`
@@ -49,6 +55,7 @@ command -v openhands &>/dev/null && echo "CLI available" || echo "CLI not found"
 ```
 
 The script checks for the CLI, installs it if needed, sends the task, and opens the resulting conversation URL.
+On Windows, run this POSIX shell script from Git Bash or WSL (`bash scripts/run.sh "Investigate flaky tests in tests/test_api.py"`) unless a native PowerShell launcher is available.
 
 If the script exits with code `2` (`AUTH_REQUIRED`), ask the user to complete authentication in the browser, then re-run.
 

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/openhands/skills/openhands-api/SKILL.md

@@ -11,6 +11,7 @@ triggers:
 ---
 
 This skill documents the **OpenHands Cloud API** (V1), commonly used **agent-server APIs**, and small, easy-to-copy clients.
+Windows PowerShell equivalents for the shell examples in this skill are in `references/windows.md`.
 
 It is intentionally focused on common OpenHands API workflows:
 

openhands_extensions-0.9.0/plugins/openhands/skills/openhands-api/references/windows.md

@@ -0,0 +1,44 @@
+# Windows Notes for OpenHands API Commands
+
+Use these PowerShell forms when running this skill's shell examples natively on Windows.
+
+## Environment Variables
+
+```powershell
+$env:OPENHANDS_CLOUD_API_KEY = "..."
+```
+
+## Curl Examples
+
+Call `curl.exe` and use PowerShell backticks for line continuation:
+
+```powershell
+curl.exe -X POST "https://app.all-hands.dev/api/v1/app-conversations" `
+  -H "Authorization: Bearer $env:OPENHANDS_CLOUD_API_KEY" `
+  -H "Content-Type: application/json" `
+  -d '{
+    "initial_message": {
+      "content": [{"type": "text", "text": "Investigate flaky tests in tests/test_api.py."}]
+    },
+    "selected_repository": "owner/repo"
+  }'
+```
+
+## Python Here-doc Debugging Examples
+
+PowerShell does not support Bash here-docs like `python3 - <<'PY'`. Save the script to a temp file and pipe the API response into it.
+
+```powershell
+$script = Join-Path $env:TEMP "openhands-events.py"
+@'
+import json, sys
+items = (json.load(sys.stdin) or {}).get("items", [])
+for i, e in enumerate(items):
+    print(f"{i:04d}  {e.get('timestamp','')}  {e.get('source','')}  {e.get('kind','')}")
+'@ | Set-Content -LiteralPath $script -Encoding utf8
+
+curl.exe -s "https://app.all-hands.dev/api/v1/conversation/$env:APP_CONVERSATION_ID/events/search?limit=100" `
+  -H "Authorization: Bearer $env:OPENHANDS_CLOUD_API_KEY" `
+  -H "Accept: application/json" |
+  python $script
+```

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/openhands/skills/openhands-automation/SKILL.md

@@ -19,6 +19,7 @@ triggers:
 # OpenHands Automations
 
 Create and manage automations that run inside an OpenHands agent server — triggered by cron schedules or webhook events (GitHub, custom services).
+Windows PowerShell equivalents for the automation API `curl` examples and shell-variable conventions are in `references/windows.md`.
 
 ## Automation Creation Process
 The agent must follow these steps when creating an automation:

{openhands_extensions-0.8.0 → openhands_extensions-0.9.0}/plugins/openhands/skills/openhands-automation/references/custom-automation.md

@@ -272,6 +272,26 @@ with OpenHandsCloudWorkspace(
 # OpenHandsCloudWorkspace.__exit__ fires the completion callback here.
 ```
 
+### Selecting an LLM profile
+
+The automation service injects an `AUTOMATION_MODEL` environment variable holding the **LLM profile name** the automation should run with. This is the profile a user selects when editing the automation, or — when none is selected — a snapshot of the user's active profile taken when the automation was created. To honor it on every run, read `AUTOMATION_MODEL` and pass it to `workspace.get_llm(profile_name=...)`:
+
+```python
+# AUTOMATION_MODEL is the selected profile name (absent when none was chosen).
+model_profile = os.environ.get("AUTOMATION_MODEL") or None
+try:
+    llm = workspace.get_llm(profile_name=model_profile)
+except FileNotFoundError:
+    # The profile was renamed or deleted after the automation was created;
+    # fall back to the user's default LLM rather than failing the run.
+    if not model_profile:
+        raise
+    print(f"profile {model_profile!r} not found; falling back to default profile")
+    llm = workspace.get_llm()
+```
+
+Calling `workspace.get_llm()` with no `profile_name` always uses the user's default LLM. The built-in prompt and plugin presets already follow the pattern above; custom scripts should too so the selected profile is honored regardless of trigger type or execution backend.
+
 ### Conversation Persistence
 
 Conversations started during a run remain accessible in the OpenHands UI after the run completes — users can view the history and continue interacting. By default, `Conversation` does not delete the conversation on close:

openhands_extensions-0.9.0/plugins/openhands/skills/openhands-automation/references/windows.md

@@ -0,0 +1,57 @@
+# Windows Notes for OpenHands Automation Commands
+
+Use these PowerShell forms when running the automation API examples natively on Windows.
+
+## Set the API Host
+
+`OPENHANDS_HOST` is a shell convention in this skill. In PowerShell, set it as:
+
+```powershell
+$env:OPENHANDS_HOST = "https://app.all-hands.dev"
+```
+
+## Authentication Header
+
+```powershell
+$headers = @{
+  Authorization = "Bearer $env:OPENHANDS_API_KEY"
+  "Content-Type" = "application/json"
+}
+```
+
+## Prompt Preset Request
+
+```powershell
+$body = @{
+  name = "My Automation Name"
+  prompt = "What the automation should do"
+  trigger = @{
+    type = "cron"
+    schedule = "0 9 * * *"
+    timezone = "UTC"
+  }
+} | ConvertTo-Json -Depth 20
+
+Invoke-RestMethod `
+  -Uri "$env:OPENHANDS_HOST/api/automation/v1/preset/prompt" `
+  -Method Post `
+  -Headers $headers `
+  -Body $body
+```
+
+## Curl Examples
+
+If copying an existing `curl` snippet, call `curl.exe`, replace `${OPENHANDS_HOST}` with `$env:OPENHANDS_HOST`, and replace `${OPENHANDS_API_KEY}` with `$env:OPENHANDS_API_KEY`.
+
+```powershell
+curl.exe "$env:OPENHANDS_HOST/api/automation/v1?limit=20" `
+  -H "Authorization: Bearer $env:OPENHANDS_API_KEY"
+```
+
+## Packaging Custom Automations
+
+Modern Windows includes `tar.exe`, which can create the `.tar.gz` files expected by the upload API:
+
+```powershell
+tar.exe -czf $tarball -C $buildDir .
+```