asteroid-odyssey 1.3.9__py3-none-any.whl → 1.3.10__py3-none-any.whl

asteroid_odyssey/agents_v2_gen/__init__.py

@@ -112,8 +112,10 @@ from asteroid_odyssey.agents_v2_gen.models.agents_graph_models_transitions_trans
 from asteroid_odyssey.agents_v2_gen.models.common_bad_request_error_body import CommonBadRequestErrorBody
 from asteroid_odyssey.agents_v2_gen.models.common_error import CommonError
 from asteroid_odyssey.agents_v2_gen.models.common_forbidden_error_body import CommonForbiddenErrorBody
+from asteroid_odyssey.agents_v2_gen.models.common_internal_server_error_body import CommonInternalServerErrorBody
 from asteroid_odyssey.agents_v2_gen.models.common_not_found_error_body import CommonNotFoundErrorBody
 from asteroid_odyssey.agents_v2_gen.models.common_os_error import CommonOSError
 from asteroid_odyssey.agents_v2_gen.models.common_sort_direction import CommonSortDirection
+from asteroid_odyssey.agents_v2_gen.models.common_unauthorized_error_body import CommonUnauthorizedErrorBody
 from asteroid_odyssey.agents_v2_gen.models.executions_list200_response import ExecutionsList200Response
 from asteroid_odyssey.agents_v2_gen.models.version import Version

asteroid_odyssey/agents_v2_gen/api/execution_api.py

