feat(api): add computer_use_enabled param

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 12
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-71da0fb8e959241d9767c5a4879871711b501bd0d6cef087fbb7047a0b86791e.yml
-openapi_spec_hash: 8b0828210e5b33f36fc88093dbf066f1
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-889ce13c0c43d5d3affffdc59a70d6f9a99b6b537f03d9f4e13685884e0ce163.yml
+openapi_spec_hash: 9ae86e64db36c40a13cf1afd24f6f736
 config_hash: 07820b17df23cbea39cb77fa05292538

src/warp_agent_sdk/resources/agent/runs.py

@@ -92,8 +92,11 @@ def list(
         environment_id: str | Omit = omit,
         limit: int | Omit = omit,
         model_id: str | Omit = omit,
+        schedule_id: str | Omit = omit,
+        skill_spec: str | Omit = omit,
         source: RunSourceType | Omit = omit,
         state: List[RunState] | Omit = omit,
+        updated_after: Union[str, datetime] | 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.
         extra_headers: Headers | None = None,
@@ -123,11 +126,17 @@ def list(
 
           model_id: Filter by model ID
 
+          schedule_id: Filter runs by the scheduled agent ID that created them
+
+          skill_spec: Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md")
+
           source: Filter by run source type
 
           state: Filter by run state. Can be specified multiple times to match any of the given
               states.
 
+          updated_after: Filter runs updated after this timestamp (RFC3339 format)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -153,8 +162,11 @@ def list(
                         "environment_id": environment_id,
                         "limit": limit,
                         "model_id": model_id,
+                        "schedule_id": schedule_id,
+                        "skill_spec": skill_spec,
                         "source": source,
                         "state": state,
+                        "updated_after": updated_after,
                     },
                     run_list_params.RunListParams,
                 ),
@@ -263,8 +275,11 @@ async def list(
         environment_id: str | Omit = omit,
         limit: int | Omit = omit,
         model_id: str | Omit = omit,
+        schedule_id: str | Omit = omit,
+        skill_spec: str | Omit = omit,
         source: RunSourceType | Omit = omit,
         state: List[RunState] | Omit = omit,
+        updated_after: Union[str, datetime] | 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.
         extra_headers: Headers | None = None,
@@ -294,11 +309,17 @@ async def list(
 
           model_id: Filter by model ID
 
+          schedule_id: Filter runs by the scheduled agent ID that created them
+
+          skill_spec: Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md")
+
           source: Filter by run source type
 
           state: Filter by run state. Can be specified multiple times to match any of the given
               states.
 
+          updated_after: Filter runs updated after this timestamp (RFC3339 format)
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -324,8 +345,11 @@ async def list(
                         "environment_id": environment_id,
                         "limit": limit,
                         "model_id": model_id,
+                        "schedule_id": schedule_id,
+                        "skill_spec": skill_spec,
                         "source": source,
                         "state": state,
+                        "updated_after": updated_after,
                     },
                     run_list_params.RunListParams,
                 ),

src/warp_agent_sdk/types/agent/artifact_item.py

@@ -7,10 +7,10 @@
 from ..._utils import PropertyInfo
 from ..._models import BaseModel
 
-__all__ = ["ArtifactItem", "PlanArtifact", "PlanArtifactPlan", "PullRequestArtifact", "PullRequestArtifactPullRequest"]
+__all__ = ["ArtifactItem", "PlanArtifact", "PlanArtifactData", "PullRequestArtifact", "PullRequestArtifactData"]
 
 
-class PlanArtifactPlan(BaseModel):
+class PlanArtifactData(BaseModel):
     document_uid: str
     """Unique identifier for the plan document"""
 
@@ -22,16 +22,16 @@ class PlanArtifactPlan(BaseModel):
 
 
 class PlanArtifact(BaseModel):
-    artifact_type: Literal["plan"]
+    artifact_type: Literal["PLAN"]
     """Type of the artifact"""
 
     created_at: datetime
     """Timestamp when the artifact was created (RFC3339)"""
 
-    plan: PlanArtifactPlan
+    data: PlanArtifactData
 
 
-class PullRequestArtifactPullRequest(BaseModel):
+class PullRequestArtifactData(BaseModel):
     branch: str
     """Branch name for the pull request"""
 
@@ -40,13 +40,13 @@ class PullRequestArtifactPullRequest(BaseModel):
 
 
 class PullRequestArtifact(BaseModel):
-    artifact_type: Literal["pull_request"]
+    artifact_type: Literal["PULL_REQUEST"]
     """Type of the artifact"""
 
     created_at: datetime
     """Timestamp when the artifact was created (RFC3339)"""
 
-    pull_request: PullRequestArtifactPullRequest
+    data: PullRequestArtifactData
 
 
 ArtifactItem: TypeAlias = Annotated[

src/warp_agent_sdk/types/agent/run_item.py

@@ -62,6 +62,7 @@ class RunItem(BaseModel):
     - INPROGRESS: Run is actively being executed
     - SUCCEEDED: Run completed successfully
     - FAILED: Run failed
+    - CANCELLED: Run was cancelled by user
     """
 
     task_id: str

src/warp_agent_sdk/types/agent/run_list_params.py

@@ -29,7 +29,7 @@ class RunListParams(TypedDict, total=False):
     cursor: str
     """Pagination cursor from previous response"""
 
-    environment_id: Annotated[str, PropertyInfo(alias="environmentId")]
+    environment_id: str
     """Filter runs by environment ID"""
 
     limit: int
@@ -38,6 +38,12 @@ class RunListParams(TypedDict, total=False):
     model_id: str
     """Filter by model ID"""
 
+    schedule_id: str
+    """Filter runs by the scheduled agent ID that created them"""
+
+    skill_spec: str
+    """Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md")"""
+
     source: RunSourceType
     """Filter by run source type"""
 
@@ -46,3 +52,6 @@ class RunListParams(TypedDict, total=False):
 
     Can be specified multiple times to match any of the given states.
     """
+
+    updated_after: Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]
+    """Filter runs updated after this timestamp (RFC3339 format)"""

src/warp_agent_sdk/types/agent/run_state.py

@@ -4,4 +4,4 @@
 
 __all__ = ["RunState"]
 
-RunState: TypeAlias = Literal["QUEUED", "PENDING", "CLAIMED", "INPROGRESS", "SUCCEEDED", "FAILED"]
+RunState: TypeAlias = Literal["QUEUED", "PENDING", "CLAIMED", "INPROGRESS", "SUCCEEDED", "FAILED", "CANCELLED"]

src/warp_agent_sdk/types/agent_run_response.py

@@ -19,4 +19,5 @@ class AgentRunResponse(BaseModel):
     - INPROGRESS: Run is actively being executed
     - SUCCEEDED: Run completed successfully
     - FAILED: Run failed
+    - CANCELLED: Run was cancelled by user
     """

src/warp_agent_sdk/types/ambient_agent_config.py

@@ -16,6 +16,12 @@ class AmbientAgentConfig(BaseModel):
     base_prompt: Optional[str] = None
     """Custom base prompt for the agent"""
 
+    computer_use_enabled: Optional[bool] = None
+    """
+    Controls whether computer use is enabled for this agent. If not set, defaults to
+    false.
+    """
+
     environment_id: Optional[str] = None
     """UID of the environment to run the agent in"""
 

src/warp_agent_sdk/types/ambient_agent_config_param.py

@@ -16,6 +16,12 @@ class AmbientAgentConfigParam(TypedDict, total=False):
     base_prompt: str
     """Custom base prompt for the agent"""
 
+    computer_use_enabled: bool
+    """
+    Controls whether computer use is enabled for this agent. If not set, defaults to
+    false.
+    """
+
     environment_id: str
     """UID of the environment to run the agent in"""
 

tests/api_resources/agent/test_runs.py

@@ -75,11 +75,14 @@ def test_method_list_with_all_params(self, client: WarpAPI) -> None:
             created_before=parse_datetime("2019-12-27T18:11:19.117Z"),
             creator="creator",
             cursor="cursor",
-            environment_id="environmentId",
+            environment_id="environment_id",
             limit=1,
             model_id="model_id",
+            schedule_id="schedule_id",
+            skill_spec="skill_spec",
             source="LINEAR",
             state=["QUEUED"],
+            updated_after=parse_datetime("2019-12-27T18:11:19.117Z"),
         )
         assert_matches_type(RunListResponse, run, path=["response"])
 
@@ -210,11 +213,14 @@ async def test_method_list_with_all_params(self, async_client: AsyncWarpAPI) ->
             created_before=parse_datetime("2019-12-27T18:11:19.117Z"),
             creator="creator",
             cursor="cursor",
-            environment_id="environmentId",
+            environment_id="environment_id",
             limit=1,
             model_id="model_id",
+            schedule_id="schedule_id",
+            skill_spec="skill_spec",
             source="LINEAR",
             state=["QUEUED"],
+            updated_after=parse_datetime("2019-12-27T18:11:19.117Z"),
         )
         assert_matches_type(RunListResponse, run, path=["response"])