humanleg 0.1.0__tar.gz

humanleg-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+node_modules/
+dist/
+coverage/
+*.tgz
+.env
+.env.*
+!.env.example
+.venv/
+__pycache__/
+*.py[cod]
+.pytest_cache/
+.DS_Store

humanleg-0.1.0/PKG-INFO

@@ -0,0 +1,36 @@
+Metadata-Version: 2.5
+Name: humanleg
+Version: 0.1.0
+Summary: Python SDK for the HumanLeg.ai public agent API
+Project-URL: Homepage, https://humanleg.ai
+Project-URL: Repository, https://github.com/humanleg-ai/humanleg
+Project-URL: Issues, https://github.com/humanleg-ai/humanleg/issues
+Author: HumanLeg.ai contributors
+License: Apache-2.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# humanleg
+
+Dependency-light Python client for the HumanLeg.ai public agent API.
+
+```bash
+pip install humanleg
+```
+
+```python
+from humanleg import HumanLegClient
+
+client = HumanLegClient(
+    base_url="http://127.0.0.1:8787",
+    token="sandbox-agent-token",
+)
+task = client.get_task("task-id")
+```

humanleg-0.1.0/README.md

@@ -0,0 +1,17 @@
+# humanleg
+
+Dependency-light Python client for the HumanLeg.ai public agent API.
+
+```bash
+pip install humanleg
+```
+
+```python
+from humanleg import HumanLegClient
+
+client = HumanLegClient(
+    base_url="http://127.0.0.1:8787",
+    token="sandbox-agent-token",
+)
+task = client.get_task("task-id")
+```

humanleg-0.1.0/humanleg/__init__.py

@@ -0,0 +1,4 @@
+from .client import HumanLegApiError, HumanLegClient
+
+__all__ = ["HumanLegApiError", "HumanLegClient"]
+__version__ = "0.1.0"

humanleg-0.1.0/humanleg/client.py

@@ -0,0 +1,105 @@
+from __future__ import annotations
+
+import json
+import uuid
+from dataclasses import dataclass
+from typing import Any, Callable
+from urllib import error, parse, request
+
+
+class HumanLegApiError(RuntimeError):
+    def __init__(self, status: int, problem: dict[str, Any]):
+        self.status = status
+        self.problem = problem
+        super().__init__(
+            str(problem.get("detail") or problem.get("title") or f"HumanLeg API failed with {status}")
+        )
+
+
+@dataclass(frozen=True)
+class HumanLegClient:
+    base_url: str
+    token: str
+    timeout: float = 15.0
+    idempotency_key: Callable[[], str] = lambda: str(uuid.uuid4())
+
+    def __post_init__(self) -> None:
+        if not self.base_url.startswith(("http://", "https://")):
+            raise ValueError("base_url must use http:// or https://")
+        if not self.token:
+            raise ValueError("token is required")
+        object.__setattr__(self, "base_url", self.base_url.rstrip("/"))
+
+    def create_fee_quote(self, *, reward_atomic: int, display_aud_cents: int) -> dict[str, Any]:
+        return self._request(
+            "/v1/fee-quotes",
+            method="POST",
+            body={"rewardAtomic": reward_atomic, "displayAudCents": display_aud_cents},
+            idempotent=True,
+        )
+
+    def create_task(self, **task: Any) -> dict[str, Any]:
+        return self._request("/v1/tasks", method="POST", body=task, idempotent=True)
+
+    def get_task(self, task_id: str) -> dict[str, Any]:
+        return self._request(f"/v1/tasks/{parse.quote(task_id, safe='')}")
+
+    def update_task(self, task_id: str, **task: Any) -> dict[str, Any]:
+        return self._request(
+            f"/v1/tasks/{parse.quote(task_id, safe='')}",
+            method="PATCH",
+            body=task,
+            idempotent=True,
+        )
+
+    def get_compliance_review(self, task_id: str) -> dict[str, Any]:
+        return self._request(f"/v1/tasks/{parse.quote(task_id, safe='')}/compliance-review")
+
+    def create_funding_intent(self, task_id: str) -> dict[str, Any]:
+        return self._request(
+            f"/v1/tasks/{parse.quote(task_id, safe='')}/funding-intents",
+            method="POST",
+            idempotent=True,
+        )
+
+    def publish_task(self, task_id: str, *, expected_version: int) -> dict[str, Any]:
+        return self._request(
+            f"/v1/tasks/{parse.quote(task_id, safe='')}/open",
+            method="POST",
+            body={"expectedVersion": expected_version},
+            idempotent=True,
+        )
+
+    def list_events(self, *, after: str | None = None) -> dict[str, Any]:
+        suffix = "" if after is None else f"?after={parse.quote(after)}"
+        return self._request(f"/v1/events{suffix}")
+
+    def _request(
+        self,
+        path: str,
+        *,
+        method: str = "GET",
+        body: dict[str, Any] | None = None,
+        idempotent: bool = False,
+    ) -> dict[str, Any]:
+        headers = {"Accept": "application/json", "Authorization": f"Bearer {self.token}"}
+        data = None
+        if body is not None:
+            headers["Content-Type"] = "application/json"
+            data = json.dumps(body).encode("utf-8")
+        if idempotent:
+            headers["Idempotency-Key"] = self.idempotency_key()
+        api_request = request.Request(
+            f"{self.base_url}{path}", data=data, headers=headers, method=method
+        )
+        try:
+            with request.urlopen(api_request, timeout=self.timeout) as response:
+                content = response.read()
+                return json.loads(content) if content else {}
+        except error.HTTPError as exc:
+            content = exc.read()
+            try:
+                problem = json.loads(content) if content else {}
+            except json.JSONDecodeError:
+                problem = {"title": "HTTP error", "detail": content.decode("utf-8", "replace")}
+            raise HumanLegApiError(exc.code, problem) from exc

