hypercli-sdk 0.8.7__tar.gz → 0.8.9__tar.gz

{hypercli_sdk-0.8.7 → hypercli_sdk-0.8.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hypercli-sdk
-Version: 0.8.7
+Version: 0.8.9
 Summary: Python SDK for HyperCLI - GPU orchestration and LLM API
 Project-URL: Homepage, https://hypercli.com
 Project-URL: Documentation, https://docs.hypercli.com

{hypercli_sdk-0.8.7 → hypercli_sdk-0.8.9}/hypercli/__init__.py

@@ -5,13 +5,13 @@ from .http import APIError, AsyncHTTPClient
 from .instances import GPUType, GPUConfig, Region, GPUPricing, PricingTier
 from .jobs import Job, JobMetrics, GPUMetrics, find_job, find_by_id, find_by_hostname, find_by_ip
 from .renders import Render, RenderStatus
-from .x402 import X402Client, X402JobLaunch, X402RenderCreate
+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
 from .logs import LogStream, stream_logs, fetch_logs
 from .claw import Claw, ClawKey, ClawPlan, ClawModel
 
-__version__ = "0.8.7"
+__version__ = "0.8.9"
 __all__ = [
     "HyperCLI",
     "configure",
@@ -35,7 +35,9 @@ __all__ = [
     # x402 API
     "X402Client",
     "X402JobLaunch",
+    "X402FlowCreate",
     "X402RenderCreate",
+    "FlowCatalogItem",
     # Files API
     "File",
     "AsyncFiles",

{hypercli_sdk-0.8.7 → hypercli_sdk-0.8.9}/hypercli/x402.py

@@ -1,4 +1,4 @@
-"""x402 payment helpers for pay-per-use job and render launches."""
+"""x402 payment helpers for pay-per-use job and flow launches."""
 from __future__ import annotations
 
 import base64
@@ -35,8 +35,8 @@ class X402JobLaunch:
 
 
 @dataclass
-class X402RenderCreate:
-    """Response payload for x402 render creation."""
+class X402FlowCreate:
+    """Response payload for x402 flow render creation."""
 
     render: Render
     access_key: str
@@ -44,7 +44,7 @@ class X402RenderCreate:
     cancel_url: str
 
     @classmethod
-    def from_dict(cls, data: dict[str, Any]) -> "X402RenderCreate":
+    def from_dict(cls, data: dict[str, Any]) -> "X402FlowCreate":
         return cls(
             render=Render.from_dict(data.get("render", {})),
             access_key=data.get("access_key", ""),
@@ -53,6 +53,34 @@ class X402RenderCreate:
         )
 
 
+@dataclass
+class FlowCatalogItem:
+    """Public flow catalog entry."""
+
+    flow_type: str
+    price_usd: float
+    template: str | None = None
+    type: str = "comfyui"
+    regions: dict[str, str] | None = None
+    interruptible: bool | None = None
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any]) -> "FlowCatalogItem":
+        flow_type = str(data.get("flow_type") or data.get("name") or "")
+        return cls(
+            flow_type=flow_type,
+            price_usd=float(data.get("price_usd", 0)),
+            template=data.get("template"),
+            type=str(data.get("type", "comfyui")),
+            regions=data.get("regions") if isinstance(data.get("regions"), dict) else {},
+            interruptible=data.get("interruptible"),
+        )
+
+
+# Backward-compat alias. Raw x402 render endpoint was replaced by flow endpoints.
+X402RenderCreate = X402FlowCreate
+
+
 def _require_x402_deps():
     try:
         from x402 import x402ClientSync
@@ -62,7 +90,7 @@ def _require_x402_deps():
         return x402ClientSync, x402HTTPClientSync, EthAccountSigner, register_exact_evm_client
     except ImportError as exc:
         raise RuntimeError(
-            "x402 dependencies missing. Install with: pip install 'x402[httpx,evm]' eth-account"
+            "x402 dependencies missing. Install with: pip install x402[httpx,evm] eth-account"
         ) from exc
 
 
@@ -111,13 +139,77 @@ def _x402_post(
     return data
 
 
+def _json_get(base_url: str, path: str, timeout: float) -> Any:
+    endpoint = f"{base_url.rstrip('/')}{path}"
+    with httpx.Client(timeout=timeout) as client:
+        response = client.get(endpoint)
+    if response.status_code >= 400:
+        raise APIError(response.status_code, _error_detail(response))
+    return response.json()
+
+
 class X402Client:
-    """x402 pay-per-use client for launching jobs and renders without a full API account."""
+    """x402 pay-per-use client for launching jobs and flow renders without a full API account."""
 
     def __init__(self, api_url: str | None = None, timeout: float = 30.0):
         self.api_url = (api_url or get_api_url()).rstrip("/")
         self.timeout = timeout
 
+    def get_flow_catalog(self) -> list[FlowCatalogItem]:
+        data = _json_get(self.api_url, "/flows", self.timeout)
+
+        rows: list[dict[str, Any]] = []
+        if isinstance(data, list):
+            # Backward compatibility with old /api/flow/public response shape
+            rows = [row for row in data if isinstance(row, dict)]
+        elif isinstance(data, dict):
+            flows = data.get("flows")
+            if isinstance(flows, list):
+                rows = [row for row in flows if isinstance(row, dict)]
+
+        if not rows:
+            raise APIError(500, "Malformed flow catalog response")
+
+        expanded_rows: list[dict[str, Any]] = []
+        for row in rows:
+            flow_name = str(row.get("flow_type") or row.get("name") or "")
+            if not flow_name:
+                continue
+
+            has_details = any(k in row for k in ("template", "regions", "type"))
+            if has_details:
+                expanded_rows.append(row)
+                continue
+
+            flow_path = row.get("path")
+            if not isinstance(flow_path, str) or not flow_path:
+                flow_path = f"/flows/{flow_name}"
+
+            try:
+                detail = _json_get(self.api_url, flow_path, self.timeout)
+            except APIError:
+                detail = {}
+
+            if isinstance(detail, dict):
+                # Preserve index price/path while augmenting with detail fields.
+                merged = {**detail, **row}
+                expanded_rows.append(merged)
+            else:
+                expanded_rows.append(row)
+
+        items = [FlowCatalogItem.from_dict(row) for row in expanded_rows]
+        return [item for item in items if item.flow_type]
+
+    def get_flow_price(self, flow_type: str) -> float:
+        if not flow_type:
+            raise ValueError("flow_type is required")
+        for item in self.get_flow_catalog():
+            if item.flow_type == flow_type:
+                if item.price_usd <= 0:
+                    raise APIError(500, f"Flow {flow_type} has invalid configured price")
+                return item.price_usd
+        raise APIError(404, f"Flow {flow_type} not found in flow catalog")
+
     def create_job(
         self,
         *,
@@ -159,25 +251,40 @@ class X402Client:
         data = _x402_post(self.api_url, "/api/x402/job", payload, account, self.timeout)
         return X402JobLaunch.from_dict(data)
 
-    def create_render(
+    def create_flow(
         self,
         *,
+        flow_type: str,
         amount: float,
         account: Any,
-        params: dict[str, Any],
-        render_type: str = "comfyui",
+        params: dict[str, Any] | None = None,
         notify_url: str | None = None,
-    ) -> X402RenderCreate:
+    ) -> X402FlowCreate:
         if amount <= 0:
             raise ValueError("amount must be greater than 0")
+        if not flow_type:
+            raise ValueError("flow_type is required")
 
-        render_payload: dict[str, Any] = {
-            "type": render_type,
-            "params": params,
+        payload: dict[str, Any] = {
+            "amount": amount,
+            "params": params or {},
         }
         if notify_url:
-            render_payload["notify_url"] = notify_url
+            payload["notify_url"] = notify_url
 
-        payload = {"amount": amount, "render": render_payload}
-        data = _x402_post(self.api_url, "/api/x402/render", payload, account, self.timeout)
-        return X402RenderCreate.from_dict(data)
+        data = _x402_post(self.api_url, f"/api/x402/flow/{flow_type}", payload, account, self.timeout)
+        return X402FlowCreate.from_dict(data)
+
+    def create_render(
+        self,
+        *,
+        amount: float,
+        account: Any,
+        params: dict[str, Any],
+        render_type: str = "comfyui",
+        notify_url: str | None = None,
+    ) -> X402RenderCreate:
+        del amount, account, params, render_type, notify_url
+        raise RuntimeError(
+            "x402 render endpoint has been removed. Use create_flow(flow_type=..., amount=..., params=...) instead."
+        )

{hypercli_sdk-0.8.7 → hypercli_sdk-0.8.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypercli-sdk"
-version = "0.8.7"
+version = "0.8.9"
 description = "Python SDK for HyperCLI - GPU orchestration and LLM API"
 readme = "README.md"
 requires-python = ">=3.10"