@openhands/extensions 0.8.0 → 0.9.0

package/skills/research-brief/SKILL.md

@@ -87,6 +87,8 @@ curl -s -X POST "${OPENHANDS_HOST}/api/automation/v1/preset/prompt" \
   }'
 ```
 
+PowerShell note: use `curl.exe` for this exact flag syntax, and replace `${OPENHANDS_HOST}` / `$OPENHANDS_AUTOMATION_API_KEY` with `$env:OPENHANDS_HOST` / `$env:OPENHANDS_AUTOMATION_API_KEY` if running it natively.
+
 ### Step 5 — Confirm
 
 Tell the user:

package/skills/skill-creator/SKILL.md

@@ -6,6 +6,7 @@ description: This skill should be used when the user wants to "create a skill",
 # Skill Creator
 
 This skill provides guidance for creating effective skills.
+Windows PowerShell equivalents for the Unix shell commands used in examples are in `references/windows.md`.
 
 ## About Skills
 

package/skills/skill-creator/references/windows.md

@@ -0,0 +1,30 @@
+# Windows Notes for Skill Creation Commands
+
+Use these PowerShell equivalents for the Unix shell examples in this skill.
+
+## Create a Skill Directory
+
+```powershell
+New-Item -ItemType Directory -Force skill-name\references,skill-name\scripts,skill-name\assets | Out-Null
+New-Item -ItemType File -Force skill-name\SKILL.md | Out-Null
+```
+
+## Run Helper Scripts
+
+Use `python` if `python3` is not available:
+
+```powershell
+python scripts\init_skill.py <skill-name> --path <output-directory>
+python scripts\quick_validate.py <path\to\skill-folder>
+```
+
+## Search and Extract Text
+
+PowerShell alternatives for common Unix text tools:
+
+```powershell
+Select-String -Path SKILL.md -Pattern "^name:"
+Get-Content SKILL.md | Select-Object -First 20
+```
+
+If a repository already provides `rg`, prefer it for recursive searches because it works well on Windows too.

package/skills/slack-channel-monitor/SKILL.md

@@ -15,6 +15,7 @@ triggers:
 # Slack Channel Monitor
 
 Create a cron automation that polls up to 10 Slack channels every minute.
+Windows PowerShell equivalents for the setup, packaging, upload, and API-check shell snippets are in `references/windows.md`.
 When a message containing the **trigger phrase** (default: `@openhands`) is
 detected it:
 

package/skills/slack-channel-monitor/references/windows.md

@@ -0,0 +1,64 @@
+# Windows Notes for Slack Channel Monitor Setup
+
+Use these PowerShell forms when creating the Slack monitor automation from Windows.
+
+## Validate Slack Tokens
+
+```powershell
+curl.exe -s https://slack.com/api/auth.test `
+  -H "Authorization: Bearer $env:SLACK_BOT_TOKEN" |
+  python -c "import json,sys; d=json.load(sys.stdin); print('ok' if d.get('ok') else d.get('error'))"
+```
+
+For a user token, replace `$env:SLACK_BOT_TOKEN` with `$env:SLACK_USER_TOKEN`.
+
+## Build Directory, Syntax Check, and Integrity Check
+
+```powershell
+$buildDir = Join-Path $env:TEMP "slack-monitor-build"
+New-Item -ItemType Directory -Force $buildDir | Out-Null
+$main = Join-Path $buildDir "main.py"
+# copy scripts/main.py to $main, then replace only the configuration constants
+
+python -m py_compile $main
+Select-String -Path $main -Pattern 'TRIGGER_PHRASE = "'
+Select-String -Path $main -Pattern 'CHANNEL_IDS: list\[str\] ='
+Select-String -Path $main -Pattern 'DEFAULT_OPENHANDS_URL = "'
+Select-String -Path $main -Pattern 'def get_secret'
+Select-String -Path $main -Pattern 'def _state_file_path'
+Select-String -Path $main -Pattern 'def create_conversation'
+```
+
+## Package and Upload
+
+```powershell
+$tarball = Join-Path $env:TEMP "slack-monitor.tar.gz"
+tar.exe -czf $tarball -C $buildDir .
+
+$upload = curl.exe -s -X POST `
+  "$env:OPENHANDS_HOST/api/automation/v1/uploads?name=slack-channel-monitor" `
+  -H "X-Session-API-Key: $env:OPENHANDS_AUTOMATION_API_KEY" `
+  -H "Content-Type: application/gzip" `
+  --data-binary "@$tarball" | ConvertFrom-Json
+
+$tarballPath = $upload.tarball_path
+```
+
+## Create the Automation
+
+```powershell
+$body = @"
+{
+  "name": "Slack Channel Monitor",
+  "trigger": {"type": "cron", "schedule": "* * * * *"},
+  "tarball_path": "$tarballPath",
+  "entrypoint": "python3 main.py",
+  "timeout": 55
+}
+"@
+
+curl.exe -s -X POST "$env:OPENHANDS_HOST/api/automation/v1" `
+  -H "X-Session-API-Key: $env:OPENHANDS_AUTOMATION_API_KEY" `
+  -H "Content-Type: application/json" `
+  -d $body
+```

