openhands-extensions 0.6.0__py3-none-any.whl

openhands_extensions/catalog/xero.json

@@ -0,0 +1,38 @@
+{
+  "id": "xero",
+  "name": "Xero",
+  "description": "Accounting, contacts, invoices, and bookkeeping workflows.",
+  "categories": [
+    "Finance",
+    "Accounting"
+  ],
+  "appUrl": "https://www.xero.com",
+  "docsUrl": "https://developer.xero.com/documentation/guides/oauth2/overview/",
+  "notes": "Important accounting platform in many regions.",
+  "popularityRank": 48,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://login.xero.com/identity/connect/authorize",
+          "tokenUrl": "https://identity.xero.com/connect/token",
+          "scopes": [
+            "accounting.contacts.read"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.xero.com/api.xro/2.0",
+        "defaultTool": {
+          "name": "list_contacts",
+          "description": "List Xero contacts for the connected tenant.",
+          "method": "GET",
+          "path": "/Contacts"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/catalog/zendesk.json

@@ -0,0 +1,38 @@
+{
+  "id": "zendesk",
+  "name": "Zendesk",
+  "description": "Support tickets, customers, agents, and help desk operations.",
+  "categories": [
+    "Support",
+    "Operations"
+  ],
+  "appUrl": "https://www.zendesk.com",
+  "docsUrl": "https://developer.zendesk.com/documentation/apps/getting-started/oauth/",
+  "notes": "Strong support automation use case for agents.",
+  "popularityRank": 26,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://{subdomain}.zendesk.com/oauth2/authorize",
+          "tokenUrl": "https://{subdomain}.zendesk.com/oauth2/token",
+          "scopes": [
+            "tickets:read"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://{subdomain}.zendesk.com/api/v2",
+        "defaultTool": {
+          "name": "list_tickets",
+          "description": "List Zendesk tickets for the connected account.",
+          "method": "GET",
+          "path": "/tickets"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/catalog/zoom.json

@@ -0,0 +1,38 @@
+{
+  "id": "zoom",
+  "name": "Zoom",
+  "description": "Meetings, recordings, webinars, and scheduling operations.",
+  "categories": [
+    "Meetings",
+    "Calendar"
+  ],
+  "appUrl": "https://zoom.us",
+  "docsUrl": "https://developers.zoom.us/docs/integrations/oauth/",
+  "notes": "Frequently requested for scheduling and meeting summaries.",
+  "popularityRank": 31,
+  "connectionOptions": [
+    {
+      "id": "oauth",
+      "provider": "http",
+      "auth": {
+        "strategy": "oauth2",
+        "oauth": {
+          "authorizationUrl": "https://zoom.us/oauth/authorize",
+          "tokenUrl": "https://zoom.us/oauth/token",
+          "scopes": [
+            "meeting:read:user"
+          ]
+        }
+      },
+      "http": {
+        "apiBaseUrl": "https://api.zoom.us/v2",
+        "defaultTool": {
+          "name": "list_meetings",
+          "description": "List Zoom meetings for the connected user.",
+          "method": "GET",
+          "path": "/users/me/meetings"
+        }
+      }
+    }
+  ]
+}

openhands_extensions/integrations.py

@@ -0,0 +1,92 @@
+"""Python bindings for the OpenHands extensions integration catalog.
+
+The source of truth is the hand-authored ``integrations/catalog/<id>.json``
+directory. Wheels include those individual JSON files directly; no aggregate
+catalog JSON is authored or packaged.
+"""
+
+from __future__ import annotations
+
+import copy
+import json
+from functools import lru_cache
+from importlib import resources
+from pathlib import Path
+from typing import Any, Iterable
+
+__all__ = [
+    "INTEGRATION_CATALOG_SNAPSHOT",
+    "get_integration_catalog_entry",
+    "list_integration_catalog",
+]
+
+
+def _repo_catalog_dir() -> Path:
+    return Path(__file__).resolve().parents[2] / "integrations" / "catalog"
+
+
+def _catalog_files() -> Iterable[Any]:
+    packaged = resources.files(__package__).joinpath("catalog")
+    if packaged.is_dir():
+        return sorted(
+            (path for path in packaged.iterdir() if path.name.endswith(".json")),
+            key=lambda path: path.name,
+        )
+
+    repo_catalog = _repo_catalog_dir()
+    return sorted(repo_catalog.glob("*.json"), key=lambda path: path.name)
+
+
+def _read_json(path: Any) -> dict[str, Any]:
+    return json.loads(path.read_text(encoding="utf-8"))
+
+
+@lru_cache(maxsize=1)
+def _integrations() -> tuple[dict[str, Any], ...]:
+    entries = [_read_json(path) for path in _catalog_files()]
+    entries.sort(
+        key=lambda entry: (-(entry.get("popularityRank") if entry.get("popularityRank") is not None else -1), entry["id"]),
+    )
+    return tuple(entries)
+
+
+@lru_cache(maxsize=1)
+def _integration_by_id() -> dict[str, dict[str, Any]]:
+    return {entry["id"]: entry for entry in _integrations()}
+
+
+def _entry_supports_mcp(entry: dict[str, Any]) -> bool:
+    return any(option.get("provider") == "mcp" for option in entry.get("connectionOptions", []))
+
+
+def _entry_supports_oauth(entry: dict[str, Any]) -> bool:
+    return any(
+        option.get("auth", {}).get("strategy") == "oauth2"
+        for option in entry.get("connectionOptions", [])
+    )
+
+
+def list_integration_catalog(
+    mcp: bool | None = None,
+    oauth: bool | None = None,
+) -> list[dict[str, Any]]:
+    """Return the integration catalog, optionally filtered by connector type."""
+    result = []
+    for entry in _integrations():
+        if mcp is not None and _entry_supports_mcp(entry) != mcp:
+            continue
+        if oauth is not None and _entry_supports_oauth(entry) != oauth:
+            continue
+        result.append(copy.deepcopy(entry))
+    return result
+
+
+def get_integration_catalog_entry(id: str) -> dict[str, Any] | None:
+    """Return one integration catalog entry by id, or ``None``."""
+    entry = _integration_by_id().get(id)
+    return copy.deepcopy(entry) if entry is not None else None
+
+
+INTEGRATION_CATALOG_SNAPSHOT: dict[str, Any] = {
+    "integrations": copy.deepcopy(list(_integrations()))
+}

openhands_extensions-0.6.0.dist-info/METADATA

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

openhands_extensions-0.6.0.dist-info/RECORD

@@ -0,0 +1,89 @@
+openhands_extensions/__init__.py,sha256=ZcVnActJ2Ei00yM4229biMiQz8xT32ecI6t8QnOZ1Mk,766
+openhands_extensions/_version.py,sha256=uWuNVUvPYX6waOG_hjYT1W80DByJWWUNbjjP-JGC8Jw,1097
+openhands_extensions/integrations.py,sha256=Ku8NZ-nPhD_hvmStAl0CCzTCP3IrpTJmqc5meeUwx2g,2831
+openhands_extensions/catalog/airtable.json,sha256=QHWxHYIQ7m0ig2NIIkIwpEUGY2tIrmyajkEWF-eV5p4,1961
+openhands_extensions/catalog/apify.json,sha256=2CmGG2q-83_iP2o2SPdGebUwcNQT_kRAmZ-6tF3cZYc,979
+openhands_extensions/catalog/asana.json,sha256=IUXGS7M4Ygs2cjghsmxE_8OlOftvp11t0lKKHL_H6GY,1001
+openhands_extensions/catalog/atlassian.json,sha256=hn5l3Dyj7D2L0itFvC_OsObwKyGbQ7nxZJHNjBs9_Nw,652
+openhands_extensions/catalog/bitbucket.json,sha256=T33fQn837m-uMh65NXEdtaO1U8XOxCNzjukbfywU_3g,1097
+openhands_extensions/catalog/box.json,sha256=7NJPD1ZV_zn9l1zxw17_FRO5D62jViHJTdVeZuFLD-A,1038
+openhands_extensions/catalog/brave-search.json,sha256=0wQOCaj3wUp9MvMfEQGJUeI-LGSzbqZJmWq3uuCvV_Y,1057
+openhands_extensions/catalog/browser-mcp.json,sha256=XmzgeROJA0bpfVpe5NOdZ0ryNs8iE1m5QcNmut5x3aE,627
+openhands_extensions/catalog/canva.json,sha256=djf9ZriDWiLi8WjPomZdkZcKif1Wq3QvIqC0r8TIbNg,918
+openhands_extensions/catalog/clickhouse.json,sha256=0Yjt8OfnWNXJcrqrencHExlE-R4n45WSlTefzJwJIK4,1396
+openhands_extensions/catalog/clickup.json,sha256=-LVVQ2WbQOFmJte3F00cTd7fDwBVKyDOtfrnDrzLY3o,984
+openhands_extensions/catalog/cloudflare-bindings.json,sha256=8FlIvMvahUsvTSWUXUCSfUho6uaJnBMG5Uoka8JmETE,707
+openhands_extensions/catalog/cloudflare-browser-rendering.json,sha256=oa1Kx9h487YF3WFxtMWjaN9nIU5iKdDBxG5CJhQZhd4,684
+openhands_extensions/catalog/cloudflare-builds.json,sha256=ndEqdjOhs4LLP6WF4yoOiX0VJx2EmmnRpyw2gd8MCI4,664
+openhands_extensions/catalog/cloudflare-docs.json,sha256=04xEnikJiZHbBvgzdSpMn7SFelxELrEfADT2FZIS_mA,656
+openhands_extensions/catalog/cloudflare-observability.json,sha256=l03AWGXeWzCOs0W-XAPOwszD-_mw4dZwtNR41forHnM,696
+openhands_extensions/catalog/confluence.json,sha256=GqihpUHynM-yhxIHZ_43x6bAmbU84fT7qMEt83ZqJhw,1111
+openhands_extensions/catalog/datadog.json,sha256=1Zo2A2r1raEy3NFeoZNAqDuNPTOMgfdl3JFImkJo9nk,1009
+openhands_extensions/catalog/deepwiki.json,sha256=gqb13coybeSrICJnzKeAlzqz37JLKKx_NvvBEqMYhHo,584
+openhands_extensions/catalog/discord.json,sha256=oWcJ8YKHKs6LTsM0CH6nceos4NDZJ0_F7sIEkI-1fyo,1051
+openhands_extensions/catalog/dropbox.json,sha256=PuLjt2XH4KjIMBzKNn8ligVdnXW_jHCRh_qRyBYBOKg,1029
+openhands_extensions/catalog/elevenlabs.json,sha256=UlL-ecKXEZOvGLZsszGZJGRhjTMlVC2KcDUODaxPm8g,1152
+openhands_extensions/catalog/everything.json,sha256=LsX_EmtvCeJF2xZXKhlmaJWBviw-8dReAk70WcCrGMU,673
+openhands_extensions/catalog/exa.json,sha256=S9kSKdfHkiXXPpf2FHnV8cjv8w7JaB1FuzlysGA4rj8,948
+openhands_extensions/catalog/fetch.json,sha256=Ntds0HP0suD3B4Z8a0xDlTEtvh3apNiqBRK8Xu_SnHo,635
+openhands_extensions/catalog/figma.json,sha256=IB6KH0czQ6eW3VAA3swzNeOelvPBiz3zxpuwrTKEWTY,1927
+openhands_extensions/catalog/filesystem.json,sha256=8fOvDkWCS6zoB2prciFtX06UZy3omMMjJA_KLJN_Xxw,1136
+openhands_extensions/catalog/firecrawl.json,sha256=dunaqBnyafoG0Iezluet8-KXHNDE7DP0F5GI2g5UMMk,951
+openhands_extensions/catalog/freshdesk.json,sha256=UAKdJ482iIfL4f225jiCTD5GhXrhofrPzXwqy4beP2c,1069
+openhands_extensions/catalog/git.json,sha256=FVl1qinZkgMMK4kTw3qTY8EcM1SRJC1EL_mm2mbpEzs,1031
+openhands_extensions/catalog/github.json,sha256=1wj36JjEEMvAqJP1gMJg8ZFqqLEm_Fm0-yRt63rjTgU,1949
+openhands_extensions/catalog/gitlab.json,sha256=KdGZY_9J8UENQHTCBBM6Pb3a1JODY3UF-9WlEwWvwnY,1026
+openhands_extensions/catalog/gmail.json,sha256=IrLXcdPDzGfvP4MeKoQlf8LQKD18AShQbzk8dbuZmdE,1105
+openhands_extensions/catalog/google-calendar.json,sha256=t8GyT8ZRiMjeDUCUGItBDkiy9Qs9T2YFL6XIpltgdhw,1151
+openhands_extensions/catalog/google-docs.json,sha256=2FFZoG2aV9cc_4z_2HHFjJp31fl8E_3EExBaU4jyQfw,1173
+openhands_extensions/catalog/google-drive.json,sha256=8nX7n0vtAohUo5aItpFvoSwrVM_WJ760uK8cEH_CzlA,1120
+openhands_extensions/catalog/google-sheets.json,sha256=Nvoz9Ra6FHn9FqXgoK05KiCfpymNpSou85OaAKtXJOE,1163
+openhands_extensions/catalog/hubspot.json,sha256=49B_fh-bBrfnDrzwbxM_re5Z89euI5HU6PwP3hEJDCk,1159
+openhands_extensions/catalog/huggingface.json,sha256=LxlISfUCQJA_ANo3KixFYvypDHI-ERCkpNqPgAEe_LY,717
+openhands_extensions/catalog/intercom.json,sha256=kSJx4Mpzd0TcxxTQhzkracOEw0LVxdq1lYqPyNv85tc,1062
+openhands_extensions/catalog/jira.json,sha256=CoJ8EQ7gb2imBSisROYsSEB0RZq7B_ENubZkxXIAwIw,1125
+openhands_extensions/catalog/kagi.json,sha256=l34-PvmnnY7L1IZffqRzKJpNcw_3ZPyx4YrZdJHb0_A,999
+openhands_extensions/catalog/linear.json,sha256=eN-g1yUtNpRe47uuF0fctmeWZrRpQ3-tvK99l1O01us,1896
+openhands_extensions/catalog/mailchimp.json,sha256=YhHeaoQhxULfs1RzJfejPKkUnosZHmmW40cOk-lxKig,1047
+openhands_extensions/catalog/memory.json,sha256=CFeIWPcdF0Le33ak4aZxvnHJyhg1dpCmXaZuM3s76sk,652
+openhands_extensions/catalog/microsoft-outlook.json,sha256=TUQGVWjCk_7ufL734S7dlg8Nk-Td5Ooxu_Jen7hoVOg,1183
+openhands_extensions/catalog/microsoft-teams.json,sha256=Jkw1pKMml8F2ZboUGjimmetgM1Mqlu2BPfSuQPokIrs,1144
+openhands_extensions/catalog/miro.json,sha256=1cFpsijiwxyIjMCVzd0vRBlQ3Qhjew3NFpf_Rz9XCtA,1030
+openhands_extensions/catalog/monday.json,sha256=mp0XF_2dTrVuxsqIajlfJp90dMCtzQ4ss526cROXzG0,993
+openhands_extensions/catalog/mongodb.json,sha256=H_Dp8U7O4fF2mzJaM4tSblJx4tvzClNRdOI-OCdFe94,1168
+openhands_extensions/catalog/neon.json,sha256=j3XUAn-uRdjIWc0BTKTQxTFqe0AjEqGf_MU6fRMj0Yw,999
+openhands_extensions/catalog/netlify.json,sha256=pgWcnxIKu-3RdLO54fZxt67zcK2TZJAdMZX1b56Nahg,1030
+openhands_extensions/catalog/notion.json,sha256=OnilF9vBOd51a3ETXcTP6sJFmdHzt6quliTnxnt7iow,1926
+openhands_extensions/catalog/obsidian.json,sha256=gBws4Nn__qk6wmlHmUboVPTYE50Vfn1_hfUp_vxJ4Ts,1043
+openhands_extensions/catalog/okta.json,sha256=NUOEPYEXb9qyZUmad4UmsFnH-6bpaNLhQYVa4CvyiEg,1031
+openhands_extensions/catalog/onedrive.json,sha256=67jjGlkyhIiRnS18krYFFFcHAfU_GCI2N9mm2Q8MqTo,1127
+openhands_extensions/catalog/ordinal.json,sha256=OwOpA_nyyeXg1qSBQ2IuhKKAIMDKlwIyn-fmUpde5tk,993
+openhands_extensions/catalog/paypal.json,sha256=xvUHBSP3MxKT0w3rpWtrHYnP2wr9iUnSFOz21a9Ushs,574
+openhands_extensions/catalog/pipedrive.json,sha256=OPxmKfvjobWhWtzCvKBiLTivbB6vxm0lq-msgOs2qzQ,1050
+openhands_extensions/catalog/plaid.json,sha256=sxGlo1QSYzsIY6gWkLIIUGgFfwfJth4uoUTkEU9WBos,877
+openhands_extensions/catalog/playwright.json,sha256=EMYiNG6G7ycmzC87ZEEwr3IgOPxg7v5CD-X0xmBKV_8,632
+openhands_extensions/catalog/posthog.json,sha256=sL2ymI8QqVo-9tbx4dDIJmPHIMWX7HsMST5IsUpPVzY,1019
+openhands_extensions/catalog/quickbooks.json,sha256=6zOBpBF5ui0_pdsSaXUsFaXgfwvnaGPLSGegLFfn9HU,1232
+openhands_extensions/catalog/redis.json,sha256=YHhFcd7X3n0M56cG3lW_l-E8nt1C6J8Ar3Y5H3Vs7lA,1134
+openhands_extensions/catalog/resend.json,sha256=_Tu2hx-gzJRVVuFG7mH53iB81kvyRbf-ylBQ3AOyEcE,1176
+openhands_extensions/catalog/salesforce.json,sha256=cpX4BPOPLcs-Wuu0UTJeyBsxxT32MoZcpeLI-d2a8PQ,1121
+openhands_extensions/catalog/sentry.json,sha256=JKmTqrUHL6nuWO_BpnqGxIUlOGwZjMxgbOZ19PoHcxI,1724
+openhands_extensions/catalog/sequential-thinking.json,sha256=5uV8gIgzPTEhV-0hy2dX4ZHTtlWUkB6yrcPhBoCIrjA,721
+openhands_extensions/catalog/servicenow.json,sha256=rr_J6oqUXi2GEOMylZrmRoflr2FHmxEpm558cEyWl9Y,1166
+openhands_extensions/catalog/sharepoint.json,sha256=B8D-XN7K0S5wFOcw0dGj0xCRCYd5cKFGRWmKPQcp4Us,1136
+openhands_extensions/catalog/shopify.json,sha256=qnelkb5PUdryPvFZ1ODZPL57XNvpD83_hlSOriiAdLA,1126
+openhands_extensions/catalog/slack.json,sha256=oaYIZQdIS41aG6n9h6tZLD0oo8molPnanwAcoyp28KE,2808
+openhands_extensions/catalog/stripe.json,sha256=BYhH3dmGpvkNanEjDqg0J5OLy3hQqe1QKWd4CyvkVUk,1603
+openhands_extensions/catalog/supabase.json,sha256=tvbYFAiNgE_UxsXXcTuUc1n564Po5mCdrudpJqG2DDU,1931
+openhands_extensions/catalog/tavily.json,sha256=WsCcxzbNonqexNSbbyep7DkLmS1p3SmzgpKZpyMYXuo,1095
+openhands_extensions/catalog/time.json,sha256=0bKrZ1D6KbuIIAgjCCwta8NKs_ZNtKyxtGkGiyuZbrQ,607
+openhands_extensions/catalog/trello.json,sha256=QJnpvvXRIx3ntU-ZrJfMzPzoYaVQ8lgETSGzGi8MlP0,944
+openhands_extensions/catalog/vercel.json,sha256=WRB_f449gzFBaYEoaOT0gU6E3BH1PD6Uv0uEDGhNH9g,1032
+openhands_extensions/catalog/webflow.json,sha256=nwqWIL79xCAz-U_EpvCjkm8ikqgGTc2c2R0_9lVxl6o,1022
+openhands_extensions/catalog/xero.json,sha256=u-5d5KYaqnHTAeW6Ws46IS_RumCx6xIZW2a4B2qR8lk,1049
+openhands_extensions/catalog/zendesk.json,sha256=ph50CkF_1KPSiSbKo3GDhj-HNyHO7PhlDhS_f8WhgR8,1067
+openhands_extensions/catalog/zoom.json,sha256=5DttG9HQvIl9GWq_pwbmFy1Rr4XqtAQPL1DAcv7FgWU,1002
+openhands_extensions-0.6.0.dist-info/METADATA,sha256=TmvNYY7UTHA8K9Km5GqE5SU5lQRjEznp42ThbWyxaIQ,207
+openhands_extensions-0.6.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+openhands_extensions-0.6.0.dist-info/licenses/LICENSE,sha256=_kJSSPxR0dGAWrFEK6it2Y13CtihMgUeqsjJPX7uPr4,1066
+openhands_extensions-0.6.0.dist-info/RECORD,,

openhands_extensions-0.6.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

openhands_extensions-0.6.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenHands
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.