feat(api): modify openapi trigger

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-5793d9138ec4b7af85e46c9b3f02baa0caeddcdfdf8b2c2192b26f62348392b9.yml
-openapi_spec_hash: 0452abd7cb14486ce786a47a9a62e49b
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-c99d72d8d845f1eeabf7a716949a12408df952a2a0ca2b97df570da3a7c8bb49.yml
+openapi_spec_hash: 8a503cbccc8a5741554282327a557114
 config_hash: 07820b17df23cbea39cb77fa05292538

README.md

@@ -180,7 +180,6 @@ from warp_agent_sdk import WarpAPI
 client = WarpAPI()
 
 response = client.agent.run(
-    prompt="Fix the bug in auth.go",
     config={},
 )
 print(response.config)

src/warp_agent_sdk/resources/agent/agent.py

@@ -2,6 +2,9 @@
 
 from __future__ import annotations
 
+from typing import Iterable
+from typing_extensions import Literal
+
 import httpx
 
 from .runs import (
@@ -70,7 +73,9 @@ def with_streaming_response(self) -> AgentResourceWithStreamingResponse:
     def list(
         self,
         *,
+        refresh: bool | Omit = omit,
         repo: str | Omit = omit,
+        sort_by: Literal["name", "last_run"] | 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,
@@ -83,9 +88,17 @@ def list(
         Agents are discovered from environments or a specific repository.
 
         Args:
+          refresh: When true, clears the agent list cache before fetching. Use this to force a
+              refresh of the available agents.
+
           repo: Optional repository specification to list agents from (format: "owner/repo"). If
               not provided, lists agents from all accessible environments.
 
+          sort_by: Sort order for the returned agents.
+
+              - "name": Sort alphabetically by name (default)
+              - "last_run": Sort by most recently used
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -101,16 +114,26 @@ def list(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=maybe_transform({"repo": repo}, agent_list_params.AgentListParams),
+                query=maybe_transform(
+                    {
+                        "refresh": refresh,
+                        "repo": repo,
+                        "sort_by": sort_by,
+                    },
+                    agent_list_params.AgentListParams,
+                ),
             ),
             cast_to=AgentListResponse,
         )
 
     def run(
         self,
         *,
-        prompt: str,
         config: AmbientAgentConfigParam | Omit = omit,
+        conversation_id: str | Omit = omit,
+        images: Iterable[agent_run_params.Image] | Omit = omit,
+        prompt: str | Omit = omit,
+        skill: str | Omit = omit,
         team: bool | Omit = omit,
         title: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -120,17 +143,33 @@ def run(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentRunResponse:
-        """Spawn an ambient agent with a prompt and optional configuration.
+        """Spawn an cloud agent with a prompt and optional configuration.
 
-        The agent will
-        be queued for execution and assigned a unique run ID.
+        The agent will be
+        queued for execution and assigned a unique run ID.
 
         Args:
-          prompt: The prompt/instruction for the agent to execute
+          config: Configuration for an cloud agent run
+
+          conversation_id: Optional conversation ID to continue an existing conversation. If provided, the
+              agent will continue from where the previous run left off.
 
-          config: Configuration for an ambient agent run
+          images: Optional images to include with the prompt (max 5). Images are uploaded to cloud
+              storage and made available to the agent.
 
-          team: Make the run visible to all team members, not only the calling user
+          prompt: The prompt/instruction for the agent to execute. Required unless a skill is
+              specified via the skill field or config.skill_spec.
+
+          skill:
+              Skill specification to use as the base prompt for the agent. Supported formats:
+
+              - "repo:skill_name" - Simple name in specific repo
+              - "repo:skill_path" - Full path in specific repo
+              - "org/repo:skill_name" - Simple name with org and repo
+              - "org/repo:skill_path" - Full path with org and repo When provided, this takes
+                precedence over config.skill_spec.
+
+          team: Whether to create a team-owned run. Defaults to true for users on a single team.
 
           title: Custom title for the run (auto-generated if not provided)
 
@@ -146,8 +185,11 @@ def run(
             "/agent/run",
             body=maybe_transform(
                 {
-                    "prompt": prompt,
                     "config": config,
+                    "conversation_id": conversation_id,
+                    "images": images,
+                    "prompt": prompt,
+                    "skill": skill,
                     "team": team,
                     "title": title,
                 },
@@ -191,7 +233,9 @@ def with_streaming_response(self) -> AsyncAgentResourceWithStreamingResponse:
     async def list(
         self,
         *,
+        refresh: bool | Omit = omit,
         repo: str | Omit = omit,
+        sort_by: Literal["name", "last_run"] | 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,
@@ -204,9 +248,17 @@ async def list(
         Agents are discovered from environments or a specific repository.
 
         Args:
+          refresh: When true, clears the agent list cache before fetching. Use this to force a
+              refresh of the available agents.
+
           repo: Optional repository specification to list agents from (format: "owner/repo"). If
               not provided, lists agents from all accessible environments.
 
+          sort_by: Sort order for the returned agents.
+
+              - "name": Sort alphabetically by name (default)
+              - "last_run": Sort by most recently used
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -222,16 +274,26 @@ async def list(
                 extra_query=extra_query,
                 extra_body=extra_body,
                 timeout=timeout,
-                query=await async_maybe_transform({"repo": repo}, agent_list_params.AgentListParams),
+                query=await async_maybe_transform(
+                    {
+                        "refresh": refresh,
+                        "repo": repo,
+                        "sort_by": sort_by,
+                    },
+                    agent_list_params.AgentListParams,
+                ),
             ),
             cast_to=AgentListResponse,
         )
 
     async def run(
         self,
         *,
-        prompt: str,
         config: AmbientAgentConfigParam | Omit = omit,
+        conversation_id: str | Omit = omit,
+        images: Iterable[agent_run_params.Image] | Omit = omit,
+        prompt: str | Omit = omit,
+        skill: str | Omit = omit,
         team: bool | Omit = omit,
         title: str | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -241,17 +303,33 @@ async def run(
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AgentRunResponse:
-        """Spawn an ambient agent with a prompt and optional configuration.
+        """Spawn an cloud agent with a prompt and optional configuration.
 
-        The agent will
-        be queued for execution and assigned a unique run ID.
+        The agent will be
+        queued for execution and assigned a unique run ID.
 
         Args:
-          prompt: The prompt/instruction for the agent to execute
+          config: Configuration for an cloud agent run
+
+          conversation_id: Optional conversation ID to continue an existing conversation. If provided, the
+              agent will continue from where the previous run left off.
+
+          images: Optional images to include with the prompt (max 5). Images are uploaded to cloud
+              storage and made available to the agent.
 
-          config: Configuration for an ambient agent run
+          prompt: The prompt/instruction for the agent to execute. Required unless a skill is
+              specified via the skill field or config.skill_spec.
 
-          team: Make the run visible to all team members, not only the calling user
+          skill:
+              Skill specification to use as the base prompt for the agent. Supported formats:
+
+              - "repo:skill_name" - Simple name in specific repo
+              - "repo:skill_path" - Full path in specific repo
+              - "org/repo:skill_name" - Simple name with org and repo
+              - "org/repo:skill_path" - Full path with org and repo When provided, this takes
+                precedence over config.skill_spec.
+
+          team: Whether to create a team-owned run. Defaults to true for users on a single team.
 
           title: Custom title for the run (auto-generated if not provided)
 
@@ -267,8 +345,11 @@ async def run(
             "/agent/run",
             body=await async_maybe_transform(
                 {
-                    "prompt": prompt,
                     "config": config,
+                    "conversation_id": conversation_id,
+                    "images": images,
+                    "prompt": prompt,
+                    "skill": skill,
                     "team": team,
                     "title": title,
                 },

src/warp_agent_sdk/resources/agent/runs.py

@@ -4,6 +4,7 @@
 
 from typing import List, Union
 from datetime import datetime
+from typing_extensions import Literal
 
 import httpx
 
@@ -84,15 +85,18 @@ def retrieve(
     def list(
         self,
         *,
-        config_name: str | Omit = omit,
+        artifact_type: Literal["PLAN", "PULL_REQUEST"] | Omit = omit,
         created_after: Union[str, datetime] | Omit = omit,
         created_before: Union[str, datetime] | Omit = omit,
         creator: str | Omit = omit,
         cursor: str | Omit = omit,
         environment_id: str | Omit = omit,
         limit: int | Omit = omit,
         model_id: str | Omit = omit,
+        name: str | Omit = omit,
+        q: str | Omit = omit,
         schedule_id: str | Omit = omit,
+        skill: str | Omit = omit,
         skill_spec: str | Omit = omit,
         source: RunSourceType | Omit = omit,
         state: List[RunState] | Omit = omit,
@@ -110,7 +114,7 @@ def list(
         ordered by creation time (newest first).
 
         Args:
-          config_name: Filter by agent config name
+          artifact_type: Filter runs by artifact type (PLAN or PULL_REQUEST)
 
           created_after: Filter runs created after this timestamp (RFC3339 format)
 
@@ -126,8 +130,15 @@ def list(
 
           model_id: Filter by model ID
 
+          name: Filter by agent config name
+
+          q: Fuzzy search query across run title, prompt, and skill_spec
+
           schedule_id: Filter runs by the scheduled agent ID that created them
 
+          skill: Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md"). Alias for
+              skill_spec.
+
           skill_spec: Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md")
 
           source: Filter by run source type
@@ -154,15 +165,18 @@ def list(
                 timeout=timeout,
                 query=maybe_transform(
                     {
-                        "config_name": config_name,
+                        "artifact_type": artifact_type,
                         "created_after": created_after,
                         "created_before": created_before,
                         "creator": creator,
                         "cursor": cursor,
                         "environment_id": environment_id,
                         "limit": limit,
                         "model_id": model_id,
+                        "name": name,
+                        "q": q,
                         "schedule_id": schedule_id,
+                        "skill": skill,
                         "skill_spec": skill_spec,
                         "source": source,
                         "state": state,
@@ -267,15 +281,18 @@ async def retrieve(
     async def list(
         self,
         *,
-        config_name: str | Omit = omit,
+        artifact_type: Literal["PLAN", "PULL_REQUEST"] | Omit = omit,
         created_after: Union[str, datetime] | Omit = omit,
         created_before: Union[str, datetime] | Omit = omit,
         creator: str | Omit = omit,
         cursor: str | Omit = omit,
         environment_id: str | Omit = omit,
         limit: int | Omit = omit,
         model_id: str | Omit = omit,
+        name: str | Omit = omit,
+        q: str | Omit = omit,
         schedule_id: str | Omit = omit,
+        skill: str | Omit = omit,
         skill_spec: str | Omit = omit,
         source: RunSourceType | Omit = omit,
         state: List[RunState] | Omit = omit,
@@ -293,7 +310,7 @@ async def list(
         ordered by creation time (newest first).
 
         Args:
-          config_name: Filter by agent config name
+          artifact_type: Filter runs by artifact type (PLAN or PULL_REQUEST)
 
           created_after: Filter runs created after this timestamp (RFC3339 format)
 
@@ -309,8 +326,15 @@ async def list(
 
           model_id: Filter by model ID
 
+          name: Filter by agent config name
+
+          q: Fuzzy search query across run title, prompt, and skill_spec
+
           schedule_id: Filter runs by the scheduled agent ID that created them
 
+          skill: Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md"). Alias for
+              skill_spec.
+
           skill_spec: Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md")
 
           source: Filter by run source type
@@ -337,15 +361,18 @@ async def list(
                 timeout=timeout,
                 query=await async_maybe_transform(
                     {
-                        "config_name": config_name,
+                        "artifact_type": artifact_type,
                         "created_after": created_after,
                         "created_before": created_before,
                         "creator": creator,
                         "cursor": cursor,
                         "environment_id": environment_id,
                         "limit": limit,
                         "model_id": model_id,
+                        "name": name,
+                        "q": q,
                         "schedule_id": schedule_id,
+                        "skill": skill,
                         "skill_spec": skill_spec,
                         "source": source,
                         "state": state,