package/skills/slack-standup-digest/SKILL.md

@@ -80,6 +80,8 @@ curl -s -X POST "${OPENHANDS_HOST}/api/automation/v1/preset/prompt" \
   }'
 ```
 
+PowerShell note: use `curl.exe` for this exact flag syntax, and replace `${OPENHANDS_HOST}` / `$OPENHANDS_AUTOMATION_API_KEY` with `$env:OPENHANDS_HOST` / `$env:OPENHANDS_AUTOMATION_API_KEY` if running it natively.
+
 ### Step 5 — Confirm
 
 Tell the user:

package/skills/spark-version-upgrade/SKILL.md

@@ -44,6 +44,7 @@ https://spark.apache.org/docs/latest/migration-guide.html
 - [ ] Identify target Spark version
 - [ ] Search for deprecated APIs: `grep -rn 'import org.apache.spark' --include='*.scala' --include='*.java' --include='*.py'`
 - [ ] List all Spark config properties: `grep -rn 'spark\.' --include='*.conf' --include='*.properties' --include='*.scala' --include='*.java' --include='*.py' | grep -v 'test'`
+- [ ] On Windows PowerShell, use `Get-ChildItem -Recurse -Include *.scala,*.java,*.py | Select-String 'import org.apache.spark'` and adjust the extensions/pattern for config searches.
 - [ ] Check for custom `SparkSession` or `SparkContext` extensions
 - [ ] Identify connector dependencies (Hive, Kafka, Cassandra, Delta, Iceberg)
 - [ ] Document findings in `spark_upgrade_impact.md`
@@ -230,4 +231,4 @@ Spark SQL behavior changes between versions can silently alter query results.
 ✓ No removed APIs remain in code
 ✓ Configuration properties are current
 ✓ SQL queries produce correct results
-✓ Upgrade impact documented in `spark_upgrade_impact.md`
+✓ Upgrade impact documented in `spark_upgrade_impact.md`

package/skills/ssh/SKILL.md

@@ -14,6 +14,7 @@ triggers:
 # SSH Skill
 
 This skill provides capabilities for establishing and managing SSH connections to remote machines.
+Windows PowerShell equivalents for SSH config creation, key paths, ssh-agent, and permissions are in `references/windows.md`.
 
 ## Capabilities
 
@@ -132,4 +133,4 @@ chmod 600 ~/.ssh/id_ed25519
 chmod 644 ~/.ssh/id_ed25519.pub
 # Set correct permissions for SSH directory
 chmod 700 ~/.ssh
-```
+```

package/skills/ssh/references/windows.md

@@ -0,0 +1,59 @@
+# Windows Notes for SSH Commands
+
+Windows includes OpenSSH Client on current Windows versions. Use these PowerShell forms for Windows-native setup.
+
+## Key Paths
+
+Use the Windows profile path:
+
+```powershell
+$sshDir = Join-Path $env:USERPROFILE ".ssh"
+New-Item -ItemType Directory -Force $sshDir | Out-Null
+```
+
+## Generate and Use a Key
+
+```powershell
+$key = Join-Path $sshDir "key_name"
+ssh-keygen -t ed25519 -f $key -C "comment" -N ""
+ssh -i $key username@hostname
+```
+
+## Create SSH Config
+
+```powershell
+$config = Join-Path $sshDir "config"
+@'
+Host alias
+    HostName hostname_or_ip
+    User username
+    IdentityFile ~/.ssh/key_name
+    Port 22
+    ServerAliveInterval 60
+'@ | Set-Content -LiteralPath $config -Encoding ascii
+```
+
+## Start ssh-agent
+
+```powershell
+Set-Service ssh-agent -StartupType Automatic
+Start-Service ssh-agent
+ssh-add $key
+```
+
+## Permissions
+
+POSIX `chmod 600` does not apply to Windows filesystems. Restrict private-key ACLs with `icacls`:
+
+```powershell
+icacls $key /inheritance:r
+icacls $key /grant:r "${env:USERNAME}:R"
+```
+
+## Copy a Public Key
+
+`ssh-copy-id` is usually not installed on Windows. For Unix-like remotes, append the key with SSH:
+
+```powershell
+Get-Content "$key.pub" | ssh username@hostname "mkdir -p ~/.ssh && cat >> ~/.ssh/authorized_keys"
+```

package/skills/swift-linux/SKILL.md

@@ -12,6 +12,7 @@ triggers:
 This document provides instructions for installing Swift on Debian 12 (Bookworm).
 
 > This setup is intended for non-UI development tasks on Swift on Linux.
+> On Windows, run these Debian commands inside WSL2 or a Linux container. For native Windows Swift, use the Windows toolchain from Swift.org instead.
 
 ## Prerequisites
 
@@ -78,4 +79,4 @@ Verify that Swift is correctly installed by running:
 
 ```bash
 swift --version
