intuned-runtime 1.3.3__tar.gz → 1.3.8__tar.gz

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: intuned-runtime
-Version: 1.3.3
+Version: 1.3.8
 Summary: Runtime SDK that powers browser automation projects running on Intuned
 License: Elastic-2.0
 License-File: LICENSE
@@ -27,6 +27,7 @@ Requires-Dist: jsonc-parser (>=1.1.5,<2.0.0)
 Requires-Dist: more-termcolor (>=1.1.3,<2.0.0)
 Requires-Dist: pathspec (>=0.12.1,<0.13.0)
 Requires-Dist: pydantic (>=2.10.6,<3.0.0)
+Requires-Dist: pyee (>=11.1.0)
 Requires-Dist: pyright (>=1.1.387,<2.0.0)
 Requires-Dist: python-dotenv (==1.0.1)
 Requires-Dist: pytimeparse (>=1.1.8,<2.0.0)

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/commands/attempt_api_command.py

@@ -19,6 +19,7 @@ async def attempt__api(
     output_file: str | None = None,
     trace: bool = False,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     """Executes an Intuned API attempt with parameters
 
@@ -32,6 +33,7 @@ async def attempt__api(
         output_file (str | None, optional): [-o/--output-file]. Output file path. Defaults to None.
         trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
         keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+        cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
     """
 
     await assert_auth_consistent(auth_session)
@@ -54,4 +56,5 @@ async def attempt__api(
         output_file=output_file,
         trace=trace,
         keep_browser_open=keep_browser_open,
+        cdp_url=cdp_url,
     )

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/commands/attempt_authsession_check_command.py

@@ -15,6 +15,7 @@ async def attempt__authsession__check(
     headless: bool = False,
     trace: bool = False,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     """Check an existing auth session
 
@@ -25,6 +26,7 @@ async def attempt__authsession__check(
         headless (bool, optional): [--headless]. Run the API in headless mode (default: False). This will not open a browser window.
         trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
         keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+        cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
     """
     await assert_auth_enabled()
 
@@ -41,4 +43,5 @@ async def attempt__authsession__check(
         proxy=proxy,
         trace=trace,
         keep_browser_open=keep_browser_open,
+        cdp_url=cdp_url,
     )

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/commands/attempt_authsession_create_command.py

@@ -17,6 +17,7 @@ async def attempt__authsession__create(
     headless: bool = False,
     trace: bool = False,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     """Create a new auth session
 
@@ -28,6 +29,7 @@ async def attempt__authsession__create(
         headless (bool, optional): [--headless]. Run the API in headless mode (default: False). This will not open a browser window.
         trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
         keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+        cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
     """
     await assert_auth_enabled(auth_type="API")
 
@@ -47,4 +49,5 @@ async def attempt__authsession__create(
         proxy=proxy,
         trace=trace,
         keep_browser_open=keep_browser_open,
+        cdp_url=cdp_url,
     )

intuned_runtime-1.3.8/intuned_cli/commands/authsession_record_command.py

@@ -0,0 +1,59 @@
+import pytimeparse  # type: ignore
+
+from intuned_cli.controller.authsession import execute_record_auth_session_cli
+from intuned_cli.utils.auth_session_helpers import assert_auth_enabled
+from intuned_cli.utils.auth_session_helpers import get_auth_session_recorder_parameters
+from intuned_cli.utils.wrapper import cli_command
+from runtime.env import get_is_auth_session_recorder_enabled
+
+if get_is_auth_session_recorder_enabled():
+
+    @cli_command
+    async def authsession__record(
+        *,
+        id: str | None = None,
+        check_attempts: int = 1,
+        proxy: str | None = None,
+        timeout: str = "10 min",
+        headless: bool = False,
+        trace: bool = False,
+        keep_browser_open: bool = False,
+        cdp_url: str | None = None,
+    ):
+        """Record a recorder-based auth session and then execute an AuthSession:Validate run to validate it
+
+        Args:
+            id (str | None, optional): ID of the auth session to record. If not provided, a new ID will be generated.
+            check_attempts (int, optional): [--check-attempts]. Number of attempts to check the auth session validity after it is created. Defaults to 1.
+            proxy (str | None, optional): [--proxy]. Proxy URL to use for recorder session and validation. Defaults to None.
+            timeout (str, optional): [--timeout]. Timeout for the auth session command - seconds or pytimeparse-formatted string. Defaults to "10 min".
+            headless (bool, optional): [--headless]. Run the auth session validation in headless mode (default: False). This will not open a browser window. The recorder will always be non-headless.
+            trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
+            keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+            cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
+        """
+
+        await assert_auth_enabled(auth_type="MANUAL")
+
+        timeout_value = pytimeparse.parse(timeout)  # type: ignore
+        if timeout_value is None:
+            raise ValueError(
+                f"Invalid timeout format: {timeout}. Please use a valid time format like '10 min' or '600 seconds'."
+            )
+
+        start_url, finish_url = await get_auth_session_recorder_parameters()
+
+        await execute_record_auth_session_cli(
+            start_url=start_url,
+            finish_url=finish_url,
+            id=id,
+            check_retries=check_attempts,
+            headless=headless,
+            proxy=proxy,
+            timeout=timeout_value,
+            trace=trace,
+            keep_browser_open=keep_browser_open,
+            cdp_url=cdp_url,
+        )
+else:
+    authsession__record = None  # type: ignore

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/commands/run_api_command.py

@@ -24,6 +24,7 @@ async def run__api(
     output_file: str | None = None,
     trace: bool = False,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     """Execute an API run with parameters
 
@@ -41,6 +42,7 @@ async def run__api(
         output_file (str | None, optional): [-o/--output-file]. Output file path. Defaults to None.
         trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
         keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+        cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
     """
     auth_session_auto_recreate = not no_auth_session_auto_recreate
 
@@ -72,4 +74,5 @@ async def run__api(
         output_file=output_file,
         trace=trace,
         keep_browser_open=keep_browser_open,
+        cdp_url=cdp_url,
     )

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/commands/run_authsession_create_command.py

@@ -21,6 +21,7 @@ async def _run_auth_session_create_impl(
     headless: bool = False,
     trace: bool = False,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     """Execute an AuthSession:Create run to create an auth session
 
@@ -34,6 +35,8 @@ async def _run_auth_session_create_impl(
         headless (bool, optional): [--headless]. Run the API in headless mode (default: False). This will not open a browser window.
         trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
         keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+
+        cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
     """
 
     await assert_auth_enabled(auth_type="API")
@@ -56,6 +59,7 @@ async def _run_auth_session_create_impl(
         timeout=timeout_value,
         trace=trace,
         keep_browser_open=keep_browser_open,
+        cdp_url=cdp_url,
     )
 
 

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/commands/run_authsession_update_command.py

@@ -21,6 +21,7 @@ async def _run_update_authsession_impl(
     headless: bool = False,
     trace: bool = False,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     """Execute an AuthSession:Update run to update an existing auth session
 
@@ -34,6 +35,7 @@ async def _run_update_authsession_impl(
         headless (bool, optional): [--headless]. Run the API in headless mode (default: False). This will not open a browser window.
         trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
         keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+        cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
     """
     await assert_auth_enabled(auth_type="API")
 
@@ -57,6 +59,7 @@ async def _run_update_authsession_impl(
         timeout=timeout_value,
         trace=trace,
         keep_browser_open=keep_browser_open,
+        cdp_url=cdp_url,
     )
 
 

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/commands/run_authsession_validate_command.py

@@ -20,6 +20,7 @@ async def _run_validate_authsession_impl(
     headless: bool = False,
     trace: bool = False,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     """Execute an AuthSession:Validate run to validate an auth session
 
@@ -33,6 +34,7 @@ async def _run_validate_authsession_impl(
         headless (bool, optional): [--headless]. Run the API in headless mode (default: False). This will not open a browser window.
         trace (bool, optional): [--trace]. Capture a trace of each attempt, useful for debugging. Defaults to False.
         keep_browser_open (bool, optional): [--keep-browser-open]. Keep the last browser open after execution for debugging. Defaults to False.
+        cdp_url (str | None, optional): [--cdp-url]. [Experimental] Chrome DevTools Protocol URL to connect to an existing browser instance. Disables proxy, headless, keep_browser_open options. Defaults to None.
     """
     await assert_auth_enabled()
 
@@ -54,6 +56,7 @@ async def _run_validate_authsession_impl(
         timeout=timeout_value,
         trace=trace,
         keep_browser_open=keep_browser_open,
+        cdp_url=cdp_url,
     )
 
 

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/controller/__test__/test_api.py

@@ -206,6 +206,7 @@ class TestAttemptApi:
             headless=False,
             proxy=None,
             keep_browser_open=False,
+            cdp_url=None,
         )
 
         attempt_api_mocks.get_cli_run_options.reset_mock()

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/controller/__test__/test_authsession.py

@@ -333,6 +333,7 @@ class TestRunCheck:
             headless=False,
             proxy=None,
             keep_browser_open=False,
+            cdp_url=None,
         )
 
         attempt_api_mocks.get_cli_run_options.reset_mock()
@@ -599,6 +600,7 @@ class TestRunCreate:
             headless=False,
             proxy=None,
             keep_browser_open=False,
+            cdp_url=None,
         )
 
         attempt_api_mocks.get_cli_run_options.reset_mock()

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/controller/api.py

@@ -190,6 +190,7 @@ async def attempt_api(
     headless = kwargs.get("headless")
     proxy = kwargs.get("proxy")
     keep_browser_open = kwargs.get("keep_browser_open")
+    cdp_url = kwargs.get("cdp_url")
     with cli_trace(trace_id) as tracing:
         async with extendable_timeout(timeout):
             result = await run_api(
@@ -204,6 +205,7 @@ async def attempt_api(
                         headless=headless,
                         proxy=ProxyConfig.parse_from_str(proxy) if proxy else None,
                         keep_browser_open=keep_browser_open,
+                        cdp_url=cdp_url,
                     ),
                     tracing=tracing,
                 ),

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/controller/authsession.py

@@ -244,6 +244,7 @@ async def run_check(
     headless = kwargs.get("headless")
     proxy = kwargs.get("proxy")
     keep_browser_open = kwargs.get("keep_browser_open")
+    cdp_url = kwargs.get("cdp_url")
     with cli_trace(trace_id) as tracing:
         async with extendable_timeout(timeout):
             result = await run_api(
@@ -256,6 +257,7 @@ async def run_check(
                         headless=headless,
                         proxy=ProxyConfig.parse_from_str(proxy) if proxy else None,
                         keep_browser_open=keep_browser_open,
+                        cdp_url=cdp_url,
                     ),
                     auth=Auth(
                         session=StateSession(
@@ -287,6 +289,7 @@ async def run_create(
     headless = kwargs.get("headless")
     proxy = kwargs.get("proxy")
     keep_browser_open = kwargs.get("keep_browser_open")
+    cdp_url = kwargs.get("cdp_url")
     with cli_trace(trace_id) as tracing:
         async with extendable_timeout(timeout):
             result = await run_api(
@@ -299,6 +302,7 @@ async def run_create(
                         headless=headless,
                         proxy=ProxyConfig.parse_from_str(proxy) if proxy else None,
                         keep_browser_open=keep_browser_open,
+                        cdp_url=cdp_url,
                     ),
                     retrieve_session=True,
                     tracing=tracing,

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/controller/save.py

@@ -60,8 +60,8 @@ async def validate_intuned_project():
 
 
 def validate_project_name(project_name: str):
-    if len(project_name) > 50:
-        raise CLIError("Project name must be 50 characters or less.")
+    if len(project_name) > 200:
+        raise CLIError("Project name must be 200 characters or less.")
 
     project_name_regex = r"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"
     if not re.match(project_name_regex, project_name):

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/types.py

@@ -29,6 +29,7 @@ class BaseExecuteCommandOptionsWithoutTrace(TypedDict):
     timeout: float
     proxy: NotRequired[str | None]
     keep_browser_open: bool
+    cdp_url: NotRequired[str | None]
 
 
 class BaseExecuteCommandOptions(BaseExecuteCommandOptionsWithoutTrace):

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/utils/__test__/test_browser.py

@@ -48,6 +48,18 @@ async def browser_mocks():
 
 
 class TestBrowser:
+    @pytest.mark.asyncio
+    @pytest.mark.asyncio
+    async def test_returns_cdp_options_if_cdp_url_is_passed(self, browser_mocks: BrowserMocks):
+        from intuned_cli.utils.browser import get_cli_run_options
+
+        options = await get_cli_run_options(
+            cdp_url="cdp_url",
+        )
+        assert options.environment == "cdp"
+        assert type(options) is CDPRunOptions
+        assert options.cdp_address == "cdp_url"
+
     @pytest.mark.asyncio
     async def test_returns_standalone_options_if_keep_browser_open_is_false(self, browser_mocks: BrowserMocks):
         from intuned_cli.utils.browser import get_cli_run_options

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/utils/browser.py

@@ -17,8 +17,14 @@ async def get_cli_run_options(
     headless: bool = False,
     proxy: ProxyConfig | None = None,
     keep_browser_open: bool = False,
+    cdp_url: str | None = None,
 ):
     global _current_browser_context_manager, _current_browser_context
+    if cdp_url is not None:
+        await close_cli_browser()
+        return CDPRunOptions(
+            cdp_address=cdp_url,
+        )
     if not keep_browser_open:
         return StandaloneRunOptions(
             headless=headless,

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/intuned_cli/utils/wrapper.py

@@ -27,7 +27,8 @@ def cli_command(fn: Callable[P, Awaitable[R]]) -> Callable[P, R]:
     @wraps(fn)
     @run_sync
     async def wrapper(*args: Any, **kwargs: Any) -> R:
-        keep_open = kwargs.get("keep_browser_open", False)
+        cdp_url = kwargs.get("cdp_url", None)
+        keep_open = (cdp_url is None) and (bool(kwargs.get("keep_browser_open", False)))
         if keep_open:
             console.print(
                 "[bold]--keep-browser-open is set, the CLI will not close the last browser after the command completes.[/bold]"

intuned_runtime-1.3.8/intuned_runtime/captcha/__init__.py

@@ -0,0 +1,6 @@
+from runtime.helpers.extensions import on_captcha_event
+from runtime.helpers.extensions import pause_captcha_solver
+from runtime.helpers.extensions import resume_captcha_solver
+from runtime.helpers.extensions import wait_for_captcha_solve
+
+__all__ = ["on_captcha_event", "wait_for_captcha_solve", "pause_captcha_solver", "resume_captcha_solver"]

{intuned_runtime-1.3.3 → intuned_runtime-1.3.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "intuned-runtime"
-version = "1.3.3"
+version = "1.3.8"
 description = "Runtime SDK that powers browser automation projects running on Intuned"
 authors = [ "Intuned Developers <engineering@intunedhq.com>",]
 readme = "README.md"
@@ -52,6 +52,7 @@ pytimeparse = "^1.1.8"
 rich = "^14.1.0"
 jsonc-parser = "^1.1.5"
 pyyaml = "^6.0.3"
+pyee = ">=11.1.0"
 
 [tool.poetry.scripts]
 intuned = "intuned_cli:run"

intuned_runtime-1.3.8/runtime/browser/extensions/__init__.py

@@ -0,0 +1,7 @@
+from .helpers import build_extensions_list
+from .intuned_extension_server import clean_intuned_extension_server
+
+__all__ = [
+    "build_extensions_list",
+    "clean_intuned_extension_server",
+]