voidaccess 1.6.2__tar.gz → 1.6.3__tar.gz

{voidaccess-1.6.2/voidaccess.egg-info → voidaccess-1.6.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voidaccess
-Version: 1.6.2
+Version: 1.6.3
 Summary: Dark web OSINT CLI — automated threat intelligence from query to report
 Author: VoidAccess
 License-Expression: MIT
@@ -19,6 +19,7 @@ License-File: LICENSE
 Requires-Dist: typer>=0.12
 Requires-Dist: rich>=13
 Requires-Dist: textual>=0.60
+Requires-Dist: click>=8.0
 Requires-Dist: aiohttp>=3.9
 Requires-Dist: aiohttp-socks>=0.8
 Requires-Dist: sqlalchemy>=2.0
@@ -39,6 +40,7 @@ Requires-Dist: trafilatura>=1.6
 Requires-Dist: requests>=2.31
 Requires-Dist: python-socks>=2.4
 Requires-Dist: tldextract>=5.1
+Requires-Dist: stix2>=3.0.2
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
@@ -65,8 +67,9 @@ Commercial threat intelligence platforms often charge prohibitive annual fees fo
 
 ---
 
-## What's New in v1.6.0
+## What's New in v1.6.3
 
+- **Release candidate alignment** — release metadata, package metadata, and docs now all report `v1.6.3`.
 - **Optional clearnet ScrapingAnt integration** — paste sites and RSS feeds can now be routed through ScrapingAnt. Affects clearnet scraping only; Tor, `.onion`, GitHub, and GitLab traffic are never affected.
 - **Three independent products** — Web Scraping API, Residential Proxy transport, and Datacenter Proxy transport are documented separately so the API key is not conflated with the proxy credentials.
 - **One-shot CLI flags** — `voidaccess investigate --use-scraping-api` and `voidaccess investigate --use-proxies` select the REST API or proxy transport for a single run.
@@ -76,7 +79,7 @@ Commercial threat intelligence platforms often charge prohibitive annual fees fo
 
 ---
 
-## What's New in v1.5.0
+## What's New in v1.6.3
 
 - 37 new entity types across crypto, credentials, messaging, and network/forensic indicators.
 - YARA, Snort, Suricata, and IOC package ZIP exports.
@@ -270,7 +273,7 @@ Export formats:
 
 ## Actor Intelligence
 
-VoidAccess v1.5.0 persists actor profiles across investigations in `actor_profiles`, with linked aliases and infrastructure in `actor_aliases` and `actor_infrastructure`. Profiles are populated from threat actor, ransomware group, and handle entities, then enriched with co-occurring infrastructure and timeline events.
+VoidAccess v1.6.3 persists actor profiles across investigations in `actor_profiles`, with linked aliases and infrastructure in `actor_aliases` and `actor_infrastructure`. Profiles are populated from threat actor, ransomware group, and handle entities, then enriched with co-occurring infrastructure and timeline events.
 
 Cross-alias resolution scores five signals: shared infrastructure, shared PGP, string similarity, temporal co-activity, and co-investigation. Use `voidaccess actors` to list profiles, `voidaccess actor <handle>` for the full profile, `voidaccess actor <handle> --timeline` for chronology, and `voidaccess actor <handle> --note "text"` for analyst notes.
 

{voidaccess-1.6.2 → voidaccess-1.6.3}/README.md

@@ -19,8 +19,9 @@ Commercial threat intelligence platforms often charge prohibitive annual fees fo
 
 ---
 
-## What's New in v1.6.0
+## What's New in v1.6.3
 
+- **Release candidate alignment** — release metadata, package metadata, and docs now all report `v1.6.3`.
 - **Optional clearnet ScrapingAnt integration** — paste sites and RSS feeds can now be routed through ScrapingAnt. Affects clearnet scraping only; Tor, `.onion`, GitHub, and GitLab traffic are never affected.
 - **Three independent products** — Web Scraping API, Residential Proxy transport, and Datacenter Proxy transport are documented separately so the API key is not conflated with the proxy credentials.
 - **One-shot CLI flags** — `voidaccess investigate --use-scraping-api` and `voidaccess investigate --use-proxies` select the REST API or proxy transport for a single run.
@@ -30,7 +31,7 @@ Commercial threat intelligence platforms often charge prohibitive annual fees fo
 
 ---
 
-## What's New in v1.5.0
+## What's New in v1.6.3
 
 - 37 new entity types across crypto, credentials, messaging, and network/forensic indicators.
 - YARA, Snort, Suricata, and IOC package ZIP exports.
@@ -224,7 +225,7 @@ Export formats:
 
 ## Actor Intelligence
 
-VoidAccess v1.5.0 persists actor profiles across investigations in `actor_profiles`, with linked aliases and infrastructure in `actor_aliases` and `actor_infrastructure`. Profiles are populated from threat actor, ransomware group, and handle entities, then enriched with co-occurring infrastructure and timeline events.
+VoidAccess v1.6.3 persists actor profiles across investigations in `actor_profiles`, with linked aliases and infrastructure in `actor_aliases` and `actor_infrastructure`. Profiles are populated from threat actor, ransomware group, and handle entities, then enriched with co-occurring infrastructure and timeline events.
 
 Cross-alias resolution scores five signals: shared infrastructure, shared PGP, string similarity, temporal co-activity, and co-investigation. Use `voidaccess actors` to list profiles, `voidaccess actor <handle>` for the full profile, `voidaccess actor <handle> --timeline` for chronology, and `voidaccess actor <handle> --note "text"` for analyst notes.
 

{voidaccess-1.6.2 → voidaccess-1.6.3}/export/ioc_package.py

@@ -54,7 +54,7 @@ logger = logging.getLogger(__name__)
 # ---------------------------------------------------------------------------
 
 PACKAGE_FORMAT = "voidaccess-ioc-v1"
-PACKAGE_VERSION = "1.5.0"
+PACKAGE_VERSION = "1.6.3"
 SNORT_SID_BASE = 9000001  # 9xxxxxx reserved for VoidAccess-generated rules
 
 # Map extractor upper-case entity types to the per-file bucket they belong to.

{voidaccess-1.6.2 → voidaccess-1.6.3}/extractor/llm_extract.py

@@ -404,34 +404,9 @@ async def _extract_chunk(chunk: str, llm) -> str:
     generate_summary) keep their streaming output unchanged.
     """
     try:
-        from langchain_core.callbacks import BaseCallbackHandler
-
-        class _SilentHandler(BaseCallbackHandler):
-            """No-op callback that suppresses the streaming handler's stdout
-            prints for this single extraction call.  Every hook is a
-            no-op; we only care about preventing the parent's stdout
-            noise — we still want ``ainvoke`` to return the full response
-            content as before, just without the per-token terminal spam.
-            """
-
-            def on_llm_new_token(self, token: str, **kwargs) -> None:  # noqa: D401
-                return None
-
-            def on_llm_end(self, response, **kwargs) -> None:  # noqa: D401
-                return None
-
-            def on_llm_error(self, error, **kwargs) -> None:  # noqa: D401
-                return None
-
         prompt = _PROMPT_TEMPLATE.format(chunk=chunk)
-        # Note: LangChain merges this callback config with the runnable's
-        # default callbacks for THIS call only.  Default callbacks on
-        # other call sites (refine_query, filter_results, summary) are
-        # not affected.
-        response = await llm.ainvoke(
-            prompt,
-            config={"callbacks": [_SilentHandler()]},
-        )
+        silent_llm = llm.bind(streaming=False, callbacks=[])
+        response = await silent_llm.ainvoke(prompt)
         content = response.content if hasattr(response, "content") else str(response)
         return content.strip()
     except Exception as exc:

{voidaccess-1.6.2 → voidaccess-1.6.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "voidaccess"
-version = "1.6.2"
+version = "1.6.3"
 description = "Dark web OSINT CLI — automated threat intelligence from query to report"
 readme = "README.md"
 license = "MIT"
@@ -25,6 +25,7 @@ dependencies = [
     "typer>=0.12",
     "rich>=13",
     "textual>=0.60",
+    "click>=8.0",
     "aiohttp>=3.9",
     "aiohttp-socks>=0.8",
     "sqlalchemy>=2.0",
@@ -45,6 +46,7 @@ dependencies = [
     "requests>=2.31",
     "python-socks>=2.4",
     "tldextract>=5.1",
+    "stix2>=3.0.2",
 ]
 
 [project.optional-dependencies]
@@ -92,7 +94,7 @@ exclude = [
     "__pycache__*",
 ]
 
-# v1.6.2 — ship data/onion_seeds.json inside the installed package.
+# v1.6.3 — ship data/onion_seeds.json inside the installed package.
 # Without this entry, ``pip install voidaccess`` produces a package
 # directory that does NOT contain the curated seed list — every
 # CLI investigation silently gets zero seed injection, which is the

{voidaccess-1.6.2 → voidaccess-1.6.3}/sources/proxy_client.py

@@ -6,7 +6,7 @@ single-axis dispatch on clearnet HTTP fetches:
 
     Transport:  How requests reach ScrapingAnt's backend
     ---------   --------------------------------------------------------
-    direct      Local aiohttp.ClientSession, no proxy (v1.5.0 behavior)
+    direct      Local aiohttp.ClientSession, no proxy (pre-1.6.2 behavior)
     api         POST to https://api.scrapingant.com/v2/general (REST)
     proxy       HTTP CONNECT through the configured ScrapingAnt proxy endpoint (proxy transport)
 
@@ -60,7 +60,7 @@ Design:
       This is a routing invariant, not a proxy concern.
     - Single transport per request, picked by config:
         - If VOIDACCESS_USE_PROXY=true (and SCRAPINGANT_API_KEY set) → proxy
-        - Else if VOIDACCESS_USE_PROXIES=true (legacy v1.5.0,
+        - Else if VOIDACCESS_USE_PROXIES=true (legacy pre-1.6.2,
           and SCRAPINGANT_API_KEY set) → api
         - Else → direct
       If BOTH VOIDACCESS_USE_PROXY and VOIDACCESS_USE_PROXIES are set,
@@ -226,7 +226,7 @@ def is_api_transport_enabled() -> bool:
     """Return True when the REST API transport should be used.
 
     Triggered by:
