humanleg 0.1.0__py3-none-any.whl

humanleg/__init__.py

@@ -0,0 +1,4 @@
+from .client import HumanLegApiError, HumanLegClient
+
+__all__ = ["HumanLegApiError", "HumanLegClient"]
+__version__ = "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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,5 @@
+humanleg/__init__.py,sha256=lQ65nFI2JmhE7sjY1KcdfNRa0B02u3GI7RiZZzm0Pwc,125
+humanleg/client.py,sha256=Lc0_XW7sv52ax8jjkKxbhr1CxoM6v0hGBibtnEerW7I,3921
+humanleg-0.1.0.dist-info/METADATA,sha256=nPfgnC206pEY4kRiPfjIPjs50gsijECponNpg6W41Xw,1061
+humanleg-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+humanleg-0.1.0.dist-info/RECORD,,

humanleg-0.1.0.dist-info/WHEEL

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