feat(api): add goal field to agent execution status

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/resources/agents.ts

@@ -802,6 +802,11 @@ export namespace AgentExecution {
       | 'AGENT_EXECUTION_FAILURE_REASON_INTERNAL'
       | 'AGENT_EXECUTION_FAILURE_REASON_AGENT_EXECUTION';
 
+    /**
+     * goal projects the current native Codex thread goal, if any.
+     */
+    goal?: Status.Goal;
+
     inputTokensUsed?: string;
 
     iterations?: string;
@@ -923,6 +928,32 @@ export namespace AgentExecution {
       }
     }
 
+    /**
+     * goal projects the current native Codex thread goal, if any.
+     */
+    export interface Goal {
+      /**
+       * objective is the current goal text tracked by the native Codex thread-goal
+       * subsystem.
+       */
+      objective?: string;
+
+      /**
+       * status is the lifecycle state of the current goal.
+       */
+      status?:
+        | 'GOAL_STATUS_UNSPECIFIED'
+        | 'GOAL_STATUS_ACTIVE'
+        | 'GOAL_STATUS_PAUSED'
+        | 'GOAL_STATUS_COMPLETED'
+        | 'GOAL_STATUS_BUDGET_EXHAUSTED';
+
+      /**
+       * updated_at is the most recent native goal update timestamp, when available.
+       */
+      updatedAt?: string;
+    }
+
     /**
      * MCPIntegrationStatus represents the status of a single MCP integration within an
      * agent execution context