-```
+```

package/skills/vercel/SKILL.md

@@ -40,6 +40,11 @@ To allow agents and automated systems to access protected deployments, users nee
    ```bash
    curl -H "x-vercel-protection-bypass: <secret>" https://your-preview-url.vercel.app
    ```
+
+   PowerShell equivalent:
+   ```powershell
+   Invoke-WebRequest -Headers @{ "x-vercel-protection-bypass" = "<secret>" } -Uri https://your-preview-url.vercel.app
+   ```
    
    **As a Query Parameter:**
    ```

package/tests/test_catalogs.py

@@ -79,9 +79,14 @@ def test_remote_no_auth_mcp_entries_are_intentionally_public():
     for entry in load_catalog_entries("integrations/catalog"):
         for option in entry["connectionOptions"]:
             transport = option.get("transport", {})
+            # An option with `headerFields` still requires the user to supply
+            # credentials (just via named headers, e.g. Datadog's
+            # DD-API-KEY/DD-APPLICATION-KEY), so it is NOT "public/no-auth".
+            has_header_credentials = bool(transport.get("headerFields"))
             if (
                 option["provider"] == "mcp"
                 and option["auth"]["strategy"] == "none"
+                and not has_header_credentials
                 and transport.get("url", "").startswith("https://")
             ):
                 actual.add(entry["id"])
@@ -98,7 +103,7 @@ def test_credential_fields_have_helper_text_and_link():
     for entry in load_catalog_entries("integrations/catalog"):
         for option in entry["connectionOptions"]:
             transport = option.get("transport", {})
-            for field_group in ("envFields", "argFields"):
+            for field_group in ("envFields", "argFields", "headerFields"):
                 for field in transport.get(field_group, []):
                     if field.get("type") == "password":
                         field_key = field.get("key", "<unknown>")