getstack 0.6.0__tar.gz → 0.7.0__tar.gz

{getstack-0.6.0 → getstack-0.7.0}/.gitignore

@@ -60,6 +60,11 @@ scripts/.openapi-cache/
 # Local dev screenshots
 *-stripe.png
 
+# Root-level scratch images (founder workspace — never commit)
+/*.png
+/*.jpg
+/*.jpeg
+
 # YC application session exports (founder voice + redacted creds — never commit)
 docs/yc-q18/
 docs/yc-application-session-preface.md

{getstack-0.6.0 → getstack-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: getstack
-Version: 0.6.0
+Version: 0.7.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.6.0 → getstack-0.7.0}/pyproject.toml

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

{getstack-0.6.0 → getstack-0.7.0}/src/getstack/__init__.py

@@ -52,6 +52,7 @@ from .security_events import SecurityEventService as SecurityEventSvc
 from .skills import SkillService
 from .identity import IdentityService
 from .intents import IntentsService
+from .missions import MissionsService
 from .types import (
     Agent,
     Passport,
@@ -216,6 +217,7 @@ class Stack:
         self.skills = SkillService(self._client)
         self.identity = IdentityService(self._client)
         self.intents = IntentsService(self._client)
+        self.missions = MissionsService(self._client)
 
     @classmethod
     def from_session(cls, session_token: str, **kwargs) -> Stack:
@@ -326,6 +328,7 @@ class AsyncStack:
         from ._async.skills import AsyncSkillService
         from ._async.identity import AsyncIdentityService
         from ._async.intents import AsyncIntentsService
+        from ._async.missions import AsyncMissionsService
 
         self.agents = AsyncAgentService(self._client)
         self.passports = AsyncPassportService(self._client)
@@ -341,6 +344,7 @@ class AsyncStack:
         self.skills = AsyncSkillService(self._client)
         self.identity = AsyncIdentityService(self._client)
         self.intents = AsyncIntentsService(self._client)
+        self.missions = AsyncMissionsService(self._client)
 
     @classmethod
     def from_session(cls, session_token: str, **kwargs) -> AsyncStack:

getstack-0.7.0/src/getstack/_async/missions.py

@@ -0,0 +1,110 @@
+"""Async mirror of MissionsService. Same surface, async/await."""
+
+from __future__ import annotations
+
+from typing import Any
+
+from ..client import AsyncHttpClient
+
+
+class AsyncMissionsService:
+    def __init__(self, client: AsyncHttpClient):
+        self._client = client
+
+    async def open(
+        self,
+        intent_summary: str,
+        *,
+        intent_services: list[str] | None = None,
+        expected_counterparties: list[str] | None = None,
+        baseline_profile: dict[str, Any] | None = None,
+        expected_output_shape: dict[str, Any] | None = None,
+        max_actions: int | None = None,
+        max_dropoff_bytes: int | None = None,
+        coverage_cap_cents: int | None = None,
+        max_duration_seconds: int | None = None,
+        max_concurrent_intents: int | None = None,
+        max_actions_per_service: dict[str, int] | None = None,
+        cap_behavior: dict[str, str] | None = None,
+        expires_in_seconds: int | None = None,
+        parent_passport_services: list[str] | None = None,
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {"intent_summary": intent_summary}
+        if intent_services is not None:
+            body["intent_services"] = intent_services
+        if expected_counterparties is not None:
+            body["expected_counterparties"] = expected_counterparties
+        if baseline_profile is not None:
+            body["baseline_profile"] = baseline_profile
+        if expected_output_shape is not None:
+            body["expected_output_shape"] = expected_output_shape
+        if max_actions is not None:
+            body["max_actions"] = max_actions
+        if max_dropoff_bytes is not None:
+            body["max_dropoff_bytes"] = max_dropoff_bytes
+        if coverage_cap_cents is not None:
+            body["coverage_cap_cents"] = coverage_cap_cents
+        if max_duration_seconds is not None:
+            body["max_duration_seconds"] = max_duration_seconds
+        if max_concurrent_intents is not None:
+            body["max_concurrent_intents"] = max_concurrent_intents
+        if max_actions_per_service is not None:
+            body["max_actions_per_service"] = max_actions_per_service
+        if cap_behavior is not None:
+            body["cap_behavior"] = cap_behavior
+        if expires_in_seconds is not None:
+            body["expires_in_seconds"] = expires_in_seconds
+        if parent_passport_services is not None:
+            body["parent_passport_services"] = parent_passport_services
+        return await self._client.request("POST", "/v1/missions", json=body)
+
+    async def complete(
+        self,
+        mission_id: str,
+        *,
+        output: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {}
+        if output is not None:
+            body["output"] = output
+        return await self._client.request(
+            "POST", f"/v1/missions/{mission_id}/complete", json=body
+        )
+
+    async def revoke(
+        self,
+        mission_id: str,
+        *,
+        reason: str,
+        notes: str | None = None,
+    ) -> dict[str, Any]:
+        body: dict[str, Any] = {"reason": reason}
+        if notes is not None:
+            body["notes"] = notes
+        return await self._client.request(
+            "POST", f"/v1/missions/{mission_id}/revoke", json=body
+        )
+
+    async def get(self, mission_id: str) -> dict[str, Any]:
+        return await self._client.request("GET", f"/v1/missions/{mission_id}")
+
+    async def list(
+        self,
+        *,
+        status: str | None = None,
+        page: int | None = None,
+        limit: int | None = None,
+    ) -> dict[str, Any]:
+        params: dict[str, Any] = {}
+        if status is not None:
+            params["status"] = status
+        if page is not None:
+            params["page"] = page
+        if limit is not None:
+            params["limit"] = limit
+        path = "/v1/missions"
+        if params:
+            from urllib.parse import urlencode
+
+            path = f"{path}?{urlencode(params)}"
+        return await self._client.request("GET", path)

getstack-0.7.0/src/getstack/missions.py

@@ -0,0 +1,130 @@
+"""Mission lifecycle — open / complete / revoke / get / list.
+
+Phase 5.0 sub-chunk 5.0.8.
+
+  open()      Open a new mission. Returns mission_id (ms_*) + the
+              signed mission_open claim_id.
+  complete()  Mark a mission complete (terminal_state='completed_successful').
+              Idempotent; second call returns the prior terminal state.
+  revoke()    Revoke a mission. reason='adversarial' triggers forward
+              cascade (passports bound to the mission also revoke);
+              reason='operator_initiated_clean' leaves passports alive.
+  get()       Fetch full mission view by id.
+  list()      List missions for the calling operator.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from .client import HttpClient
+
+
+class MissionsService:
+    def __init__(self, client: HttpClient):
+        self._client = client
+
+    def open(
+        self,
+        intent_summary: str,
+        *,
+        intent_services: list[str] | None = None,
+        expected_counterparties: list[str] | None = None,
+        baseline_profile: dict[str, Any] | None = None,
+        expected_output_shape: dict[str, Any] | None = None,
+        max_actions: int | None = None,
+        max_dropoff_bytes: int | None = None,
+        coverage_cap_cents: int | None = None,
+        max_duration_seconds: int | None = None,
+        max_concurrent_intents: int | None = None,
+        max_actions_per_service: dict[str, int] | None = None,
+        cap_behavior: dict[str, str] | None = None,
+        expires_in_seconds: int | None = None,
+        parent_passport_services: list[str] | None = None,
+    ) -> dict[str, Any]:
+        """Open a new mission. Returns dict with mission_id, claim_id,
+        expires_at."""
+        body: dict[str, Any] = {"intent_summary": intent_summary}
+        if intent_services is not None:
+            body["intent_services"] = intent_services
+        if expected_counterparties is not None:
+            body["expected_counterparties"] = expected_counterparties
+        if baseline_profile is not None:
+            body["baseline_profile"] = baseline_profile
+        if expected_output_shape is not None:
+            body["expected_output_shape"] = expected_output_shape
+        if max_actions is not None:
+            body["max_actions"] = max_actions
+        if max_dropoff_bytes is not None:
+            body["max_dropoff_bytes"] = max_dropoff_bytes
+        if coverage_cap_cents is not None:
+            body["coverage_cap_cents"] = coverage_cap_cents
+        if max_duration_seconds is not None:
+            body["max_duration_seconds"] = max_duration_seconds
+        if max_concurrent_intents is not None:
+            body["max_concurrent_intents"] = max_concurrent_intents
+        if max_actions_per_service is not None:
+            body["max_actions_per_service"] = max_actions_per_service
+        if cap_behavior is not None:
+            body["cap_behavior"] = cap_behavior
+        if expires_in_seconds is not None:
+            body["expires_in_seconds"] = expires_in_seconds
+        if parent_passport_services is not None:
+            body["parent_passport_services"] = parent_passport_services
+        return self._client.request("POST", "/v1/missions", json=body)
+
+    def complete(
+        self,
+        mission_id: str,
+        *,
+        output: dict[str, Any] | None = None,
+    ) -> dict[str, Any]:
+        """Mark a mission complete. Returns dict with mission_id, claim_id,
+        terminal_state, completed_at, transitioned."""
+        body: dict[str, Any] = {}
+        if output is not None:
+            body["output"] = output
+        return self._client.request(
+            "POST", f"/v1/missions/{mission_id}/complete", json=body
+        )
+
+    def revoke(
+        self,
+        mission_id: str,
+        *,
+        reason: str,
+        notes: str | None = None,
+    ) -> dict[str, Any]:
+        """Revoke a mission. reason in {'adversarial', 'operator_initiated_clean'}."""
+        body: dict[str, Any] = {"reason": reason}
+        if notes is not None:
+            body["notes"] = notes
+        return self._client.request(
+            "POST", f"/v1/missions/{mission_id}/revoke", json=body
+        )
+
+    def get(self, mission_id: str) -> dict[str, Any]:
+        """Fetch a mission by id. 404 for unknown or cross-tenant."""
+        return self._client.request("GET", f"/v1/missions/{mission_id}")
+
+    def list(
+        self,
+        *,
+        status: str | None = None,
+        page: int | None = None,
+        limit: int | None = None,
+    ) -> dict[str, Any]:
+        """List missions for the calling operator. Returns dict with `items`."""
+        params: dict[str, Any] = {}
+        if status is not None:
+            params["status"] = status
+        if page is not None:
+            params["page"] = page
+        if limit is not None:
+            params["limit"] = limit
+        path = "/v1/missions"
+        if params:
+            from urllib.parse import urlencode
+
+            path = f"{path}?{urlencode(params)}"
+        return self._client.request("GET", path)