mainsequence 6.0.48__tar.gz → 6.0.49__tar.gz

{mainsequence-6.0.48 → mainsequence-6.0.49}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 6.0.48
+Version: 6.0.49
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-6.0.48 → mainsequence-6.0.49}/agent_scaffold/skills/platform_operations/orchestration_and_releases/SKILL.md

@@ -302,6 +302,16 @@ The SDK surface also accepts:
 - `ResourceRelease.deploy_current_version()` for an SDK-triggered manual deployment run; it returns `DeploymentRun`
 - `DeploymentRun.filter(target_type="resource_release", target_uid=release.uid)` to inspect runs for one release
 
+Every release also exposes its immutable revision lifecycle:
+
+- `desired_revision` is the public UID of the accepted revision being materialized
+- `active_revision` is the public UID of the ready revision currently serving behind the stable release URL
+- the two UIDs may differ while a deployment is running or after a deployment fails
+- `revision_retention_count` is the positive release-owned retention setting; omission on create uses the backend default
+- configure retention with `ResourceRelease.create(..., revision_retention_count=3)` or `release.patch(revision_retention_count=5)`
+
+Treat `active_revision` and `desired_revision` as read-only public identities. Do not substitute provider revision names, deployment names, or internal database IDs.
+
 Do not claim there is a CLI command for `deploy_current_version` unless the local CLI actually exposes one. In this SDK, the manual detail action is available through the client model.
 
 Inspect the unified run's `state`, `phase`, `outcome`, `steps`, `logs`, and `error` fields. Do not use legacy resource-release deployment status fields or filters.

{mainsequence-6.0.48 → mainsequence-6.0.49}/mainsequence/client/models_helpers.py

@@ -1199,6 +1199,33 @@ class ResourceRelease(
             "The revision is returned by the API and is not part of create requests."
         ),
     )