-        - VOIDACCESS_USE_PROXIES=true (legacy v1.5.0 alias — kept for
+        - VOIDACCESS_USE_PROXIES=true (legacy pre-1.6.2 alias — kept for
           backward compatibility with Phase 1 deployments)
 
     Requires SCRAPINGANT_API_KEY to be set and non-empty.
@@ -378,7 +378,7 @@ async def clearnet_fetch(
 
     Picks ONE transport based on env-var configuration:
         - direct (default, when no ScrapingAnt env vars are set)
-        - api (VOIDACCESS_USE_PROXIES=true; legacy v1.5.0 alias)
+        - api (VOIDACCESS_USE_PROXIES=true; legacy pre-1.6.2 alias)
         - proxy (VOIDACCESS_USE_PROXY=true; proxy transport per docs)
 
     Per https://docs.scrapingant.com/proxy-mode: "The proxy transport is a

{voidaccess-1.6.2 → voidaccess-1.6.3/voidaccess.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: voidaccess
-Version: 1.6.2
+Version: 1.6.3
 Summary: Dark web OSINT CLI — automated threat intelligence from query to report
 Author: VoidAccess
 License-Expression: MIT
@@ -19,6 +19,7 @@ License-File: LICENSE
 Requires-Dist: typer>=0.12
 Requires-Dist: rich>=13
 Requires-Dist: textual>=0.60
+Requires-Dist: click>=8.0
 Requires-Dist: aiohttp>=3.9
 Requires-Dist: aiohttp-socks>=0.8
 Requires-Dist: sqlalchemy>=2.0
@@ -39,6 +40,7 @@ Requires-Dist: trafilatura>=1.6
 Requires-Dist: requests>=2.31
 Requires-Dist: python-socks>=2.4
 Requires-Dist: tldextract>=5.1
+Requires-Dist: stix2>=3.0.2
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-asyncio; extra == "dev"
@@ -65,8 +67,9 @@ Commercial threat intelligence platforms often charge prohibitive annual fees fo
 
 ---
 
-## What's New in v1.6.0
+## What's New in v1.6.3
 
+- **Release candidate alignment** — release metadata, package metadata, and docs now all report `v1.6.3`.
 - **Optional clearnet ScrapingAnt integration** — paste sites and RSS feeds can now be routed through ScrapingAnt. Affects clearnet scraping only; Tor, `.onion`, GitHub, and GitLab traffic are never affected.
 - **Three independent products** — Web Scraping API, Residential Proxy transport, and Datacenter Proxy transport are documented separately so the API key is not conflated with the proxy credentials.
 - **One-shot CLI flags** — `voidaccess investigate --use-scraping-api` and `voidaccess investigate --use-proxies` select the REST API or proxy transport for a single run.
@@ -76,7 +79,7 @@ Commercial threat intelligence platforms often charge prohibitive annual fees fo
 
 ---
 
-## What's New in v1.5.0
+## What's New in v1.6.3
 
 - 37 new entity types across crypto, credentials, messaging, and network/forensic indicators.
 - YARA, Snort, Suricata, and IOC package ZIP exports.
@@ -270,7 +273,7 @@ Export formats:
 
 ## Actor Intelligence
 
-VoidAccess v1.5.0 persists actor profiles across investigations in `actor_profiles`, with linked aliases and infrastructure in `actor_aliases` and `actor_infrastructure`. Profiles are populated from threat actor, ransomware group, and handle entities, then enriched with co-occurring infrastructure and timeline events.
+VoidAccess v1.6.3 persists actor profiles across investigations in `actor_profiles`, with linked aliases and infrastructure in `actor_aliases` and `actor_infrastructure`. Profiles are populated from threat actor, ransomware group, and handle entities, then enriched with co-occurring infrastructure and timeline events.
 
 Cross-alias resolution scores five signals: shared infrastructure, shared PGP, string similarity, temporal co-activity, and co-investigation. Use `voidaccess actors` to list profiles, `voidaccess actor <handle>` for the full profile, `voidaccess actor <handle> --timeline` for chronology, and `voidaccess actor <handle> --note "text"` for analyst notes.
 

{voidaccess-1.6.2 → voidaccess-1.6.3}/voidaccess.egg-info/requires.txt

@@ -1,6 +1,7 @@
 typer>=0.12
 rich>=13
 textual>=0.60
+click>=8.0
 aiohttp>=3.9
 aiohttp-socks>=0.8
 sqlalchemy>=2.0
@@ -21,6 +22,7 @@ trafilatura>=1.6
 requests>=2.31
 python-socks>=2.4
 tldextract>=5.1
+stix2>=3.0.2
 
 [dev]
 pytest

{voidaccess-1.6.2 → voidaccess-1.6.3}/voidaccess_cli/__init__.py

@@ -1,3 +1,3 @@
 """voidaccess CLI — dark-web OSINT command-line interface."""
 
-__version__ = "1.6.2"
+__version__ = "1.6.3"

{voidaccess-1.6.2 → voidaccess-1.6.3}/voidaccess_cli/commands/configure.py

@@ -242,23 +242,27 @@ def _prompt_scrapingant(cfg: dict) -> None:
     # both means the chokepoint picks proxy (logged at runtime with a
     # one-shot info message).
     if new_key.strip():
-        current_api = bool(cfg.get("features", {}).get("use_proxies", False))
+        current_api = bool(cfg.get("features", {}).get("rest_api_transport_enabled", cfg.get("features", {}).get("use_proxies", False)))
         if Confirm.ask(
             "  Enable REST API transport (ScrapingAnt Web Scraping API) for clearnet scrapes?",
             default=current_api,
         ):
+            cfg.setdefault("features", {})["rest_api_transport_enabled"] = True
             cfg.setdefault("features", {})["use_proxies"] = True
         else:
+            cfg.setdefault("features", {})["rest_api_transport_enabled"] = False
             cfg.setdefault("features", {})["use_proxies"] = False
 
-        current_proxy = bool(cfg.get("features", {}).get("use_proxy", False))
+        current_proxy = bool(cfg.get("features", {}).get("residential_proxy_enabled", cfg.get("features", {}).get("use_proxy", False)))
         if Confirm.ask(
             f"  Enable proxy transport (HTTP CONNECT through the configured ScrapingAnt proxy endpoint, "
             f"{new_type} pool) for clearnet scrapes?",
             default=current_proxy,
         ):
+            cfg.setdefault("features", {})["residential_proxy_enabled"] = True
             cfg.setdefault("features", {})["use_proxy"] = True
         else:
+            cfg.setdefault("features", {})["residential_proxy_enabled"] = False
             cfg.setdefault("features", {})["use_proxy"] = False
 
 
@@ -334,7 +338,7 @@ def configure_proxy(
     enable: Optional[bool] = typer.Option(
         None,
         "--enable/--disable",
-        help="Enable or disable the REST API transport (legacy v1.5.0 toggle).",
+        help="Enable or disable the REST API transport (legacy pre-1.6.2 toggle).",
     ),
     enable_proxy: Optional[bool] = typer.Option(
         None,
@@ -350,7 +354,7 @@ def configure_proxy(
     """Configure the optional clearnet proxy (ScrapingAnt).
 
     With no flags, runs the interactive prompt.  With --enable / --disable,
-    sets the REST API transport toggle non-interactively (legacy v1.5.0
+    sets the REST API transport toggle non-interactively (legacy pre-1.6.2
     flag).  With --enable-proxy / --disable-proxy, sets the proxy transport
     transport toggle (new in v1.6.2 — requires SCRAPINGANT_API_KEY to
     actually activate).
@@ -364,7 +368,6 @@ def configure_proxy(
     Clearnet scraping only — Tor and .onion traffic are never affected.
     """
     cfg = cli_config.load_config()
-
     # --show: display current state with the key masked, and exit.
     if show and enable is None and enable_proxy is None:
         key = cfg.get("enrichment_keys", {}).get("SCRAPINGANT_API_KEY", "")
@@ -373,8 +376,8 @@ def configure_proxy(
         proxy_type = (
             cfg.get("enrichment_keys", {}).get("SCRAPINGANT_PROXY_TYPE", "") or "—"
         )
-        api_transport = bool(cfg.get("features", {}).get("use_proxies", False))
-        proxy_transport = bool(cfg.get("features", {}).get("use_proxy", False))
+        api_transport = bool(cfg.get("features", {}).get("rest_api_transport_enabled", cfg.get("features", {}).get("use_proxies", False)))
+        proxy_transport = bool(cfg.get("features", {}).get("residential_proxy_enabled", cfg.get("features", {}).get("use_proxy", False)))
 
         masked_key = (
             f"{key[:4]}…{key[-4:]}" if len(key) > 8 else ("set" if key else "—")
@@ -390,8 +393,8 @@ def configure_proxy(
         console.print(f"  Pool type       : {proxy_type}")
         api_label = "[green]enabled[/green]" if api_transport else "[red]disabled[/red]"
         proxy_label = "[green]enabled[/green]" if proxy_transport else "[red]disabled[/red]"
-        console.print(f"  API transport   : {api_label}")
-        console.print(f"  Proxy transport : {proxy_label}")
+        console.print(f"  REST API transport      : {api_label}")
+        console.print(f"  Residential proxy       : {proxy_label}")
         console.print("  Scope           : paste + RSS only, never Tor")
         if proxy_transport and (not proxy_username or not proxy_password):
             console.print(
@@ -409,6 +412,7 @@ def configure_proxy(
         return
 
     if enable is not None:
+        cfg.setdefault("features", {})["rest_api_transport_enabled"] = bool(enable)
         cfg.setdefault("features", {})["use_proxies"] = bool(enable)
         cli_config.save_config(cfg)
         state = "enabled" if enable else "disabled"
@@ -422,6 +426,7 @@ def configure_proxy(
         return
 
     if enable_proxy is not None:
+        cfg.setdefault("features", {})["residential_proxy_enabled"] = bool(enable_proxy)
         cfg.setdefault("features", {})["use_proxy"] = bool(enable_proxy)
         cli_config.save_config(cfg)
         state = "enabled" if enable_proxy else "disabled"

{voidaccess-1.6.2 → voidaccess-1.6.3}/voidaccess_cli/config.py

@@ -11,9 +11,14 @@ from __future__ import annotations
 
 import json
 import os
+import logging
+import warnings
 from pathlib import Path
 from typing import Any, Optional
 
+logger = logging.getLogger(__name__)
+_DEPRECATION_NOTIFIED = False
+
 CLI_HOME = Path(os.path.expanduser("~/.voidaccess"))
 CONFIG_PATH = CLI_HOME / "config.json"
 DB_PATH = CLI_HOME / "investigations.db"
@@ -82,7 +87,7 @@ DEFAULT_CONFIG: dict[str, Any] = {
         #
         # use_proxies           → VOIDACCESS_USE_PROXIES=true
         #                         Selects the REST API transport.
-        #                         (legacy v1.5.0 alias; Phase 1 verified
+        #                         (legacy pre-1.6.2 alias; Phase 1 verified
         #                         correct, must not be touched.)
         #
         # use_proxy             → VOIDACCESS_USE_PROXY=true
@@ -99,6 +104,8 @@ DEFAULT_CONFIG: dict[str, Any] = {
         #                         emits a one-shot info log.
         "use_proxies": False,
         "use_proxy": False,
+        "rest_api_transport_enabled": False,
+        "residential_proxy_enabled": False,
     },
     "tor": {
         "host": "127.0.0.1",
@@ -118,7 +125,7 @@ def load_config() -> dict[str, Any]:
     if not CONFIG_PATH.exists():
         return json.loads(json.dumps(DEFAULT_CONFIG))
     try:
-        cfg = json.loads(CONFIG_PATH.read_text(encoding="utf-8"))
+        cfg = json.loads(CONFIG_PATH.read_text(encoding="utf-8-sig"))
     except Exception:
         return json.loads(json.dumps(DEFAULT_CONFIG))
     # Merge with defaults so missing keys don't crash
@@ -127,12 +134,44 @@ def load_config() -> dict[str, Any]:
     merged["tor"].update(cfg.get("tor", {}))
     merged["enrichment_keys"].update(cfg.get("enrichment_keys", {}))
     merged["features"].update(cfg.get("features", {}))
+    features = merged["features"]
+    global _DEPRECATION_NOTIFIED
+    deprecated_keys = []
+    if "rest_api_transport_enabled" not in cfg.get("features", {}) and "use_proxies" in cfg.get("features", {}):
+        features["rest_api_transport_enabled"] = bool(cfg["features"].get("use_proxies"))
+        deprecated_keys.append("use_proxies")
+    if "residential_proxy_enabled" not in cfg.get("features", {}) and "use_proxy" in cfg.get("features", {}):
+        features["residential_proxy_enabled"] = bool(cfg["features"].get("use_proxy"))
+        deprecated_keys.append("use_proxy")
+    if deprecated_keys and not _DEPRECATION_NOTIFIED:
+        message = (
+            "Deprecated config keys "
+            + ", ".join(sorted(deprecated_keys))
+            + " found; prefer 'rest_api_transport_enabled' and 'residential_proxy_enabled'."
+        )
+        logger.warning(message)
+        warnings.warn(message, DeprecationWarning, stacklevel=2)
+    _DEPRECATION_NOTIFIED = True
+    if "rest_api_transport_enabled" in cfg.get("features", {}):
+        features["use_proxies"] = bool(features.get("rest_api_transport_enabled", False))
+    elif "use_proxies" in cfg.get("features", {}):
+        features["use_proxies"] = bool(cfg["features"].get("use_proxies", False))
+
+    if "residential_proxy_enabled" in cfg.get("features", {}):
+        features["use_proxy"] = bool(features.get("residential_proxy_enabled", False))
+    elif "use_proxy" in cfg.get("features", {}):
+        features["use_proxy"] = bool(cfg["features"].get("use_proxy", False))
     if cfg.get("output_dir"):
         merged["output_dir"] = cfg["output_dir"]
     return merged
 
 
 def save_config(config: dict[str, Any]) -> None:
+    features = config.setdefault("features", {})
+    features["rest_api_transport_enabled"] = bool(features.get("rest_api_transport_enabled", features.get("use_proxies", False)))
+    features["residential_proxy_enabled"] = bool(features.get("residential_proxy_enabled", features.get("use_proxy", False)))
+    features["use_proxies"] = features["rest_api_transport_enabled"]
+    features["use_proxy"] = features["residential_proxy_enabled"]
     _ensure_home()
     CONFIG_PATH.write_text(
         json.dumps(config, indent=2, sort_keys=True),
@@ -291,9 +330,11 @@ def apply_env(config: Optional[dict[str, Any]] = None) -> None:
     # gates (see sources/proxy_client.py §Architectural grounding for
     # the full quote from https://docs.scrapingant.com/proxy-mode).
     #
-    # - features.use_proxies (legacy v1.5.0) → VOIDACCESS_USE_PROXIES=true
+    # - features.rest_api_transport_enabled (preferred) →
+    #   VOIDACCESS_USE_PROXIES=true
     #   Selects the REST API transport.
-    # - features.use_proxy (new in v1.6.2)  → VOIDACCESS_USE_PROXY=true
+    # - features.residential_proxy_enabled (preferred) →
+    #   VOIDACCESS_USE_PROXY=true
     #   Selects the proxy transport.
     #
     # Each is set ONLY when the user has explicitly enabled it.  The
@@ -302,11 +343,11 @@ def apply_env(config: Optional[dict[str, Any]] = None) -> None:
     # fallback surprise.  This is the same logic already proven in
     # Phase 1's tests.
     features = cfg.get("features") or {}
-    if features.get("use_proxies"):
+    if features.get("rest_api_transport_enabled", features.get("use_proxies")):
         os.environ["VOIDACCESS_USE_PROXIES"] = "true"
     else:
         os.environ.pop("VOIDACCESS_USE_PROXIES", None)
-    if features.get("use_proxy"):
+    if features.get("residential_proxy_enabled", features.get("use_proxy")):
         os.environ["VOIDACCESS_USE_PROXY"] = "true"
     else:
         os.environ.pop("VOIDACCESS_USE_PROXY", None)

{voidaccess-1.6.2 → voidaccess-1.6.3}/voidaccess_cli/main.py

@@ -206,7 +206,7 @@ def status(
     # transport selector so the display ALWAYS matches what
     # clearnet_fetch() will actually do.  Never reveals raw keys.
     #
-    #   both off          → red    "disabled"           (direct — v1.5.0 behavior)
+    #   both off          → red    "disabled"           (direct — pre-1.6.2 behavior)
     #   proxy only        → cyan   "proxy transport"         (HTTP CONNECT through the configured ScrapingAnt proxy endpoint)
     #   api only          → green  "REST API"          (POST api.scrapingant.com/v2/general)
     #   both on (proxy wins) → magenta "proxy transport (api would be overridden)"