feat(api): add artifacts, worker_host, and new source types

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 3
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-24029c9a3bb61d8ed8807686035c52060f97505d57ad827ae4debdec426ea0a0.yml
-openapi_spec_hash: ffe58e3dd2d1c5c1552af6c0330e6fb1
-config_hash: 386210f0e52fc8dd00b78e25011b9980
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-48ffcddda2e2febbe761bbb643e04c4d260c5b6ba6378297f1e7af9793dedaa5.yml
+openapi_spec_hash: 1058ed679fc1f8a91d4f4c3136445dbc
+config_hash: efa7e85b4732b72432e1b5828d2b6b9c

api.md

@@ -15,7 +15,13 @@ Methods:
 Types:
 
 ```python
-from warp_agent_sdk.types.agent import RunItem, RunSourceType, RunState, RunListResponse
+from warp_agent_sdk.types.agent import (
+    ArtifactItem,
+    RunItem,
+    RunSourceType,
+    RunState,
+    RunListResponse,
+)
 ```
 
 Methods:

src/warp_agent_sdk/resources/agent/runs.py

@@ -89,6 +89,7 @@ def list(
         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,
         source: RunSourceType | Omit = omit,
@@ -116,6 +117,8 @@ def list(
 
           cursor: Pagination cursor from previous response
 
+          environment_id: Filter runs by environment ID
+
           limit: Maximum number of runs to return
 
           model_id: Filter by model ID
@@ -147,6 +150,7 @@ def list(
                         "created_before": created_before,
                         "creator": creator,
                         "cursor": cursor,
+                        "environment_id": environment_id,
                         "limit": limit,
                         "model_id": model_id,
                         "source": source,
@@ -221,6 +225,7 @@ async def list(
         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,
         source: RunSourceType | Omit = omit,
@@ -248,6 +253,8 @@ async def list(
 
           cursor: Pagination cursor from previous response
 
+          environment_id: Filter runs by environment ID
+
           limit: Maximum number of runs to return
 
           model_id: Filter by model ID
@@ -279,6 +286,7 @@ async def list(
                         "created_before": created_before,
                         "creator": creator,
                         "cursor": cursor,
+                        "environment_id": environment_id,
                         "limit": limit,
                         "model_id": model_id,
                         "source": source,

src/warp_agent_sdk/types/agent/__init__.py

@@ -4,6 +4,7 @@
 
 from .run_item import RunItem as RunItem
 from .run_state import RunState as RunState
+from .artifact_item import ArtifactItem as ArtifactItem
 from .run_list_params import RunListParams as RunListParams
 from .run_source_type import RunSourceType as RunSourceType
 from .run_list_response import RunListResponse as RunListResponse

src/warp_agent_sdk/types/agent/artifact_item.py

@@ -0,0 +1,54 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Union, Optional
+from datetime import datetime
+from typing_extensions import Literal, Annotated, TypeAlias
+
+from ..._utils import PropertyInfo
+from ..._models import BaseModel
+
+__all__ = ["ArtifactItem", "PlanArtifact", "PlanArtifactPlan", "PullRequestArtifact", "PullRequestArtifactPullRequest"]
+
+
+class PlanArtifactPlan(BaseModel):
+    document_uid: str
+    """Unique identifier for the plan document"""
+
+    notebook_uid: Optional[str] = None
+    """Unique identifier for the associated notebook"""
+
+    title: Optional[str] = None
+    """Title of the plan"""
+
+
+class PlanArtifact(BaseModel):
+    artifact_type: Literal["plan"]
+    """Type of the artifact"""
+
+    created_at: datetime
+    """Timestamp when the artifact was created (RFC3339)"""
+
+    plan: PlanArtifactPlan
+
+
+class PullRequestArtifactPullRequest(BaseModel):
+    branch: str
+    """Branch name for the pull request"""
+
+    url: str
+    """URL of the pull request"""
+
+
+class PullRequestArtifact(BaseModel):
+    artifact_type: Literal["pull_request"]
+    """Type of the artifact"""
+
+    created_at: datetime
+    """Timestamp when the artifact was created (RFC3339)"""
+
+    pull_request: PullRequestArtifactPullRequest
+
+
+ArtifactItem: TypeAlias = Annotated[
+    Union[PlanArtifact, PullRequestArtifact], PropertyInfo(discriminator="artifact_type")
+]

src/warp_agent_sdk/types/agent/run_item.py

@@ -1,11 +1,12 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import List, Optional
 from datetime import datetime
 from typing_extensions import Literal
 
 from ..._models import BaseModel
 from .run_state import RunState
+from .artifact_item import ArtifactItem
 from .run_source_type import RunSourceType
 from ..ambient_agent_config import AmbientAgentConfig
 
@@ -77,6 +78,9 @@ class RunItem(BaseModel):
     agent_config: Optional[AmbientAgentConfig] = None
     """Configuration for an ambient agent run"""
 
+    artifacts: Optional[List[ArtifactItem]] = None
+    """Artifacts created during the run (plans, pull requests, etc.)"""
+
     conversation_id: Optional[str] = None
     """UUID of the conversation associated with the run"""
 
@@ -102,6 +106,8 @@ class RunItem(BaseModel):
     - SLACK: Created from Slack integration
     - LOCAL: Created from local CLI/app
     - SCHEDULED_AGENT: Created by a scheduled agent
+    - WEB_APP: Created from the Warp web app
+    - GITHUB_ACTION: Created from a GitHub action
     """
 
     started_at: Optional[datetime] = None

src/warp_agent_sdk/types/agent/run_list_params.py

@@ -29,6 +29,9 @@ class RunListParams(TypedDict, total=False):
     cursor: str
     """Pagination cursor from previous response"""
 
+    environment_id: Annotated[str, PropertyInfo(alias="environmentId")]
+    """Filter runs by environment ID"""
+
     limit: int
     """Maximum number of runs to return"""
 

src/warp_agent_sdk/types/agent/run_source_type.py

@@ -4,4 +4,4 @@
 
 __all__ = ["RunSourceType"]
 
-RunSourceType: TypeAlias = Literal["LINEAR", "API", "SLACK", "LOCAL", "SCHEDULED_AGENT"]
+RunSourceType: TypeAlias = Literal["LINEAR", "API", "SLACK", "LOCAL", "SCHEDULED_AGENT", "WEB_APP", "GITHUB_ACTION"]

src/warp_agent_sdk/types/ambient_agent_config.py

@@ -51,3 +51,9 @@ class AmbientAgentConfig(BaseModel):
 
     name: Optional[str] = None
     """Config name for searchability and traceability"""
+
+    worker_host: Optional[str] = None
+    """
+    Self-hosted worker ID that should execute this task. If not specified or set to
+    "warp", the task runs on Warp-hosted workers.
+    """

src/warp_agent_sdk/types/ambient_agent_config_param.py

@@ -52,3 +52,9 @@ class AmbientAgentConfigParam(TypedDict, total=False):
 
     name: str
     """Config name for searchability and traceability"""
+
+    worker_host: str
+    """
+    Self-hosted worker ID that should execute this task. If not specified or set to
+    "warp", the task runs on Warp-hosted workers.
+    """