+    revision_retention_count: PositiveInt = Field(
+        default=3,
+        title="Revision Retention Count",
+        description=(
+            "Number of immutable release revisions retained by the platform. "
+            "This positive release setting can be supplied on create or patch."
+        ),
+        examples=[3],
+    )
+    active_revision: str | None = Field(
+        default=None,
+        title="Active Revision UID",
+        description=(
+            "Public UID of the ready immutable revision currently serving behind "
+            "the stable release URL."
+        ),
+        examples=["19128ab6-d72f-460c-8525-d758fa92676a", None],
+    )
+    desired_revision: str | None = Field(
+        default=None,
+        title="Desired Revision UID",
+        description=(
+            "Public UID of the accepted immutable revision currently being "
+            "materialized. It may differ from the active revision during deployment."
+        ),
+        examples=["2a9370a7-c07f-439c-bcd9-629e3e916699", None],
+    )
     cors_allowed_origins: list[str] | None = Field(
         default=None,
         title="CORS Allowed Origins",
@@ -1222,6 +1249,7 @@ class ResourceRelease(
         gpu_type: str | None = None,
         spot: bool | None = None,
         automatic_deployment: bool | None = None,
+        revision_retention_count: int | None = None,
         timeout: int | None = None,
         files=None,
     ) -> ResourceRelease:
@@ -1268,6 +1296,10 @@ class ResourceRelease(
             payload["spot"] = bool(spot)
         if automatic_deployment is not None:
             payload["automatic_deployment"] = bool(automatic_deployment)
+        if revision_retention_count is not None:
+            payload["revision_retention_count"] = cls._normalize_revision_retention_count(
+                revision_retention_count
+            )
 
         request_payload = {"json": cls.serialize_for_json(payload)}
         if files:
@@ -1287,6 +1319,20 @@ class ResourceRelease(
 
         return cls(**r.json())
 
+    @staticmethod
+    def _normalize_revision_retention_count(value: int) -> int:
+        if isinstance(value, bool) or not isinstance(value, int) or value < 1:
+            raise ValueError("revision_retention_count must be a positive integer.")
+        return value
+
+    @classmethod
+    def patch_by_uid(cls, uid: str, *args, _into=None, **kwargs):
+        if "revision_retention_count" in kwargs:
+            kwargs["revision_retention_count"] = cls._normalize_revision_retention_count(
+                kwargs["revision_retention_count"]
+            )
+        return super().patch_by_uid(uid, *args, _into=_into, **kwargs)
+
     def deploy_current_version(
         self,
         *,

{mainsequence-6.0.48 → mainsequence-6.0.49}/mainsequence.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mainsequence
-Version: 6.0.48
+Version: 6.0.49
 Summary: Main Sequence SDK 
 Author-email: Main Sequence GmbH <dev@main-sequence.io>
 License-Expression: LicenseRef-MainSequence-Proprietary

{mainsequence-6.0.48 → mainsequence-6.0.49}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "mainsequence"
-version = "6.0.48"
+version = "6.0.49"
 description = "Main Sequence SDK "
 readme = "README.md"
 requires-python = ">=3.13"

{mainsequence-6.0.48 → mainsequence-6.0.49}/tests/test_filter_normalization.py

@@ -2538,6 +2538,9 @@ def test_resource_release_model_supports_automatic_deployment_payloads():
                 "tag_regex": None,
                 "policy_revision": 3,
             },
+            "revision_retention_count": 3,
+            "active_revision": None,
+            "desired_revision": "2a9370a7-c07f-439c-bcd9-629e3e916699",
         }
     )
 
@@ -2547,6 +2550,45 @@ def test_resource_release_model_supports_automatic_deployment_payloads():
     assert release.automatic_redeployment_policy is not None
     assert release.automatic_redeployment_policy.tag_regex is None
     assert release.automatic_redeployment_policy.policy_revision == 3
+    assert release.revision_retention_count == 3
+    assert release.active_revision is None
+    assert release.desired_revision == "2a9370a7-c07f-439c-bcd9-629e3e916699"
+
+
+def test_resource_release_filter_accepts_canonical_revision_lifecycle_projection(monkeypatch):
+    release_uid = "2f4c4c3d-5669-4da5-9d86-b84633c1e6ed"
+    desired_revision_uid = "2a9370a7-c07f-439c-bcd9-629e3e916699"
+    response_payload = {
+        "uid": release_uid,
+        "project_branch_uid": PROJECT_BRANCH_UID,
+        "name": "Pricing API",
+        "release_kind": "fastapi",
+        "automatic_deployment": True,
+        "automatic_redeployment_policy": {
+            "tag_regex": None,
+            "policy_revision": 2,
+        },
+        "revision_retention_count": 3,
+        "active_revision": None,
+        "desired_revision": desired_revision_uid,
+    }
+
+    class FakeResponse:
+        status_code = 200
+
+        @staticmethod
+        def json():
+            return [dict(response_payload)]
+
+    monkeypatch.setattr(base_mod, "make_request", lambda **kwargs: FakeResponse())
+
+    releases = models_helpers_mod.ResourceRelease.filter(project_branch_uid=PROJECT_BRANCH_UID)
+
+    assert len(releases) == 1
+    assert releases[0].uid == release_uid
+    assert releases[0].revision_retention_count == 3
+    assert releases[0].active_revision is None
+    assert releases[0].desired_revision == desired_revision_uid
 
 
 def test_legacy_resource_release_deployment_run_model_is_not_exported():
@@ -2582,6 +2624,9 @@ def test_resource_release_create_sends_automatic_deployment(monkeypatch):
                     "tag_regex": "^v[0-9]+\\.[0-9]+\\.[0-9]+$",
                     "policy_revision": 1,
                 },
+                "revision_retention_count": 5,
+                "active_revision": "19128ab6-d72f-460c-8525-d758fa92676a",
+                "desired_revision": "2a9370a7-c07f-439c-bcd9-629e3e916699",
             }
 
     def _fake_make_request(*, s, loaders, r_type, url, payload, time_out=None):
@@ -2600,6 +2645,7 @@ def test_resource_release_create_sends_automatic_deployment(monkeypatch):
         cpu_request="500m",
         memory_request="1Gi",
         automatic_deployment=True,
+        revision_retention_count=5,
         timeout=11,
     )
 
@@ -2607,14 +2653,42 @@ def test_resource_release_create_sends_automatic_deployment(monkeypatch):
     assert release.automatic_redeployment_policy is not None
     assert release.automatic_redeployment_policy.tag_regex == "^v[0-9]+\\.[0-9]+\\.[0-9]+$"
     assert release.automatic_redeployment_policy.policy_revision == 1
+    assert release.revision_retention_count == 5
+    assert release.active_revision == "19128ab6-d72f-460c-8525-d758fa92676a"
+    assert release.desired_revision == "2a9370a7-c07f-439c-bcd9-629e3e916699"
     assert captured["r_type"] == "POST"
     assert str(captured["url"]).endswith("/api/v1/resource-releases/")
     assert captured["payload"]["json"]["automatic_deployment"] is True
+    assert captured["payload"]["json"]["revision_retention_count"] == 5
     assert captured["payload"]["json"]["resource_uid"] == resource_uid
     assert captured["payload"]["json"]["related_image_uid"] == image_uid
     assert captured["timeout"] == 11
 
 
