feat: Add parent_run_id filter to List runs endpoint

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-a29592b2ba26cba9d89b95969d66506f49c08e140b76ce4aea4189e5c1dccc06.yml
-openapi_spec_hash: 27a5de1f891104d5e47904ad8e4b4bd1
-config_hash: 40327fb76b7cce7b97f23de9b8d48efb
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-96b15c5805e3554bc9eba7055a9b018fc3304f9b149f2c1f27e4cf4d6a1996d7.yml
+openapi_spec_hash: b99e78f4bfe7de8864c15a803bb0bb0b
+config_hash: 60052b2c1c0862014416821aba875574

src/oz_agent_sdk/resources/agent/agent.py

@@ -193,6 +193,7 @@ def get_artifact(
     def run(
         self,
         *,
+        agent_identity_uid: str | Omit = omit,
         attachments: Iterable[agent_run_params.Attachment] | Omit = omit,
         config: AmbientAgentConfigParam | Omit = omit,
         conversation_id: str | Omit = omit,
@@ -215,6 +216,9 @@ def run(
         runs. Behavior is identical to POST /agent/run.
 
         Args:
+          agent_identity_uid: Optional agent identity UID to use as the execution principal for the run. This
+              is only valid for runs that are team owned.
+
           attachments: Optional file attachments to include with the prompt (max 5). Attachments are
               uploaded to cloud storage and made available to the agent.
 
@@ -256,6 +260,7 @@ def run(
             "/agent/runs",
             body=maybe_transform(
                 {
+                    "agent_identity_uid": agent_identity_uid,
                     "attachments": attachments,
                     "config": config,
                     "conversation_id": conversation_id,
@@ -417,6 +422,7 @@ async def get_artifact(
     async def run(
         self,
         *,
+        agent_identity_uid: str | Omit = omit,
         attachments: Iterable[agent_run_params.Attachment] | Omit = omit,
         config: AmbientAgentConfigParam | Omit = omit,
         conversation_id: str | Omit = omit,
@@ -439,6 +445,9 @@ async def run(
         runs. Behavior is identical to POST /agent/run.
 
         Args:
+          agent_identity_uid: Optional agent identity UID to use as the execution principal for the run. This
+              is only valid for runs that are team owned.
+
           attachments: Optional file attachments to include with the prompt (max 5). Attachments are
               uploaded to cloud storage and made available to the agent.
 
@@ -480,6 +489,7 @@ async def run(
             "/agent/runs",
             body=await async_maybe_transform(
                 {
+                    "agent_identity_uid": agent_identity_uid,
                     "attachments": attachments,
                     "config": config,
                     "conversation_id": conversation_id,

src/oz_agent_sdk/resources/agent/runs.py

@@ -87,6 +87,7 @@ def retrieve(
     def list(
         self,
         *,
+        ancestor_run_id: str | Omit = omit,
         artifact_type: Literal["PLAN", "PULL_REQUEST", "SCREENSHOT", "FILE"] | Omit = omit,
         created_after: Union[str, datetime] | Omit = omit,
         created_before: Union[str, datetime] | Omit = omit,
@@ -119,6 +120,9 @@ def list(
         to `sort_by=updated_at` and `sort_order=desc`.
 
         Args:
+          ancestor_run_id: Filter runs by ancestor run ID. The referenced run must exist and be accessible
+              to the caller.
+
           artifact_type: Filter runs by artifact type
 
           created_after: Filter runs created after this timestamp (RFC3339 format)
@@ -182,6 +186,7 @@ def list(
                 timeout=timeout,
                 query=maybe_transform(
                     {
+                        "ancestor_run_id": ancestor_run_id,
                         "artifact_type": artifact_type,
                         "created_after": created_after,
                         "created_before": created_before,
@@ -307,6 +312,7 @@ async def retrieve(
     def list(
         self,
         *,
+        ancestor_run_id: str | Omit = omit,
         artifact_type: Literal["PLAN", "PULL_REQUEST", "SCREENSHOT", "FILE"] | Omit = omit,
         created_after: Union[str, datetime] | Omit = omit,
         created_before: Union[str, datetime] | Omit = omit,
@@ -339,6 +345,9 @@ def list(
         to `sort_by=updated_at` and `sort_order=desc`.
 
         Args:
+          ancestor_run_id: Filter runs by ancestor run ID. The referenced run must exist and be accessible
+              to the caller.
+
           artifact_type: Filter runs by artifact type
 
           created_after: Filter runs created after this timestamp (RFC3339 format)
@@ -402,6 +411,7 @@ def list(
                 timeout=timeout,
                 query=maybe_transform(
                     {
+                        "ancestor_run_id": ancestor_run_id,
                         "artifact_type": artifact_type,
                         "created_after": created_after,
                         "created_before": created_before,

src/oz_agent_sdk/types/agent/run_list_params.py

@@ -14,6 +14,12 @@
 
 
 class RunListParams(TypedDict, total=False):
+    ancestor_run_id: str
+    """Filter runs by ancestor run ID.
+
+    The referenced run must exist and be accessible to the caller.
+    """
+
     artifact_type: Literal["PLAN", "PULL_REQUEST", "SCREENSHOT", "FILE"]
     """Filter runs by artifact type"""
 

src/oz_agent_sdk/types/agent_run_params.py

@@ -14,6 +14,12 @@
 
 
 class AgentRunParams(TypedDict, total=False):
+    agent_identity_uid: str
+    """
+    Optional agent identity UID to use as the execution principal for the run. This
+    is only valid for runs that are team owned.
+    """
+
     attachments: Iterable[Attachment]
     """
     Optional file attachments to include with the prompt (max 5). Attachments are

tests/api_resources/agent/test_runs.py

@@ -71,6 +71,7 @@ def test_method_list(self, client: OzAPI) -> None:
     @parametrize
     def test_method_list_with_all_params(self, client: OzAPI) -> None:
         run = client.agent.runs.list(
+            ancestor_run_id="ancestor_run_id",
             artifact_type="PLAN",
             created_after=parse_datetime("2019-12-27T18:11:19.117Z"),
             created_before=parse_datetime("2019-12-27T18:11:19.117Z"),
@@ -215,6 +216,7 @@ async def test_method_list(self, async_client: AsyncOzAPI) -> None:
     @parametrize
     async def test_method_list_with_all_params(self, async_client: AsyncOzAPI) -> None:
         run = await async_client.agent.runs.list(
+            ancestor_run_id="ancestor_run_id",
             artifact_type="PLAN",
             created_after=parse_datetime("2019-12-27T18:11:19.117Z"),
             created_before=parse_datetime("2019-12-27T18:11:19.117Z"),

tests/api_resources/test_agent.py

@@ -112,6 +112,7 @@ def test_method_run(self, client: OzAPI) -> None:
     @parametrize
     def test_method_run_with_all_params(self, client: OzAPI) -> None:
         agent = client.agent.run(
+            agent_identity_uid="agent_identity_uid",
             attachments=[
                 {
                     "data": "U3RhaW5sZXNzIHJvY2tz",
@@ -272,6 +273,7 @@ async def test_method_run(self, async_client: AsyncOzAPI) -> None:
     @parametrize
     async def test_method_run_with_all_params(self, async_client: AsyncOzAPI) -> None:
         agent = await async_client.agent.run(
+            agent_identity_uid="agent_identity_uid",
             attachments=[
                 {
                     "data": "U3RhaW5sZXNzIHJvY2tz",