anchorbrowser 0.1.1__py3-none-any.whl → 0.3.0__py3-none-any.whl

anchorbrowser/types/session_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Union
+from typing import Union, Iterable
 from typing_extensions import Literal, Required, TypeAlias, TypedDict
 
 from .._types import SequenceNotStr
@@ -13,12 +13,17 @@ __all__ = [
     "BrowserAdblock",
     "BrowserCaptchaSolver",
     "BrowserDisableWebSecurity",
+    "BrowserExtraStealth",
     "BrowserFullscreen",
     "BrowserHeadless",
     "BrowserP2pDownload",
     "BrowserPopupBlocker",
     "BrowserProfile",
     "BrowserViewport",
+    "Integration",
+    "IntegrationConfiguration",
+    "IntegrationConfigurationOnePasswordAllSecretsConfig",
+    "IntegrationConfigurationOnePasswordSpecificSecretsConfig",
     "Session",
     "SessionLiveView",
     "SessionProxy",
@@ -33,6 +38,12 @@ class SessionCreateParams(TypedDict, total=False):
     browser: Browser
     """Browser-specific configurations."""
 
+    integrations: Iterable[Integration]
+    """Array of integrations to load in the browser session.
+
+    Integrations must be previously created using the Integrations API.
+    """
+
     session: Session
     """Session-related configurations."""
 
@@ -59,6 +70,11 @@ class BrowserDisableWebSecurity(TypedDict, total=False):
     """
 
 
+class BrowserExtraStealth(TypedDict, total=False):
+    active: bool
+    """Enable or disable extra stealth mode."""
+
+
 class BrowserFullscreen(TypedDict, total=False):
     active: bool
     """Enable or disable fullscreen mode.
@@ -99,12 +115,6 @@ class BrowserProfile(TypedDict, total=False):
     browser session ends. Defaults to `false`.
     """
 
-    reset_preferences: bool
-    """When enabled, resets the profile's preferences on session creation.
-
-    Defaults to `false`.
-    """
-
 
 class BrowserViewport(TypedDict, total=False):
     height: int
@@ -130,6 +140,12 @@ class Browser(TypedDict, total=False):
     Extensions must be previously uploaded using the Extensions API.
     """
 
+    extra_stealth: BrowserExtraStealth
+    """
+    Configuration for extra stealth mode to enhance browser fingerprinting
+    protection.
+    """
+
     fullscreen: BrowserFullscreen
     """Configuration for fullscreen mode."""
 
@@ -149,6 +165,34 @@ class Browser(TypedDict, total=False):
     """Configuration for the browser's viewport size."""
 
 
+class IntegrationConfigurationOnePasswordAllSecretsConfig(TypedDict, total=False):
+    load_mode: Required[Literal["all"]]
+    """Load all secrets from 1Password"""
+
+
+class IntegrationConfigurationOnePasswordSpecificSecretsConfig(TypedDict, total=False):
+    load_mode: Required[Literal["specific"]]
+    """Load specific secrets from 1Password"""
+
+    secrets: Required[SequenceNotStr[str]]
+    """Array of secret references to load"""
+
+
+IntegrationConfiguration: TypeAlias = Union[
+    IntegrationConfigurationOnePasswordAllSecretsConfig, IntegrationConfigurationOnePasswordSpecificSecretsConfig
+]
+
+
+class Integration(TypedDict, total=False):
+    id: Required[str]
+    """Unique integration ID"""
+
+    configuration: Required[IntegrationConfiguration]
+
+    type: Required[Literal["1PASSWORD"]]
+    """Integration type"""
+
+
 class SessionLiveView(TypedDict, total=False):
     read_only: bool
     """Enable or disable read-only mode for live viewing. Defaults to `false`."""
@@ -162,7 +206,6 @@ class SessionProxyAnchorProxy(TypedDict, total=False):
     """City name for precise geographic targeting.
 
     Supported for anchor_proxy only. Can only be used when region is also provided.
-    Example: "San Francisco", "los-angeles", "london"
     """
 
     country_code: Literal[
@@ -368,7 +411,7 @@ class SessionProxyAnchorProxy(TypedDict, total=False):
     region: str
     """
     Region code for more specific geographic targeting. The city parameter can only
-    be used when region is also provided. Example: "ca" for California
+    be used when region is also provided.
     """
 
     type: Literal["anchor_proxy", "anchor_residential", "anchor_mobile", "anchor_gov"]

anchorbrowser/types/sessions/__init__.py

@@ -2,13 +2,9 @@
 
 from __future__ import annotations
 
-from .mouse_up_params import MouseUpParams as MouseUpParams
-from .mouse_down_params import MouseDownParams as MouseDownParams
 from .mouse_move_params import MouseMoveParams as MouseMoveParams
-from .mouse_up_response import MouseUpResponse as MouseUpResponse
 from .mouse_click_params import MouseClickParams as MouseClickParams
 from .all_status_response import AllStatusResponse as AllStatusResponse
-from .mouse_down_response import MouseDownResponse as MouseDownResponse
 from .mouse_move_response import MouseMoveResponse as MouseMoveResponse
 from .clipboard_set_params import ClipboardSetParams as ClipboardSetParams
 from .keyboard_type_params import KeyboardTypeParams as KeyboardTypeParams

anchorbrowser/types/sessions/agent/__init__.py

@@ -0,0 +1,7 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .file_list_response import FileListResponse as FileListResponse
+from .file_upload_params import FileUploadParams as FileUploadParams
+from .file_upload_response import FileUploadResponse as FileUploadResponse

anchorbrowser/types/sessions/agent/file_list_response.py

@@ -0,0 +1,32 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import List, Optional
+from datetime import datetime
+
+from pydantic import Field as FieldInfo
+
+from ...._models import BaseModel
+
+__all__ = ["FileListResponse", "Data", "DataFile"]
+
+
+class DataFile(BaseModel):
+    last_modified: Optional[datetime] = FieldInfo(alias="lastModified", default=None)
+    """When the resource was last modified"""
+
+    name: Optional[str] = None
+    """The resource name"""
+
+    size: Optional[int] = None
+    """Resource size in bytes"""
+
+    type: Optional[str] = None
+    """Resource extension/type"""
+
+
+class Data(BaseModel):
+    files: Optional[List[DataFile]] = None
+
+
+class FileListResponse(BaseModel):
+    data: Optional[Data] = None

anchorbrowser/types/sessions/agent/file_upload_params.py

@@ -0,0 +1,14 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import Required, TypedDict
+
+from ...._types import FileTypes
+
+__all__ = ["FileUploadParams"]
+
+
+class FileUploadParams(TypedDict, total=False):
+    file: Required[FileTypes]
+    """File to upload as agent resource (ZIP files will be extracted automatically)"""

anchorbrowser/types/sessions/agent/file_upload_response.py

@@ -0,0 +1,17 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from ...._models import BaseModel
+
+__all__ = ["FileUploadResponse", "Data"]
+
+
+class Data(BaseModel):
+    message: Optional[str] = None
+
+    status: Optional[str] = None
+
+
+class FileUploadResponse(BaseModel):
+    data: Optional[Data] = None

anchorbrowser/types/task/__init__.py

@@ -0,0 +1,6 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from .run_execute_params import RunExecuteParams as RunExecuteParams
+from .run_execute_response import RunExecuteResponse as RunExecuteResponse

anchorbrowser/types/task/run_execute_params.py

@@ -0,0 +1,324 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Dict, Union
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
+
+from ..._utils import PropertyInfo
+
+__all__ = [
+    "RunExecuteParams",
+    "OverrideBrowserConfiguration",
+    "OverrideBrowserConfigurationLiveView",
+    "OverrideBrowserConfigurationProxy",
+    "OverrideBrowserConfigurationProxyAnchorProxy",
+    "OverrideBrowserConfigurationProxyCustomProxy",
+    "OverrideBrowserConfigurationRecording",
+    "OverrideBrowserConfigurationTimeout",
+]
+
+
+class RunExecuteParams(TypedDict, total=False):
+    task_id: Required[Annotated[str, PropertyInfo(alias="taskId")]]
+    """Task identifier"""
+
+    inputs: Dict[str, str]
+    """Environment variables for task execution (keys must start with ANCHOR\\__)"""
+
+    override_browser_configuration: Annotated[
+        OverrideBrowserConfiguration, PropertyInfo(alias="overrideBrowserConfiguration")
+    ]
+    """Override browser configuration for this execution"""
+
+    session_id: Annotated[str, PropertyInfo(alias="sessionId")]
+    """Optional existing session ID to use"""
+
+    task_session_id: Annotated[str, PropertyInfo(alias="taskSessionId")]
+    """Optional task-specific session ID"""
+
+    version: str
+    """Version to run (draft, latest, or version number)"""
+
+
+class OverrideBrowserConfigurationLiveView(TypedDict, total=False):
+    read_only: bool
+    """Enable or disable read-only mode for live viewing. Defaults to `false`."""
+
+
+class OverrideBrowserConfigurationProxyAnchorProxy(TypedDict, total=False):
+    active: Required[bool]
+
+    city: str
+    """City name for precise geographic targeting.
+
+    Supported for anchor_proxy only. Can only be used when region is also provided.
+    """
+
+    country_code: Literal[
+        "af",
+        "al",
+        "dz",
+        "ad",
+        "ao",
+        "as",
+        "ag",
+        "ar",
+        "am",
+        "aw",
+        "au",
+        "at",
+        "az",
+        "bs",
+        "bh",
+        "bb",
+        "by",
+        "be",
+        "bz",
+        "bj",
+        "bm",
+        "bo",
+        "ba",
+        "br",
+        "bg",
+        "bf",
+        "cm",
+        "ca",
+        "cv",
+        "td",
+        "cl",
+        "co",
+        "cg",
+        "cr",
+        "ci",
+        "hr",
+        "cu",
+        "cy",
+        "cz",
+        "dk",
+        "dm",
+        "do",
+        "ec",
+        "eg",
+        "sv",
+        "ee",
+        "et",
+        "fo",
+        "fi",
+        "fr",
+        "gf",
+        "pf",
+        "ga",
+        "gm",
+        "ge",
+        "de",
+        "gh",
+        "gi",
+        "gr",
+        "gd",
+        "gp",
+        "gt",
+        "gg",
+        "gn",
+        "gw",
+        "gy",
+        "ht",
+        "hn",
+        "hu",
+        "is",
+        "in",
+        "ir",
+        "iq",
+        "ie",
+        "il",
+        "it",
+        "jm",
+        "jp",
+        "jo",
+        "kz",
+        "kw",
+        "kg",
+        "lv",
+        "lb",
+        "ly",
+        "li",
+        "lt",
+        "lu",
+        "mk",
+        "ml",
+        "mt",
+        "mq",
+        "mr",
+        "mx",
+        "md",
+        "mc",
+        "me",
+        "ma",
+        "nl",
+        "nz",
+        "ni",
+        "ng",
+        "no",
+        "pk",
+        "pa",
+        "py",
+        "pe",
+        "ph",
+        "pl",
+        "pt",
+        "pr",
+        "qa",
+        "ro",
+        "lc",
+        "sm",
+        "sa",
+        "sn",
+        "rs",
+        "sc",
+        "sl",
+        "sk",
+        "si",
+        "so",
+        "za",
+        "kr",
+        "es",
+        "sr",
+        "se",
+        "ch",
+        "sy",
+        "st",
+        "tw",
+        "tj",
+        "tg",
+        "tt",
+        "tn",
+        "tr",
+        "tc",
+        "ua",
+        "ae",
+        "us",
+        "uy",
+        "uz",
+        "ve",
+        "ye",
+        "bd",
+        "bw",
+        "bn",
+        "bi",
+        "kh",
+        "cn",
+        "dj",
+        "gq",
+        "sz",
+        "fj",
+        "hk",
+        "id",
+        "ke",
+        "la",
+        "ls",
+        "lr",
+        "mg",
+        "mw",
+        "my",
+        "mv",
+        "mn",
+        "mz",
+        "mm",
+        "na",
+        "np",
+        "nc",
+        "ne",
+        "om",
+        "pg",
+        "ru",
+        "rw",
+        "ws",
+        "sg",
+        "ss",
+        "lk",
+        "sd",
+        "tz",
+        "th",
+        "tl",
+        "tm",
+        "ug",
+        "gb",
+        "vu",
+        "vn",
+        "zm",
+        "zw",
+        "bt",
+        "mu",
+    ]
+    """Supported country codes ISO 2 lowercase
+
+    **On change make sure to update the Proxy type.**
+    """
+
+    region: str
+    """
+    Region code for more specific geographic targeting. The city parameter can only
+    be used when region is also provided.
+    """
+
+    type: Literal["anchor_proxy", "anchor_residential", "anchor_mobile", "anchor_gov"]
+    """**On change make sure to update the country_code.**"""
+
+
+class OverrideBrowserConfigurationProxyCustomProxy(TypedDict, total=False):
+    active: Required[bool]
+
+    password: Required[str]
+    """Proxy password"""
+
+    server: Required[str]
+    """Proxy server address"""
+
+    type: Required[Literal["custom"]]
+
+    username: Required[str]
+    """Proxy username"""
+
+
+OverrideBrowserConfigurationProxy: TypeAlias = Union[
+    OverrideBrowserConfigurationProxyAnchorProxy, OverrideBrowserConfigurationProxyCustomProxy
+]
+
+
+class OverrideBrowserConfigurationRecording(TypedDict, total=False):
+    active: bool
+    """Enable or disable video recording of the browser session. Defaults to `true`."""
+
+
+class OverrideBrowserConfigurationTimeout(TypedDict, total=False):
+    idle_timeout: int
+    """
+    The amount of time (in minutes) the browser session waits for new connections
+    after all others are closed before stopping. Defaults to `5`.
+    """
+
+    max_duration: int
+    """Maximum amount of time (in minutes) for the browser to run before terminating.
+
+    Defaults to `20`.
+    """
+
+
+class OverrideBrowserConfiguration(TypedDict, total=False):
+    initial_url: str
+    """The URL to navigate to when the browser session starts.
+
+    If not provided, the browser will load an empty page.
+    """
+
+    live_view: OverrideBrowserConfigurationLiveView
+    """Configuration for live viewing the browser session."""
+
+    proxy: OverrideBrowserConfigurationProxy
+    """Proxy Documentation available at [Proxy Documentation](/advanced/proxy)"""
+
+    recording: OverrideBrowserConfigurationRecording
+    """Configuration for session recording."""
+
+    timeout: OverrideBrowserConfigurationTimeout
+    """Timeout configurations for the browser session."""

anchorbrowser/types/task/run_execute_response.py

@@ -0,0 +1,33 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from typing import Optional
+
+from pydantic import Field as FieldInfo
+
+from ..._models import BaseModel
+
+__all__ = ["RunExecuteResponse", "Data"]
+
+
+class Data(BaseModel):
+    message: str
+    """Execution result message"""
+
+    success: bool
+    """Whether the task executed successfully"""
+
+    task_id: str = FieldInfo(alias="taskId")
+    """Task identifier"""
+
+    error: Optional[str] = None
+    """Error message if execution failed"""
+
+    execution_time: Optional[float] = FieldInfo(alias="executionTime", default=None)
+    """Execution duration in milliseconds"""
+
+    output: Optional[str] = None
+    """Task execution output"""
+
+
+class RunExecuteResponse(BaseModel):
+    data: Optional[Data] = None