+@pytest.mark.parametrize("invalid_value", [0, -1, True, 1.5, "3"])
+def test_resource_release_create_rejects_invalid_revision_retention_count(
+    monkeypatch, invalid_value
+):
+    monkeypatch.setattr(
+        models_helpers_mod,
+        "make_request",
+        lambda **kwargs: pytest.fail("invalid retention must fail before the request"),
+    )
+
+    with pytest.raises(
+        ValueError,
+        match="revision_retention_count must be a positive integer",
+    ):
+        models_helpers_mod.ResourceRelease.create(
+            resource_uid="857bec7b-dd77-4272-aecd-13fc2138eacc",
+            related_image_uid="6cfdb152-923e-45b9-a150-c4541c68b0d1",
+            release_kind=models_helpers_mod.ResourceReleaseKind.FAST_API,
+            cpu_request="500m",
+            memory_request="1Gi",
+            revision_retention_count=invalid_value,
+        )
+
+
 def test_project_resource_create_release_uses_related_image_uid(monkeypatch):
     captured = {}
     resource_uid = "857bec7b-dd77-4272-aecd-13fc2138eacc"
@@ -2703,6 +2777,9 @@ def test_resource_release_get_accepts_fastapi_cors_allowed_origins(monkeypatch):
         "release_kind": "fastapi",
         "automatic_deployment": True,
         "automatic_redeployment_policy": None,
+        "revision_retention_count": 4,
+        "active_revision": "19128ab6-d72f-460c-8525-d758fa92676a",
+        "desired_revision": None,
         "cors_allowed_origins": [
             "https://app.example.com",
             "https://*.site-dev.main-sequence.app",
@@ -2732,12 +2809,70 @@ def test_resource_release_get_accepts_fastapi_cors_allowed_origins(monkeypatch):
     release = models_helpers_mod.ResourceRelease.get(pk=release_uid, timeout=13)
 
     assert release.release_kind == models_helpers_mod.ResourceReleaseKind.FAST_API
+    assert release.revision_retention_count == 4
+    assert release.active_revision == "19128ab6-d72f-460c-8525-d758fa92676a"
+    assert release.desired_revision is None
     assert release.cors_allowed_origins == response_payload["cors_allowed_origins"]
     assert captured["r_type"] == "GET"
     assert captured["url"].endswith(f"/resource-releases/{release_uid}/")
     assert captured["timeout"] == 13
 
 
+def test_resource_release_patch_supports_positive_revision_retention_count(monkeypatch):
+    captured = {}
+    release_uid = "2f4c4c3d-5669-4da5-9d86-b84633c1e6ed"
+    release = models_helpers_mod.ResourceRelease(
+        uid=release_uid,
+        release_kind="fastapi",
+        revision_retention_count=3,
+    )
+
+    class FakeResponse:
+        status_code = 200
+
+        @staticmethod
+        def json():
+            return {
+                "revision_retention_count": 6,
+                "active_revision": None,
+                "desired_revision": None,
+            }
+
+    def _fake_make_request(*, s, loaders, r_type, url, payload, time_out=None):
+        captured.update({"r_type": r_type, "url": url, "payload": payload})
+        return FakeResponse()
+
+    monkeypatch.setattr(base_mod, "make_request", _fake_make_request)
+
+    patched = release.patch(revision_retention_count=6)
+
+    assert patched is release
+    assert patched.revision_retention_count == 6
+    assert captured["r_type"] == "PATCH"
+    assert captured["url"].endswith(f"/resource-releases/{release_uid}/")
+    assert captured["payload"]["json"] == {"revision_retention_count": 6}
+
+
+@pytest.mark.parametrize("invalid_value", [None, 0, -1, True, 1.5, "3"])
+def test_resource_release_patch_rejects_invalid_revision_retention_count(
+    monkeypatch, invalid_value
+):
+    monkeypatch.setattr(
+        base_mod,
+        "make_request",
+        lambda **kwargs: pytest.fail("invalid retention must fail before the request"),
+    )
+
+    with pytest.raises(
+        ValueError,
+        match="revision_retention_count must be a positive integer",
+    ):
+        models_helpers_mod.ResourceRelease.patch_by_uid(
+            "2f4c4c3d-5669-4da5-9d86-b84633c1e6ed",
+            revision_retention_count=invalid_value,
+        )
+
+
 def _resource_release_pipeline_payload(*, running_step: str | None = None):
     keys = (
         "resolve_revision",