feat(api): add dev_runner_id to agents, dev_environment_id and provider to runners

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 172
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-871abe56c856169257435fbf85a09a3c075c2677671282c92606590e0a1bfc54.yml
-openapi_spec_hash: 7d0d7816110fc899f755a9d39770c044
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gitpod%2Fgitpod-700cd47eae87ca42bbbdc8b39e84e864226d169f0c369f414680f9eda694d3a5.yml
+openapi_spec_hash: 9364ced18661e420a15fb1be5203da4b
 config_hash: ad1db65b32248aecda41b64586aac9ce

src/gitpod/resources/agents.py

@@ -540,6 +540,7 @@ def start_execution(
         code_context: AgentCodeContextParam | Omit = omit,
         mode: AgentMode | Omit = omit,
         name: str | Omit = omit,
+        runner_id: str | Omit = omit,
         workflow_action_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -569,6 +570,10 @@ def start_execution(
           mode: mode specifies the operational mode for this agent execution If not specified,
               defaults to AGENT_MODE_EXECUTION
 
+          runner_id: runner_id specifies a runner for this agent execution. When set, the agent
+              execution is routed to this runner instead of the runner associated with the
+              environment.
+
           workflow_action_id: workflow_action_id is an optional reference to the workflow execution action
               that created this agent execution. Used for tracking and event correlation.
 
@@ -588,6 +593,7 @@ def start_execution(
                     "code_context": code_context,
                     "mode": mode,
                     "name": name,
+                    "runner_id": runner_id,
                     "workflow_action_id": workflow_action_id,
                 },
                 agent_start_execution_params.AgentStartExecutionParams,
@@ -1194,6 +1200,7 @@ async def start_execution(
         code_context: AgentCodeContextParam | Omit = omit,
         mode: AgentMode | Omit = omit,
         name: str | Omit = omit,
+        runner_id: str | Omit = omit,
         workflow_action_id: Optional[str] | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -1223,6 +1230,10 @@ async def start_execution(
           mode: mode specifies the operational mode for this agent execution If not specified,
               defaults to AGENT_MODE_EXECUTION
 
+          runner_id: runner_id specifies a runner for this agent execution. When set, the agent
+              execution is routed to this runner instead of the runner associated with the
+              environment.
+
           workflow_action_id: workflow_action_id is an optional reference to the workflow execution action
               that created this agent execution. Used for tracking and event correlation.
 
@@ -1242,6 +1253,7 @@ async def start_execution(
                     "code_context": code_context,
                     "mode": mode,
                     "name": name,
+                    "runner_id": runner_id,
                     "workflow_action_id": workflow_action_id,
                 },
                 agent_start_execution_params.AgentStartExecutionParams,

src/gitpod/types/agent_start_execution_params.py

@@ -25,6 +25,13 @@ class AgentStartExecutionParams(TypedDict, total=False):
 
     name: str
 
+    runner_id: Annotated[str, PropertyInfo(alias="runnerId")]
+    """
+    runner_id specifies a runner for this agent execution. When set, the agent
+    execution is routed to this runner instead of the runner associated with the
+    environment.
+    """
+
     workflow_action_id: Annotated[Optional[str], PropertyInfo(alias="workflowActionId")]
     """
     workflow_action_id is an optional reference to the workflow execution action

src/gitpod/types/runner_provider.py

@@ -11,4 +11,5 @@
     "RUNNER_PROVIDER_DESKTOP_MAC",
     "RUNNER_PROVIDER_MANAGED",
     "RUNNER_PROVIDER_GCP",
+    "RUNNER_PROVIDER_DEV_AGENT",
 ]

tests/api_resources/test_agents.py

@@ -438,6 +438,7 @@ def test_method_start_execution_with_all_params(self, client: Gitpod) -> None:
             },
             mode="AGENT_MODE_UNSPECIFIED",
             name="name",
+            runner_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             workflow_action_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
         )
         assert_matches_type(AgentStartExecutionResponse, agent, path=["response"])
@@ -963,6 +964,7 @@ async def test_method_start_execution_with_all_params(self, async_client: AsyncG
             },
             mode="AGENT_MODE_UNSPECIFIED",
             name="name",
+            runner_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
             workflow_action_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
         )
         assert_matches_type(AgentStartExecutionResponse, agent, path=["response"])