feat(api): add StatusGoal model and goal field to agent_execution

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 193
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod/gitpod-b9c1a7558d4dda4b0e58729d1c14b130d19262615d63ce6c78340daeca76188e.yml
-openapi_spec_hash: a91da1453dbfb8aceccb085665b3b21d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod/gitpod-c98c46c0408dfba7bdd2887afe0c58542113d05999d7ea1c34519f513e9a5fdf.yml
+openapi_spec_hash: 6a9e3377c0df786e5e88be2dfad93f66
 config_hash: 9052d3b03d620cf6871184b15487e020

src/gitpod/types/agent_execution.py

@@ -21,6 +21,7 @@
     "StatusCurrentOperation",
     "StatusCurrentOperationLlm",
     "StatusCurrentOperationToolUse",
+    "StatusGoal",
     "StatusMcpIntegrationStatus",
     "StatusOutputs",
     "StatusUsedEnvironment",
@@ -308,6 +309,30 @@ class StatusCurrentOperation(BaseModel):
     tool_use: Optional[StatusCurrentOperationToolUse] = FieldInfo(alias="toolUse", default=None)
 
 
+class StatusGoal(BaseModel):
+    """goal projects the current native Codex thread goal, if any."""
+
+    objective: Optional[str] = None
+    """
+    objective is the current goal text tracked by the native Codex thread-goal
+    subsystem.
+    """
+
+    status: Optional[
+        Literal[
+            "GOAL_STATUS_UNSPECIFIED",
+            "GOAL_STATUS_ACTIVE",
+            "GOAL_STATUS_PAUSED",
+            "GOAL_STATUS_COMPLETED",
+            "GOAL_STATUS_BUDGET_EXHAUSTED",
+        ]
+    ] = None
+    """status is the lifecycle state of the current goal."""
+
+    updated_at: Optional[datetime] = FieldInfo(alias="updatedAt", default=None)
+    """updated_at is the most recent native goal update timestamp, when available."""
+
+
 class StatusMcpIntegrationStatus(BaseModel):
     """
     MCPIntegrationStatus represents the status of a single MCP integration
@@ -393,6 +418,9 @@ class Status(BaseModel):
     ] = FieldInfo(alias="failureReason", default=None)
     """failure_reason contains a structured reason code for the failure."""
 
+    goal: Optional[StatusGoal] = None
+    """goal projects the current native Codex thread goal, if any."""
+
     input_tokens_used: Optional[str] = FieldInfo(alias="inputTokensUsed", default=None)
 
     iterations: Optional[str] = None