feat: Orchestrations V2: Public API endpoints

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-1b6767b852f3064c16752433a1cfd1db8ef38aa442dcb33b136e78fcc094bc51.yml
-openapi_spec_hash: 1fdcb18c88b88e4d257b7748a4896b26
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-753a2c218019502904eeefce9318e46c152ddf6fe4556e232a3a5fc6931f9b80.yml
+openapi_spec_hash: 8d9a460280c5943425e79300f79296c9
 config_hash: 1888db8b2f33dc16874aea51a90e78f7

src/oz_agent_sdk/resources/agent/agent.py

@@ -192,6 +192,7 @@ def run(
         config: AmbientAgentConfigParam | Omit = omit,
         conversation_id: str | Omit = omit,
         interactive: bool | Omit = omit,
+        parent_run_id: str | Omit = omit,
         prompt: str | Omit = omit,
         skill: str | Omit = omit,
         team: bool | Omit = omit,
@@ -219,6 +220,9 @@ def run(
 
           interactive: Whether the run should be interactive. If not set, defaults to false.
 
+          parent_run_id: Optional run ID of the parent that spawned this run. Used for orchestration
+              hierarchies.
+
           prompt: The prompt/instruction for the agent to execute. Required unless a skill is
               specified via the skill field or config.skill_spec.
 
@@ -251,6 +255,7 @@ def run(
                     "config": config,
                     "conversation_id": conversation_id,
                     "interactive": interactive,
+                    "parent_run_id": parent_run_id,
                     "prompt": prompt,
                     "skill": skill,
                     "team": team,
@@ -406,6 +411,7 @@ async def run(
         config: AmbientAgentConfigParam | Omit = omit,
         conversation_id: str | Omit = omit,
         interactive: bool | Omit = omit,
+        parent_run_id: str | Omit = omit,
         prompt: str | Omit = omit,
         skill: str | Omit = omit,
         team: bool | Omit = omit,
@@ -433,6 +439,9 @@ async def run(
 
           interactive: Whether the run should be interactive. If not set, defaults to false.
 
+          parent_run_id: Optional run ID of the parent that spawned this run. Used for orchestration
+              hierarchies.
+
           prompt: The prompt/instruction for the agent to execute. Required unless a skill is
               specified via the skill field or config.skill_spec.
 
@@ -465,6 +474,7 @@ async def run(
                     "config": config,
                     "conversation_id": conversation_id,
                     "interactive": interactive,
+                    "parent_run_id": parent_run_id,
                     "prompt": prompt,
                     "skill": skill,
                     "team": team,

src/oz_agent_sdk/types/agent_run_params.py

@@ -32,6 +32,12 @@ class AgentRunParams(TypedDict, total=False):
     interactive: bool
     """Whether the run should be interactive. If not set, defaults to false."""
 
+    parent_run_id: str
+    """
+    Optional run ID of the parent that spawned this run. Used for orchestration
+    hierarchies.
+    """
+
     prompt: str
     """
     The prompt/instruction for the agent to execute. Required unless a skill is

tests/api_resources/test_agent.py

@@ -142,6 +142,7 @@ def test_method_run_with_all_params(self, client: OzAPI) -> None:
             },
             conversation_id="conversation_id",
             interactive=True,
+            parent_run_id="parent_run_id",
             prompt="prompt",
             skill="skill",
             team=True,
@@ -298,6 +299,7 @@ async def test_method_run_with_all_params(self, async_client: AsyncOzAPI) -> Non
             },
             conversation_id="conversation_id",
             interactive=True,
+            parent_run_id="parent_run_id",
             prompt="prompt",
             skill="skill",
             team=True,