askui-agent-os 26.1.1__tar.gz

askui_agent_os-26.1.1/PKG-INFO

@@ -0,0 +1,386 @@
+Metadata-Version: 2.4
+Name: askui-agent-os
+Version: 26.1.1
+Summary: Platform-specific binaries for the AskUI Remote Device Controller, shipped as a Python package. Used by the AskUI Agent (created with the AskUI Python SDK) to control the local device on Windows, Linux, and macOS.
+Author-email: askui GmbH <support@askui.com>
+License: ================================================================================
+                                      askui GmbH
+                      Zimmerstraße 3 · 76137 Karlsruhe · Germany
+        ================================================================================
+        
+                                  ASKUI AGENT OS
+                                TERMS OF SERVICE
+        
+                              Effective Date: February 2026
+        
+        --------------------------------------------------------------------------------
+        IMPORTANT — READ CAREFULLY
+        --------------------------------------------------------------------------------
+        By downloading, installing, copying, or otherwise using AskUI Agent OS (the
+        "Software"), you agree to be bound by the terms of this Agreement. If you do
+        not agree, do not install or use the Software.
+        
+        
+        ================================================================================
+        1. DEFINITIONS
+        ================================================================================
+        
+          "AskUI" means askui GmbH, registered at Zimmerstraße 3, 76137 Karlsruhe,
+          Germany (HRB 740125).
+        
+          "Agent OS" or "Software" means the AskUI Agent OS desktop controller
+          software, including all updates, patches, documentation, and associated
+          files provided by AskUI.
+        
+          "Commercial Use" means any use of the Software in connection with or for the
+          benefit of a business, organization, or revenue-generating activity,
+          including but not limited to: use in production environments, use for client
+          projects, integration into commercial products or services, or use by or on
+          behalf of any for-profit entity.
+        
+          "Commercial Licence" means a valid, paid subscription agreement between the
+          Licensee and AskUI (such as a SaaS Order Form) that expressly authorises
+          Commercial Use of the Software.
+        
+          "Trial Period" means a time-limited evaluation period expressly agreed in
+          writing between the Licensee and AskUI, during which the Licensee may use
+          the Software for evaluation and testing purposes under the terms specified
+          in such agreement.
+        
+          "Licensee" or "You" means the individual or legal entity that downloads,
+          installs, or uses the Software.
+        
+          "Non-Commercial Use" means use of the Software solely for personal learning,
+          academic research, open-source development, or internal evaluation purposes
+          that do not directly or indirectly generate revenue or commercial advantage.
+        
+        
+        ================================================================================
+        2. LICENCE GRANT
+        ================================================================================
+        
+          2.1 Non-Commercial Licence.
+              Subject to the terms of this Agreement, AskUI grants the Licensee a
+              limited, non-exclusive, non-transferable, revocable licence to install
+              and use the Software solely for Non-Commercial Use. This licence is
+              granted free of charge and does not require a separate subscription
+              agreement.
+        
+          2.2 Commercial Use Prohibited Without Licence.
+              Commercial Use of the Software is strictly prohibited unless the
+              Licensee holds a valid Commercial Licence issued by AskUI. Any
+              Commercial Use without a Commercial Licence constitutes a material
+              breach of this Agreement and may result in immediate termination of the
+              licence and legal action.
+        
+          2.3 Commercial Licence.
+              Licensees who wish to use the Software for Commercial Use must enter
+              into a separate Commercial Licence agreement with AskUI (e.g., a SaaS
+              Order Form or enterprise agreement). The terms of such Commercial
+              Licence shall govern Commercial Use and shall take precedence over this
+              Agreement to the extent of any conflict.
+        
+          2.4 Trial Use.
+              AskUI may, at its sole discretion, grant the Licensee a time-limited
+              Trial Period for evaluation purposes. Trial use is subject to the
+              following conditions:
+        
+              (a) The Trial Period must be agreed in writing between the Licensee and
+                  AskUI, specifying the duration, scope, and any limitations.
+        
+              (b) During the Trial Period, the Licensee may use the Software for
+                  internal evaluation and testing only. Production use, client-facing
+                  use, and revenue-generating activities are not permitted during a
+                  Trial unless expressly authorised.
+        
+              (c) Upon expiration of the Trial Period, the Licensee must either enter
+                  into a Commercial Licence or cease all use of the Software and
+                  uninstall it from all systems.
+        
+              (d) AskUI reserves the right to revoke any Trial at any time and for
+                  any reason upon written notice.
+        
+        
+        ================================================================================
+        3. RESTRICTIONS
+        ================================================================================
+        
+          The Licensee shall not, and shall not permit any third party to:
+        
+            • Use the Software for any Commercial Use without a valid Commercial
+              Licence or an active, authorised Trial Period;
+        
+            • Copy, modify, adapt, translate, or create derivative works of the
+              Software, in whole or in part;
+        
+            • Reverse engineer, decompile, disassemble, or otherwise attempt to
+              discover the source code, algorithms, or underlying structure of the
+              Software;
+        
+            • Distribute, sublicence, lease, rent, loan, or otherwise transfer the
+              Software or any rights therein to any third party;
+        
+            • Remove, alter, or obscure any proprietary notices, labels, or
+              trademarks on or within the Software;
+        
+            • Use the Software for timesharing, service bureau, managed service, or
+              similar purposes for the benefit of third parties;
+        
+            • Use the Software in any manner that violates applicable law or
+              regulation;
+        
+            • Circumvent or attempt to circumvent any licence key, activation
+              mechanism, usage limit, or technical protection measure incorporated
+              into the Software;
+        
+            • Use the Software to develop a competing product or service.
+        
+        
+        ================================================================================
+        4. INTELLECTUAL PROPERTY
+        ================================================================================
+        
+          4.1 The Software is the proprietary product of AskUI and is protected by
+              copyright, trade secret, and other intellectual property laws. AskUI
+              and its licensors retain all right, title, and interest in and to the
+              Software, including all copies, modifications, and derivative works
+              thereof. Nothing in this Agreement transfers ownership of the Software
+              to the Licensee.
+        
+          4.2 All trademarks, service marks, and trade names associated with the
+              Software (including "AskUI", "Agent OS", and the AskUI logo) are the
+              exclusive property of AskUI. The Licensee is not granted any right to
+              use such marks without prior written consent.
+        
+        
+        ================================================================================
+        5. DATA AND PRIVACY
+        ================================================================================
+        
+          5.1 The Software may collect anonymised, aggregated telemetry data relating
+              to system performance, usage patterns, and error diagnostics. This data
+              does not include personal data or any content processed by the Software
+              during test execution.
+        
+          5.2 If the Software is used in connection with AskUI's SaaS services (under
+              a Commercial Licence), data processing shall be governed by the Data
+              Processing Agreement entered into between AskUI and the Licensee.
+        
+          5.3 AskUI will not use any data processed through the Software to train,
+              fine-tune, or improve any artificial intelligence or machine learning
+              models. AI models used by the Software are pre-trained and do not learn
+              from Licensee data.
+        
+        
+        ================================================================================
+        6. DISCLAIMER OF WARRANTIES
+        ================================================================================
+        
+          THE SOFTWARE IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTY OF ANY
+          KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED
+          WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND
+          NON-INFRINGEMENT. ASKUI DOES NOT WARRANT THAT THE SOFTWARE WILL BE
+          UNINTERRUPTED, ERROR-FREE, OR FREE OF HARMFUL COMPONENTS. THE LICENSEE
+          ASSUMES ALL RISK ARISING FROM THE USE OF THE SOFTWARE.
+        
+        
+        ================================================================================
+        7. LIMITATION OF LIABILITY
+        ================================================================================
+        
+          7.1 TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL
+              ASKUI BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR
+              PUNITIVE DAMAGES, OR ANY LOSS OF PROFITS, REVENUE, DATA, OR BUSINESS
+              OPPORTUNITY, ARISING OUT OF OR IN CONNECTION WITH THIS AGREEMENT OR THE
+              USE OF THE SOFTWARE, REGARDLESS OF THE THEORY OF LIABILITY.
+        
+          7.2 ASKUI'S TOTAL AGGREGATE LIABILITY UNDER THIS AGREEMENT SHALL NOT EXCEED
+              THE FEES ACTUALLY PAID BY THE LICENSEE TO ASKUI FOR THE SOFTWARE IN THE
+              TWELVE (12) MONTHS PRECEDING THE EVENT GIVING RISE TO THE CLAIM. WHERE
+              NO FEES HAVE BEEN PAID (E.G., NON-COMMERCIAL OR TRIAL USE), ASKUI'S
+              LIABILITY SHALL BE LIMITED TO FIFTY EUROS (€50).
+        
+          7.3 The limitations in this Section 7 shall not apply to liability arising
+              from AskUI's gross negligence, wilful misconduct, or breach of
+              obligations that cannot be limited under mandatory applicable law.
+        
+        
+        ================================================================================
+        8. TERM AND TERMINATION
+        ================================================================================
+        
+          8.1 This Agreement is effective from the date the Licensee first installs or
+              uses the Software and continues until terminated.
+        
+          8.2 Non-Commercial and Trial Licences. AskUI may terminate this licence at
+              any time for any reason upon thirty (30) days' written notice. The
+              Licensee may terminate at any time by uninstalling the Software and
+              destroying all copies.
+        
+          8.3 Termination for Breach. AskUI may terminate this Agreement immediately
+              upon written notice if the Licensee breaches any term of this Agreement,
+              including but not limited to engaging in unauthorised Commercial Use.
+        
+          8.4 Effect of Termination. Upon termination or expiration of this Agreement,
+              the Licensee must immediately cease all use of the Software and
+              uninstall or destroy all copies in its possession or control. Sections
+              3, 4, 6, 7, 9, and 10 shall survive termination.
+        
+        
+        ================================================================================
+        9. COMPLIANCE AND AUDIT
+        ================================================================================
+        
+          9.1 AskUI reserves the right to verify the Licensee's compliance with this
+              Agreement, including verification of licence type and usage scope. The
+              Licensee agrees to provide reasonable cooperation in connection with
+              any compliance verification.
+        
+          9.2 If an audit reveals unauthorised Commercial Use, the Licensee shall
+              promptly pay all applicable licence fees retroactively from the date
+              such Commercial Use commenced, plus a surcharge of twenty-five percent
+              (25%) of the applicable fees as liquidated damages. This is in addition
+              to, and not in lieu of, any other remedies available to AskUI.
+        
+        
+        ================================================================================
+        10. GOVERNING LAW AND JURISDICTION
+        ================================================================================
+        
+          10.1 This Agreement shall be governed by and construed in accordance with
+               the laws of the Federal Republic of Germany, excluding the UN
+               Convention on Contracts for the International Sale of Goods (CISG) and
+               conflict-of-law rules.
+        
+          10.2 The exclusive place of jurisdiction for all disputes arising out of or
+               in connection with this Agreement shall be Karlsruhe, Germany, to the
+               extent permitted by applicable law.
+        
+        
+        ================================================================================
+        11. EXPORT COMPLIANCE
+        ================================================================================
+        
+          The Licensee shall comply with all applicable export control laws and
+          regulations, including those of the European Union and Germany. The
+          Licensee shall not export, re-export, or transfer the Software to any
+          country, entity, or person prohibited by applicable export laws without
+          obtaining prior authorisation from the relevant authorities.
+        
+        
+        ================================================================================
+        12. MISCELLANEOUS
+        ================================================================================
+        
+          12.1 Entire Agreement. This Agreement constitutes the entire agreement
+               between the Licensee and AskUI with respect to the non-commercial and
+               trial use of the Software. For Commercial Use, the applicable
+               Commercial Licence agreement shall govern.
+        
+          12.2 Amendments. AskUI reserves the right to modify this Agreement at any
+               time. Updated terms will be made available through the Software or at
+               askui.com. Continued use of the Software after such modifications
+               constitutes acceptance of the revised terms.
+        
+          12.3 Severability. If any provision of this Agreement is found to be
+               invalid or unenforceable, the remaining provisions shall remain in
+               full force and effect.
+        
+          12.4 No Waiver. The failure of AskUI to enforce any right or provision of
+               this Agreement shall not constitute a waiver of such right or
+               provision.
+        
+          12.5 Assignment. The Licensee may not assign or transfer this Agreement or
+               any rights hereunder without AskUI's prior written consent. AskUI may
+               assign this Agreement freely in connection with a merger, acquisition,
+               or sale of assets.
+        
+        
+        ================================================================================
+                            — End of Terms of Service —
+        ================================================================================
+        
+          askui GmbH
+          Registry court: Amtsgericht Mannheim · HRB 740125 · VAT-ID: DE342511595
+          Responsible persons: Jonas Menesklou, Dominik Klotz
+        
+Project-URL: Homepage, https://www.askui.com/
+Project-URL: Documentation, https://docs.askui.com
+Keywords: askui,automation,agent-os
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: docs/AskUI_AgentOS_TermsOfService.txt
+Dynamic: license-file
+
+# AskUI Agent OS
+
+Platform-specific binaries for the **AskUI Remote Device Controller**, shipped as a Python package. Use it with the [AskUI Python SDK](https://github.com/askui/python-sdk) when you need local device control—see the [Setup Guide](https://docs.askui.com) in the official docs.
+
+## Requirements
+
+- **Python:** 3.8+
+- **Platforms:** Windows, Linux, macOS
+- **Windows only:** [Microsoft Visual C++ Redistributable](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist) (minimum version 14.34.31938). The package checks this automatically when you use the API.
+
+## Installation
+
+```bash
+pip install askui-agent-os
+```
+
+## Usage
+
+### Command line
+
+Get the path to the Remote Device Controller binary:
+
+```bash
+askui-agent-os get-binary-path
+```
+
+### Python API
+
+The package exposes a single class, **`AgentOS`**, with static methods. On import, `AgentOS.setup()` runs and makes the controller binary executable (no-op on Windows). Prerequisites (e.g. Windows VC++ runtime) are checked when you call `bin_path()` or `controller_path()`.
+
+```python
+from askui_agent_os import AgentOS
+
+# Directory containing platform binaries
+bin_dir = AgentOS.bin_path()
+
+# Full path to the controller executable (use this with the AskUI SDK)
+path = AgentOS.controller_path()
+
+# Optional: require Windows VC++ runtime (raises RuntimeError if missing on Windows)
+AgentOS.require_vc_redistributable()
+```
+
+| Method | Description |
+|--------|-------------|
+| `AgentOS.bin_path()` | Path to the package `bin` directory. |
+| `AgentOS.controller_path()` | Full path to the controller executable. |
+| `AgentOS.require_vc_redistributable()` | No-op on non-Windows; on Windows, raises if the required VC++ runtime is missing. |
+
+## CI/CD and automated pipelines
+
+**This package is for local and desktop use only.** It is **not** suitable for use in CI/CD or other headless/automated pipelines. For CI/CD you need the dedicated AskUI service. To request access, contact **support@askui.com**.
+
+## License
+
+Use of AskUI Agent OS is subject to the AskUI Agent OS Terms of Service. Non-commercial use is free; commercial use requires a separate Commercial Licence from AskUI.
+
+## Links
+
+- [Homepage](https://www.askui.com/)
+- [Python SDK](https://github.com/askui/python-sdk)
+- [Documentation](https://docs.askui.com)
+- [Support](mailto:support@askui.com)

askui_agent_os-26.1.1/README.md

@@ -0,0 +1,80 @@
+# AskUI Agent OS Deliveries
+
+This repository contains the delivery pipelines and assets for **AskUI Agent OS** and **AskUI Suite Installers**. Use it to build, release, and publish installers and the Agent OS Python package.
+
+---
+
+## Overview
+
+You can use this repo in two main ways:
+
+| Delivery type | What it does | How to trigger |
+|---------------|--------------|----------------|
+| **Suite Installer** | Build and release AskUI Suite Installers (Web/Full) for Windows, macOS, and Linux | Create a **GitHub Release** with a version tag, or run the **Build Suite Installer** workflow manually |
+| **Agent OS** | Publish the Agent OS Python package to PyPI and build Windows service installers (AMD64/ARM64) | Run the **Release Agent OS** workflow manually and provide a version |
+
+---
+
+## Suite Installer releases
+
+### Version and tag format
+
+- **Stable:** `26.2.1` (semver: `YY.MINOR.PATCH`)
+- **Release candidate:** `26.2.1.1` (e.g. `26.2.1.1` = rc1 for 26.2.1)
+
+### Option A: Release from a GitHub Release
+
+1. In this repo, go to **Releases** → **Draft a new release**.
+2. Create a **tag** with the version (e.g. `26.2.1` or `26.2.1.1`).
+3. Publish the release.
+
+Publishing the release triggers **Build Suite Installer** and builds installers for:
+
+- Windows (AMD64): Web, Full  
+- Windows (ARM64): Web  
+- macOS (ARM64): Web  
+- Linux (AMD64, ARM64): Web  
+
+Installers are released to the configured S3 bucket. Only tags **without** the `agent-os-` prefix trigger this behavior.
+
+### Option B: Manual build (single or all)
+
+1. Go to **Actions** → **Build Suite Installer** → **Run workflow**.
+2. Choose:
+   - **all_builds:** `true` to build all OS/arch/type combinations (as above), or `false` to pick one.
+   - **os:** Windows, MacOS, or Linux (ignored if `all_builds` is true).
+   - **architecture:** AMD64 or ARM64 (ignored if `all_builds` is true).
+   - **version:** e.g. `26.2.1`.
+   - **installationType:** Web or Full.
+   - **release:** set to `true` to publish the built installer to the S3 bucket.
+
+---
+
+## Agent OS releases (Python package + Windows installers)
+
+### Version format
+
+- **Stable:** `26.2.1` → tag `agent-os-v26.2.1`, PyPI version `26.2.1`.
+- **Release candidate:** `26.2.1.5` → tag `agent-os-v26.2.1.5`, PyPI version `26.2.1.rc5`.
+
+Version must match: `YY.MINOR.PATCH` or `YY.MINOR.PATCH.RC` (e.g. `26.1.1` or `26.1.1.5` for rc5).
+
+### How to release
+
+1. Go to **Actions** → **Release Agent OS** → **Run workflow**.
+2. Enter the **version** (e.g. `26.1.1` or `26.1.1.5` for rc5).
+3. Run the workflow.
+
+The workflow will:
+
+1. Bump the version and create the Git tag (e.g. `agent-os-v26.2.1` or `agent-os-v26.2.1.5`).
+2. Publish the **Python package** to PyPI (e.g. `pip install askui-agent-os==26.2.1`).
+3. Build **Agent OS Windows service installers** for AMD64 and ARM64 and upload them to the S3 bucket.
+4. Create a **GitHub Release** with generated release notes (PyPI install instructions and installer download links).
+
+---
+
+## Summary
+
+- **Suite Installers:** Use a **GitHub Release** with a version tag (`26.2.1` or `26.2.1.1`), or run **Build Suite Installer** manually for a single or full matrix.
+- **Agent OS:** Run **Release Agent OS** with a version; it handles tagging, PyPI, Windows installers, and the GitHub Release.

askui_agent_os-26.1.1/askui_agent_os/__init__.py

@@ -0,0 +1,5 @@
+from askui_agent_os.agent_os import AgentOS
+
+AgentOS.setup()
+
+__all__ = ["AgentOS"]

askui_agent_os-26.1.1/askui_agent_os/_runtime_check.py

@@ -0,0 +1,66 @@
+"""Windows C++ runtime check - verifies minimum Visual C++ Redistributable version."""
+
+import platform
+
+
+def check_windows_cpp_runtime(
+    min_major: int,
+    min_minor: int,
+    min_patch: int,
+) -> bool:
+    """
+    Check if a sufficient Microsoft Visual C++ Redistributable is installed (Windows only).
+
+    Returns True if not on Windows, or if a compatible runtime is installed.
+    Returns False if on Windows and no compatible runtime is found.
+    """
+    if platform.system() != "Windows":
+        return True
+
+    try:
+        import winreg
+    except ImportError:
+        return True
+
+    arch = platform.machine().lower()
+    if arch in ("amd64", "x86_64"):
+        arch_key = "x64"
+    elif arch in ("arm64", "aarch64"):
+        arch_key = "ARM64"
+    else:
+        arch_key = "x86"
+
+    base_path = r"SOFTWARE\Microsoft\VisualStudio\14.0\VC\Runtimes"
+    wow_path = r"SOFTWARE\WOW6432Node\Microsoft\VisualStudio\14.0\VC\Runtimes"
+
+    for root, subkey in [
+        (winreg.HKEY_LOCAL_MACHINE, base_path),
+        (winreg.HKEY_LOCAL_MACHINE, wow_path),
+    ]:
+        try:
+            key_path = f"{subkey}\\{arch_key}"
+            with winreg.OpenKey(root, key_path, 0, winreg.KEY_READ) as key:
+                try:
+                    version, _ = winreg.QueryValueEx(key, "Version")
+                except OSError:
+                    continue
+                if isinstance(version, str):
+                    version = version.lstrip("v").strip()
+                    parts = version.split(".")
+                    major = int(parts[0]) if parts else 0
+                    minor = int(parts[1]) if len(parts) > 1 else 0
+                    patch = int(parts[2]) if len(parts) > 2 else 0
+                else:
+                    continue
+                if (
+                    major > min_major
+                    or (major == min_major and minor >= min_minor)
+                    or (
+                        major == min_major and minor == min_minor and patch >= min_patch
+                    )
+                ):
+                    return True
+        except OSError:
+            continue
+
+    return False

askui_agent_os-26.1.1/askui_agent_os/agent_os.py

@@ -0,0 +1,90 @@
+"""Public API: single entry point for AskUI Agent OS functionality."""
+
+import platform
+from pathlib import Path
+
+from askui_agent_os._runtime_check import (
+    check_windows_cpp_runtime,
+)
+
+
+class AgentOS:
+    """
+    Platform-specific binaries and helpers for the AskUI Remote Device Controller.
+
+    Use static methods to get paths, check runtimes, and prepare the environment.
+    Setup runs on import; prerequisites (e.g. Windows VC++ runtime check) run on each call.
+    """
+
+    _MIN_VC_RUNTIME_MAJOR = 14
+    _MIN_VC_RUNTIME_MINOR = 34
+    _MIN_VC_RUNTIME_PATCH = 31938
+
+    @staticmethod
+    def setup() -> None:
+        """Prepare the environment: make binary executable. Called on import."""
+        AgentOS._make_binary_executable()
+
+    @staticmethod
+    def bin_path() -> Path:
+        """Return the path to the package's bin directory (where binaries are installed)."""
+        AgentOS._ensure_prerequisites()
+        return AgentOS._get_bin_dir()
+
+    @staticmethod
+    def controller_path() -> Path:
+        """Return the path to the remote device controller binary."""
+        AgentOS._ensure_prerequisites()
+        return AgentOS._get_remote_device_controller_path()
+
+    @staticmethod
+    def make_executable() -> None:
+        """Make the controller binary executable (no-op on Windows)."""
+        AgentOS._ensure_prerequisites()
+        AgentOS._make_binary_executable()
+
+    @staticmethod
+    def require_vc_redistributable() -> None:
+        """
+        Require a sufficient Microsoft Visual C++ Redistributable on Windows.
+
+        No-op on non-Windows platforms. On Windows, raises RuntimeError if the
+        minimum required version is not found.
+        """
+        if not check_windows_cpp_runtime(
+            min_major=AgentOS._MIN_VC_RUNTIME_MAJOR,
+            min_minor=AgentOS._MIN_VC_RUNTIME_MINOR,
+            min_patch=AgentOS._MIN_VC_RUNTIME_PATCH,
+        ):
+            raise RuntimeError(
+                f"[AskUI Agent OS]: Microsoft Visual C++ Redistributable (minimum "
+                f"{AgentOS._MIN_VC_RUNTIME_MAJOR}.{AgentOS._MIN_VC_RUNTIME_MINOR}.{AgentOS._MIN_VC_RUNTIME_PATCH}) "
+                "is required on Windows. Install from: "
+                "https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist"
+            )
+
+    @staticmethod
+    def _ensure_prerequisites() -> None:
+        """Run prerequisites (e.g. require Windows VC++ runtime). Called before each operation."""
+        AgentOS.require_vc_redistributable()
+
+    @staticmethod
+    def _get_bin_dir() -> Path:
+        """Return the path to the package's bin directory (where binaries are installed)."""
+        return Path(__file__).resolve().parent / "bin"
+
+    @staticmethod
+    def _get_remote_device_controller_path() -> Path:
+        """Return the path to the remote device controller binary."""
+        binary_name = "AskuiRemoteDeviceController"
+        if platform.system() == "Windows":
+            binary_name += ".exe"
+        return (AgentOS._get_bin_dir() / binary_name).absolute()
+
+    @staticmethod
+    def _make_binary_executable() -> None:
+        """Make the binary executable (no-op on Windows)."""
+        if platform.system() == "Windows":
+            return
+        AgentOS._get_remote_device_controller_path().chmod(0o755)
+

askui_agent_os-26.1.1/askui_agent_os/cli.py

@@ -0,0 +1,25 @@
+"""CLI for askui-agent-os."""
+
+import argparse
+
+from askui_agent_os import AgentOS
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(prog="askui-agent-os")
+    subparsers = parser.add_subparsers(dest="command", required=True)
+
+    path_parser = subparsers.add_parser("get-binary-path")
+    path_parser.set_defaults(func=_cmd_controller_path)
+
+    args = parser.parse_args()
+    args.func(args)
+
+
+def _cmd_controller_path(_args: argparse.Namespace) -> None:
+    path = AgentOS.controller_path()
+    print(path)
+
+
+if __name__ == "__main__":
+    main()

askui_agent_os-26.1.1/askui_agent_os/py.typed

@@ -0,0 +1 @@
+