drukbox-python-sdk 0.0.2__py3-none-any.whl → 0.0.4__py3-none-any.whl

{drukbox_python_sdk-0.0.2.dist-info → drukbox_python_sdk-0.0.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: drukbox-python-sdk
-Version: 0.0.2
+Version: 0.0.4
 Summary: Async Python client for Drukbox.
 Requires-Python: >=3.11
 Requires-Dist: httpx>=0.28
@@ -65,6 +65,7 @@ Public exports live in `drukbox_sdk`:
 
 - `SandboxAPI`
 - `SandboxHost`
+- `DoctorReport` and `DoctorCheck`
 - `SandboxAPIError` and typed subclasses for auth, not found, conflict,
   unavailable, and unclassified response errors
 
@@ -75,11 +76,18 @@ Supported host operations:
 - `attach`
 - `list_hosts`
 - `delete_host`
+- `doctor`
 - `aclose`
 
 `create_host` supports the service's optional `image`, `env`, `expires_at`,
 and `Idempotency-Key` inputs.
 
+`doctor` fetches `GET /doctor` — read-only dependency health. The service
+runs one cheap, non-mutating probe per dependency (database, active VM
+provider, Tailscale when enabled) and always responds 200, so callers branch
+on `DoctorReport.ok` rather than the HTTP status. A failed `DoctorCheck`
+carries a stable `hint` slug for remediation.
+
 The SDK does not mint Tailscale auth keys, manage ACLs, establish SSH,
 provision Linux users, transfer files, or run remote commands.
 

drukbox_python_sdk-0.0.4.dist-info/RECORD

@@ -0,0 +1,6 @@
+drukbox_sdk/__init__.py,sha256=mYIclrOsTbsz9I-0J7eTizXg9s95dGker9SQppmVmrI,732
+drukbox_sdk/api.py,sha256=rZ1MI4zKMiqGNOtAzcPM10Y-Q7ZW3Ly_ZP9cgVqhcDc,13953
+drukbox_sdk/exceptions.py,sha256=eGtoDqmyt5vF0f4AJ4XmOatEe1vVl9KDOfI2YygdA2k,1811
+drukbox_python_sdk-0.0.4.dist-info/METADATA,sha256=aAGDQPkXP6ktJ_yKYbOAaooAmDbqS0lq4fckWJqKgu8,3191
+drukbox_python_sdk-0.0.4.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+drukbox_python_sdk-0.0.4.dist-info/RECORD,,

drukbox_sdk/__init__.py

@@ -5,6 +5,8 @@ detail and may change without notice.
 """
 
 from .api import (
+    DoctorCheck,
+    DoctorReport,
     SandboxAPI,
     SandboxHost,
 )
@@ -19,6 +21,8 @@ from .exceptions import (
 )
 
 __all__ = [
+    "DoctorCheck",
+    "DoctorReport",
     "SandboxAPI",
     "SandboxAPIError",
     "SandboxAuthError",

drukbox_sdk/api.py

@@ -86,6 +86,7 @@ class SandboxHost:
     image: str
     external_ssh_host: str
     external_ssh_port: int
+    ssh_username: str
     internal_ssh_host: str | None
     known_hosts: str
     tailscale_device_id: str | None
@@ -111,6 +112,46 @@ def _parse_sandbox_host(data: dict[str, Any]) -> SandboxHost:
     return SandboxHost(**{key: data[key] for key in _SANDBOX_HOST_FIELDS})
 
 
+@dataclass(frozen=True)
+class DoctorCheck:
+    """One dependency probe. ``hint`` is a remediation slug, set only on failures."""
+
+    name: str
+    status: str
+    detail: str | None
+    latency_ms: int | None
+    hint: str | None
+
+
+@dataclass(frozen=True)
+class DoctorReport:
+    """Health snapshot. The HTTP status is always 200 — branch on ``ok``."""
+
+    ok: bool
+    active_provider: str
+    tailscale_enabled: bool
+    checks: list[DoctorCheck]
+
+
+def _parse_doctor_check(data: dict[str, Any]) -> DoctorCheck:
+    return DoctorCheck(
+        name=data["name"],
+        status=data["status"],
+        detail=data["detail"],
+        latency_ms=data["latency_ms"],
+        hint=data["hint"],
+    )
+
+
+def _parse_doctor_report(data: dict[str, Any]) -> DoctorReport:
+    return DoctorReport(
+        ok=data["ok"],
+        active_provider=data["active_provider"],
+        tailscale_enabled=data["tailscale_enabled"],
+        checks=[_parse_doctor_check(check) for check in data["checks"]],
+    )
+
+
 class SandboxAPI:
     """Async client for Drukbox.
 
@@ -230,6 +271,17 @@ class SandboxAPI:
     async def delete_host(self, host_id: uuid.UUID | str) -> None:
         await self._request("DELETE", f"/hosts/{host_id}")
 
+    async def doctor(self) -> DoctorReport:
+        """Fetch ``GET /doctor`` — read-only dependency health.
+
+        Always responds 200; inspect :attr:`DoctorReport.ok`, not the HTTP
+        status. Auth failures raise :class:`SandboxAuthError`.
+        """
+
+        data = await self._request("GET", "/doctor")
+        assert isinstance(data, dict)
+        return _parse_doctor_report(data)
+
     async def aclose(self) -> None:
         if self._client is None:
             return

drukbox_python_sdk-0.0.2.dist-info/RECORD

@@ -1,6 +0,0 @@
-drukbox_sdk/__init__.py,sha256=KJmc7_s4WLMBbD_IlMoILfGvfFNcaR8cu7TbPeKHDs4,658
-drukbox_sdk/api.py,sha256=EGx2iAMc5Rnlbfyb6GOayxlx77t09RD4_qMPHBkgPF0,12536
-drukbox_sdk/exceptions.py,sha256=eGtoDqmyt5vF0f4AJ4XmOatEe1vVl9KDOfI2YygdA2k,1811
-drukbox_python_sdk-0.0.2.dist-info/METADATA,sha256=CQmsoYnRviY0w1p7P-emHcXGkty1vueOWsSe3KX1yfM,2801
-drukbox_python_sdk-0.0.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-drukbox_python_sdk-0.0.2.dist-info/RECORD,,