feat: Improve session state reliability

- Instead of a str, the API returns a fixed set of available states.
  This makes handling in other application and the frontend easier.
- A separate attribute "preparation_state" is returned, indicating
  the status of the session preparation.
- Sessions no longer spawn deployments, Pods are directly created instead.
  This avoids unwanted restarts of containers.
- The `app` label on workloads has been replaced with `capellacollab/session-id`
- The logs are no longer considered for the session state.

backend/capellacollab/sessions/injection.py

@@ -2,15 +2,12 @@
 # SPDX-License-Identifier: Apache-2.0
 
 import logging
-import re
 
 import requests
 
 from capellacollab import core
 from capellacollab.config import config
 
-from . import operators
-
 log = logging.getLogger(__name__)
 
 
@@ -45,20 +42,3 @@ def _get_last_seen(idletime: int | float) -> str:
         return f"{round(idlehours, 2)} hrs ago"
 
     return f"{idletime:.0f} mins ago"
-
-
-def determine_session_state(session_id: str) -> str:
-    state = operators.get_operator().get_session_state(session_id)
-
-    if state in ("Started", "BackOff"):
-        try:
-            logs = operators.get_operator().get_session_logs(
-                session_id, container="session-preparation"
-            )
-            logs += operators.get_operator().get_session_logs(session_id)
-            res = re.search(r"(?s:.*)^---(.*?)---$", logs, re.MULTILINE)
-            if res:
-                return res.group(1)
-        except Exception:
-            log.exception("Could not parse log")
-    return state

backend/capellacollab/sessions/models.py

@@ -15,6 +15,7 @@
 from capellacollab.core import database
 from capellacollab.core import models as core_models
 from capellacollab.core import pydantic as core_pydantic
+from capellacollab.sessions import operators
 from capellacollab.tools import models as tools_models
 from capellacollab.users import models as users_models
 
@@ -69,6 +70,24 @@ class SessionSharing(core_pydantic.BaseModel):
     created_at: datetime.datetime
 
 
+class SessionPreparationState(enum.Enum):
+    RUNNING = "Running"
+    COMPLETED = "Completed"
+    FAILED = "Failed"
+    PENDING = "Pending"
+    NOT_FOUND = "NotFound"
+    UNKNOWN = "Unknown"
+
+
+class SessionState(enum.Enum):
+    RUNNING = "Running"
+    FAILED = "Failed"
+    TERMINATED = "Terminated"
+    PENDING = "Pending"
+    NOT_FOUND = "NotFound"
+    UNKNOWN = "Unknown"
+
+
 class Session(core_pydantic.BaseModel):
     id: str
     type: SessionType
@@ -77,7 +96,10 @@ class Session(core_pydantic.BaseModel):
 
     version: tools_models.ToolVersionWithTool
 
-    state: str = pydantic.Field(default="UNKNOWN")
+    preparation_state: SessionPreparationState = pydantic.Field(
+        default=SessionPreparationState.UNKNOWN
+    )
+    state: SessionState = pydantic.Field(default=SessionState.UNKNOWN)
     warnings: list[core_models.Message] = pydantic.Field(default=[])
     last_seen: str = pydantic.Field(default="UNKNOWN")
 
@@ -105,7 +127,9 @@ def resolve_connection_method(self) -> t.Any:
     @pydantic.model_validator(mode="after")
     def add_warnings_and_last_seen(self) -> t.Any:
         self.last_seen = injection.get_last_seen(self.id)
-        self.state = injection.determine_session_state(self.id)
+        self.preparation_state, self.state = (
+            operators.get_operator().get_session_state(self.id)
+        )
 
         return self