getstack 0.16.0__tar.gz → 0.17.0__tar.gz

{getstack-0.16.0 → getstack-0.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getstack
-Version: 0.16.0
+Version: 0.17.0
 Summary: Python SDK for STACK — trust infrastructure for AI agents
 Project-URL: Homepage, https://getstack.run
 Project-URL: Documentation, https://getstack.run/docs/sdk

{getstack-0.16.0 → getstack-0.17.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "getstack"
-version = "0.16.0"
+version = "0.17.0"
 description = "Python SDK for STACK — trust infrastructure for AI agents"
 readme = "README.md"
 license = "MIT"

getstack-0.17.0/src/getstack/_async/usage.py

@@ -0,0 +1,25 @@
+"""Async mirror of UsageService."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from ..client import AsyncHttpClient
+
+
+class AsyncUsageService:
+    def __init__(self, client: AsyncHttpClient):
+        self._client = client
+
+    async def get(
+        self,
+        *,
+        since: str | None = None,
+        until: str | None = None,
+    ) -> dict[str, Any]:
+        params: dict[str, str] = {}
+        if since is not None:
+            params["since"] = since
+        if until is not None:
+            params["until"] = until
+        return await self._client.get("/v1/usage", params=params or None)

getstack-0.17.0/src/getstack/usage.py

@@ -0,0 +1,55 @@
+"""Usage service — `/v1/usage` (usage + spend + earnings rollup).
+
+The one-call rollup of what your operator consumed against its plan,
+spent, and earned this billing period. Superset of the per-domain meters
+(`stack.scan.usage()`, `stack.llm.usage`, `stack.proxy` counts) — one
+authoritative shape the CLI and dashboard read too. Money fields are in
+cents.
+
+Example::
+
+    u = stack.usage.get()
+    p = u["consumption"]["passports"]
+    print(f"Passports {p['used']}/{p['limit']}")
+    print(f"Spent this period: ${u['spend_cents']['total'] / 100:.2f}")
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .client import HttpClient
+
+
+class UsageService:
+    def __init__(self, client: HttpClient):
+        self._client = client
+
+    def get(
+        self,
+        *,
+        since: str | None = None,
+        until: str | None = None,
+    ) -> dict[str, Any]:
+        """Usage, spend, and earnings for the current billing period.
+
+        Args:
+            since: Optional window start (ISO-8601 or unix-ms). When set, the
+                flow metrics (spend, passports, dropoffs, skill invocations,
+                proxy) are scoped to the window; inventory meters gain a
+                ``created_in_window`` count. Omit for the billing period.
+            until: Optional exclusive window end.
+
+        Returns:
+            Dict with keys: tier, period_start, period_end, period_label,
+            consumption (per-meter {used, limit, created_in_window?}),
+            spend_cents (skills / llm_compute / identity / overage / total),
+            wallet_cents ({balance}), and earnings_cents ({unpaid, lifetime}).
+            All money in cents.
+        """
+        params: dict[str, str] = {}
+        if since is not None:
+            params["since"] = since
+        if until is not None:
+            params["until"] = until
+        return self._client.get("/v1/usage", params=params or None)

getstack-0.16.0/src/getstack/_async/usage.py

@@ -1,15 +0,0 @@
-"""Async mirror of UsageService."""
-
-from __future__ import annotations
-
-from typing import Any
-
-from ..client import AsyncHttpClient
-
-
-class AsyncUsageService:
-    def __init__(self, client: AsyncHttpClient):
-        self._client = client
-
-    async def get(self) -> dict[str, Any]:
-        return await self._client.request("GET", "/v1/usage")

getstack-0.16.0/src/getstack/usage.py

@@ -1,37 +0,0 @@
-"""Usage service — `/v1/usage` (usage + spend + earnings rollup).
-
-The one-call rollup of what your operator consumed against its plan,
-spent, and earned this billing period. Superset of the per-domain meters
-(`stack.scan.usage()`, `stack.llm.usage`, `stack.proxy` counts) — one
-authoritative shape the CLI and dashboard read too. Money fields are in
-cents.
-
-Example::
-
-    u = stack.usage.get()
-    p = u["consumption"]["passports"]
-    print(f"Passports {p['used']}/{p['limit']}")
-    print(f"Spent this period: ${u['spend_cents']['total'] / 100:.2f}")
-"""
-
-from __future__ import annotations
-
-from typing import Any
-
-from .client import HttpClient
-
-
-class UsageService:
-    def __init__(self, client: HttpClient):
-        self._client = client
-
-    def get(self) -> dict[str, Any]:
-        """Usage, spend, and earnings for the current billing period.
-
-        Returns:
-            Dict with keys: tier, period_start, period_end, consumption
-            (per-meter {used, limit}), spend_cents (skills / llm_compute /
-            identity / overage / total), wallet_cents ({balance}), and
-            earnings_cents ({unpaid, lifetime}). All money in cents.
-        """
-        return self._client.request("GET", "/v1/usage")