llama-deploy-core 0.3.13__tar.gz → 0.3.14__tar.gz

{llama_deploy_core-0.3.13 → llama_deploy_core-0.3.14}/PKG-INFO

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

{llama_deploy_core-0.3.13 → llama_deploy_core-0.3.14}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "llama-deploy-core"
-version = "0.3.13"
+version = "0.3.14"
 description = "Core models and schemas for LlamaDeploy"
 readme = "README.md"
 license = { text = "MIT" }

{llama_deploy_core-0.3.13 → llama_deploy_core-0.3.14}/src/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-0.3.13 → llama_deploy_core-0.3.14}/src/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-0.3.13 → llama_deploy_core-0.3.14}/src/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-0.3.13 → llama_deploy_core-0.3.14}/src/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-0.3.13 → llama_deploy_core-0.3.14}/src/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-0.3.13 → llama_deploy_core-0.3.14}/src/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)],