@@ -110,8 +110,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "List[AgentsExecutionActivity]",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -188,8 +190,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "List[AgentsExecutionActivity]",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -266,8 +270,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "List[AgentsExecutionActivity]",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -406,8 +412,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "AgentsExecutionListItem",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -476,8 +484,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "AgentsExecutionListItem",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -546,8 +556,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "AgentsExecutionListItem",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -680,8 +692,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '201': "str",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -754,8 +768,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '201': "str",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -828,8 +844,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '201': "str",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1031,8 +1049,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "ExecutionsList200Response",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1157,8 +1177,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "ExecutionsList200Response",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,
@@ -1283,8 +1305,10 @@ class ExecutionApi:
         _response_types_map: Dict[str, Optional[str]] = {
             '200': "ExecutionsList200Response",
             '400': "CommonBadRequestErrorBody",
+            '401': "CommonUnauthorizedErrorBody",
             '403': "CommonForbiddenErrorBody",
             '404': "CommonNotFoundErrorBody",
+            '500': "CommonInternalServerErrorBody",
         }
         response_data = self.api_client.call_api(
             *_param,

asteroid_odyssey/agents_v2_gen/models/__init__.py

@@ -93,8 +93,10 @@ from asteroid_odyssey.agents_v2_gen.models.agents_graph_models_transitions_trans
 from asteroid_odyssey.agents_v2_gen.models.common_bad_request_error_body import CommonBadRequestErrorBody
 from asteroid_odyssey.agents_v2_gen.models.common_error import CommonError
 from asteroid_odyssey.agents_v2_gen.models.common_forbidden_error_body import CommonForbiddenErrorBody
+from asteroid_odyssey.agents_v2_gen.models.common_internal_server_error_body import CommonInternalServerErrorBody
 from asteroid_odyssey.agents_v2_gen.models.common_not_found_error_body import CommonNotFoundErrorBody
 from asteroid_odyssey.agents_v2_gen.models.common_os_error import CommonOSError
 from asteroid_odyssey.agents_v2_gen.models.common_sort_direction import CommonSortDirection
+from asteroid_odyssey.agents_v2_gen.models.common_unauthorized_error_body import CommonUnauthorizedErrorBody
 from asteroid_odyssey.agents_v2_gen.models.executions_list200_response import ExecutionsList200Response
 from asteroid_odyssey.agents_v2_gen.models.version import Version

asteroid_odyssey/agents_v2_gen/models/agents_execution_list_item.py

@@ -36,7 +36,8 @@ class AgentsExecutionListItem(BaseModel):
     agent_profile_name: Optional[StrictStr] = Field(default=None, description="The name of the agent profile used for this execution (if any)", alias="agentProfileName")
     agent_version: StrictInt = Field(description="The version of the agent that was executed", alias="agentVersion")
     agent_version_dirty: StrictBool = Field(description="Whether the agent version was modified from the original", alias="agentVersionDirty")
-    browser_recording_url: Optional[StrictStr] = Field(default=None, description="Browser recording URL (if a browser session was used)", alias="browserRecordingUrl")
+    browser_live_view_url: Optional[StrictStr] = Field(default=None, description="Browser live view URL for debugging (if a browser session is active and execution is running)", alias="browserLiveViewUrl")
+    browser_recording_url: Optional[StrictStr] = Field(default=None, description="Browser recording URL (if a browser session was used and execution is terminal)", alias="browserRecordingUrl")
     comments: List[AgentsExecutionComment] = Field(description="Comments on this execution")
     created_at: datetime = Field(description="When the execution was created", alias="createdAt")
     duration: Optional[Union[StrictFloat, StrictInt]] = Field(default=None, description="Execution duration in seconds (only present for terminal executions)")
@@ -48,7 +49,7 @@ class AgentsExecutionListItem(BaseModel):
     status: AgentsExecutionStatus = Field(description="The current status of the execution")
     terminal_at: Optional[datetime] = Field(default=None, description="When the execution reached a terminal state (if applicable)", alias="terminalAt")
     workflow_id: StrictStr = Field(description="The ID of the workflow that was executed", alias="workflowId")
-    __properties: ClassVar[List[str]] = ["agentId", "agentName", "agentProfileName", "agentVersion", "agentVersionDirty", "browserRecordingUrl", "comments", "createdAt", "duration", "executionResult", "humanLabels", "id", "metadata", "organizationId", "status", "terminalAt", "workflowId"]
+    __properties: ClassVar[List[str]] = ["agentId", "agentName", "agentProfileName", "agentVersion", "agentVersionDirty", "browserLiveViewUrl", "browserRecordingUrl", "comments", "createdAt", "duration", "executionResult", "humanLabels", "id", "metadata", "organizationId", "status", "terminalAt", "workflowId"]
 
     model_config = ConfigDict(
         populate_by_name=True,
@@ -123,6 +124,7 @@ class AgentsExecutionListItem(BaseModel):
             "agentProfileName": obj.get("agentProfileName"),
             "agentVersion": obj.get("agentVersion"),
             "agentVersionDirty": obj.get("agentVersionDirty"),
+            "browserLiveViewUrl": obj.get("browserLiveViewUrl"),
             "browserRecordingUrl": obj.get("browserRecordingUrl"),
             "comments": [AgentsExecutionComment.from_dict(_item) for _item in obj["comments"]] if obj.get("comments") is not None else None,
             "createdAt": obj.get("createdAt"),

asteroid_odyssey/agents_v2_gen/models/common_internal_server_error_body.py

@@ -0,0 +1,96 @@
+# coding: utf-8
+
+"""
+    Agent Service
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictFloat, StrictInt, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class CommonInternalServerErrorBody(BaseModel):
+    """
+    CommonInternalServerErrorBody
+    """ # noqa: E501
+    code: Union[StrictFloat, StrictInt]
+    message: StrictStr
+    __properties: ClassVar[List[str]] = ["code", "message"]
+
+    @field_validator('code')
+    def code_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set([500]):
+            raise ValueError("must be one of enum values (500)")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of CommonInternalServerErrorBody from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of CommonInternalServerErrorBody from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "code": obj.get("code"),
+            "message": obj.get("message")
+        })
+        return _obj
+
+

asteroid_odyssey/agents_v2_gen/models/common_unauthorized_error_body.py

@@ -0,0 +1,96 @@
+# coding: utf-8
+
+"""
+    Agent Service
+
+    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+
+    The version of the OpenAPI document: v1
+    Generated by OpenAPI Generator (https://openapi-generator.tech)
+
+    Do not edit the class manually.
+"""  # noqa: E501
+
+
+from __future__ import annotations
+import pprint
+import re  # noqa: F401
+import json
+
+from pydantic import BaseModel, ConfigDict, StrictFloat, StrictInt, StrictStr, field_validator
+from typing import Any, ClassVar, Dict, List, Union
+from typing import Optional, Set
+from typing_extensions import Self
+
+class CommonUnauthorizedErrorBody(BaseModel):
+    """
+    CommonUnauthorizedErrorBody
+    """ # noqa: E501
+    code: Union[StrictFloat, StrictInt]
+    message: StrictStr
+    __properties: ClassVar[List[str]] = ["code", "message"]
+
+    @field_validator('code')
+    def code_validate_enum(cls, value):
+        """Validates the enum"""
+        if value not in set([401]):
+            raise ValueError("must be one of enum values (401)")
+        return value
+
+    model_config = ConfigDict(
+        populate_by_name=True,
+        validate_assignment=True,
+        protected_namespaces=(),
+    )
+
+
+    def to_str(self) -> str:
+        """Returns the string representation of the model using alias"""
+        return pprint.pformat(self.model_dump(by_alias=True))
+
+    def to_json(self) -> str:
+        """Returns the JSON representation of the model using alias"""
+        # TODO: pydantic v2: use .model_dump_json(by_alias=True, exclude_unset=True) instead
+        return json.dumps(self.to_dict())
+
+    @classmethod
+    def from_json(cls, json_str: str) -> Optional[Self]:
+        """Create an instance of CommonUnauthorizedErrorBody from a JSON string"""
+        return cls.from_dict(json.loads(json_str))
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Return the dictionary representation of the model using alias.
+
+        This has the following differences from calling pydantic's
+        `self.model_dump(by_alias=True)`:
+
+        * `None` is only added to the output dict for nullable fields that
+          were set at model initialization. Other fields with value `None`
+          are ignored.
+        """
+        excluded_fields: Set[str] = set([
+        ])
+
+        _dict = self.model_dump(
+            by_alias=True,
+            exclude=excluded_fields,
+            exclude_none=True,
+        )
+        return _dict
+
+    @classmethod
+    def from_dict(cls, obj: Optional[Dict[str, Any]]) -> Optional[Self]:
+        """Create an instance of CommonUnauthorizedErrorBody from a dict"""
+        if obj is None:
+            return None
+
+        if not isinstance(obj, dict):
+            return cls.model_validate(obj)
+
+        _obj = cls.model_validate({
+            "code": obj.get("code"),
+            "message": obj.get("message")
+        })
+        return _obj
+
+

asteroid_odyssey/client.py

@@ -25,7 +25,6 @@ from .agents_v1_gen import (
     ExecutionStatusResponse,
     ExecutionResult,
     Status,
-    StructuredAgentExecutionRequest,
     CreateAgentProfileRequest,
     UpdateAgentProfileRequest,
     DeleteAgentProfile200Response,
@@ -44,9 +43,14 @@ from .agents_v2_gen import (
     AgentsExecutionActivity as ExecutionActivity,
     AgentsExecutionUserMessagesAddTextBody as ExecutionUserMessagesAddTextBody,
     AgentsFilesFile as File,
-    AgentsAgentExecuteAgentRequest as V2ExecuteAgentRequest,
+    AgentsAgentExecuteAgentRequest as ExecuteAgentRequest,
     AgentsFilesTempFile as TempFile,
     AgentsFilesTempFilesResponse as TempFilesResponse,
+    AgentsExecutionSortField as ExecutionSortField,
+    AgentsExecutionStatus as ExecutionStatus,
+    AgentsExecutionListItem as ExecutionListItem,
+    ExecutionsList200Response,
+    CommonSortDirection as SortDirection,
 )
 
 
@@ -156,10 +160,12 @@ class AsteroidClient:
         self.agents_v2_execution_api = AgentsV2ExecutionApi(self.agents_v2_api_client)
         self.agents_v2_files_api = AgentsV2FilesApi(self.agents_v2_api_client)
 
+    # --- V2 ---
+
     def execute_agent(
         self,
         agent_id: str,
-        execution_data: Optional[Dict[str, Any]] = None,
+        dynamic_data: Optional[Dict[str, Any]] = None,
         agent_profile_id: Optional[str] = None,
         metadata: Optional[Dict[str, Any]] = None,
         temp_files: Optional[List[TempFile]] = None,
@@ -170,10 +176,10 @@ class AsteroidClient:
 
         Args:
             agent_id: The ID of the agent to execute
-            execution_data: Dynamic data to be merged into the placeholders defined in prompts
+            dynamic_data: Dynamic data to be merged into the placeholders defined in prompts
             agent_profile_id: Optional ID of the agent profile to use
             metadata: Optional metadata key-value pairs for organizing and filtering executions
-            temp_files: Optional list of temporary files to attach (must be pre-uploaded using stage file endpoint)
+            temp_files: Optional list of temporary files to attach (must be pre-uploaded using stage_temp_files)
             version: Optional version of the agent to execute. If not provided, the latest version will be used.
 
         Returns:
@@ -186,8 +192,8 @@ class AsteroidClient:
             execution_id = client.execute_agent('my-agent-id', {'input': 'some dynamic value'})
             execution_id = client.execute_agent('my-agent-id', {'input': 'value'}, version=3)
         """
-        req = V2ExecuteAgentRequest(
-            dynamic_data=execution_data,
+        req = ExecuteAgentRequest(
+            dynamic_data=dynamic_data,
             agent_profile_id=agent_profile_id,
             metadata=metadata,
             temp_files=temp_files,
@@ -794,8 +800,6 @@ class AsteroidClient:
             pass
         return False
 
-    # --- V2 ---
-
     def get_agents(self, org_id: str, page: int = 1, page_size: int = 100) -> List[Agent]:
         """
         Get a paginated list of agents for an organization.
@@ -812,9 +816,102 @@ class AsteroidClient:
             for agent in agents:
                 print(f"Agent: {agent.name}")
         """
-        response = self.agents_v2_execution_api.agent_list(organization_id=org_id, page=page, page_size=page_size)
+        response = self.agents_v2_agents_api.agent_list(organization_id=org_id, page=page, page_size=page_size)
         return response.items
 
+    def get_executions(
+        self,
+        organization_id: str,
+        page: int = 1,
+        page_size: int = 20,
+        execution_id: Optional[str] = None,
+        agent_id: Optional[str] = None,
+        status: Optional[List[str]] = None,
+        agent_version: Optional[int] = None,
+        created_after: Optional[str] = None,
+        created_before: Optional[str] = None,
+        human_labels: Optional[List[str]] = None,
+        outcome_label: Optional[str] = None,
+        metadata_key: Optional[str] = None,
+        metadata_value: Optional[str] = None,
+        sort_field: Optional[str] = None,
+        sort_direction: Optional[str] = None,
+    ) -> ExecutionsList200Response:
+        """
+        Get a paginated list of executions with optional filtering.
+
+        Args:
+            organization_id: The organization identifier (required)
+            page: The page number (default: 1)
+            page_size: The page size (default: 20)
+            execution_id: Search by execution ID (partial, case-insensitive match)
+            agent_id: Filter by agent ID
+            status: Filter by execution status (can specify multiple)
+            agent_version: Filter by agent version
+            created_after: Filter executions created after this timestamp (ISO 8601)
+            created_before: Filter executions created before this timestamp (ISO 8601)
+            human_labels: Filter by human labels (can specify multiple label IDs)
+            outcome_label: Filter by execution result outcome (partial, case-insensitive match)
+            metadata_key: Filter by metadata key - must be used together with metadata_value
+            metadata_value: Filter by metadata value - must be used together with metadata_key
+            sort_field: Field to sort by (e.g., 'created_at')
+            sort_direction: Sort direction ('asc' or 'desc')
+
+        Returns:
+            Paginated execution list with metadata
+
+        Raises:
+            AsteroidAPIError: If the executions request fails
+
+        Example:
+            # Get all executions for an organization
+            result = client.get_executions(organization_id='org_123', page=1, page_size=20)
+
+            # Filter by agent and status
+            result = client.get_executions(
+                organization_id='org_123',
+                agent_id='agent_456',
+                status=['completed', 'failed'],
+                sort_field='created_at',
+                sort_direction='desc'
+            )
+        """
+        from datetime import datetime as dt
+
+        # Convert status strings to enum if provided
+        status_enums = None
+        if status:
+            status_enums = [ExecutionStatus(s) for s in status]
+
+        # Convert sort_field and sort_direction to enums if provided
+        sort_field_enum = ExecutionSortField(sort_field) if sort_field else None
+        sort_direction_enum = SortDirection(sort_direction) if sort_direction else None
+
+        # Parse datetime strings
+        created_after_dt = dt.fromisoformat(created_after.replace('Z', '+00:00')) if created_after else None
+        created_before_dt = dt.fromisoformat(created_before.replace('Z', '+00:00')) if created_before else None
+
+        try:
+            return self.agents_v2_execution_api.executions_list(
+                page_size=page_size,
+                page=page,
+                organization_id=organization_id,
+                execution_id=execution_id,
+                agent_id=agent_id,
+                status=status_enums,
+                agent_version=agent_version,
+                created_after=created_after_dt,
+                created_before=created_before_dt,
+                human_labels=human_labels,
+                outcome_label=outcome_label,
+                metadata_key=metadata_key,
+                metadata_value=metadata_value,
+                sort_field=sort_field_enum,
+                sort_direction=sort_direction_enum,
+            )
+        except ApiException as e:
+            raise AsteroidAPIError(f"Failed to get executions: {e}") from e
+
     def get_last_n_execution_activities(self, execution_id: str, n: int) -> List[ExecutionActivity]:
         """
         Get the last N execution activities for a given execution ID, sorted by their timestamp in descending order.
@@ -1055,10 +1152,12 @@ def create_client(api_key: str, base_url: Optional[str] = None) -> AsteroidClien
     """
     return AsteroidClient(api_key, base_url)
 
+# --- V2 ---
+
 def execute_agent(
     client: AsteroidClient,
     agent_id: str,
-    execution_data: Optional[Dict[str, Any]] = None,
+    dynamic_data: Optional[Dict[str, Any]] = None,
     agent_profile_id: Optional[str] = None,
     metadata: Optional[Dict[str, Any]] = None,
     temp_files: Optional[List[TempFile]] = None,
@@ -1070,10 +1169,10 @@ def execute_agent(
     Args:
         client: The AsteroidClient instance
         agent_id: The ID of the agent to execute
-        execution_data: Dynamic data to be merged into the placeholders defined in prompts
+        dynamic_data: Dynamic data to be merged into the placeholders defined in prompts
         agent_profile_id: Optional ID of the agent profile to use
         metadata: Optional metadata key-value pairs for organizing and filtering executions
-        temp_files: Optional list of temporary files to attach (must be pre-uploaded using stage file endpoint)
+        temp_files: Optional list of temporary files to attach (must be pre-uploaded using stage_temp_files)
         version: Optional version of the agent to execute. If not provided, the latest version will be used.
 
     Returns:
@@ -1085,7 +1184,7 @@ def execute_agent(
     """
     return client.execute_agent(
         agent_id,
-        execution_data,
+        dynamic_data,
         agent_profile_id,
         metadata,
         temp_files,
@@ -1380,8 +1479,71 @@ def get_agents(client: AsteroidClient, org_id: str, page: int = 1, page_size: in
         for agent in agents:
             print(f"Agent: {agent.name}")
     """
-    response = client.get_agents(org_id, page, page_size)
-    return response.items
+    return client.get_agents(org_id, page, page_size)
+
+def get_executions(
+    client: AsteroidClient,
+    organization_id: str,
+    page: int = 1,
+    page_size: int = 20,
+    execution_id: Optional[str] = None,
+    agent_id: Optional[str] = None,
+    status: Optional[List[str]] = None,
+    agent_version: Optional[int] = None,
+    created_after: Optional[str] = None,
+    created_before: Optional[str] = None,
+    human_labels: Optional[List[str]] = None,
+    outcome_label: Optional[str] = None,
+    metadata_key: Optional[str] = None,
+    metadata_value: Optional[str] = None,
+    sort_field: Optional[str] = None,
+    sort_direction: Optional[str] = None,
+) -> ExecutionsList200Response:
+    """
+    Get a paginated list of executions with optional filtering.
+
+    Args:
+        client: The AsteroidClient instance
+        organization_id: The organization identifier (required)
+        page: The page number (default: 1)
+        page_size: The page size (default: 20)
+        execution_id: Search by execution ID (partial, case-insensitive match)
+        agent_id: Filter by agent ID
+        status: Filter by execution status (can specify multiple)
+        agent_version: Filter by agent version
+        created_after: Filter executions created after this timestamp (ISO 8601)
+        created_before: Filter executions created before this timestamp (ISO 8601)
+        human_labels: Filter by human labels (can specify multiple label IDs)
+        outcome_label: Filter by execution result outcome (partial, case-insensitive match)
+        metadata_key: Filter by metadata key - must be used together with metadata_value
+        metadata_value: Filter by metadata value - must be used together with metadata_key
+        sort_field: Field to sort by (e.g., 'created_at')
+        sort_direction: Sort direction ('asc' or 'desc')
+
+    Returns:
+        Paginated execution list with metadata
+
+    Example:
+        result = get_executions(client, organization_id='org_123', page=1, page_size=20)
+    """
+    return client.get_executions(
+        organization_id=organization_id,
+        page=page,
+        page_size=page_size,
+        execution_id=execution_id,
+        agent_id=agent_id,
+        status=status,
+        agent_version=agent_version,
+        created_after=created_after,
+        created_before=created_before,
+        human_labels=human_labels,
+        outcome_label=outcome_label,
+        metadata_key=metadata_key,
+        metadata_value=metadata_value,
+        sort_field=sort_field,
+        sort_direction=sort_direction,
+    )
+
 def get_last_n_execution_activities(client: AsteroidClient, execution_id: str, n: int) -> List[ExecutionActivity]:
     """
     Get the last N execution activities for a given execution ID, sorted by their timestamp in descending order.
@@ -1520,31 +1682,46 @@ def wait_for_agent_interaction(
 
 # Re-export common types for convenience
 __all__ = [
+    # Client
     'AsteroidClient',
     'create_client',
+    # Agent Execution (V2)
     'execute_agent',
+    'get_executions',
+    # Execution Status & Results (V1)
     'get_execution_status',
     'get_execution_result',
     'wait_for_execution_result',
     'upload_execution_files',
     'stage_temp_files',
     'get_browser_session_recording',
+    # Agent Profiles (V1)
     'get_agent_profiles',
     'get_agent_profile',
     'create_agent_profile',
     'update_agent_profile',
     'delete_agent_profile',
+    'get_credentials_public_key',
+    # Agents (V2)
     'get_agents',
+    # Execution Activities (V2)
     'get_last_n_execution_activities',
     'add_message_to_execution',
     'get_execution_files',
     'download_execution_file',
     'wait_for_agent_interaction',
-    'get_credentials_public_key',
+    # Exceptions
     'AsteroidAPIError',
     'ExecutionError',
     'TimeoutError',
     'AgentInteractionResult',
+    # Types
     'TempFile',
     'TempFilesResponse',
+    'ExecuteAgentRequest',
+    'ExecutionListItem',
+    'ExecutionsList200Response',
+    'ExecutionStatus',
+    'ExecutionSortField',
+    'SortDirection',
 ]

{asteroid_odyssey-1.3.9.dist-info → asteroid_odyssey-1.3.10.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: asteroid-odyssey
-Version: 1.3.9
+Version: 1.3.10
 Summary: A Python SDK for browser automation using Asteroid platform.
 Author-email: David Mlcoch <founders@asteroid.com>
 License-Expression: MIT

{asteroid_odyssey-1.3.9.dist-info → asteroid_odyssey-1.3.10.dist-info}/RECORD

@@ -1,5 +1,5 @@
 asteroid_odyssey/__init__.py,sha256=po0AK2n1AiFyeAywL4Ju3qHGzTcRuH2LuXstuXthbT0,1273
-asteroid_odyssey/client.py,sha256=hn4n26Sf6k0qxxBKYFMiKahhKZW1JrvyqfRPLgk9yQI,59685
+asteroid_odyssey/client.py,sha256=vL1JF5PiKfhK3MdagdviUhUJraSWRYZNL5hclN70M08,66726
 asteroid_odyssey/agents_v1_gen/__init__.py,sha256=8ULksHLOQJbxz9LkUs0sHFs47cWst2SeKs3NLGlLCjk,2841
 asteroid_odyssey/agents_v1_gen/api_client.py,sha256=sxH4_y4LtJLTmK9Sd67qYIkHwnbjLGFI7aaL-Y4xZUs,27513
 asteroid_odyssey/agents_v1_gen/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
@@ -30,7 +30,7 @@ asteroid_odyssey/agents_v1_gen/models/proxy_type.py,sha256=zZ2MI0w7PZ8_a3KCLlNqQ
 asteroid_odyssey/agents_v1_gen/models/status.py,sha256=tnt_4jdoMzcjo6J0vttf2QKLNK0FC9XcjZKbGC3sbz0,889
 asteroid_odyssey/agents_v1_gen/models/structured_agent_execution_request.py,sha256=VZyW85pVz9T27aiG4ZlGywnnxTOaJCAjHSDz8D2YxY8,2913
 asteroid_odyssey/agents_v1_gen/models/update_agent_profile_request.py,sha256=zFy3EoYm9-nCncNPHwZDX7I5O2ZlKRJH6foPk0sAhA8,5895
-asteroid_odyssey/agents_v2_gen/__init__.py,sha256=iR4Io6QLbZUU_NUNvYe2Xeo1M9ueJc2dGZLwQS7JH9k,11969
+asteroid_odyssey/agents_v2_gen/__init__.py,sha256=Zp_fAYikJ55pSXr1vdXgH5akHbWUEc9kvV8fkrSBblQ,12192
 asteroid_odyssey/agents_v2_gen/api_client.py,sha256=zf8LBIbhuInmYPs4iTmxc8mU4gwONeX3JPq3D8ZTftM,27573
 asteroid_odyssey/agents_v2_gen/api_response.py,sha256=eMxw1mpmJcoGZ3gs9z6jM4oYoZ10Gjk333s9sKxGv7s,652
 asteroid_odyssey/agents_v2_gen/configuration.py,sha256=z_um4Jc01mYd-U0-8J74KOy2AJYq6KDtcRxBtDFVsEQ,18593
@@ -39,9 +39,9 @@ asteroid_odyssey/agents_v2_gen/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMp
 asteroid_odyssey/agents_v2_gen/rest.py,sha256=pSjg1rCUe0Z7K1xrRtsHwQo7Xa-yF35k2o2ORAdbiKY,9431
 asteroid_odyssey/agents_v2_gen/api/__init__.py,sha256=zP96zXtocDaIDci8REJzcl6ARlnBapyslSrPf7-JiT0,256
 asteroid_odyssey/agents_v2_gen/api/agents_api.py,sha256=UAIQsb3CLwN-q_cwlEH3sfOwfEvaT67E5OSDpVXFK9M,26558
-asteroid_odyssey/agents_v2_gen/api/execution_api.py,sha256=F9hQRxRItKRvru3drCnXzIcLfU2bwmrdW6TZPENr8B4,62441
+asteroid_odyssey/agents_v2_gen/api/execution_api.py,sha256=PZ11wUU9ilYzf943aDdL2r-JKmBq1KNYC5qC0itRv8g,63665
 asteroid_odyssey/agents_v2_gen/api/files_api.py,sha256=jcIgHi2b6g49eh07bVd99LdWXGpZuN0czmrWoxayqSQ,35517
-asteroid_odyssey/agents_v2_gen/models/__init__.py,sha256=xjB5hYPR0x4Tul9qvGYE1GHbcV8_rukGasojBKeB1IY,11073
+asteroid_odyssey/agents_v2_gen/models/__init__.py,sha256=PxgTCmKQyJNiZ3KDO2YKBqkjZSU5uIT0E9RkcUXObFQ,11296
 asteroid_odyssey/agents_v2_gen/models/agent_list200_response.py,sha256=09DlBwTk0VSWPgfLewU9HkNncyrz1ij2I7PxtaYQC8o,3249
 asteroid_odyssey/agents_v2_gen/models/agents_agent_base.py,sha256=XfW4gpuvynUZ1JJn1ovnLBcM25fB_Ctgnm7VO1NoiNg,2955
 asteroid_odyssey/agents_v2_gen/models/agents_agent_execute_agent_request.py,sha256=BDOK7pn3RTNIlmSTFspgtxpTy8AQa0MC0pJp9-b_VgI,4245
@@ -79,7 +79,7 @@ asteroid_odyssey/agents_v2_gen/models/agents_execution_file_list_completed_detai
 asteroid_odyssey/agents_v2_gen/models/agents_execution_file_read_completed_details.py,sha256=4LVTrL7iS2yfE4JAMXNeCxAPaVfgJSKVqih_T6Vgb5I,3352
 asteroid_odyssey/agents_v2_gen/models/agents_execution_file_stage_completed_details.py,sha256=aowoJrFg-jwZQ3ImE1WRdMR-8gS2qo4bxrBavbQSCbk,3032
 asteroid_odyssey/agents_v2_gen/models/agents_execution_human_label.py,sha256=kjFJmgimqWECegmLpeiomykYdupyvw67s3OXS5vNutg,3218
-asteroid_odyssey/agents_v2_gen/models/agents_execution_list_item.py,sha256=04WyY7ZgFGV8iJxBaiYLvJKGaQJX7zxY5XK5eN72hCc,7415
+asteroid_odyssey/agents_v2_gen/models/agents_execution_list_item.py,sha256=DzdAV5e7c_hFYTbrIvaTtU4LL5HKRJb0FFEtYHX3Uys,7734
 asteroid_odyssey/agents_v2_gen/models/agents_execution_llm_call_purpose.py,sha256=ZyMEExVLDmrRDU25GWEePHAnDhKFEgJmUaU4h7ij2lU,1065
 asteroid_odyssey/agents_v2_gen/models/agents_execution_llm_call_started_details.py,sha256=18pbGktwRxtLhvGm58uAvihD9Ve3hKrWrsrPzMfhAGY,3104
 asteroid_odyssey/agents_v2_gen/models/agents_execution_nav_to_completed_details.py,sha256=x3FB2vujx1Kedlplfe6jaZ6KhchFuX0KCliZbGgUDzE,3036
@@ -121,12 +121,14 @@ asteroid_odyssey/agents_v2_gen/models/agents_graph_models_transitions_transition
 asteroid_odyssey/agents_v2_gen/models/common_bad_request_error_body.py,sha256=cZQcZH6c2RmQleZe57-mfUsCKW74lGGtVMWbJFGc1ho,2889
 asteroid_odyssey/agents_v2_gen/models/common_error.py,sha256=to8zl1yPqcf8hRXEZeOrhuA_jWhmpaMmly5Y_Xl129k,2551
 asteroid_odyssey/agents_v2_gen/models/common_forbidden_error_body.py,sha256=9yADAujD_9eTW4BtZ7oYifmFCDTpAw-j1jEEJhwdAVs,2885
+asteroid_odyssey/agents_v2_gen/models/common_internal_server_error_body.py,sha256=DDtB3LOeVTtvdWhTEthmobNL-0BsuhAd7Zh0ZAb4Mgs,2905
 asteroid_odyssey/agents_v2_gen/models/common_not_found_error_body.py,sha256=BAVAweVD5ltGL2lWfdDNwaq82CI4iVkPVE_E9JfEpi8,2881
 asteroid_odyssey/agents_v2_gen/models/common_os_error.py,sha256=5hF0Q4D2sYdRe-F-mDT1FmD5yH4PcbKRlm8VkqDtBC4,2483
 asteroid_odyssey/agents_v2_gen/models/common_sort_direction.py,sha256=UBW99PM3QRGRRE7dB5OSBhmhogmsXQQsrw66j0fg_xc,763
+asteroid_odyssey/agents_v2_gen/models/common_unauthorized_error_body.py,sha256=Ng62vZVuPWEkTvdnYimbItSKhUGT9G52ZOapMQ2O7Xg,2897
 asteroid_odyssey/agents_v2_gen/models/executions_list200_response.py,sha256=hmZBiOEUKpzEptDcElwgNwhCwSnXFJsrBbb9w2amGiM,3302
 asteroid_odyssey/agents_v2_gen/models/version.py,sha256=Vjiri_a5CcDJ1lSziRqif5HuFpaxneVDLIB1r8SFIkE,707
-asteroid_odyssey-1.3.9.dist-info/METADATA,sha256=JzD_ZEA8e2A5L371dCmWiar2Pd6NEKpFxrOFkR8q0P0,7108
-asteroid_odyssey-1.3.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-asteroid_odyssey-1.3.9.dist-info/top_level.txt,sha256=h4T6NKscnThJ4Nhzors2NKlJeZzepnM7XvDgsnfi5HA,17
-asteroid_odyssey-1.3.9.dist-info/RECORD,,
+asteroid_odyssey-1.3.10.dist-info/METADATA,sha256=HVHgSVf2vDCzIBo08j4YHScTAIpYZTws37dNX4--rJs,7109
+asteroid_odyssey-1.3.10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+asteroid_odyssey-1.3.10.dist-info/top_level.txt,sha256=h4T6NKscnThJ4Nhzors2NKlJeZzepnM7XvDgsnfi5HA,17
+asteroid_odyssey-1.3.10.dist-info/RECORD,,