rc-openhands-sdk 0.1.0__tar.gz

rc_openhands_sdk-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RingCentral AI Desk
+
+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.

rc_openhands_sdk-0.1.0/MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE NOTICE README.md PUBLISHING.md UPSTREAM.md
+recursive-include rc_openhands_sdk *.json
+recursive-include tests *.py

rc_openhands_sdk-0.1.0/NOTICE

@@ -0,0 +1,10 @@
+RcOpenHandsSDK wraps MIT-licensed OpenHands local CLI/SDK packages.
+
+Upstream packages:
+- openhands 1.16.0, MIT License, Copyright (c) 2025 All Hands AI
+- openhands-sdk 1.21.0, MIT License, OpenHands software-agent-sdk
+
+Excluded from this distribution:
+- OpenHands enterprise/ directory
+- Hosted OpenHands Cloud service code and deployment integrations
+- Any source or artifact whose license cannot be verified as MIT-compatible

rc_openhands_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: rc-openhands-sdk
+Version: 0.1.0
+Summary: RingCentral MIT-only OpenHands SDK distribution and CLI wrapper
+Author: RingCentral AI Desk
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk
+Project-URL: Source, https://github.com/OpenHands/software-agent-sdk/tree/v1.21.0
+Keywords: openhands,sdk,agent,cli,ringcentral
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.13,>=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: openhands==1.16.0
+Requires-Dist: openhands-sdk==1.21.0
+Dynamic: license-file
+
+# RcOpenHandsSDK
+
+RcOpenHandsSDK is AI Desk's MIT-only OpenHands distribution wrapper.
+It exposes stable RingCentral-owned CLI entry points while delegating to the
+upstream OpenHands CLI and SDK packages pinned below:
+
+- `openhands==1.16.0`
+- `openhands-sdk==1.21.0`
+
+The package intentionally excludes OpenHands Cloud and `enterprise/` code. It
+only depends on the upstream packages distributed under MIT-compatible terms for
+the local CLI/SDK replacement path used by AI Desk daemon verification.
+
+## Commands
+
+```bash
+rcopenhands --version
+rcopenhands-acp --help
+```
+
+AI Desk still uses the internal `openhands` agent type for compatibility with
+existing task/session payloads, but CLI detection now resolves that type to the
+`rcopenhands` command.

rc_openhands_sdk-0.1.0/PUBLISHING.md

@@ -0,0 +1,28 @@
+# Publishing
+
+Build artifacts:
+
+```bash
+uv build
+```
+
+Current local artifacts:
+
+- `dist/rc_openhands_sdk-0.1.0-py3-none-any.whl`
+- `dist/rc_openhands_sdk-0.1.0.tar.gz`
+
+Install from the local artifact:
+
+```bash
+uv venv --python 3.12 /private/tmp/aidesk-rcopenhands-sdk
+uv pip install --python /private/tmp/aidesk-rcopenhands-sdk/bin/python dist/rc_openhands_sdk-0.1.0-py3-none-any.whl
+```
+
+Remote publishing requires a configured package repository and credentials, for
+example `TWINE_USERNAME`/`TWINE_PASSWORD` or an equivalent Nexus/PyPI token:
+
+```bash
+uv publish --publish-url <repository-url> dist/*
+```
+
+Do not publish a build that includes `enterprise/` or hosted Cloud source.

rc_openhands_sdk-0.1.0/README.md

@@ -0,0 +1,23 @@
+# RcOpenHandsSDK
+
+RcOpenHandsSDK is AI Desk's MIT-only OpenHands distribution wrapper.
+It exposes stable RingCentral-owned CLI entry points while delegating to the
+upstream OpenHands CLI and SDK packages pinned below:
+
+- `openhands==1.16.0`
+- `openhands-sdk==1.21.0`
+
+The package intentionally excludes OpenHands Cloud and `enterprise/` code. It
+only depends on the upstream packages distributed under MIT-compatible terms for
+the local CLI/SDK replacement path used by AI Desk daemon verification.
+
+## Commands
+
+```bash
+rcopenhands --version
+rcopenhands-acp --help
+```
+
+AI Desk still uses the internal `openhands` agent type for compatibility with
+existing task/session payloads, but CLI detection now resolves that type to the
+`rcopenhands` command.

rc_openhands_sdk-0.1.0/UPSTREAM.md

@@ -0,0 +1,36 @@
+# Upstream Boundary
+
+RcOpenHandsSDK is the AI Desk distribution boundary for the local OpenHands
+replacement path.
+
+## Included
+
+- `openhands==1.16.0`
+- `openhands-sdk==1.21.0`
+- `openhands-tools==1.21.0`
+- `openhands-workspace==1.11.1`
+
+The package exposes RingCentral-owned commands:
+
+- `rcopenhands`
+- `rcopenhands-acp`
+
+AI Desk keeps the internal agent type as `openhands` for API compatibility, but
+daemon detection and execution must resolve that type to the `rcopenhands`
+command.
+
+## Excluded
+
+- `enterprise/`
+- hosted OpenHands Cloud flows
+- any source or artifact whose license cannot be verified for the local
+  MIT replacement scope
+
+## License Notes
+
+RcOpenHandsSDK itself is MIT. The upstream OpenHands CLI package metadata
+declares MIT. The SDK source boundary is tracked against the OpenHands
+`software-agent-sdk` MIT repository and tag used by the pinned package.
+
+Third-party transitive dependencies keep their own upstream licenses; they are
+not vendored into RcOpenHandsSDK.

