getstack 0.5.0__tar.gz → 0.5.1__tar.gz

{getstack-0.5.0 → getstack-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getstack
-Version: 0.5.0
+Version: 0.5.1
 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.5.0 → getstack-0.5.1}/pyproject.toml

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

{getstack-0.5.0 → getstack-0.5.1}/src/getstack/intents.py

@@ -108,14 +108,16 @@ class IntentsService:
         timeout_seconds: float = 60.0,
         poll_interval_seconds: float = 1.0,
     ) -> dict[str, Any]:
-        """Submit then poll the pending list until the row leaves
-        'pending' or the timeout elapses.
+        """Submit then poll the per-id endpoint until the row reaches a
+        terminal status (approved | rejected | expired) or the timeout
+        elapses.
 
         Returns:
             Dict with keys 'initial' (the submit response),
             'final' (the last known row state), and 'timed_out' (bool).
-            When the row disappears from the pending list before timeout,
-            it has been decided; 'timed_out' is False.
+            When the row reaches a terminal status before timeout,
+            'timed_out' is False and 'final["status"]' is one of
+            approved | rejected | expired.
         """
         initial = self.submit(
             intent,
@@ -126,15 +128,14 @@ class IntentsService:
         approval_id = initial["approval_id"]
         deadline = time.monotonic() + timeout_seconds
         last_row: dict[str, Any] | None = None
+        # Use GET /v1/intents/:id rather than list_pending so we can
+        # read the actual terminal status — list_pending alone can't
+        # distinguish 'no longer pending' from 'approved'.
         while time.monotonic() < deadline:
-            response = self.list_pending()
-            items = response.get("items", [])
-            match = next((r for r in items if r.get("id") == approval_id), None)
-            if match is None:
-                # Row left the pending queue → terminal state.
-                final = last_row or {"id": approval_id, "status": "approved"}
-                return {"initial": initial, "final": final, "timed_out": False}
-            last_row = match
+            row = self.get(approval_id)
+            last_row = row
+            if row.get("status") != "pending":
+                return {"initial": initial, "final": row, "timed_out": False}
             time.sleep(poll_interval_seconds)
         return {
             "initial": initial,
@@ -142,6 +143,15 @@ class IntentsService:
             "timed_out": True,
         }
 
+    def get(self, approval_id: str) -> dict[str, Any]:
+        """Fetch a single approval row by id, regardless of status.
+
+        Returns the full row when the calling operator owns it. Raises
+        the SDK's standard 404 error when the row doesn't exist or
+        belongs to a different operator (cross-tenant existence hidden).
+        """
+        return self._client.request("GET", f"/v1/intents/{approval_id}")
+
     def list_pending(
         self,
         *,