feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 14
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/warp-bnavetta%2Fwarp-api-e281c64ee44d0db13ba9ce62d3a61e8b17fcd1fad9bffb5c3b0e3dfb2b5e66e1.yml
 openapi_spec_hash: 6bd667f546147c5fac3bffe34522ba2f
-config_hash: 56e5336dfbbacf3f4ec7f63b41309773
+config_hash: 1888db8b2f33dc16874aea51a90e78f7

api.md

@@ -11,7 +11,6 @@ from oz_agent_sdk.types import (
     Error,
     ErrorCode,
     GcpProviderConfig,
-    Harness,
     McpServerConfig,
     Scope,
     UserProfile,
@@ -34,12 +33,9 @@ Types:
 ```python
 from oz_agent_sdk.types.agent import (
     ArtifactItem,
-    RequestUsage,
     RunItem,
     RunSourceType,
     RunState,
-    RunStatusMessage,
-    ScheduleInfo,
     RunCancelResponse,
 )
 ```

src/oz_agent_sdk/types/__init__.py

@@ -3,11 +3,9 @@
 from __future__ import annotations
 
 from .scope import Scope as Scope
-from .harness import Harness as Harness
 from .error_code import ErrorCode as ErrorCode
 from .agent_skill import AgentSkill as AgentSkill
 from .user_profile import UserProfile as UserProfile
-from .harness_param import HarnessParam as HarnessParam
 from .agent_run_params import AgentRunParams as AgentRunParams
 from .agent_list_params import AgentListParams as AgentListParams
 from .mcp_server_config import McpServerConfig as McpServerConfig

src/oz_agent_sdk/types/agent/__init__.py

@@ -5,11 +5,8 @@
 from .run_item import RunItem as RunItem
 from .run_state import RunState as RunState
 from .artifact_item import ArtifactItem as ArtifactItem
-from .request_usage import RequestUsage as RequestUsage
-from .schedule_info import ScheduleInfo as ScheduleInfo
 from .run_list_params import RunListParams as RunListParams
 from .run_source_type import RunSourceType as RunSourceType
-from .run_status_message import RunStatusMessage as RunStatusMessage
 from .run_cancel_response import RunCancelResponse as RunCancelResponse
 from .scheduled_agent_item import ScheduledAgentItem as ScheduledAgentItem
 from .schedule_create_params import ScheduleCreateParams as ScheduleCreateParams

src/oz_agent_sdk/types/agent/request_usage.py

@@ -7,15 +7,13 @@
 from ..scope import Scope
 from ..._models import BaseModel
 from .run_state import RunState
+from ..error_code import ErrorCode
 from ..user_profile import UserProfile
 from .artifact_item import ArtifactItem
-from .request_usage import RequestUsage
-from .schedule_info import ScheduleInfo
 from .run_source_type import RunSourceType
-from .run_status_message import RunStatusMessage
 from ..ambient_agent_config import AmbientAgentConfig
 
-__all__ = ["RunItem", "AgentSkill"]
+__all__ = ["RunItem", "AgentSkill", "RequestUsage", "Schedule", "StatusMessage"]
 
 
 class AgentSkill(BaseModel):
@@ -37,6 +35,79 @@ class AgentSkill(BaseModel):
     """Human-readable name of the skill"""
 
 
+class RequestUsage(BaseModel):
+    """Resource usage information for the run"""
+
+    compute_cost: Optional[float] = None
+    """Cost of compute resources for the run"""
+
+    inference_cost: Optional[float] = None
+    """Cost of LLM inference for the run"""
+
+
+class Schedule(BaseModel):
+    """
+    Information about the schedule that triggered this run (only present for scheduled runs)
+    """
+
+    cron_schedule: str
+    """Cron expression at the time the run was created"""
+
+    schedule_id: str
+    """Unique identifier for the schedule"""
+
+    schedule_name: str
+    """Name of the schedule at the time the run was created"""
+
+
+class StatusMessage(BaseModel):
+    """Status message for a run.
+
+    For terminal error states, includes structured
+    error code and retryability info from the platform error catalog.
+    """
+
+    message: str
+    """Human-readable status message"""
+
+    error_code: Optional[ErrorCode] = None
+    """
+    Machine-readable error code identifying the problem type. Used in the `type` URI
+    of Error responses and in the `error_code` field of RunStatusMessage.
+
+    User errors (run transitions to FAILED):
+
+    - `insufficient_credits` — Team has no remaining add-on credits
+    - `feature_not_available` — Required feature not enabled for user's plan
+    - `external_authentication_required` — User hasn't authorized a required
+      external service
+    - `not_authorized` — Principal lacks permission for the requested operation
+    - `invalid_request` — Request is malformed or contains invalid parameters
+    - `resource_not_found` — Referenced resource does not exist
+    - `budget_exceeded` — Spending budget limit has been reached
+    - `integration_disabled` — Integration is disabled and must be enabled
+    - `integration_not_configured` — Integration setup is incomplete
+    - `operation_not_supported` — Requested operation not supported for this
+      resource/state
+    - `environment_setup_failed` — Client-side environment setup failed
+    - `content_policy_violation` — Prompt or setup commands violated content policy
+    - `conflict` — Request conflicts with the current state of the resource
+
+    Warp errors (run transitions to ERROR):
+
+    - `authentication_required` — Request lacks valid authentication credentials
+    - `resource_unavailable` — Transient infrastructure issue (retryable)
+    - `internal_error` — Unexpected server-side error (retryable)
+    """
+
+    retryable: Optional[bool] = None
+    """Whether the error is transient and the client may retry by submitting a new run.
+
+    Only present on terminal error states. When false, retrying without addressing
+    the underlying cause will not succeed.
+    """
+
+
 class RunItem(BaseModel):
     created_at: datetime
     """Timestamp when the run was created (RFC3339)"""
@@ -103,7 +174,7 @@ class RunItem(BaseModel):
     request_usage: Optional[RequestUsage] = None
     """Resource usage information for the run"""
 
-    schedule: Optional[ScheduleInfo] = None
+    schedule: Optional[Schedule] = None
     """
     Information about the schedule that triggered this run (only present for
     scheduled runs)
@@ -135,7 +206,7 @@ class RunItem(BaseModel):
     started_at: Optional[datetime] = None
     """Timestamp when the agent started working on the run (RFC3339)"""
 
-    status_message: Optional[RunStatusMessage] = None
+    status_message: Optional[StatusMessage] = None
     """Status message for a run.
 
     For terminal error states, includes structured error code and retryability info

src/oz_agent_sdk/types/agent/run_item.py

@@ -4,11 +4,20 @@
 
 from pydantic import Field as FieldInfo
 
-from .harness import Harness
 from .._models import BaseModel
 from .mcp_server_config import McpServerConfig
 
-__all__ = ["AmbientAgentConfig"]
+__all__ = ["AmbientAgentConfig", "Harness"]
+
+
+class Harness(BaseModel):
+    """
+    Specifies which execution harness to use for the agent run.
+    Default (nil/empty) uses Warp's built-in Oz harness.
+    """
+
+    type: Optional[str] = None
+    """The harness type identifier (e.g. "claude")."""
 
 
 class AmbientAgentConfig(BaseModel):

src/oz_agent_sdk/types/agent/run_status_message.py

@@ -5,10 +5,19 @@
 from typing import Dict
 from typing_extensions import TypedDict
 
-from .harness_param import HarnessParam
 from .mcp_server_config_param import McpServerConfigParam
 
-__all__ = ["AmbientAgentConfigParam"]
+__all__ = ["AmbientAgentConfigParam", "Harness"]
+
+
+class Harness(TypedDict, total=False):
+    """
+    Specifies which execution harness to use for the agent run.
+    Default (nil/empty) uses Warp's built-in Oz harness.
+    """
+
+    type: str
+    """The harness type identifier (e.g. "claude")."""
 
 
 class AmbientAgentConfigParam(TypedDict, total=False):
@@ -26,7 +35,7 @@ class AmbientAgentConfigParam(TypedDict, total=False):
     environment_id: str
     """UID of the environment to run the agent in"""
 
-    harness: HarnessParam
+    harness: Harness
     """
     Specifies which execution harness to use for the agent run. Default (nil/empty)
     uses Warp's built-in Oz harness.