hyperbrowser 0.44.0__py3-none-any.whl → 0.72.0__py3-none-any.whl

hyperbrowser/client/managers/sync_manager/scrape.py

@@ -109,6 +109,7 @@ class BatchScrapeManager:
                 job_response.total_scraped_pages = tmp_job_response.total_scraped_pages
                 job_response.total_page_batches = tmp_job_response.total_page_batches
                 job_response.batch_size = tmp_job_response.batch_size
+                job_response.error = tmp_job_response.error
                 failures = 0
                 first_check = False
             except Exception as e:

hyperbrowser/client/managers/sync_manager/session.py

@@ -1,4 +1,4 @@
-from typing import List
+from typing import List, Union, IO
 from ....models.session import (
     BasicResponse,
     CreateSessionParams,
@@ -9,12 +9,33 @@ from ....models.session import (
     SessionListParams,
     SessionListResponse,
     SessionRecording,
+    UploadFileResponse,
+    SessionEventLogListParams,
+    SessionEventLogListResponse,
+    SessionEventLog,
 )
 
 
+class SessionEventLogsManager:
+    def __init__(self, client):
+        self._client = client
+
+    def list(
+        self,
+        session_id: str,
+        params: SessionEventLogListParams = SessionEventLogListParams(),
+    ) -> SessionEventLogListResponse:
+        response = self._client.transport.get(
+            self._client._build_url(f"/session/{session_id}/event-logs"),
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SessionEventLogListResponse(**response.data)
+
+
 class SessionManager:
     def __init__(self, client):
         self._client = client
+        self.event_logs = SessionEventLogsManager(client)
 
     def create(self, params: CreateSessionParams = None) -> SessionDetail:
         response = self._client.transport.post(
@@ -69,3 +90,21 @@ class SessionManager:
             self._client._build_url(f"/session/{id}/downloads-url")
         )
         return GetSessionDownloadsUrlResponse(**response.data)
+
+    def upload_file(self, id: str, file_input: Union[str, IO]) -> UploadFileResponse:
+        response = None
+        if isinstance(file_input, str):
+            with open(file_input, "rb") as file_obj:
+                files = {"file": file_obj}
+                response = self._client.transport.post(
+                    self._client._build_url(f"/session/{id}/uploads"),
+                    files=files,
+                )
+        else:
+            files = {"file": file_input}
+            response = self._client.transport.post(
+                self._client._build_url(f"/session/{id}/uploads"),
+                files=files,
+            )
+
+        return UploadFileResponse(**response.data)

hyperbrowser/client/managers/sync_manager/team.py

@@ -0,0 +1,12 @@
+from hyperbrowser.models import TeamCreditInfo
+
+
+class TeamManager:
+    def __init__(self, client):
+        self._client = client
+
+    def get_credit_info(self) -> TeamCreditInfo:
+        response = self._client.transport.get(
+            self._client._build_url("/team/credit-info")
+        )
+        return TeamCreditInfo(**response.data)

hyperbrowser/client/sync.py

@@ -10,6 +10,8 @@ from .managers.sync_manager.extract import ExtractManager
 from .managers.sync_manager.profile import ProfileManager
 from .managers.sync_manager.scrape import ScrapeManager
 from .managers.sync_manager.session import SessionManager
+from .managers.sync_manager.team import TeamManager
+from .managers.sync_manager.computer_action import ComputerActionManager
 
 
 class Hyperbrowser(HyperbrowserBase):
@@ -31,6 +33,8 @@ class Hyperbrowser(HyperbrowserBase):
         self.profiles = ProfileManager(self)
         self.extensions = ExtensionManager(self)
         self.agents = Agents(self)
+        self.team = TeamManager(self)
+        self.computer_action = ComputerActionManager(self)
 
     def close(self) -> None:
         self.transport.close()

hyperbrowser/config.py

@@ -8,7 +8,7 @@ class ClientConfig:
     """Configuration for the Hyperbrowser client"""
 
     api_key: str
-    base_url: str = "https://app.hyperbrowser.ai"
+    base_url: str = "https://api.hyperbrowser.ai"
 
     @classmethod
     def from_env(cls) -> "ClientConfig":
@@ -17,6 +17,6 @@ class ClientConfig:
             raise ValueError("HYPERBROWSER_API_KEY environment variable is required")
 
         base_url = os.environ.get(
-            "HYPERBROWSER_BASE_URL", "https://app.hyperbrowser.ai"
+            "HYPERBROWSER_BASE_URL", "https://api.hyperbrowser.ai"
         )
         return cls(api_key=api_key, base_url=base_url)

hyperbrowser/models/__init__.py

@@ -4,13 +4,47 @@ from .agents.browser_use import (
     BrowserUseTaskStatusResponse,
     StartBrowserUseTaskParams,
     StartBrowserUseTaskResponse,
+    BrowserUseApiKeys,
+    BrowserUseAgentBrain,
+    BrowserUseAgentOutput,
+    BrowserUseActionResult,
+    BrowserUseStepMetadata,
+    BrowserUseTabInfo,
+    BrowserUseCoordinates,
+    BrowserUseCoordinateSet,
+    BrowserUseViewportInfo,
+    BrowserUseDOMHistoryElement,
+    BrowserUseBrowserStateHistory,
+    BrowserUseAgentHistory,
+    BrowserUseAgentOutputV0710,
+    BrowserUseActionResultV0710,
+    BrowserUseBrowserStateHistoryV0710,
+    BrowserUseStepMetadataV0710,
+    BrowserUseAgentHistoryV0710,
+    BrowserUseAgentHistoryLatest,
+    BrowserUseTaskMetadata,
+    BrowserUseStep,
+    cast_steps_for_version,
 )
 from .agents.claude_computer_use import (
+    ClaudeComputerUseTaskStatus,
+    ClaudeComputerUseStepResponse,
     ClaudeComputerUseTaskData,
     ClaudeComputerUseTaskResponse,
     ClaudeComputerUseTaskStatusResponse,
     StartClaudeComputerUseTaskParams,
     StartClaudeComputerUseTaskResponse,
+    ClaudeComputerUseApiKeys,
+)
+from .agents.gemini_computer_use import (
+    GeminiComputerUseTaskStatus,
+    GeminiComputerUseStepResponse,
+    GeminiComputerUseTaskData,
+    GeminiComputerUseTaskResponse,
+    GeminiComputerUseTaskStatusResponse,
+    StartGeminiComputerUseTaskParams,
+    StartGeminiComputerUseTaskResponse,
+    GeminiComputerUseApiKeys,
 )
 from .agents.cua import (
     CuaTaskData,
@@ -18,6 +52,7 @@ from .agents.cua import (
     CuaTaskStatusResponse,
     StartCuaTaskParams,
     StartCuaTaskResponse,
+    CuaApiKeys,
 )
 from .agents.hyper_agent import (
     HyperAgentActionOutput,
@@ -29,12 +64,14 @@ from .agents.hyper_agent import (
     HyperAgentTaskStatusResponse,
     StartHyperAgentTaskParams,
     StartHyperAgentTaskResponse,
+    HyperAgentApiKeys,
 )
 from .consts import (
     ISO639_1,
     POLLING_ATTEMPTS,
     HyperAgentLlm,
     BrowserUseLlm,
+    ClaudeComputerUseLlm,
     Country,
     DownloadsStatus,
     OperatingSystem,
@@ -44,7 +81,10 @@ from .consts import (
     ScrapePageStatus,
     ScrapeScreenshotFormat,
     ScrapeWaitUntil,
+    SessionEventLogType,
     State,
+    SessionRegion,
+    BrowserUseVersion,
 )
 from .crawl import (
     CrawledPage,
@@ -63,6 +103,7 @@ from .extract import (
     ExtractJobStatusResponse,
     StartExtractJobParams,
     StartExtractJobResponse,
+    ExtractJobMetadata,
 )
 from .profile import (
     CreateProfileParams,
@@ -86,6 +127,27 @@ from .scrape import (
     StartBatchScrapeJobResponse,
     StartScrapeJobParams,
     StartScrapeJobResponse,
+    StorageStateOptions,
+)
+from .computer_action import (
+    ClickActionParams,
+    ComputerAction,
+    ComputerActionParams,
+    ComputerActionResponse,
+    Coordinate,
+    DragActionParams,
+    HoldKeyActionParams,
+    MouseDownActionParams,
+    MouseUpActionParams,
+    MoveMouseActionParams,
+    PressKeysActionParams,
+    ScreenshotActionParams,
+    ScrollActionParams,
+    TypeTextActionParams,
+    ComputerActionMouseButton,
+    GetClipboardTextActionParams,
+    ComputerActionResponseDataClipboardText,
+    ComputerActionResponseData,
 )
 from .session import (
     BasicResponse,
@@ -101,7 +163,15 @@ from .session import (
     SessionListResponse,
     SessionRecording,
     SessionStatus,
+    SessionEventLog,
+    SessionEventLogListParams,
+    SessionEventLogListResponse,
+    SessionProfile,
+    SessionLaunchState,
+    UploadFileResponse,
+    ImageCaptchaParam,
 )
+from .team import TeamCreditInfo
 
 __all__ = [
     # consts
@@ -109,6 +179,7 @@ __all__ = [
     "POLLING_ATTEMPTS",
     "HyperAgentLlm",
     "BrowserUseLlm",
+    "ClaudeComputerUseLlm",
     "Country",
     "DownloadsStatus",
     "OperatingSystem",
@@ -118,7 +189,10 @@ __all__ = [
     "ScrapePageStatus",
     "ScrapeScreenshotFormat",
     "ScrapeWaitUntil",
+    "SessionEventLogType",
     "State",
+    "SessionRegion",
+    "BrowserUseVersion",
     # agents
     "HyperAgentTaskStatus",
     "HyperAgentActionOutput",
@@ -135,18 +209,51 @@ __all__ = [
     "BrowserUseTaskStatusResponse",
     "StartBrowserUseTaskParams",
     "StartBrowserUseTaskResponse",
+    "BrowserUseAgentBrain",
+    "BrowserUseAgentOutput",
+    "BrowserUseActionResult",
+    "BrowserUseStepMetadata",
+    "BrowserUseTabInfo",
+    "BrowserUseCoordinates",
+    "BrowserUseCoordinateSet",
+    "BrowserUseViewportInfo",
+    "BrowserUseDOMHistoryElement",
+    "BrowserUseBrowserStateHistory",
+    "BrowserUseAgentHistory",
+    "BrowserUseAgentOutputV0710",
+    "BrowserUseActionResultV0710",
+    "BrowserUseBrowserStateHistoryV0710",
+    "BrowserUseStepMetadataV0710",
+    "BrowserUseAgentHistoryV0710",
+    "BrowserUseAgentHistoryLatest",
+    "BrowserUseStep",
+    "BrowserUseTaskMetadata",
+    "cast_steps_for_version",
     "ClaudeComputerUseTaskStatus",
+    "ClaudeComputerUseStepResponse",
     "ClaudeComputerUseTaskData",
     "ClaudeComputerUseTaskResponse",
     "ClaudeComputerUseTaskStatusResponse",
     "StartClaudeComputerUseTaskParams",
     "StartClaudeComputerUseTaskResponse",
+    "GeminiComputerUseTaskStatus",
+    "GeminiComputerUseStepResponse",
+    "GeminiComputerUseTaskData",
+    "GeminiComputerUseTaskResponse",
+    "GeminiComputerUseTaskStatusResponse",
+    "StartGeminiComputerUseTaskParams",
+    "StartGeminiComputerUseTaskResponse",
     "CuaTaskStatus",
     "CuaTaskData",
     "CuaTaskResponse",
     "CuaTaskStatusResponse",
     "StartCuaTaskParams",
     "StartCuaTaskResponse",
+    "BrowserUseApiKeys",
+    "ClaudeComputerUseApiKeys",
+    "GeminiComputerUseApiKeys",
+    "CuaApiKeys",
+    "HyperAgentApiKeys",
     # crawl
     "CrawledPage",
     "CrawlJobResponse",
@@ -165,6 +272,7 @@ __all__ = [
     "ExtractJobStatusResponse",
     "StartExtractJobParams",
     "StartExtractJobResponse",
+    "ExtractJobMetadata",
     # profile
     "CreateProfileParams",
     "CreateProfileResponse",
@@ -186,6 +294,7 @@ __all__ = [
     "StartBatchScrapeJobResponse",
     "StartScrapeJobParams",
     "StartScrapeJobResponse",
+    "StorageStateOptions",
     # session
     "BasicResponse",
     "CreateSessionParams",
@@ -200,4 +309,32 @@ __all__ = [
     "SessionListResponse",
     "SessionRecording",
     "SessionStatus",
+    "SessionEventLog",
+    "SessionEventLogListParams",
+    "SessionEventLogListResponse",
+    "SessionProfile",
+    "SessionLaunchState",
+    "UploadFileResponse",
+    "ImageCaptchaParam",
+    # team
+    "TeamCreditInfo",
+    # computer action
+    "ClickActionParams",
+    "ComputerAction",
+    "ComputerActionParams",
+    "ComputerActionResponse",
+    "Coordinate",
+    "DragActionParams",
+    "HoldKeyActionParams",
+    "MouseDownActionParams",
+    "MouseUpActionParams",
+    "MoveMouseActionParams",
+    "PressKeysActionParams",
+    "ScreenshotActionParams",
+    "ScrollActionParams",
+    "TypeTextActionParams",
+    "ComputerActionMouseButton",
+    "GetClipboardTextActionParams",
+    "ComputerActionResponseDataClipboardText",
+    "ComputerActionResponseData",
 ]

hyperbrowser/models/agents/browser_use.py

@@ -1,13 +1,27 @@
-from typing import Any, Dict, List, Literal, Optional, Union
+from typing import Any, Dict, List, Literal, Optional, Type, Union
 
 from pydantic import BaseModel, ConfigDict, Field
 
-from ..consts import BrowserUseLlm
+from ..consts import BrowserUseLlm, BrowserUseVersion
 from ..session import CreateSessionParams
 
 BrowserUseTaskStatus = Literal["pending", "running", "completed", "failed", "stopped"]
 
 
+class BrowserUseApiKeys(BaseModel):
+    """
+    API keys for the browser use task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    openai: Optional[str] = Field(default=None, serialization_alias="openai")
+    anthropic: Optional[str] = Field(default=None, serialization_alias="anthropic")
+    google: Optional[str] = Field(default=None, serialization_alias="google")
+
+
 class StartBrowserUseTaskParams(BaseModel):
     """
     Parameters for creating a new browser use task.
@@ -18,6 +32,9 @@ class StartBrowserUseTaskParams(BaseModel):
     )
 
     task: str
+    version: Optional[BrowserUseVersion] = Field(
+        default=None, serialization_alias="version"
+    )
     llm: Optional[BrowserUseLlm] = Field(default=None, serialization_alias="llm")
     session_id: Optional[str] = Field(default=None, serialization_alias="sessionId")
     validate_output: Optional[bool] = Field(
@@ -47,12 +64,27 @@ class StartBrowserUseTaskParams(BaseModel):
     initial_actions: Optional[List[Dict[str, Dict[str, Any]]]] = Field(
         default=None, serialization_alias="initialActions"
     )
+    sensitive_data: Optional[Dict[str, str]] = Field(
+        default=None, serialization_alias="sensitiveData"
+    )
+    message_context: Optional[str] = Field(
+        default=None, serialization_alias="messageContext"
+    )
+    output_model_schema: Optional[Union[Dict[str, Any], Type[BaseModel]]] = Field(
+        default=None, serialization_alias="outputModelSchema"
+    )
     keep_browser_open: Optional[bool] = Field(
         default=None, serialization_alias="keepBrowserOpen"
     )
     session_options: Optional[CreateSessionParams] = Field(
         default=None, serialization_alias="sessionOptions"
     )
+    use_custom_api_keys: Optional[bool] = Field(
+        default=None, serialization_alias="useCustomApiKeys"
+    )
+    api_keys: Optional[BrowserUseApiKeys] = Field(
+        default=None, serialization_alias="apiKeys"
+    )
 
 
 class StartBrowserUseTaskResponse(BaseModel):
@@ -164,15 +196,79 @@ class BrowserUseAgentHistory(BaseModel):
     metadata: Optional[BrowserUseStepMetadata] = None
 
 
+# ===== 0.7.10-specific response models =====
+
+
+class BrowserUseAgentOutputV0710(BaseModel):
+    thinking: Optional[str] = None
+    evaluation_previous_goal: Optional[str] = None
+    memory: Optional[str] = None
+    next_goal: Optional[str] = None
+    action: list[dict]
+
+
+class BrowserUseActionResultV0710(BaseModel):
+    is_done: Optional[bool] = False
+    success: Optional[bool] = None
+    error: Optional[str] = None
+    metadata: Optional[dict] = None
+    attachments: Optional[list[str]] = None
+    long_term_memory: Optional[str] = None
+    extracted_content: Optional[str] = None
+    include_extracted_content_only_once: Optional[bool] = False
+    include_in_memory: bool = False
+
+
+class BrowserUseBrowserStateHistoryV0710(BaseModel):
+    url: str
+    title: str
+    tabs: list[dict]
+    interacted_element: Union[list[Union[dict, None]], list[None]]
+
+
+class BrowserUseStepMetadataV0710(BaseModel):
+    step_start_time: float
+    step_end_time: float
+    step_number: int
+
+
+class BrowserUseAgentHistoryV0710(BaseModel):
+    model_output: Union[BrowserUseAgentOutputV0710, None]
+    result: list[BrowserUseActionResultV0710]
+    state: BrowserUseBrowserStateHistoryV0710
+    metadata: Optional[BrowserUseStepMetadataV0710] = None
+
+
+# ===== latest response models =====
+
+BrowserUseAgentHistoryLatest = Dict[str, Any]
+
+BrowserUseStep = Union[
+    BrowserUseAgentHistory, BrowserUseAgentHistoryV0710, BrowserUseAgentHistoryLatest
+]
+
+
 class BrowserUseTaskData(BaseModel):
     model_config = ConfigDict(
         populate_by_alias=True,
     )
 
-    steps: list[BrowserUseAgentHistory]
+    steps: list[BrowserUseStep]
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class BrowserUseTaskMetadata(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    input_tokens: Optional[int] = Field(default=None, alias="inputTokens")
+    output_tokens: Optional[int] = Field(default=None, alias="outputTokens")
+    num_task_steps_completed: Optional[int] = Field(
+        default=None, alias="numTaskStepsCompleted"
+    )
+
+
 class BrowserUseTaskResponse(BaseModel):
     """
     Response from a browser use task.
@@ -184,6 +280,20 @@ class BrowserUseTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: BrowserUseTaskStatus
+    metadata: Optional[BrowserUseTaskMetadata] = Field(default=None, alias="metadata")
     data: Optional[BrowserUseTaskData] = Field(default=None, alias="data")
     error: Optional[str] = Field(default=None, alias="error")
     live_url: Optional[str] = Field(default=None, alias="liveUrl")
+
+
+def cast_steps_for_version(
+    steps: List[BrowserUseStep], version: BrowserUseVersion
+) -> List[BrowserUseStep]:
+    if version == "0.1.40":
+        return [BrowserUseAgentHistory.model_validate(s) for s in steps]
+    elif version == "0.7.10":
+        return [BrowserUseAgentHistoryV0710.model_validate(s) for s in steps]
+    elif version == "latest":
+        return steps
+    else:
+        raise ValueError(f"Invalid version: {version}")

hyperbrowser/models/agents/claude_computer_use.py

@@ -3,12 +3,25 @@ from typing import Any, Literal, Optional
 from pydantic import BaseModel, ConfigDict, Field
 
 from ..session import CreateSessionParams
+from ..consts import ClaudeComputerUseLlm
 
 ClaudeComputerUseTaskStatus = Literal[
     "pending", "running", "completed", "failed", "stopped"
 ]
 
 
+class ClaudeComputerUseApiKeys(BaseModel):
+    """
+    API keys for the Claude Computer Use task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    anthropic: Optional[str] = Field(default=None, serialization_alias="anthropic")
+
+
 class StartClaudeComputerUseTaskParams(BaseModel):
     """
     Parameters for creating a new Claude Computer Use task.
@@ -19,6 +32,7 @@ class StartClaudeComputerUseTaskParams(BaseModel):
     )
 
     task: str
+    llm: Optional[ClaudeComputerUseLlm] = Field(default=None, serialization_alias="llm")
     session_id: Optional[str] = Field(default=None, serialization_alias="sessionId")
     max_failures: Optional[int] = Field(default=None, serialization_alias="maxFailures")
     max_steps: Optional[int] = Field(default=None, serialization_alias="maxSteps")
@@ -28,6 +42,15 @@ class StartClaudeComputerUseTaskParams(BaseModel):
     session_options: Optional[CreateSessionParams] = Field(
         default=None, serialization_alias="sessionOptions"
     )
+    use_custom_api_keys: Optional[bool] = Field(
+        default=None, serialization_alias="useCustomApiKeys"
+    )
+    api_keys: Optional[ClaudeComputerUseApiKeys] = Field(
+        default=None, serialization_alias="apiKeys"
+    )
+    use_computer_action: Optional[bool] = Field(
+        default=None, serialization_alias="useComputerAction"
+    )
 
 
 class StartClaudeComputerUseTaskResponse(BaseModel):
@@ -81,6 +104,18 @@ class ClaudeComputerUseTaskData(BaseModel):
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class ClaudeComputerUseTaskMetadata(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    input_tokens: Optional[int] = Field(default=None, alias="inputTokens")
+    output_tokens: Optional[int] = Field(default=None, alias="outputTokens")
+    num_task_steps_completed: Optional[int] = Field(
+        default=None, alias="numTaskStepsCompleted"
+    )
+
+
 class ClaudeComputerUseTaskResponse(BaseModel):
     """
     Response from a Claude Computer Use task.
@@ -92,6 +127,9 @@ class ClaudeComputerUseTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: ClaudeComputerUseTaskStatus
+    metadata: Optional[ClaudeComputerUseTaskMetadata] = Field(
+        default=None, alias="metadata"
+    )
     data: Optional[ClaudeComputerUseTaskData] = Field(default=None, alias="data")
     error: Optional[str] = Field(default=None, alias="error")
     live_url: Optional[str] = Field(default=None, alias="liveUrl")

hyperbrowser/models/agents/cua.py

@@ -7,6 +7,18 @@ from ..session import CreateSessionParams
 CuaTaskStatus = Literal["pending", "running", "completed", "failed", "stopped"]
 
 
+class CuaApiKeys(BaseModel):
+    """
+    API keys for the CUA task.
+    """
+
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    openai: Optional[str] = Field(default=None, serialization_alias="openai")
+
+
 class StartCuaTaskParams(BaseModel):
     """
     Parameters for creating a new CUA task.
@@ -26,6 +38,13 @@ class StartCuaTaskParams(BaseModel):
     session_options: Optional[CreateSessionParams] = Field(
         default=None, serialization_alias="sessionOptions"
     )
+    use_custom_api_keys: Optional[bool] = Field(
+        default=None, serialization_alias="useCustomApiKeys"
+    )
+    api_keys: Optional[CuaApiKeys] = Field(default=None, serialization_alias="apiKeys")
+    use_computer_action: Optional[bool] = Field(
+        default=None, serialization_alias="useComputerAction"
+    )
 
 
 class StartCuaTaskResponse(BaseModel):
@@ -115,6 +134,18 @@ class CuaTaskData(BaseModel):
     final_result: Optional[str] = Field(default=None, alias="finalResult")
 
 
+class CuaTaskMetadata(BaseModel):
+    model_config = ConfigDict(
+        populate_by_alias=True,
+    )
+
+    input_tokens: Optional[int] = Field(default=None, alias="inputTokens")
+    output_tokens: Optional[int] = Field(default=None, alias="outputTokens")
+    num_task_steps_completed: Optional[int] = Field(
+        default=None, alias="numTaskStepsCompleted"
+    )
+
+
 class CuaTaskResponse(BaseModel):
     """
     Response from a CUA task.
@@ -126,6 +157,7 @@ class CuaTaskResponse(BaseModel):
 
     job_id: str = Field(alias="jobId")
     status: CuaTaskStatus
+    metadata: Optional[CuaTaskMetadata] = Field(default=None, alias="metadata")
     data: Optional[CuaTaskData] = Field(default=None, alias="data")
     error: Optional[str] = Field(default=None, alias="error")
     live_url: Optional[str] = Field(default=None, alias="liveUrl")