getstack 0.16.0__tar.gz → 0.18.0__tar.gz

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

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

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

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

@@ -55,6 +55,7 @@ from .skills import SkillService
 from .identity import IdentityService
 from .inbound_webhooks import InboundWebhookService
 from .partner_tenants import PartnerTenantsService
+from .partner_connect import PartnerConnectService
 from .passport_header_verify import verify_passport_header
 from .verify_offline import verify_passport_offline
 from .sign_claim import sign_claim_envelope
@@ -244,6 +245,7 @@ class Stack:
         self.llm = LlmService(self._client)
         self.inbound_webhooks = InboundWebhookService(self._client)
         self.partner_tenants = PartnerTenantsService(self._client)
+        self.partner_connect = PartnerConnectService(self._client)
         self.team = TeamService(self._client)
         self.delivery_methods = DeliveryMethodService(self._client)
         self.detector_config = DetectorConfigService(self._client)
@@ -389,6 +391,7 @@ class AsyncStack:
         from ._async.llm import AsyncLlmService
         from ._async.inbound_webhooks import AsyncInboundWebhookService
         from ._async.partner_tenants import AsyncPartnerTenantsService
+        from ._async.partner_connect import AsyncPartnerConnectService
         from ._async.evidence_packs import AsyncEvidencePacksService
         from ._async.team import AsyncTeamService
         from ._async.delivery_methods import AsyncDeliveryMethodService
@@ -414,6 +417,7 @@ class AsyncStack:
         self.llm = AsyncLlmService(self._client)
         self.inbound_webhooks = AsyncInboundWebhookService(self._client)
         self.partner_tenants = AsyncPartnerTenantsService(self._client)
+        self.partner_connect = AsyncPartnerConnectService(self._client)
         self.evidence_packs = AsyncEvidencePacksService(self._client)
         self.team = AsyncTeamService(self._client)
         self.delivery_methods = AsyncDeliveryMethodService(self._client)

getstack-0.18.0/src/getstack/_async/partner_connect.py

@@ -0,0 +1,43 @@
+"""Async mirror of PartnerConnectService (GET-210)."""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from ..client import AsyncHttpClient
+
+
+class AsyncPartnerConnectService:
+    def __init__(self, client: AsyncHttpClient):
+        self._client = client
+
+    async def connect(
+        self,
+        email: str,
+        external_customer_id: Optional[str] = None,
+        scopes: Optional[list[str]] = None,
+        providers: Optional[list[str]] = None,
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {"email": email}
+        if external_customer_id is not None:
+            body["external_customer_id"] = external_customer_id
+        if scopes is not None:
+            body["scopes"] = scopes
+        if providers is not None:
+            body["providers"] = providers
+        return await self._client.post("/v1/partner/connect", json=body)
+
+    async def list_connections(self) -> list[dict[str, Any]]:
+        res = await self._client.get("/v1/partner/connections")
+        return list(res.get("connections", []))
+
+    async def get_connection(self, grant_id: str) -> dict[str, Any]:
+        return await self._client.get(f"/v1/partner/connections/{grant_id}")
+
+    async def revoke_connection(self, grant_id: str) -> dict[str, Any]:
+        return await self._client.delete(f"/v1/partner/connections/{grant_id}")
+
+    async def rotate_token(self, grant_id: str) -> dict[str, Any]:
+        return await self._client.post(
+            f"/v1/partner/connections/{grant_id}/rotate-token", json={}
+        )

getstack-0.18.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.18.0/src/getstack/partner_connect.py

@@ -0,0 +1,69 @@
+"""GET-210 — "Connect with STACK" partner surface (sync).
+
+connect(email) creates a USER-OWNED STACK account on the customer's
+real email (Express model, notice email) or opens a consent flow when
+the account exists, and returns an opaque ``sk_grant_*`` token you
+attach to the calls you already make — same Bearer header, scoped to
+what the grant created, revocable by the user under /services.
+
+Supersedes the Phase 5.6 child-tenant OWNERSHIP semantics; the tenant
+surface remains available through its deprecation window.
+
+Near-zero integration::
+
+    res = stack.partner_connect.connect(email="customer@example.com")
+    user_stack = Stack(api_key=res["grant_token"])
+    # register agents, connect your provider, issue passports, proxy.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+from .client import HttpClient
+
+
+class PartnerConnectService:
+    def __init__(self, client: HttpClient):
+        self._client = client
+
+    def connect(
+        self,
+        email: str,
+        external_customer_id: Optional[str] = None,
+        scopes: Optional[list[str]] = None,
+        providers: Optional[list[str]] = None,
+    ) -> dict[str, Any]:
+        """One call: create-on-email or consent-request.
+
+        The response's ``grant_token`` is present EXACTLY ONCE, on the
+        call that created the grant. ``status`` is ``active`` (new
+        account) or ``pending_consent`` (existing account — the token
+        authenticates nothing until the user approves).
+        """
+        body: dict[str, Any] = {"email": email}
+        if external_customer_id is not None:
+            body["external_customer_id"] = external_customer_id
+        if scopes is not None:
+            body["scopes"] = scopes
+        if providers is not None:
+            body["providers"] = providers
+        return self._client.post("/v1/partner/connect", json=body)
+
+    def list_connections(self) -> list[dict[str, Any]]:
+        res = self._client.get("/v1/partner/connections")
+        return list(res.get("connections", []))
+
+    def get_connection(self, grant_id: str) -> dict[str, Any]:
+        return self._client.get(f"/v1/partner/connections/{grant_id}")
+
+    def revoke_connection(self, grant_id: str) -> dict[str, Any]:
+        """Revoke the edge. Cascades: grant-created agents' passports,
+        webhooks, and connections all die with it."""
+        return self._client.delete(f"/v1/partner/connections/{grant_id}")
+
+    def rotate_token(self, grant_id: str) -> dict[str, Any]:
+        """Rotate the grant token (lost/leaked). New plaintext returned once."""
+        return self._client.post(
+            f"/v1/partner/connections/{grant_id}/rotate-token", json={}
+        )

getstack-0.18.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 → getstack-0.18.0}/tests/test_parity.py

@@ -34,7 +34,8 @@ EXPECTED_SERVICES = [
     "agents", "passports", "credentials", "services", "dropoffs", "reviews",
     "notifications", "audit", "proxy", "scan", "usage", "security_events",
     "skills", "identity", "intents", "missions", "evidence_packs", "llm",
-    "inbound_webhooks", "partner_tenants", "team", "delivery_methods",
+    "inbound_webhooks", "partner_tenants",
+    "partner_connect", "team", "delivery_methods",
     "detector_config",
 ]
 

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")