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

agent.go

@@ -911,9 +911,11 @@ type AgentExecutionStatus struct {
 	// failure_message contains the reason the agent run failed to operate.
 	FailureMessage string `json:"failureMessage"`
 	// failure_reason contains a structured reason code for the failure.
-	FailureReason   AgentExecutionStatusFailureReason `json:"failureReason"`
-	InputTokensUsed string                            `json:"inputTokensUsed"`
-	Iterations      string                            `json:"iterations"`
+	FailureReason AgentExecutionStatusFailureReason `json:"failureReason"`
+	// goal projects the current native Codex thread goal, if any.
+	Goal            AgentExecutionStatusGoal `json:"goal"`
+	InputTokensUsed string                   `json:"inputTokensUsed"`
+	Iterations      string                   `json:"iterations"`
 	// judgement is the judgement of the agent run produced by the judgement prompt.
 	Judgement string `json:"judgement"`
 	// mcp_integration_statuses contains the status of all MCP integrations used by
@@ -957,6 +959,7 @@ type agentExecutionStatusJSON struct {
 	CurrentOperation         apijson.Field
 	FailureMessage           apijson.Field
 	FailureReason            apijson.Field
+	Goal                     apijson.Field
 	InputTokensUsed          apijson.Field
 	Iterations               apijson.Field
 	Judgement                apijson.Field
@@ -1076,6 +1079,55 @@ func (r AgentExecutionStatusFailureReason) IsKnown() bool {
 	return false
 }
 
+// goal projects the current native Codex thread goal, if any.
+type AgentExecutionStatusGoal struct {
+	// objective is the current goal text tracked by the native Codex thread-goal
+	// subsystem.
+	Objective string `json:"objective"`
+	// status is the lifecycle state of the current goal.
+	Status AgentExecutionStatusGoalStatus `json:"status"`
+	// updated_at is the most recent native goal update timestamp, when available.
+	UpdatedAt time.Time                    `json:"updatedAt" format:"date-time"`
+	JSON      agentExecutionStatusGoalJSON `json:"-"`
+}
+
+// agentExecutionStatusGoalJSON contains the JSON metadata for the struct
+// [AgentExecutionStatusGoal]
+type agentExecutionStatusGoalJSON struct {
+	Objective   apijson.Field
+	Status      apijson.Field
+	UpdatedAt   apijson.Field
+	raw         string
+	ExtraFields map[string]apijson.Field
+}
+
+func (r *AgentExecutionStatusGoal) UnmarshalJSON(data []byte) (err error) {
+	return apijson.UnmarshalRoot(data, r)
+}
+
+func (r agentExecutionStatusGoalJSON) RawJSON() string {
+	return r.raw
+}
+
+// status is the lifecycle state of the current goal.
+type AgentExecutionStatusGoalStatus string
+
+const (
+	AgentExecutionStatusGoalStatusGoalStatusUnspecified     AgentExecutionStatusGoalStatus = "GOAL_STATUS_UNSPECIFIED"
+	AgentExecutionStatusGoalStatusGoalStatusActive          AgentExecutionStatusGoalStatus = "GOAL_STATUS_ACTIVE"
+	AgentExecutionStatusGoalStatusGoalStatusPaused          AgentExecutionStatusGoalStatus = "GOAL_STATUS_PAUSED"
+	AgentExecutionStatusGoalStatusGoalStatusCompleted       AgentExecutionStatusGoalStatus = "GOAL_STATUS_COMPLETED"
+	AgentExecutionStatusGoalStatusGoalStatusBudgetExhausted AgentExecutionStatusGoalStatus = "GOAL_STATUS_BUDGET_EXHAUSTED"
+)
+
+func (r AgentExecutionStatusGoalStatus) IsKnown() bool {
+	switch r {
+	case AgentExecutionStatusGoalStatusGoalStatusUnspecified, AgentExecutionStatusGoalStatusGoalStatusActive, AgentExecutionStatusGoalStatusGoalStatusPaused, AgentExecutionStatusGoalStatusGoalStatusCompleted, AgentExecutionStatusGoalStatusGoalStatusBudgetExhausted:
+		return true
+	}
+	return false
+}
+
 // MCPIntegrationStatus represents the status of a single MCP integration within an
 // agent execution context
 type AgentExecutionStatusMcpIntegrationStatus struct {