humanleg-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "humanleg"
+version = "0.1.0"
+description = "Python SDK for the HumanLeg.ai public agent API"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "Apache-2.0" }
+authors = [{ name = "HumanLeg.ai contributors" }]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+
+[project.urls]
+Homepage = "https://humanleg.ai"
+Repository = "https://github.com/humanleg-ai/humanleg"
+Issues = "https://github.com/humanleg-ai/humanleg/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["humanleg"]

humanleg-0.1.0/tests/test_client.py

@@ -0,0 +1,46 @@
+import io
+import json
+import pathlib
+import sys
+import unittest
+from unittest.mock import patch
+
+sys.path.insert(0, str(pathlib.Path(__file__).parents[1]))
+
+from humanleg import HumanLegClient  # noqa: E402
+
+
+class FakeResponse:
+    def __init__(self, body):
+        self.body = json.dumps(body).encode()
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *_args):
+        return False
+
+    def read(self):
+        return self.body
+
+
+class HumanLegClientTests(unittest.TestCase):
+    def test_fee_quote_headers_and_body(self):
+        client = HumanLegClient(
+            base_url="https://sandbox.humanleg.ai/",
+            token="test-token",
+            idempotency_key=lambda: "idem-12345678",
+        )
+        with patch("urllib.request.urlopen", return_value=FakeResponse({"id": "quote-1"})) as call:
+            result = client.create_fee_quote(reward_atomic=20_000_000, display_aud_cents=3_000)
+
+        self.assertEqual(result["id"], "quote-1")
+        api_request = call.call_args.args[0]
+        self.assertEqual(api_request.full_url, "https://sandbox.humanleg.ai/v1/fee-quotes")
+        self.assertEqual(api_request.headers["Authorization"], "Bearer test-token")
+        self.assertEqual(api_request.headers["Idempotency-key"], "idem-12345678")
+        self.assertEqual(json.loads(api_request.data), {"rewardAtomic": 20_000_000, "displayAudCents": 3_000})
+
+
+if __name__ == "__main__":
+    unittest.main()