getstack 0.15.0__tar.gz → 0.16.0__tar.gz

{getstack-0.15.0 → getstack-0.16.0}/CLAUDE.md

@@ -12,7 +12,7 @@ Published to PyPI as `getstack`. Not a workspace member of the main monorepo
   `AsyncStack`): agents, passports (+ delegate + revoke-agent/session/all +
   list_active), services (+ connect + grant/revoke/get_permissions),
   credentials, drop-offs (+ expire), skills, identity, audit, notifications
-  (+ update), security-events, proxy, scan, intents, missions,
+  (+ update), security-events, proxy, scan, usage, intents, missions,
   evidence-packs, llm gateway, inbound-webhooks, partner, **team**,
   **delivery_methods**, **detector_config**.
 - **Offline / customer-managed crypto** (the JS headline features):

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getstack
-Version: 0.15.0
+Version: 0.16.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.15.0 → getstack-0.16.0}/pyproject.toml

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

{getstack-0.15.0 → getstack-0.16.0}/src/getstack/__init__.py

@@ -49,6 +49,7 @@ from .notifications import NotificationService
 from .audit import AuditService
 from .proxy import ProxyService as ProxySvc, ProxyResponse
 from .scan import ScanService
+from .usage import UsageService
 from .security_events import SecurityEventService as SecurityEventSvc
 from .skills import SkillService
 from .identity import IdentityService
@@ -233,6 +234,7 @@ class Stack:
         self.audit = AuditService(self._client)
         self.proxy = ProxySvc(self._client)
         self.scan = ScanService(self._client)
+        self.usage = UsageService(self._client)
         self.security_events = SecurityEventSvc(self._client)
         self.skills = SkillService(self._client)
         self.identity = IdentityService(self._client)
@@ -378,6 +380,7 @@ class AsyncStack:
         from ._async.audit import AsyncAuditService
         from ._async.proxy import AsyncProxyService
         from ._async.scan import AsyncScanService
+        from ._async.usage import AsyncUsageService
         from ._async.security_events import AsyncSecurityEventService
         from ._async.skills import AsyncSkillService
         from ._async.identity import AsyncIdentityService
@@ -402,6 +405,7 @@ class AsyncStack:
         self.audit = AsyncAuditService(self._client)
         self.proxy = AsyncProxyService(self._client)
         self.scan = AsyncScanService(self._client)
+        self.usage = AsyncUsageService(self._client)
         self.security_events = AsyncSecurityEventService(self._client)
         self.skills = AsyncSkillService(self._client)
         self.identity = AsyncIdentityService(self._client)

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

@@ -0,0 +1,15 @@
+"""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

@@ -0,0 +1,37 @@
+"""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")

{getstack-0.15.0 → getstack-0.16.0}/tests/test_parity.py

@@ -32,8 +32,8 @@ from getstack import (  # noqa: E402
 # Services that must exist on BOTH clients.
 EXPECTED_SERVICES = [
     "agents", "passports", "credentials", "services", "dropoffs", "reviews",
-    "notifications", "audit", "proxy", "scan", "security_events", "skills",
-    "identity", "intents", "missions", "evidence_packs", "llm",
+    "notifications", "audit", "proxy", "scan", "usage", "security_events",
+    "skills", "identity", "intents", "missions", "evidence_packs", "llm",
     "inbound_webhooks", "partner_tenants", "team", "delivery_methods",
     "detector_config",
 ]
@@ -58,6 +58,7 @@ EXPECTED_METHODS = [
     ("team", "invite"),
     ("delivery_methods", "add"),
     ("detector_config", "upsert"),
+    ("usage", "get"),
 ]