release: 0.14.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.13.0"
+  ".": "0.14.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-964f646a32c318735de7673531a12788aede1840f7ab4893f2efa31c83440837.yml
-openapi_spec_hash: 30f07ff0bfb491efb11cd88fce79968a
-config_hash: 236823a4936c76818117c16aa5c188df
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-8b8de9abf59d848042cc4107118de305ef6dddb46a3783eb6b0d94457a4c8682.yml
+openapi_spec_hash: 6c50747f76de7e0bb66a5fdd07d851ac
+config_hash: 279b20eafe220bf54131676cc0b9cdd2

CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.14.0 (2026-05-29)
+
+Full Changelog: [v0.13.0...v0.14.0](https://github.com/warpdotdev/oz-sdk-python/compare/v0.13.0...v0.14.0)
+
+### Features
+
+* Add server run runtime to agent API ([2145304](https://github.com/warpdotdev/oz-sdk-python/commit/2145304e213c8aaf664df0c53f87b5c65cdd553f))
+* Allow for empty-prompt cloud-agent handoff ([f67f068](https://github.com/warpdotdev/oz-sdk-python/commit/f67f06822c78742e17afea463f322d7b4db96c5f))
+* **api:** api update ([b5d9461](https://github.com/warpdotdev/oz-sdk-python/commit/b5d9461399ebe20c93caf7fd4ccceb2f2a54e341))
+* **api:** api update ([5a09dfd](https://github.com/warpdotdev/oz-sdk-python/commit/5a09dfdad29f12ee7116815f5c25d632cfe0e7cb))
+
 ## 0.13.0 (2026-05-21)
 
 Full Changelog: [v0.12.0...v0.13.0](https://github.com/warpdotdev/oz-sdk-python/compare/v0.12.0...v0.13.0)

pyproject.toml

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

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.13.0"  # x-release-please-version
+__version__ = "0.14.0"  # x-release-please-version

src/oz_agent_sdk/resources/agent/agent.py

@@ -302,7 +302,8 @@ def run(
               hierarchies.
 
           prompt: The prompt/instruction for the agent to execute. Required unless a skill is
-              specified via the skill field, config.skill_spec, or config.skills.
+              specified via the skill field, config.skill_spec, or config.skills. Handoff
+              requests may omit prompt when conversation_id is set.
 
           skill:
               Skill specification to use as the base prompt for the agent. Supported formats:
@@ -593,7 +594,8 @@ async def run(
               hierarchies.
 
           prompt: The prompt/instruction for the agent to execute. Required unless a skill is
-              specified via the skill field, config.skill_spec, or config.skills.
+              specified via the skill field, config.skill_spec, or config.skills. Handoff
+              requests may omit prompt when conversation_id is set.
 
           skill:
               Skill specification to use as the base prompt for the agent. Supported formats:

src/oz_agent_sdk/resources/agent/runs.py

@@ -301,7 +301,7 @@ def submit_followup(
         self,
         run_id: str,
         *,
-        message: str,
+        message: str | Omit = omit,
         mode: Literal["normal", "plan", "orchestrate"] | 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.
@@ -621,7 +621,7 @@ async def submit_followup(
         self,
         run_id: str,
         *,
-        message: str,
+        message: str | Omit = omit,
         mode: Literal["normal", "plan", "orchestrate"] | 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.

src/oz_agent_sdk/types/agent/agent_response.py

@@ -108,6 +108,9 @@ class AgentResponse(BaseModel):
     uid: str
     """Unique identifier for the agent"""
 
+    updated_at: datetime
+    """When the agent was last updated (RFC3339)"""
+
     base_harness: Optional[str] = None
     """Default harness for runs executed by this agent.
 

src/oz_agent_sdk/types/agent/run_item.py

@@ -182,6 +182,12 @@ class RunItem(BaseModel):
     request_usage: Optional[RequestUsage] = None
     """Resource usage information for the run"""
 
+    run_time: Optional[str] = None
+    """Total runtime as an ISO 8601 duration (e.g.
+
+    "PT2M30S"), computed server-side from run executions.
+    """
+
     schedule: Optional[Schedule] = None
     """
     Information about the schedule that triggered this run (only present for

src/oz_agent_sdk/types/agent/run_submit_followup_params.py

@@ -2,13 +2,13 @@
 
 from __future__ import annotations
 
-from typing_extensions import Literal, Required, TypedDict
+from typing_extensions import Literal, TypedDict
 
 __all__ = ["RunSubmitFollowupParams"]
 
 
 class RunSubmitFollowupParams(TypedDict, total=False):
-    message: Required[str]
+    message: str
     """The follow-up message to send to the run."""
 
     mode: Literal["normal", "plan", "orchestrate"]

src/oz_agent_sdk/types/agent_run_params.py

@@ -55,7 +55,8 @@ class AgentRunParams(TypedDict, total=False):
     prompt: str
     """
     The prompt/instruction for the agent to execute. Required unless a skill is
-    specified via the skill field, config.skill_spec, or config.skills.
+    specified via the skill field, config.skill_spec, or config.skills. Handoff
+    requests may omit prompt when conversation_id is set.
     """
 
     skill: str

tests/api_resources/agent/test_runs.py

@@ -209,7 +209,6 @@ def test_path_params_list_handoff_attachments(self, client: OzAPI) -> None:
     def test_method_submit_followup(self, client: OzAPI) -> None:
         run = client.agent.runs.submit_followup(
             run_id="runId",
-            message="message",
         )
         assert_matches_type(object, run, path=["response"])
 
@@ -228,7 +227,6 @@ def test_method_submit_followup_with_all_params(self, client: OzAPI) -> None:
     def test_raw_response_submit_followup(self, client: OzAPI) -> None:
         response = client.agent.runs.with_raw_response.submit_followup(
             run_id="runId",
-            message="message",
         )
 
         assert response.is_closed is True
@@ -241,7 +239,6 @@ def test_raw_response_submit_followup(self, client: OzAPI) -> None:
     def test_streaming_response_submit_followup(self, client: OzAPI) -> None:
         with client.agent.runs.with_streaming_response.submit_followup(
             run_id="runId",
-            message="message",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -257,7 +254,6 @@ def test_path_params_submit_followup(self, client: OzAPI) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `run_id` but received ''"):
             client.agent.runs.with_raw_response.submit_followup(
                 run_id="",
-                message="message",
             )
 
 
@@ -453,7 +449,6 @@ async def test_path_params_list_handoff_attachments(self, async_client: AsyncOzA
     async def test_method_submit_followup(self, async_client: AsyncOzAPI) -> None:
         run = await async_client.agent.runs.submit_followup(
             run_id="runId",
-            message="message",
         )
         assert_matches_type(object, run, path=["response"])
 
@@ -472,7 +467,6 @@ async def test_method_submit_followup_with_all_params(self, async_client: AsyncO
     async def test_raw_response_submit_followup(self, async_client: AsyncOzAPI) -> None:
         response = await async_client.agent.runs.with_raw_response.submit_followup(
             run_id="runId",
-            message="message",
         )
 
         assert response.is_closed is True
@@ -485,7 +479,6 @@ async def test_raw_response_submit_followup(self, async_client: AsyncOzAPI) -> N
     async def test_streaming_response_submit_followup(self, async_client: AsyncOzAPI) -> None:
         async with async_client.agent.runs.with_streaming_response.submit_followup(
             run_id="runId",
-            message="message",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -501,5 +494,4 @@ async def test_path_params_submit_followup(self, async_client: AsyncOzAPI) -> No
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `run_id` but received ''"):
             await async_client.agent.runs.with_raw_response.submit_followup(
                 run_id="",
-                message="message",
             )