release: 0.11.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.10.1"
+  ".": "0.11.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-a912e2533a6f1fbeee38d4b7739b771ed5711c648a6a7f3d8769b8b2cb4f31fb.yml
-openapi_spec_hash: ef48f8fcc46a51b00893505e9b52c95d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-a931490557d2c27bcec6b9d7cb0502913f6a3969a5907c810a3c2073ca2ca9e0.yml
+openapi_spec_hash: 632bc51224846da7edc3996983d35ff3
 config_hash: e894152aaebba5a2e65e27efaf2712e2

CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.11.0 (2026-03-31)
+
+Full Changelog: [v0.10.1...v0.11.0](https://github.com/warpdotdev/oz-sdk-python/compare/v0.10.1...v0.11.0)
+
+### Features
+
+* Add VMIdleTimeoutMinutes param to API ([31b5a63](https://github.com/warpdotdev/oz-sdk-python/commit/31b5a63204a2baca1a41f0b4124408d2d2b7e6a4))
+* **api:** api update ([9fe02aa](https://github.com/warpdotdev/oz-sdk-python/commit/9fe02aad21c71cbab837f7d335e5234e1974bb90))
+* **api:** api update ([7fc79ef](https://github.com/warpdotdev/oz-sdk-python/commit/7fc79efe0897451670cb44cf29c0f99b06ffe821))
+* Endpoint to upload third-party harness block snapshots ([2f71989](https://github.com/warpdotdev/oz-sdk-python/commit/2f7198972cec56e72b802c7505fb445d10304bf4))
+* **internal:** implement indices array format for query and form serialization ([c518876](https://github.com/warpdotdev/oz-sdk-python/commit/c518876f3da1129d3c351982ed4a06590fd15f2e))
+* Use correct branch for Stainless PRs ([d7b298d](https://github.com/warpdotdev/oz-sdk-python/commit/d7b298d99c5dcb5e02530329fef222de92f3e9d6))
+
 ## 0.10.1 (2026-03-24)
 
 Full Changelog: [v0.10.0...v0.10.1](https://github.com/warpdotdev/oz-sdk-python/compare/v0.10.0...v0.10.1)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "oz-agent-sdk"
-version = "0.10.1"
+version = "0.11.0"
 description = "The official Python library for the oz-api API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/oz_agent_sdk/_qs.py

@@ -101,7 +101,10 @@ def _stringify_item(
                     items.extend(self._stringify_item(key, item, opts))
                 return items
             elif array_format == "indices":
-                raise NotImplementedError("The array indices format is not supported yet")
+                items = []
+                for i, item in enumerate(value):
+                    items.extend(self._stringify_item(f"{key}[{i}]", item, opts))
+                return items
             elif array_format == "brackets":
                 items = []
                 key = key + "[]"

src/oz_agent_sdk/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "oz_agent_sdk"
-__version__ = "0.10.1"  # x-release-please-version
+__version__ = "0.11.0"  # x-release-please-version

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"],