feat: Allow for empty-prompt cloud-agent handoff

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 23
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-0bc171e3cd0224936953898ce9b7eb35e1bf1cbf58a673fc80b32c90ce84bcd0.yml
-openapi_spec_hash: 6c7d5f294b0800e878729314f57a09f0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta/warp-api-8b8de9abf59d848042cc4107118de305ef6dddb46a3783eb6b0d94457a4c8682.yml
+openapi_spec_hash: 6c50747f76de7e0bb66a5fdd07d851ac
 config_hash: 279b20eafe220bf54131676cc0b9cdd2

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/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",
             )