warpdotdev · stainless-app · Feb 8, 2026 · Feb 8, 2026
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.4.0"
+  ".": "0.5.0"
 }
diff --git a/.stats.yml b/.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
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.5.0 (2026-02-08)
+
+Full Changelog: [v0.4.0...v0.5.0](https://github.com/warpdotdev/warp-sdk-python/compare/v0.4.0...v0.5.0)
+
+### Features
+
+* **api:** modify openapi trigger ([db2d311](https://github.com/warpdotdev/warp-sdk-python/commit/db2d3116a353cc7a5b552e09769372264f6353b8))
+
 ## 0.4.0 (2026-02-06)
 
 Full Changelog: [v0.3.0...v0.4.0](https://github.com/warpdotdev/warp-sdk-python/compare/v0.3.0...v0.4.0)

diff --git a/README.md b/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)

diff --git a/pyproject.toml b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "warp-agent-sdk"
-version = "0.4.0"
+version = "0.5.0"
 description = "The official Python library for the warp-api API"
 dynamic = ["readme"]
 license = "Apache-2.0"

diff --git a/src/warp_agent_sdk/_version.py b/src/warp_agent_sdk/_version.py
@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "warp_agent_sdk"
-__version__ = "0.4.0"  # x-release-please-version
+__version__ = "0.5.0"  # x-release-please-version
diff --git a/src/warp_agent_sdk/resources/agent/agent.py b/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,
                 },