llama-deploy-core 0.3.12__py3-none-any.whl → 0.3.14__py3-none-any.whl

llama_deploy/core/client/manage_client.py

@@ -8,9 +8,11 @@ from llama_deploy.core.client.ssl_util import get_httpx_verify_param
 from llama_deploy.core.schema import LogEvent
 from llama_deploy.core.schema.deployments import (
     DeploymentCreate,
+    DeploymentHistoryResponse,
     DeploymentResponse,
     DeploymentsListResponse,
     DeploymentUpdate,
+    RollbackRequest,
 )
 from llama_deploy.core.schema.git_validation import (
     RepositoryValidationRequest,
@@ -202,6 +204,27 @@ class ProjectClient(BaseClient):
         _raise_for_status(response)
         return DeploymentResponse.model_validate(response.json())
 
+    async def get_deployment_history(
+        self, deployment_id: str
+    ) -> DeploymentHistoryResponse:
+        response = await self.client.get(
+            f"/api/v1beta1/deployments/{deployment_id}/history",
+            params={"project_id": self.project_id},
+        )
+        _raise_for_status(response)
+        return DeploymentHistoryResponse.model_validate(response.json())
+
+    async def rollback_deployment(
+        self, deployment_id: str, git_sha: str
+    ) -> DeploymentResponse:
+        response = await self.client.post(
+            f"/api/v1beta1/deployments/{deployment_id}/rollback",
+            params={"project_id": self.project_id},
+            json=RollbackRequest(git_sha=git_sha).model_dump(),
+        )
+        _raise_for_status(response)
+        return DeploymentResponse.model_validate(response.json())
+
     async def validate_repository(
         self,
         repo_url: str,

llama_deploy/core/git/git_util.py

@@ -265,6 +265,14 @@ def get_current_branch() -> str | None:
     return result.strip() if result.strip() else None
 
 
+def get_commit_sha_for_ref(ref: str) -> str | None:
+    """
+    get the commit SHA for a specified ref (branch, commit, HEAD...)
+    """
+    result = _run_process(["git", "rev-parse", ref])
+    return result.strip() if result.strip() else None
+
+
 def get_git_root() -> Path:
     """
     get the root of the current git repo

llama_deploy/core/schema/__init__.py

@@ -1,12 +1,14 @@
 from .base import Base
 from .deployments import (
     DeploymentCreate,
+    DeploymentHistoryResponse,
     DeploymentResponse,
     DeploymentsListResponse,
     DeploymentUpdate,
     LlamaDeploymentPhase,
     LlamaDeploymentSpec,
     LogEvent,
+    RollbackRequest,
     apply_deployment_update,
 )
 from .git_validation import RepositoryValidationRequest, RepositoryValidationResponse
@@ -20,6 +22,8 @@ __all__ = [
     "DeploymentResponse",
     "DeploymentUpdate",
     "DeploymentsListResponse",
+    "DeploymentHistoryResponse",
+    "RollbackRequest",
     "LlamaDeploymentSpec",
     "apply_deployment_update",
     "LlamaDeploymentPhase",

llama_deploy/core/schema/deployments.py

@@ -102,6 +102,8 @@ class LlamaDeploymentStatus(Base):
     message: str | None = None
     lastUpdated: datetime | None = None
     authToken: str | None = None
+    # Historical list of released versions from the CRD (camelCase fields)
+    releaseHistory: list["ReleaseHistoryEntry"] | None = None
 
 
 class LlamaDeploymentCRD(Base):
@@ -224,3 +226,33 @@ class LogEvent(Base):
     container: str
     text: str
     timestamp: datetime
+
+
+# ===== Release history models =====
+
+
+class ReleaseHistoryEntry(Base):
+    """
+    Mirrors the CRD status.releaseHistory entry with camelCase keys.
+    """
+
+    gitSha: str
+    releasedAt: datetime
+
+
+class ReleaseHistoryItem(Base):
+    """
+    API-exposed release history item with snake_case keys for clients.
+    """
+
+    git_sha: str
+    released_at: datetime
+
+
+class DeploymentHistoryResponse(Base):
+    deployment_id: str
+    history: list[ReleaseHistoryItem]
+
+
+class RollbackRequest(Base):
+    git_sha: str

llama_deploy/core/server/manage_api/_abstract_deployments_service.py

@@ -3,7 +3,11 @@ from typing import AsyncGenerator, cast
 
 from llama_deploy.core import schema
 from llama_deploy.core.schema import LogEvent
-from llama_deploy.core.schema.deployments import DeploymentResponse
+from llama_deploy.core.schema.deployments import (
+    DeploymentHistoryResponse,
+    DeploymentResponse,
+    RollbackRequest,
+)
 
 
 class AbstractPublicDeploymentsService(ABC):
@@ -134,6 +138,24 @@ class AbstractDeploymentsService(ABC):
         """
         ...
 
+    @abstractmethod
+    async def get_deployment_history(
+        self, project_id: str, deployment_id: str
+    ) -> DeploymentHistoryResponse:
+        """
+        Get the release history for a deployment.
+        """
+        ...
+
+    @abstractmethod
+    async def rollback_deployment(
+        self, project_id: str, deployment_id: str, request: RollbackRequest
+    ) -> DeploymentResponse:
+        """
+        Roll back a deployment to a previous git sha.
+        """
+        ...
+
     @abstractmethod
     async def stream_deployment_logs(
         self,

llama_deploy/core/server/manage_api/_create_deployments_router.py

@@ -103,6 +103,25 @@ def create_v1beta1_deployments_router(
 
         return deployment
 
+    @router.get("/{deployment_id}/history")
+    async def get_deployment_history(
+        project_id: Annotated[str, Depends(get_project_id)],
+        deployment_id: str,
+    ) -> schema.DeploymentHistoryResponse:
+        return await deployments_service.get_deployment_history(
+            project_id=project_id, deployment_id=deployment_id
+        )
+
+    @router.post("/{deployment_id}/rollback")
+    async def rollback_deployment(
+        project_id: Annotated[str, Depends(get_project_id)],
+        deployment_id: str,
+        request: schema.RollbackRequest,
+    ) -> schema.DeploymentResponse:
+        return await deployments_service.rollback_deployment(
+            project_id=project_id, deployment_id=deployment_id, request=request
+        )
+
     @router.delete("/{deployment_id}")
     async def delete_deployment(
         project_id: Annotated[str, Depends(get_project_id)],

{llama_deploy_core-0.3.12.dist-info → llama_deploy_core-0.3.14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: llama-deploy-core
-Version: 0.3.12
+Version: 0.3.14
 Summary: Core models and schemas for LlamaDeploy
 License: MIT
 Requires-Dist: fastapi>=0.115.0

{llama_deploy_core-0.3.12.dist-info → llama_deploy_core-0.3.14.dist-info}/RECORD

@@ -1,23 +1,23 @@
 llama_deploy/core/__init__.py,sha256=112612bf2e928c2e0310d6556bb13fc28c00db70297b90a8527486cd2562e408,43
-llama_deploy/core/client/manage_client.py,sha256=944f565d8e9397e76e94b032d91b818924dc5b5b4c5859eb78e20d670707de00,9479
+llama_deploy/core/client/manage_client.py,sha256=d33613cc3355896dc15d20ead713b7766fd900f43c5f4d547e8e8df9e29a660f,10366
 llama_deploy/core/client/ssl_util.py,sha256=b9743dc828fa27c18ba0867b1348662cdf0d855965c5a33db63505f23eef5d7b,1010
 llama_deploy/core/config.py,sha256=69bb0ea8ac169eaa4e808cd60a098b616bddd3145d26c6c35e56db38496b0e6a,35
 llama_deploy/core/deployment_config.py,sha256=bde431070758421f578f2e27f006152147e8cd752ee1054f1bf7c37ca95b0b38,15853
-llama_deploy/core/git/git_util.py,sha256=e62a5479c619a5973de203ebcc56b9729b5060c48fcb9cfc2e442756716c2abf,10960
+llama_deploy/core/git/git_util.py,sha256=8b20ba8c12cbcd26ef7d4d06e9fd693f643fc4a64d6da739c3977451e91f1658,11206
 llama_deploy/core/iter_utils.py,sha256=68ac9dbf09f58315ffcfec6bd01ed50b88a954b00458da9bc28a0535b79ba29e,7042
 llama_deploy/core/path_util.py,sha256=14d50c0c337c8450ed46cafc88436027056b365a48370a69cdb76c88d7c26fd1,798
 llama_deploy/core/py.typed,sha256=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855,0
-llama_deploy/core/schema/__init__.py,sha256=d1459ee50c690779a682130eff72f61dc1a687d2d4b26d8a5d3620a72d92d831,802
+llama_deploy/core/schema/__init__.py,sha256=d466fb068415a890de01be1696237cbd62e5fb0d83a6b2976e80c4d29381cd29,910
 llama_deploy/core/schema/base.py,sha256=2de6d23e58c36b6bb311ec0aea4b902661867056c1250c6b7ce3bad17141fe15,677
-llama_deploy/core/schema/deployments.py,sha256=a85c294fdca939023918d93c36e4fa3f7a39a65383ec3b8f60d2f82ba43c0e93,7030
+llama_deploy/core/schema/deployments.py,sha256=b541978218dfcd1de4a326c7376c172b9ece1d2ccff85631c6551608610b98f8,7683
 llama_deploy/core/schema/git_validation.py,sha256=27b306aa6ecabe58cab6381d92551545f263fe7550c58b3087115410bc71fd21,1915
 llama_deploy/core/schema/projects.py,sha256=726f91e90ff8699c90861d9740819c44c3f00d945ab09df71bd6d35fdc218a45,726
 llama_deploy/core/schema/public.py,sha256=022129c8fc09192f5e503b0500ccf54d106f5712b9cf8ce84b3b1c37e186f930,147
 llama_deploy/core/server/manage_api/__init__.py,sha256=e477ccab59cfd084edbad46f209972a282e623eb314d0847a754a46a16361db5,457
-llama_deploy/core/server/manage_api/_abstract_deployments_service.py,sha256=85ceab2a343c3642db7f77d4a665d5710a14bca920bbfdc25c5f1168cce30b22,4638
-llama_deploy/core/server/manage_api/_create_deployments_router.py,sha256=9bc8468169445e1cc7f2a479e1c7da42b4bdd7482fa3b440e03ee49cd09a75df,6801
+llama_deploy/core/server/manage_api/_abstract_deployments_service.py,sha256=4b55c9628a9374a68bb78b7f6ae362b7cf4d1c5fc13d35e5cac191130fc13731,5181
+llama_deploy/core/server/manage_api/_create_deployments_router.py,sha256=2db7d59a43e8690cf6d3d925940212228498f0a7c5728cfcf4253830d6fa1b52,7554
 llama_deploy/core/server/manage_api/_exceptions.py,sha256=ee71cd9c2354a665e6905cd9cc752d2d65f71f0b936d33fec3c1c5229c38accf,246
 llama_deploy/core/ui_build.py,sha256=290dafa951918e5593b9035570fa4c66791d7e5ea785bd372ad11e99e8283857,1514
-llama_deploy_core-0.3.12.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
-llama_deploy_core-0.3.12.dist-info/METADATA,sha256=4a2b2d5d8204fbef0e58ea396b2d3474d01700d4e06b182cb6cb5f6a234f0d6f,698
-llama_deploy_core-0.3.12.dist-info/RECORD,,
+llama_deploy_core-0.3.14.dist-info/WHEEL,sha256=66530aef82d5020ef5af27ae0123c71abb9261377c5bc519376c671346b12918,79
+llama_deploy_core-0.3.14.dist-info/METADATA,sha256=6e3498e70352f5dac2034d2fcea13f190cdb88f61c1afcec1a000f20a4dcb895,698
+llama_deploy_core-0.3.14.dist-info/RECORD,,