rc_openhands_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "rc-openhands-sdk"
+version = "0.1.0"
+description = "RingCentral MIT-only OpenHands SDK distribution and CLI wrapper"
+readme = "README.md"
+requires-python = ">=3.12,<3.13"
+license = "MIT"
+license-files = ["LICENSE", "NOTICE"]
+authors = [
+  { name = "RingCentral AI Desk" }
+]
+keywords = ["openhands", "sdk", "agent", "cli", "ringcentral"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules"
+]
+dependencies = [
+  "openhands==1.16.0",
+  "openhands-sdk==1.21.0"
+]
+
+[project.scripts]
+rcopenhands = "rc_openhands_sdk.cli:main"
+rcopenhands-acp = "rc_openhands_sdk.acp:main"
+
+[project.urls]
+Homepage = "https://github.com/OpenHands/software-agent-sdk"
+Source = "https://github.com/OpenHands/software-agent-sdk/tree/v1.21.0"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["rc_openhands_sdk*"]
+
+[tool.setuptools.package-data]
+rc_openhands_sdk = ["MIT_ONLY_MANIFEST.json"]

rc_openhands_sdk-0.1.0/rc_openhands_sdk/MIT_ONLY_MANIFEST.json

@@ -0,0 +1,30 @@
+{
+  "package": "RcOpenHandsSDK",
+  "license": "MIT",
+  "version": "0.1.0",
+  "upstream": [
+    {
+      "name": "openhands",
+      "version": "1.16.0",
+      "license": "MIT",
+      "entry_points": [
+        "openhands_cli.entrypoint:main",
+        "openhands_cli.acp:main"
+      ],
+      "source": "https://github.com/OpenHands/OpenHands-CLI"
+    },
+    {
+      "name": "openhands-sdk",
+      "version": "1.21.0",
+      "license": "MIT",
+      "source": "https://github.com/OpenHands/software-agent-sdk/tree/v1.21.0"
+    }
+  ],
+  "excluded": [
+    "enterprise/",
+    "OpenHands Cloud hosted service integrations",
+    "Any artifact whose license cannot be verified as MIT-compatible"
+  ],
+  "ai_desk_agent_type": "openhands",
+  "ai_desk_command": "rcopenhands"
+}

rc_openhands_sdk-0.1.0/rc_openhands_sdk/__init__.py

