synth-ai 0.18.2.dev600__tar.gz → 0.18.2.dev601__tar.gz

{synth_ai-0.18.2.dev600/synth_ai.egg-info → synth_ai-0.18.2.dev601}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.18.2.dev600
+Version: 0.18.2.dev601
 Summary: Python SDK and CLI for Synth Managed Research and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev601}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.18.2.dev600"
+version = "0.18.2.dev601"
 description = "Python SDK and CLI for Synth Managed Research and Research Factory"
 authors = [{name = "Synth AI", email = "josh@usesynth.ai"}]
 license = "MIT"

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev601}/synth_ai/sdk/research/contracts/__init__.py

@@ -389,6 +389,8 @@ from synth_ai.sdk.research.contracts.swarms import (
     SwarmPreflight,
     SwarmSpec,
     SwarmState,
+    SwarmTerminalOutcome,
+    SwarmTerminalOutcomeMissingError,
     ToolProvider,
     WorkerRolePalette,
     WorkMode,
@@ -861,6 +863,8 @@ __all__ = [
     "SwarmPreflight",
     "SwarmSpec",
     "SwarmState",
+    "SwarmTerminalOutcome",
+    "SwarmTerminalOutcomeMissingError",
     "SwarmEnvironment",
     "SwarmUsage",
     "TaskId",

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev601}/synth_ai/sdk/research/contracts/swarms.py

@@ -316,6 +316,20 @@ class SwarmState(StrEnum):
         }
 
 
+class SwarmTerminalOutcome(StrEnum):
+    """Proof-backed terminal result vocabulary owned by the SMR backend."""
+
+    SUCCEEDED = "succeeded"
+    FAILED = "failed"
+    PARTIAL = "partial"
+    STOPPED = "stopped"
+    CANCELED = "canceled"
+
+
+class SwarmTerminalOutcomeMissingError(ValueError):
+    """A terminal swarm was returned without its durable terminal outcome."""
+
+
 class BranchMode(StrEnum):
     EXACT = "exact"
     WITH_MESSAGE = "with_message"
@@ -1252,7 +1266,7 @@ class Swarm:
     effort_id: EffortId | None = None
     started_at: datetime | None = None
     finished_at: datetime | None = None
-    terminal_outcome: str | None = None
+    terminal_outcome: SwarmTerminalOutcome | None = None
     work_completed: bool = False
 
     @classmethod
@@ -1260,6 +1274,7 @@ class Swarm:
         payload = object_value(value, operation_id="swarm")
         work_mode = optional_text(payload, "work_mode")
         effort_id = optional_text(payload, "effort_id")
+        terminal_outcome = optional_text(payload, "terminal_outcome")
         return cls(
             swarm_id=SwarmId(required_text(payload, "run_id")),
             project_id=ProjectId(required_text(payload, "project_id")),
@@ -1273,10 +1288,23 @@ class Swarm:
             effort_id=EffortId(effort_id) if effort_id is not None else None,
             started_at=_optional_datetime(payload, "started_at"),
             finished_at=_optional_datetime(payload, "finished_at"),
-            terminal_outcome=optional_text(payload, "terminal_outcome"),
+            terminal_outcome=(
+                SwarmTerminalOutcome(terminal_outcome) if terminal_outcome is not None else None
+            ),
             work_completed=optional_bool(payload, "work_completed"),
         )
 
+    def require_terminal_outcome(self) -> SwarmTerminalOutcome:
+        """Return the backend-authored durable outcome or fail explicitly."""
+
+        if self.terminal_outcome is not None:
+            return self.terminal_outcome
+        raise SwarmTerminalOutcomeMissingError(
+            "terminal_outcome_missing:"
+            f"run_id={self.swarm_id}:public_state={self.state.value}:"
+            f"is_terminal={str(self.state.is_terminal).lower()}"
+        )
+
 
 @dataclass(frozen=True, slots=True)
 class ResolvedSwarmConfiguration:

{synth_ai-0.18.2.dev600 → synth_ai-0.18.2.dev601/synth_ai.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.18.2.dev600
+Version: 0.18.2.dev601
 Summary: Python SDK and CLI for Synth Managed Research and Research Factory
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT