feat(api): add models for agent skill, user profile

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-3ee19d97da1711b8dfcba85f38c3c345fa96aaf78ea7f025e1ae490d17e97517.yml
 openapi_spec_hash: 2d03e7a248b1be5bd5600b62912cdab8
-config_hash: 9db55bfa03e8dd5e251342bd7491408c
+config_hash: 07820b17df23cbea39cb77fa05292538

api.md

@@ -4,10 +4,11 @@ Types:
 
 ```python
 from warp_agent_sdk.types import (
+    AgentSkill,
     AmbientAgentConfig,
     CloudEnvironmentConfig,
     McpServerConfig,
-    RunCreatorInfo,
+    UserProfile,
     AgentListResponse,
     AgentRunResponse,
 )

src/warp_agent_sdk/types/__init__.py

@@ -2,8 +2,9 @@
 
 from __future__ import annotations
 
+from .agent_skill import AgentSkill as AgentSkill
+from .user_profile import UserProfile as UserProfile
 from .agent_run_params import AgentRunParams as AgentRunParams
-from .run_creator_info import RunCreatorInfo as RunCreatorInfo
 from .agent_list_params import AgentListParams as AgentListParams
 from .mcp_server_config import McpServerConfig as McpServerConfig
 from .agent_run_response import AgentRunResponse as AgentRunResponse

src/warp_agent_sdk/types/agent/run_item.py

@@ -5,9 +5,9 @@
 
 from ..._models import BaseModel
 from .run_state import RunState
+from ..user_profile import UserProfile
 from .artifact_item import ArtifactItem
 from .run_source_type import RunSourceType
-from ..run_creator_info import RunCreatorInfo
 from ..ambient_agent_config import AmbientAgentConfig
 
 __all__ = ["RunItem", "RequestUsage", "StatusMessage"]
@@ -70,7 +70,7 @@ class RunItem(BaseModel):
     conversation_id: Optional[str] = None
     """UUID of the conversation associated with the run"""
 
-    creator: Optional[RunCreatorInfo] = None
+    creator: Optional[UserProfile] = None
 
     is_sandbox_running: Optional[bool] = None
     """Whether the sandbox environment is currently running"""

src/warp_agent_sdk/types/agent/scheduled_agent_item.py

@@ -4,7 +4,7 @@
 from datetime import datetime
 
 from ..._models import BaseModel
-from ..run_creator_info import RunCreatorInfo
+from ..user_profile import UserProfile
 from ..ambient_agent_config import AmbientAgentConfig
 from ..cloud_environment_config import CloudEnvironmentConfig
 
@@ -49,7 +49,7 @@ class ScheduledAgentItem(BaseModel):
     agent_config: Optional[AmbientAgentConfig] = None
     """Configuration for an ambient agent run"""
 
-    created_by: Optional[RunCreatorInfo] = None
+    created_by: Optional[UserProfile] = None
 
     environment: Optional[CloudEnvironmentConfig] = None
     """Configuration for a cloud environment used by scheduled agents"""
@@ -60,4 +60,4 @@ class ScheduledAgentItem(BaseModel):
     last_spawn_error: Optional[str] = None
     """Error message from the last failed spawn attempt, if any"""
 
-    updated_by: Optional[RunCreatorInfo] = None
+    updated_by: Optional[UserProfile] = None

src/warp_agent_sdk/types/agent_list_response.py

@@ -3,56 +3,11 @@
 from typing import List
 
 from .._models import BaseModel
+from .agent_skill import AgentSkill
 
-__all__ = ["AgentListResponse", "Agent", "AgentVariant", "AgentVariantEnvironment", "AgentVariantSource"]
-
-
-class AgentVariantEnvironment(BaseModel):
-    name: str
-    """Human-readable name of the environment"""
-
-    uid: str
-    """Unique identifier for the environment"""
-
-
-class AgentVariantSource(BaseModel):
-    name: str
-    """GitHub repository name"""
-
-    owner: str
-    """GitHub repository owner"""
-
-    skill_path: str
-    """Path to the skill definition file within the repository"""
-
-
-class AgentVariant(BaseModel):
-    id: str
-    """
-    Stable identifier for this skill variant. Format: "{owner}/{repo}:{skill_path}"
-    Example: "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"
-    """
-
-    base_prompt: str
-    """Base prompt/instructions for the agent"""
-
-    description: str
-    """Description of the agent variant"""
-
-    environments: List[AgentVariantEnvironment]
-    """Environments where this agent variant is available"""
-
-    source: AgentVariantSource
-
-
-class Agent(BaseModel):
-    name: str
-    """Human-readable name of the agent"""
-
-    variants: List[AgentVariant]
-    """Available variants of this agent"""
+__all__ = ["AgentListResponse"]
 
 
 class AgentListResponse(BaseModel):
-    agents: List[Agent]
+    agents: List[AgentSkill]
     """List of available agents"""

src/warp_agent_sdk/types/agent_skill.py

@@ -0,0 +1,53 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List
+
+from .._models import BaseModel
+
+__all__ = ["AgentSkill", "Variant", "VariantEnvironment", "VariantSource"]
+
+
+class VariantEnvironment(BaseModel):
+    name: str
+    """Human-readable name of the environment"""
+
+    uid: str
+    """Unique identifier for the environment"""
+
+
+class VariantSource(BaseModel):
+    name: str
+    """GitHub repository name"""
+
+    owner: str
+    """GitHub repository owner"""
+
+    skill_path: str
+    """Path to the skill definition file within the repository"""
+
+
+class Variant(BaseModel):
+    id: str
+    """
+    Stable identifier for this skill variant. Format: "{owner}/{repo}:{skill_path}"
+    Example: "warpdotdev/warp-server:.claude/skills/deploy/SKILL.md"
+    """
+
+    base_prompt: str
+    """Base prompt/instructions for the agent"""
+
+    description: str
+    """Description of the agent variant"""
+
+    environments: List[VariantEnvironment]
+    """Environments where this agent variant is available"""
+
+    source: VariantSource
+
+
+class AgentSkill(BaseModel):
+    name: str
+    """Human-readable name of the agent"""
+
+    variants: List[Variant]
+    """Available variants of this agent"""

…warp_agent_sdk/types/run_creator_info.py src/warp_agent_sdk/types/user_profile.pysrc/warp_agent_sdk/types/run_creator_info.py renamed to src/warp_agent_sdk/types/user_profile.py src/warp_agent_sdk/types/run_creator_info.py renamed to src/warp_agent_sdk/types/user_profile.py

@@ -5,10 +5,10 @@
 
 from .._models import BaseModel
 
-__all__ = ["RunCreatorInfo"]
+__all__ = ["UserProfile"]
 
 
-class RunCreatorInfo(BaseModel):
+class UserProfile(BaseModel):
     display_name: Optional[str] = None
     """Display name of the creator"""