synth-ai 0.22.2.dev682__tar.gz → 0.22.2.dev683__tar.gz

{synth_ai-0.22.2.dev682/synth_ai.egg-info → synth_ai-0.22.2.dev683}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.22.2.dev682
+Version: 0.22.2.dev683
 Summary: Python SDK, CLI and MCP servers for Synth Index search and Swarms
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT

{synth_ai-0.22.2.dev682 → synth_ai-0.22.2.dev683}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "synth-ai"
-version = "0.22.2.dev682"
+version = "0.22.2.dev683"
 description = "Python SDK, CLI and MCP servers for Synth Index search and Swarms"
 keywords = ["synth", "index", "search", "citations", "research", "swarms", "mcp", "sdk"]
 authors = [{name = "Synth AI", email = "josh@usesynth.ai"}]

{synth_ai-0.22.2.dev682 → synth_ai-0.22.2.dev683}/synth_ai/sdk/research/contracts/__init__.py

@@ -456,6 +456,7 @@ from synth_ai.sdk.research.contracts.swarms import (
     BranchResult,
     BranchSpec,
     CredentialProvider,
+    DeploymentPin,
     DeprecatedActorModel,
     DirectedEffortOutcomeSpec,
     EnvironmentVariable,
@@ -472,6 +473,7 @@ from synth_ai.sdk.research.contracts.swarms import (
     PlatformResolvedExecutionTarget,
     PrimaryParentKind,
     PrimaryParentRef,
+    ProvenanceMode,
     ProviderBinding,
     ProviderPolicy,
     ResearchSwarm,
@@ -490,6 +492,7 @@ from synth_ai.sdk.research.contracts.swarms import (
     RunPolicy,
     RunPolicyAccess,
     RunPolicyLimits,
+    RunResourceBindings,
     Swarm,
     SwarmEnvironment,
     SwarmPreflight,
@@ -1069,6 +1072,9 @@ __all__ = [
     "SwarmPreflight",
     "SwarmPreflightBlocker",
     "SwarmRuntimeSnapshot",
+    "DeploymentPin",
+    "ProvenanceMode",
+    "RunResourceBindings",
     "SwarmSpec",
     "SwarmState",
     "SwarmTerminalOutcome",

{synth_ai-0.22.2.dev682 → synth_ai-0.22.2.dev683}/synth_ai/sdk/research/contracts/swarms.py

@@ -26,6 +26,7 @@ from synth_ai.sdk.research.contracts.common import (
     SwarmId,
     require_text,
 )
+from synth_ai.sdk.research.contracts.types import RunResourceBindings
 
 FrozenJsonScalar: TypeAlias = str | int | float | bool | None
 FrozenJsonValue: TypeAlias = (
@@ -1153,6 +1154,54 @@ class AiCachePolicy:
         return payload
 
 
+class ProvenanceMode(StrEnum):
+    """Launch provenance posture (backend ``SmrProjectTriggerRequest.provenance_mode``)."""
+
+    LIVE = "live"
+    DRY_RUN = "dry_run"
+
+
+@dataclass(frozen=True, slots=True)
+class DeploymentPin:
+    """One repository's resolved deployment receipt (backend ``SmrDeploymentPinRequest``).
+
+    The backend provenance authority refuses placeholder pins in ``live`` mode;
+    the SDK checks shape only.
+    """
+
+    repository: str
+    commit_sha: str
+    environment: str
+    resolved_at: datetime
+    deployment_id: str | None = None
+    artifact_digest: str | None = None
+
+    def __post_init__(self) -> None:
+        require_text(self.repository, field_name="deployment_pin.repository")
+        require_text(self.commit_sha, field_name="deployment_pin.commit_sha")
+        require_text(self.environment, field_name="deployment_pin.environment")
+        if not isinstance(self.resolved_at, datetime):
+            raise ValueError("deployment_pin.resolved_at must be a datetime")
+        if self.resolved_at.tzinfo is None:
+            raise ValueError("deployment_pin.resolved_at must be timezone-aware")
+        for name, value in (
+            ("deployment_id", self.deployment_id),
+            ("artifact_digest", self.artifact_digest),
+        ):
+            if value is not None:
+                require_text(value, field_name=f"deployment_pin.{name}")
+
+    def to_wire(self) -> JsonObject:
+        return {
+            "repository": self.repository,
+            "commit_sha": self.commit_sha,
+            "deployment_id": self.deployment_id,
+            "artifact_digest": self.artifact_digest,
+            "environment": self.environment,
+            "resolved_at": self.resolved_at.isoformat(),
+        }
+
+
 @dataclass(frozen=True, slots=True)
 class SwarmSpec:
     objective: str
@@ -1191,6 +1240,15 @@ class SwarmSpec:
     dev_environment_id: str | None = None
     effort_id: str | None = None
     idempotency_key: str | None = None
+    #: Explicit launch resource inventories. Always serialized: the backend
+    #: refuses ``resource_inventory_unspecified`` when the lists are omitted,
+    #: and an empty list selects none.
+    resource_bindings: RunResourceBindings = field(default_factory=RunResourceBindings)
+    #: Resolved deployment receipts, one per participating repository. Must be
+    #: non-empty together with ``provenance_mode``; leaving both unset sends
+    #: neither and the backend refuses ``provenance_unbound``.
+    deployment_pins: tuple[DeploymentPin, ...] = ()
+    provenance_mode: ProvenanceMode | None = None
     provider: (
         InferenceProvider
         | str
@@ -1274,6 +1332,16 @@ class SwarmSpec:
             )
         ):
             raise ValueError("execution_target cannot be combined with legacy placement fields")
+        if not isinstance(self.resource_bindings, RunResourceBindings):
+            raise ValueError("resource_bindings must be RunResourceBindings")
+        pins = tuple(self.deployment_pins)
+        if any(not isinstance(pin, DeploymentPin) for pin in pins):
+            raise ValueError("deployment_pins values must be DeploymentPin")
+        object.__setattr__(self, "deployment_pins", pins)
+        if self.provenance_mode is not None:
+            object.__setattr__(self, "provenance_mode", ProvenanceMode(self.provenance_mode))
+        if (self.provenance_mode is None) != (not pins):
+            raise ValueError("deployment_pins and provenance_mode must be supplied together")
         normalized_images: dict[str, ActorImageBinding] = {}
         for role, binding in dict(self.actor_image_overrides).items():
             if not isinstance(binding, ActorImageBinding):
@@ -1378,6 +1446,10 @@ class SwarmSpec:
             payload["primary_parent_ref"] = self.primary_parent_ref.to_wire()
         if self.primary_parent is not None:
             payload["primary_parent"] = self.primary_parent.to_wire()
+        payload["resource_bindings"] = cast(JsonObject, self.resource_bindings.to_wire())
+        if self.provenance_mode is not None:
+            payload["deployment_pins"] = [pin.to_wire() for pin in self.deployment_pins]
+            payload["provenance_mode"] = self.provenance_mode.value
         return payload
 
 

{synth_ai-0.22.2.dev682 → synth_ai-0.22.2.dev683}/synth_ai/sdk/research/public.py

@@ -79,6 +79,7 @@ from synth_ai.sdk.research.contracts import (
     DatasetRevisionResponse,
     Delivery,
     DeliveryReceipt,
+    DeploymentPin,
     DeprecatedActorModel,
     DirectedEffortOutcomeSpec,
     DraftDeliveryAuthorityResponse,
@@ -305,6 +306,7 @@ from synth_ai.sdk.research.contracts import (
     ProjectRuntimeOperationReceipt,
     ProjectSpec,
     ProjectWorkspaceInputs,
+    ProvenanceMode,
     ProviderBinding,
     ProviderPolicy,
     RegistryActorRuntimeImageRegistration,
@@ -332,6 +334,7 @@ from synth_ai.sdk.research.contracts import (
     RunPolicy,
     RunPolicyAccess,
     RunPolicyLimits,
+    RunResourceBindings,
     RuntimeImageKind,
     RuntimeImageRef,
     RuntimeImageReleaseArchiveResponse,
@@ -883,6 +886,9 @@ __all__ = [
     "SwarmId",
     "SwarmLivenessPhase",
     "SwarmRuntimeSnapshot",
+    "DeploymentPin",
+    "ProvenanceMode",
+    "RunResourceBindings",
     "SwarmSpec",
     "SwarmState",
     "SwarmTranscriptEvent",

{synth_ai-0.22.2.dev682 → synth_ai-0.22.2.dev683/synth_ai.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synth-ai
-Version: 0.22.2.dev682
+Version: 0.22.2.dev683
 Summary: Python SDK, CLI and MCP servers for Synth Index search and Swarms
 Author-email: Synth AI <josh@usesynth.ai>
 License-Expression: MIT