@@ -0,0 +1,10 @@
+"""RcOpenHandsSDK package metadata."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("rc-openhands-sdk")
+except PackageNotFoundError:
+    __version__ = "0.1.0"
+
+__all__ = ["__version__"]

rc_openhands_sdk-0.1.0/rc_openhands_sdk/acp.py

@@ -0,0 +1,9 @@
+"""RingCentral-owned entry point for the OpenHands ACP bridge."""
+
+from __future__ import annotations
+
+
+def main() -> None:
+    from openhands_cli.acp import main as acp_main
+
+    acp_main()

rc_openhands_sdk-0.1.0/rc_openhands_sdk/cli.py

@@ -0,0 +1,26 @@
+"""RingCentral-owned entry point for the MIT-only OpenHands CLI path."""
+
+from __future__ import annotations
+
+import sys
+from importlib.metadata import PackageNotFoundError, version
+
+from rc_openhands_sdk import __version__
+
+
+def _package_version(package: str) -> str:
+    try:
+        return version(package)
+    except PackageNotFoundError:
+        return "unknown"
+
+
+def main() -> None:
+    if len(sys.argv) > 1 and sys.argv[1] in {"--version", "-v"}:
+        openhands_version = _package_version("openhands")
+        print(f"RcOpenHandsSDK {__version__} (OpenHands CLI {openhands_version})")
+        return
+
+    from openhands_cli.entrypoint import main as openhands_main
+
+    openhands_main()

rc_openhands_sdk-0.1.0/rc_openhands_sdk/license_guard.py

@@ -0,0 +1,12 @@
+"""Helpers for reading the MIT-only package manifest."""
+
+from __future__ import annotations
+
+import json
+from importlib import resources
+from typing import Any
+
+
+def load_manifest() -> dict[str, Any]:
+    data = resources.files(__package__).joinpath("MIT_ONLY_MANIFEST.json").read_text(encoding="utf-8")
+    return json.loads(data)

rc_openhands_sdk-0.1.0/rc_openhands_sdk.egg-info/PKG-INFO

@@ -0,0 +1,44 @@
+Metadata-Version: 2.4
+Name: rc-openhands-sdk
+Version: 0.1.0
+Summary: RingCentral MIT-only OpenHands SDK distribution and CLI wrapper
+Author: RingCentral AI Desk
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/OpenHands/software-agent-sdk
+Project-URL: Source, https://github.com/OpenHands/software-agent-sdk/tree/v1.21.0
+Keywords: openhands,sdk,agent,cli,ringcentral
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: <3.13,>=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: openhands==1.16.0
+Requires-Dist: openhands-sdk==1.21.0
+Dynamic: license-file
+
+# RcOpenHandsSDK
+
+RcOpenHandsSDK is AI Desk's MIT-only OpenHands distribution wrapper.
+It exposes stable RingCentral-owned CLI entry points while delegating to the
+upstream OpenHands CLI and SDK packages pinned below:
+
+- `openhands==1.16.0`
+- `openhands-sdk==1.21.0`
+
+The package intentionally excludes OpenHands Cloud and `enterprise/` code. It
+only depends on the upstream packages distributed under MIT-compatible terms for
+the local CLI/SDK replacement path used by AI Desk daemon verification.
+
+## Commands
+
+```bash
+rcopenhands --version
+rcopenhands-acp --help
+```
+
+AI Desk still uses the internal `openhands` agent type for compatibility with
+existing task/session payloads, but CLI detection now resolves that type to the
+`rcopenhands` command.

rc_openhands_sdk-0.1.0/rc_openhands_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,19 @@
+LICENSE
+MANIFEST.in
+NOTICE
+PUBLISHING.md
+README.md
+UPSTREAM.md
+pyproject.toml
+rc_openhands_sdk/MIT_ONLY_MANIFEST.json
+rc_openhands_sdk/__init__.py
+rc_openhands_sdk/acp.py
+rc_openhands_sdk/cli.py
+rc_openhands_sdk/license_guard.py
+rc_openhands_sdk.egg-info/PKG-INFO
+rc_openhands_sdk.egg-info/SOURCES.txt
+rc_openhands_sdk.egg-info/dependency_links.txt
+rc_openhands_sdk.egg-info/entry_points.txt
+rc_openhands_sdk.egg-info/requires.txt
+rc_openhands_sdk.egg-info/top_level.txt
+tests/test_cli_wrappers.py

rc_openhands_sdk-0.1.0/rc_openhands_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

rc_openhands_sdk-0.1.0/rc_openhands_sdk.egg-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+rcopenhands = rc_openhands_sdk.cli:main
+rcopenhands-acp = rc_openhands_sdk.acp:main

rc_openhands_sdk-0.1.0/rc_openhands_sdk.egg-info/requires.txt

@@ -0,0 +1,2 @@
+openhands==1.16.0
+openhands-sdk==1.21.0

rc_openhands_sdk-0.1.0/rc_openhands_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+rc_openhands_sdk

rc_openhands_sdk-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

rc_openhands_sdk-0.1.0/tests/test_cli_wrappers.py

@@ -0,0 +1,59 @@
+import sys
+from types import ModuleType
+
+from rc_openhands_sdk import __version__
+from rc_openhands_sdk import acp, cli
+from rc_openhands_sdk.license_guard import load_manifest
+
+
+def test_version_is_available() -> None:
+    assert __version__
+
+
+def test_manifest_is_mit_only() -> None:
+    manifest = load_manifest()
+    assert manifest["license"] == "MIT"
+    assert manifest["ai_desk_command"] == "rcopenhands"
+    assert "enterprise/" in manifest["excluded"]
+
+
+def test_cli_version_is_fast_and_ringcentral_owned(monkeypatch, capsys) -> None:
+    monkeypatch.setattr(sys, "argv", ["rcopenhands", "--version"])
+
+    cli.main()
+
+    assert "RcOpenHandsSDK" in capsys.readouterr().out
+
+
+def test_cli_delegates_to_openhands_entrypoint() -> None:
+    calls: list[str] = []
+    package = ModuleType("openhands_cli")
+    entrypoint = ModuleType("openhands_cli.entrypoint")
+
+    def fake_main() -> None:
+        calls.append("cli")
+
+    entrypoint.main = fake_main  # type: ignore[attr-defined]
+    sys.modules["openhands_cli"] = package
+    sys.modules["openhands_cli.entrypoint"] = entrypoint
+
+    cli.main()
+
+    assert calls == ["cli"]
+
+
+def test_acp_delegates_to_openhands_acp() -> None:
+    calls: list[str] = []
+    package = ModuleType("openhands_cli")
+    acp_module = ModuleType("openhands_cli.acp")
+
+    def fake_main() -> None:
+        calls.append("acp")
+
+    acp_module.main = fake_main  # type: ignore[attr-defined]
+    sys.modules["openhands_cli"] = package
+    sys.modules["openhands_cli.acp"] = acp_module
+
+    acp.main()
+
+    assert calls == ["acp"]