feat: move agent mode from Spec to Status, add AgentModeChange signals

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 160
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-46e0124fe8e07933a6ea784e81b4d02086696c246f519aaa34b087f46410c818.yml
-openapi_spec_hash: fe98c15ea1e320c05593cd57457e4af5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-cad9422301ea573f7fdbcf5047e421a0a6e963468a9d8f464e47ed1800a8fc75.yml
+openapi_spec_hash: b2e5072d4659a5c4fb5d2e8916388af9
 config_hash: d3267594264bfb76d2ee7e881d5f8a5a

src/gitpod/types/agent_execution.py

@@ -259,9 +259,6 @@ class Spec(BaseModel):
 
     limits: Optional[SpecLimits] = None
 
-    mode: Optional[AgentMode] = None
-    """mode is the operational mode for this agent execution"""
-
     session: Optional[str] = None
 
     spec_version: Optional[str] = FieldInfo(alias="specVersion", default=None)
@@ -355,6 +352,12 @@ class Status(BaseModel):
     judgement: Optional[str] = None
     """judgement is the judgement of the agent run produced by the judgement prompt."""
 
+    mode: Optional[AgentMode] = None
+    """
+    mode is the current operational mode of the agent execution. This is set by the
+    agent when entering different modes (e.g., Ralph mode via /ona:ralph command).
+    """
+
     outputs: Optional[Dict[str, StatusOutputs]] = None
     """
     outputs is a map of key-value pairs that can be set by the agent during

src/gitpod/types/agent_mode.py

@@ -4,4 +4,6 @@
 
 __all__ = ["AgentMode"]
 
-AgentMode: TypeAlias = Literal["AGENT_MODE_UNSPECIFIED", "AGENT_MODE_EXECUTION", "AGENT_MODE_PLANNING"]
+AgentMode: TypeAlias = Literal[
+    "AGENT_MODE_UNSPECIFIED", "AGENT_MODE_EXECUTION", "AGENT_MODE_PLANNING", "AGENT_MODE_RALPH"
+]