hypercli-sdk 2026.4.7__tar.gz → 2026.4.13__tar.gz

{hypercli_sdk-2026.4.7 → hypercli_sdk-2026.4.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-sdk
-Version: 2026.4.7
+Version: 2026.4.13
 Summary: Python SDK for HyperCLI - GPU orchestration and HyperAgent API
 Project-URL: Homepage, https://hypercli.com
 Project-URL: Documentation, https://docs.hypercli.com
@@ -132,6 +132,19 @@ response = client.chat.completions.create(
 )
 ```
 
+## OpenClaw Agents
+
+OpenClaw uses the generic deployment launch surface. `registry_url`, `registry_auth`, `sync_root`, and `sync_enabled` are generic deployment options; the OpenClaw helpers only add defaults such as routes, image, and `sync_root=/home/node`.
+
+```python
+agent = client.deployments.create_openclaw(
+    name="docs-demo",
+    start=True,
+    registry_url="git.nedos.co",
+    registry_auth={"username": "ci", "password": "token"},
+)
+```
+
 ## Error Handling
 
 ```python

{hypercli_sdk-2026.4.7 → hypercli_sdk-2026.4.13}/README.md

@@ -101,6 +101,19 @@ response = client.chat.completions.create(
 )
 ```
 
+## OpenClaw Agents
+
+OpenClaw uses the generic deployment launch surface. `registry_url`, `registry_auth`, `sync_root`, and `sync_enabled` are generic deployment options; the OpenClaw helpers only add defaults such as routes, image, and `sync_root=/home/node`.
+
+```python
+agent = client.deployments.create_openclaw(
+    name="docs-demo",
+    start=True,
+    registry_url="git.nedos.co",
+    registry_auth={"username": "ci", "password": "token"},
+)
+```
+
 ## Error Handling
 
 ```python

{hypercli_sdk-2026.4.7 → hypercli_sdk-2026.4.13}/hypercli/__init__.py

@@ -32,6 +32,7 @@ from .jobs import (
 )
 from .renders import Render, RenderStatus
 from .voice import VoiceAPI
+from .models import Model, ModelsAPI
 from .x402 import X402Client, X402JobLaunch, X402FlowCreate, X402RenderCreate, FlowCatalogItem
 from .files import File, AsyncFiles
 from .job import BaseJob, ComfyUIJob, GradioJob, apply_params, apply_graph_modes, find_node, find_nodes, load_template, graph_to_api, expand_subgraphs, DEFAULT_OBJECT_INFO
@@ -42,6 +43,8 @@ from .agent import (
     HyperAgent,
     HyperAgentPlan,
     HyperAgentCurrentPlan,
+    HyperAgentEntitlements,
+    HyperAgentEntitlementsSummary,
     HyperAgentSubscription,
     HyperAgentSubscriptionSummary,
     HyperAgentModel,
@@ -57,7 +60,7 @@ from .gateway import (
     extract_gateway_chat_tool_calls,
     normalize_gateway_chat_message,
 )
-__version__ = "2026.4.7"
+__version__ = "2026.4.13"
 __all__ = [
     "HyperCLI",
     "configure",
@@ -93,6 +96,8 @@ __all__ = [
     "Render",
     "RenderStatus",
     "VoiceAPI",
+    "Model",
+    "ModelsAPI",
     # x402 API
     "X402Client",
     "X402JobLaunch",
@@ -138,6 +143,8 @@ __all__ = [
     "HyperAgent",
     "HyperAgentPlan",
     "HyperAgentCurrentPlan",
+    "HyperAgentEntitlements",
+    "HyperAgentEntitlementsSummary",
     "HyperAgentSubscription",
     "HyperAgentSubscriptionSummary",
     "HyperAgentModel",

{hypercli_sdk-2026.4.7 → hypercli_sdk-2026.4.13}/hypercli/agent.py

@@ -85,7 +85,7 @@ class HyperAgentCurrentPlan:
 
 @dataclass
 class HyperAgentSubscription:
-    """A purchased HyperClaw entitlement/subscription instance."""
+    """A recurring HyperClaw billing subscription."""
 
     id: str
     user_id: str
@@ -106,10 +106,11 @@ class HyperAgentSubscription:
     plan_tpd: int = 0
     plan_agent_tier: str | None = None
     slot_grants: dict[str, int] | None = None
+    entitlements: list["HyperAgentEntitlement"] | None = None
 
     @classmethod
     def from_dict(cls, data: dict) -> "HyperAgentSubscription":
-        expires_at = data.get("expires_at")
+        expires_at = data.get("current_period_end", data.get("expires_at"))
         updated_at = data.get("updated_at")
         return cls(
             id=data["id"],
@@ -131,6 +132,92 @@ class HyperAgentSubscription:
             plan_tpd=int(data.get("plan_tpd", 0) or 0),
             plan_agent_tier=data.get("plan_agent_tier"),
             slot_grants=data.get("slot_grants") or None,
+            entitlements=[HyperAgentEntitlement.from_dict(item) for item in data.get("entitlements", [])] or None,
+        )
+
+
+@dataclass
+class HyperAgentEntitlement:
+    """A concrete 1:1 entitlement grant."""
+
+    id: str
+    user_id: str
+    subscription_id: str | None
+    plan_id: str
+    plan_name: str
+    provider: str
+    status: str
+    expires_at: datetime | None = None
+    updated_at: datetime | None = None
+    tpm_limit: int = 0
+    rpm_limit: int = 0
+    tpd_limit: int = 0
+    agent_tier: str | None = None
+    features: dict[str, bool] | None = None
+    tags: list[str] | None = None
+    meta: dict[str, Any] | None = None
+    slot_grants: dict[str, int] | None = None
+    active_agent_count: int = 0
+    active_agent_ids: list[str] | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "HyperAgentEntitlement":
+        expires_at = data.get("expires_at")
+        updated_at = data.get("updated_at")
+        return cls(
+            id=data["id"],
+            user_id=data.get("user_id", ""),
+            subscription_id=data.get("subscription_id"),
+            plan_id=data.get("plan_id", ""),
+            plan_name=data.get("plan_name", data.get("plan_id", "")),
+            provider=data.get("provider", ""),
+            status=data.get("status", ""),
+            expires_at=datetime.fromisoformat(str(expires_at).replace("Z", "+00:00")) if expires_at else None,
+            updated_at=datetime.fromisoformat(str(updated_at).replace("Z", "+00:00")) if updated_at else None,
+            tpm_limit=int(data.get("tpm_limit", 0) or 0),
+            rpm_limit=int(data.get("rpm_limit", 0) or 0),
+            tpd_limit=int(data.get("tpd_limit", 0) or 0),
+            agent_tier=data.get("agent_tier"),
+            features=data.get("features") or {},
+            tags=data.get("tags") or [],
+            meta=data.get("meta") or None,
+            slot_grants=data.get("slot_grants") or None,
+            active_agent_count=int(data.get("active_agent_count", 0) or 0),
+            active_agent_ids=data.get("active_agent_ids") or [],
+        )
+
+
+@dataclass
+class HyperAgentEntitlements:
+    """Effective account entitlements computed by the backend."""
+
+    effective_plan_id: str
+    pooled_tpm_limit: int
+    pooled_rpm_limit: int
+    pooled_tpd: int
+    slot_inventory: dict[str, Any]
+    active_entitlement_count: int
+    billing_reset_at: datetime | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "HyperAgentEntitlements":
+        payload = data.get("entitlements") if isinstance(data.get("entitlements"), dict) else data
+        return cls(
+            effective_plan_id=payload.get("effective_plan_id", data.get("effective_plan_id", "")),
+            pooled_tpm_limit=int(payload.get("pooled_tpm_limit", data.get("pooled_tpm_limit", 0)) or 0),
+            pooled_rpm_limit=int(payload.get("pooled_rpm_limit", data.get("pooled_rpm_limit", 0)) or 0),
+            pooled_tpd=int(payload.get("pooled_tpd", data.get("pooled_tpd", 0)) or 0),
+            slot_inventory=payload.get("slot_inventory") or data.get("slot_inventory") or {},
+            active_entitlement_count=int(
+                payload.get(
+                    "active_entitlement_count",
+                    data.get("active_entitlement_count", data.get("active_subscription_count", 0)),
+                )
+                or 0
+            ),
+            billing_reset_at=datetime.fromisoformat(str(payload.get("billing_reset_at")).replace("Z", "+00:00"))
+            if payload.get("billing_reset_at")
+            else None,
         )
 
 
@@ -140,11 +227,16 @@ class HyperAgentSubscriptionSummary:
 
     effective_plan_id: str
     current_subscription_id: str | None
+    current_entitlement_id: str | None
     pooled_tpm_limit: int
     pooled_rpm_limit: int
     pooled_tpd: int
     slot_inventory: dict[str, Any]
+    billing_reset_at: datetime | None
     active_subscription_count: int
+    active_entitlement_count: int
+    entitlements: HyperAgentEntitlements
+    entitlement_items: list[HyperAgentEntitlement]
     active_subscriptions: list[HyperAgentSubscription]
     subscriptions: list[HyperAgentSubscription]
     user: dict[str, Any]
@@ -154,17 +246,42 @@ class HyperAgentSubscriptionSummary:
         return cls(
             effective_plan_id=data.get("effective_plan_id", ""),
             current_subscription_id=data.get("current_subscription_id"),
+            current_entitlement_id=data.get("current_entitlement_id", data.get("current_subscription_id")),
             pooled_tpm_limit=int(data.get("pooled_tpm_limit", 0) or 0),
             pooled_rpm_limit=int(data.get("pooled_rpm_limit", 0) or 0),
             pooled_tpd=int(data.get("pooled_tpd", 0) or 0),
             slot_inventory=data.get("slot_inventory") or {},
+            billing_reset_at=datetime.fromisoformat(str(data.get("billing_reset_at")).replace("Z", "+00:00"))
+            if data.get("billing_reset_at")
+            else None,
             active_subscription_count=int(data.get("active_subscription_count", 0) or 0),
+            active_entitlement_count=int(data.get("active_entitlement_count", data.get("active_subscription_count", 0)) or 0),
+            entitlements=HyperAgentEntitlements.from_dict(data),
+            entitlement_items=[HyperAgentEntitlement.from_dict(item) for item in data.get("entitlement_items", [])],
             active_subscriptions=[HyperAgentSubscription.from_dict(item) for item in data.get("active_subscriptions", [])],
             subscriptions=[HyperAgentSubscription.from_dict(item) for item in data.get("subscriptions", [])],
             user=data.get("user") or {},
         )
 
 
+HyperAgentEntitlementsSummary = HyperAgentSubscriptionSummary
+
+
+@dataclass
+class HyperAgentSubscriptionMutationResult:
+    ok: bool
+    message: str
+    subscription: HyperAgentSubscription | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "HyperAgentSubscriptionMutationResult":
+        return cls(
+            ok=bool(data.get("ok", False)),
+            message=str(data.get("message") or ""),
+            subscription=HyperAgentSubscription.from_dict(data["subscription"]) if data.get("subscription") else None,
+        )
+
+
 @dataclass
 class HyperAgentModel:
     """Available model on HyperAgent."""
@@ -368,6 +485,35 @@ class HyperAgent:
         response.raise_for_status()
         return HyperAgentSubscriptionSummary.from_dict(response.json())
 
+    def entitlements(self) -> HyperAgentEntitlementsSummary:
+        response = self._http._session.get(
+            f"{self._control_base_url}/entitlements",
+            headers={"Authorization": f"Bearer {self._api_key}"},
+        )
+        response.raise_for_status()
+        return HyperAgentEntitlementsSummary.from_dict(response.json())
+
+    def entitlement_instances(self) -> list[HyperAgentEntitlement]:
+        response = self._http._session.get(
+            f"{self._control_base_url}/entitlements/instances",
+            headers={"Authorization": f"Bearer {self._api_key}"},
+        )
+        response.raise_for_status()
+        data = response.json()
+        return [HyperAgentEntitlement.from_dict(item) for item in data.get("items", [])]
+
+    def update_subscription(self, subscription_id: str, bundle: dict[str, int] | None) -> HyperAgentSubscriptionMutationResult:
+        response = self._http._session.post(
+            f"{self._control_base_url}/subscriptions/{subscription_id}/update",
+            headers={"Authorization": f"Bearer {self._api_key}"},
+            json={"bundle": dict(bundle or {})},
+        )
+        response.raise_for_status()
+        return HyperAgentSubscriptionMutationResult.from_dict(response.json())
+
+    def cancel_subscription(self, subscription_id: str) -> HyperAgentSubscriptionMutationResult:
+        return self.update_subscription(subscription_id, {})
+
     def discovery_health(self) -> Dict[str, Any]:
         response = self._http._session.get(f"{self._api_base_without_v1()}/discovery/health")
         response.raise_for_status()

{hypercli_sdk-2026.4.7 → hypercli_sdk-2026.4.13}/hypercli/agents.py

@@ -32,7 +32,7 @@ DEV_AGENTS_API_BASE = "https://api.dev.hypercli.com/agents"
 DEV_AGENTS_WS_URL = "wss://api.agents.dev.hypercli.com/ws"
 DEFAULT_OPENCLAW_IMAGE = "ghcr.io/hypercli/hypercli-openclaw:prod"
 LAUNCH_CONFIG_KEYS = frozenset({"image", "env", "routes", "ports", "command", "entrypoint", "sync_root", "sync_enabled", "registry_url", "registry_auth"})
-DEFAULT_OPENCLAW_SYNC_ROOT = "/home/ubuntu"
+DEFAULT_OPENCLAW_SYNC_ROOT = "/home/node"
 
 
 def _is_directory_listing_payload(value: object) -> bool:
@@ -386,6 +386,28 @@ class Agent:
         self._deployments = agent._deployments
         return self
 
+    def update(
+        self,
+        *,
+        name: str | None = None,
+        size: str | None = None,
+        refresh_from_lagoon: bool | None = None,
+        last_error: str | None = None,
+    ) -> "Agent":
+        agent = self._require_deployments().update(
+            self.id,
+            name=name,
+            size=size,
+            refresh_from_lagoon=refresh_from_lagoon,
+            last_error=last_error,
+        )
+        self.__dict__.update(agent.__dict__)
+        self._deployments = agent._deployments
+        return self
+
+    def resize(self, *, size: str | None = None) -> "Agent":
+        return self.update(size=size)
+
     def env(self) -> dict[str, str]:
         """Fetch runtime environment from the pod's K8s secret."""
         data = self._require_deployments().env(self.id)
@@ -980,8 +1002,6 @@ class Deployments:
         self,
         name: str = None,
         size: str = None,
-        cpu: int = None,
-        memory: int = None,
         config: dict = None,
         tags: list[str] = None,
         env: dict = None,
@@ -1004,8 +1024,6 @@ class Deployments:
         Args:
             name: Agent name.
             size: Size preset (small/medium/large). Default: medium.
-            cpu: Custom CPU in cores (overrides size).
-            memory: Custom memory in GB (overrides size).
             config: Optional config overrides.
             env: Optional environment variables to pass through to the pod.
             ports: Optional exposed ports config.
@@ -1035,10 +1053,6 @@ class Deployments:
             body["name"] = name
         if size:
             body["size"] = size
-        if cpu is not None:
-            body["cpu"] = cpu
-        if memory is not None:
-            body["memory"] = memory
         if meta_ui:
             body["meta"] = {"ui": copy.deepcopy(meta_ui)}
         if tags:
@@ -1056,8 +1070,6 @@ class Deployments:
         self,
         name: str = None,
         size: str = None,
-        cpu: int = None,
-        memory: int = None,
         config: dict = None,
         tags: list[str] = None,
         env: dict = None,
@@ -1077,14 +1089,13 @@ class Deployments:
         openclaw_routes: dict | None = None,
         openclaw_route_options: dict | None = None,
     ) -> Agent:
+        effective_env = dict(env or {})
         return self.create(
             name=name,
             size=size,
-            cpu=cpu,
-            memory=memory,
             config=config,
             tags=tags,
-            env=env,
+            env=effective_env,
             ports=ports,
             routes=_resolve_openclaw_routes(
                 routes,
@@ -1229,10 +1240,11 @@ class Deployments:
         openclaw_routes: dict | None = None,
         openclaw_route_options: dict | None = None,
     ) -> Agent:
+        effective_env = dict(env or {})
         return self.start(
             agent_id,
             config=config,
-            env=env,
+            env=effective_env,
             ports=ports,
             routes=_resolve_openclaw_routes(
                 routes,
@@ -1250,6 +1262,35 @@ class Deployments:
             dry_run=dry_run,
         )
 
+    def update(
+        self,
+        agent_id: str,
+        *,
+        name: str | None = None,
+        size: str | None = None,
+        refresh_from_lagoon: bool | None = None,
+        last_error: str | None = None,
+    ) -> Agent:
+        body: dict[str, Any] = {}
+        if name is not None:
+            body["name"] = name
+        if size is not None:
+            body["size"] = size
+        if refresh_from_lagoon is not None:
+            body["refresh_from_lagoon"] = refresh_from_lagoon
+        if last_error is not None:
+            body["last_error"] = last_error
+        data = self._http.patch(f"{AGENTS_API_PREFIX}/{agent_id}", json=body)
+        return self._hydrate_agent(data)
+
+    def resize(
+        self,
+        agent_id: str,
+        *,
+        size: str | None = None,
+    ) -> Agent:
+        return self.update(agent_id, size=size)
+
     def stop(self, agent_id: str) -> Agent:
         """Stop an agent (tears down pod, keeps DB record).
 

{hypercli_sdk-2026.4.7 → hypercli_sdk-2026.4.13}/hypercli/client.py

@@ -19,6 +19,7 @@ from .voice import VoiceAPI
 from .agents import Deployments
 from .agent import HyperAgent
 from .keys import KeysAPI
+from .models import ModelsAPI
 
 
 def _derive_agents_api_base(api_url: str, agent_dev: bool) -> str:
@@ -100,6 +101,7 @@ class HyperCLI:
         self.files = Files(self._http)
         self.voice = VoiceAPI(self._http)
         self.keys = KeysAPI(self._http)
+        self.models = ModelsAPI(self._http)
         self.agent = HyperAgent(
             self._http,
             agent_api_key=resolved_agent_api_key,

hypercli_sdk-2026.4.13/hypercli/gateway.py

@@ -0,0 +1,7 @@
+"""Backward-compatible module alias for OpenClaw gateway surfaces."""
+
+import sys
+
+from .openclaw import gateway as _gateway
+
+sys.modules[__name__] = _gateway

{hypercli_sdk-2026.4.7 → hypercli_sdk-2026.4.13}/hypercli/http.py

@@ -166,10 +166,10 @@ class HTTPClient:
         )
         return _handle_response(resp)
 
-    def post_bytes(self, path: str, json: dict = None) -> bytes:
+    def post_bytes(self, path: str, json: dict = None, timeout: float | None = None) -> bytes:
         resp = request_with_retry(
             "post", f"{self.base_url}{path}",
-            headers=self.headers, timeout=self.timeout, json=json
+            headers=self.headers, timeout=timeout if timeout is not None else self.timeout, json=json
         )
         return _handle_bytes_response(resp)
 

hypercli_sdk-2026.4.13/hypercli/models.py

@@ -0,0 +1,33 @@
+"""OpenAI-compatible models API"""
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, List
+
+if TYPE_CHECKING:
+    from .http import HTTPClient
+
+
+@dataclass
+class Model:
+    id: str
+    object: str
+    owned_by: str | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "Model":
+        return cls(
+            id=data.get("id", ""),
+            object=data.get("object", "model"),
+            owned_by=data.get("owned_by"),
+        )
+
+
+class ModelsAPI:
+    """OpenAI-compatible models API"""
+
+    def __init__(self, http: "HTTPClient"):
+        self._http = http
+
+    def list(self) -> List[Model]:
+        payload = self._http.get("/v1/models")
+        data = payload.get("data") if isinstance(payload, dict) else payload
+        return [Model.from_dict(item) for item in (data or [])]

hypercli_sdk-2026.4.13/hypercli/openclaw/__init__.py

@@ -0,0 +1,25 @@
+"""OpenClaw-specific SDK surfaces."""
+
+from .gateway import (
+    GatewayClient,
+    GatewayError,
+    ChatEvent,
+    GatewayChatToolCall,
+    GatewayChatMessageSummary,
+    extract_gateway_chat_thinking,
+    extract_gateway_chat_media_urls,
+    extract_gateway_chat_tool_calls,
+    normalize_gateway_chat_message,
+)
+
+__all__ = [
+    "GatewayClient",
+    "GatewayError",
+    "ChatEvent",
+    "GatewayChatToolCall",
+    "GatewayChatMessageSummary",
+    "extract_gateway_chat_thinking",
+    "extract_gateway_chat_media_urls",
+    "extract_gateway_chat_tool_calls",
+    "normalize_gateway_chat_message",
+]

{hypercli_sdk-2026.4.7/hypercli → hypercli_sdk-2026.4.13/hypercli/openclaw}/gateway.py

@@ -14,12 +14,13 @@ import base64
 import hashlib
 import json
 import os
+import shlex
 import time
 import uuid
 from dataclasses import asdict, dataclass
 from pathlib import Path
 from typing import Any, AsyncIterator, Callable, Literal, Optional
-from urllib.parse import parse_qsl, quote, urlsplit
+from urllib.parse import parse_qsl, quote, urlsplit, urlunsplit
 
 import httpx
 import websockets
@@ -815,6 +816,10 @@ class GatewayClient:
             raise RuntimeError(
                 "auto_approve_pairing requires deployment_id, api_key, and api_base"
             )
+        command = (
+            "openclaw devices approve "
+            f"{shlex.quote(request_id)} --json"
+        )
         async with httpx.AsyncClient(timeout=30) as client:
             response = await client.post(
                 f"{self.api_base}/deployments/{quote(self.deployment_id or '')}/exec",
@@ -823,7 +828,7 @@ class GatewayClient:
                     "Content-Type": "application/json",
                 },
                 json={
-                    "command": f"openclaw devices approve {request_id}",
+                    "command": command,
                     "timeout": 30,
                 },
             )