feat: Add VMIdleTimeoutMinutes param to API

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-c098713ad7d0db50c26687968fc23fbb61b919a674a9f26bb3375af48ea816f1.yml
-openapi_spec_hash: 633a8a510fd3d0eb0c17c61522de6003
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-4caffe00bccb10ade46f9043bec5c13558c78c49b35fc5dfa3e0ac6258465ce2.yml
+openapi_spec_hash: ed3c519d0d108a9a9da06d0ff1bad9a9
 config_hash: e894152aaebba5a2e65e27efaf2712e2

src/oz_agent_sdk/resources/agent/runs.py

@@ -118,7 +118,7 @@ def list(
         to `sort_by=updated_at` and `sort_order=desc`.
 
         Args:
-          artifact_type: Filter runs by artifact type (PLAN or PULL_REQUEST)
+          artifact_type: Filter runs by artifact type
 
           created_after: Filter runs created after this timestamp (RFC3339 format)
 
@@ -333,7 +333,7 @@ async def list(
         to `sort_by=updated_at` and `sort_order=desc`.
 
         Args:
-          artifact_type: Filter runs by artifact type (PLAN or PULL_REQUEST)
+          artifact_type: Filter runs by artifact type
 
           created_after: Filter runs created after this timestamp (RFC3339 format)
 

src/oz_agent_sdk/resources/agent/schedules.py

@@ -275,8 +275,7 @@ def pause(
     ) -> ScheduledAgentItem:
         """Pause a scheduled agent.
 
-        The agent will not run until resumed. This sets the
-        enabled flag to false.
+        The agent will not run until resumed.
 
         Args:
           extra_headers: Send extra headers
@@ -311,7 +310,7 @@ def resume(
         """Resume a paused scheduled agent.
 
         The agent will start running according to its
-        cron schedule. This sets the enabled flag to true.
+        cron schedule.
 
         Args:
           extra_headers: Send extra headers
@@ -584,8 +583,7 @@ async def pause(
     ) -> ScheduledAgentItem:
         """Pause a scheduled agent.
 
-        The agent will not run until resumed. This sets the
-        enabled flag to false.
+        The agent will not run until resumed.
 
         Args:
           extra_headers: Send extra headers
@@ -620,7 +618,7 @@ async def resume(
         """Resume a paused scheduled agent.
 
         The agent will start running according to its
-        cron schedule. This sets the enabled flag to true.
+        cron schedule.
 
         Args:
           extra_headers: Send extra headers

src/oz_agent_sdk/types/agent/run_list_params.py

@@ -15,7 +15,7 @@
 
 class RunListParams(TypedDict, total=False):
     artifact_type: Literal["PLAN", "PULL_REQUEST", "SCREENSHOT"]
-    """Filter runs by artifact type (PLAN or PULL_REQUEST)"""
+    """Filter runs by artifact type"""
 
     created_after: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
     """Filter runs created after this timestamp (RFC3339 format)"""

src/oz_agent_sdk/types/ambient_agent_config.py

@@ -25,6 +25,19 @@ class AmbientAgentConfig(BaseModel):
     environment_id: Optional[str] = None
     """UID of the environment to run the agent in"""
 
+    harness: Optional[str] = None
+    """
+    Agent harness to use for the agent run. Default (empty) uses Warp's built-in Oz
+    harness.
+    """
+
+    idle_timeout_minutes: Optional[int] = None
+    """
+    Number of minutes to keep the agent environment alive after task completion. If
+    not set, defaults to 10 minutes. Maximum allowed value is min(60,
+    floor(max_instance_runtime_seconds / 60) for your billing tier).
+    """
+
     mcp_servers: Optional[Dict[str, McpServerConfig]] = None
     """Map of MCP server configurations by name"""
 

src/oz_agent_sdk/types/ambient_agent_config_param.py

@@ -25,6 +25,19 @@ class AmbientAgentConfigParam(TypedDict, total=False):
     environment_id: str
     """UID of the environment to run the agent in"""
 
+    harness: str
+    """
+    Agent harness to use for the agent run. Default (empty) uses Warp's built-in Oz
+    harness.
+    """
+
+    idle_timeout_minutes: int
+    """
+    Number of minutes to keep the agent environment alive after task completion. If
+    not set, defaults to 10 minutes. Maximum allowed value is min(60,
+    floor(max_instance_runtime_seconds / 60) for your billing tier).
+    """
+
     mcp_servers: Dict[str, McpServerConfigParam]
     """Map of MCP server configurations by name"""
 

tests/api_resources/agent/test_schedules.py

@@ -40,6 +40,8 @@ def test_method_create_with_all_params(self, client: OzAPI) -> None:
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
+                "harness": "harness",
+                "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
                         "args": ["string"],
@@ -154,6 +156,8 @@ def test_method_update_with_all_params(self, client: OzAPI) -> None:
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
+                "harness": "harness",
+                "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
                         "args": ["string"],
@@ -395,6 +399,8 @@ async def test_method_create_with_all_params(self, async_client: AsyncOzAPI) ->
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
+                "harness": "harness",
+                "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
                         "args": ["string"],
@@ -509,6 +515,8 @@ async def test_method_update_with_all_params(self, async_client: AsyncOzAPI) ->
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
+                "harness": "harness",
+                "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
                         "args": ["string"],

tests/api_resources/test_agent.py

@@ -123,6 +123,8 @@ def test_method_run_with_all_params(self, client: OzAPI) -> None:
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
+                "harness": "harness",
+                "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
                         "args": ["string"],
@@ -277,6 +279,8 @@ async def test_method_run_with_all_params(self, async_client: AsyncOzAPI) -> Non
                 "base_prompt": "base_prompt",
                 "computer_use_enabled": True,
                 "environment_id": "environment_id",
+                "harness": "harness",
+                "idle_timeout_minutes": 1,
                 "mcp_servers": {
                     "foo": {
                         "args": ["string"],