hold-sdk 0.2.0__py3-none-any.whl

hold_sdk/__init__.py

@@ -0,0 +1,32 @@
+import os
+import time
+import httpx
+
+def request_approval(title, *, description="", severity="medium", target=None,
+                     ttl_seconds=300, payload=None, action_type="generic",
+                     server_url=None, token=None, poll_interval=2, timeout=None,
+                     _transport=None) -> str:
+    server_url = server_url or os.environ.get("HMA_SERVER_URL")
+    token = token or os.environ.get("HMA_AGENT_TOKEN")
+    if not server_url or not token:
+        return "denied"  # fail-closed: unconfigured is a no
+    hdr = {"Authorization": f"Bearer {token}"}
+    try:
+        with httpx.Client(base_url=server_url.rstrip("/"), timeout=10, transport=_transport) as c:
+            r = c.post("/v1/requests", headers=hdr, json={
+                "title": title, "description": description, "action_type": action_type,
+                "payload": payload or {}, "severity": severity,
+                "ttl_seconds": ttl_seconds, "target": target})
+            r.raise_for_status()
+            rid = r.json()["id"]
+            deadline = time.time() + (timeout if timeout is not None else ttl_seconds + 5)
+            while time.time() < deadline:
+                g = c.get(f"/v1/requests/{rid}", headers=hdr)
+                g.raise_for_status()
+                status = g.json()["status"]
+                if status in ("approved", "denied", "expired"):
+                    return status
+                time.sleep(poll_interval)
+    except Exception:
+        return "denied"  # fail-closed
+    return "denied"      # local timeout

hold_sdk/client.py

@@ -0,0 +1,34 @@
+import time
+import httpx
+
+class ArbiterClient:
+    def __init__(self, base_url, agent_token, app_token=None, verify=True):
+        self.base_url = base_url.rstrip("/")
+        self.agent_token = agent_token
+        self._http = httpx.Client(base_url=self.base_url, verify=verify, timeout=10)
+
+    def request_approval(self, title, description="", action_type="generic",
+                         payload=None, severity="medium", ttl=300, target=None,
+                         poll_interval=2, timeout=None) -> str:
+        try:
+            r = self._http.post("/v1/requests",
+                headers={"Authorization": f"Bearer {self.agent_token}"},
+                json={"title": title, "description": description, "action_type": action_type,
+                      "payload": payload or {}, "severity": severity, "ttl_seconds": ttl, "target": target})
+            r.raise_for_status()
+            rid = r.json()["id"]
+        except Exception:
+            return "denied"  # fail-closed
+        deadline = time.time() + (timeout if timeout is not None else ttl + 5)
+        while time.time() < deadline:
+            try:
+                g = self._http.get(f"/v1/requests/{rid}",
+                    headers={"Authorization": f"Bearer {self.agent_token}"})
+                g.raise_for_status()
+                status = g.json()["status"]
+            except Exception:
+                return "denied"  # fail-closed
+            if status in ("approved", "denied", "expired"):
+                return status
+            time.sleep(poll_interval)
+        return "denied"  # fail-closed on local timeout

hold_sdk-0.2.0.dist-info/METADATA

@@ -0,0 +1,32 @@
+Metadata-Version: 2.4
+Name: hold-sdk
+Version: 0.2.0
+Summary: Fail-closed approval client for Hold My Agent
+License: MIT
+Project-URL: Homepage, https://holdmyagent.com
+Project-URL: Repository, https://github.com/holdmyagent/arbiter
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.27
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+
+# `hold-sdk`
+
+Python client for Hold My Agent's Arbiter server — gate an agent action
+behind a human approval with one call:
+
+```python
+from hold_sdk import request_approval
+
+if request_approval("Deploy to prod?", severity="high") != "approved":
+    raise SystemExit("blocked: not approved")
+```
+
+Fail-closed: any timeout, network error, or unconfigured client returns
+`"denied"`, never raises.
+
+- Homepage: https://holdmyagent.com
+- Source / issues: https://github.com/holdmyagent/arbiter

hold_sdk-0.2.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+hold_sdk/__init__.py,sha256=uRa68fv1HYMiH0d5hYH3aJOasCsI5bnBysDn8HhCgag,1546
+hold_sdk/client.py,sha256=EfV2WiPs1DeGtyc7CE912gDMBYYH9IvJIEThSMbYfQ4,1597
+hold_sdk-0.2.0.dist-info/METADATA,sha256=RE86UOsYbVXTTKGYiOL7hCerF4H_Lnv2NeEwmMOzCgw,971
+hold_sdk-0.2.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+hold_sdk-0.2.0.dist-info/top_level.txt,sha256=00ob32MPr_IoZxK5708ioCuLK-8u8bjhmZh_MipqdAE,9
+hold_sdk-0.2.0.dist-info/RECORD,,

hold_sdk-0.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

hold_sdk-0.2.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+hold_sdk