vector-inspector 0.3.8__tar.gz → 0.3.11__tar.gz

{vector_inspector-0.3.8 → vector_inspector-0.3.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vector-inspector
-Version: 0.3.8
+Version: 0.3.11
 Summary: A comprehensive desktop application for visualizing, querying, and managing vector database data
 Author-Email: Anthony Dawson <anthonypdawson+github@gmail.com>
 License: MIT
@@ -8,7 +8,7 @@ Project-URL: Homepage, https://vector-inspector.divinedevops.com
 Project-URL: Source, https://github.com/anthonypdawson/vector-inspector
 Project-URL: Issues, https://github.com/anthonypdawson/vector-inspector/issues
 Project-URL: Documentation, https://github.com/anthonypdawson/vector-inspector#readme
-Requires-Python: <3.14,>=3.10
+Requires-Python: >=3.10
 Requires-Dist: chromadb>=0.4.22
 Requires-Dist: qdrant-client>=1.7.0
 Requires-Dist: pyside6>=6.6.0
@@ -32,30 +32,8 @@ Description-Content-Type: text/markdown
 
 # Latest updates
 
-## Vector Inspector 2026.01 Release Notes
-
-### Major Refactor and Studio-Ready Architecture
-- Refactored main window into modular components:
-  - InspectorShell: reusable UI shell (splitter, tabs, layout)
-  - ProviderFactory: centralized connection creation
-  - DialogService: dialog management
-  - ConnectionController: connection lifecycle and threading
-  - InspectorTabs: pluggable tab registry
-- MainWindow now inherits from InspectorShell and is fully reusable as a widget
-- Bootstrap logic is separated from UI logic—Studio can host Inspector as a component
-- Tab system is now pluggable: Studio and Inspector can add, remove, or override tabs via TabDefinition
-- All Inspector UI logic is self-contained; Studio can extend without modifying Inspector code
-
-### Data Browser Improvements
-- Added a checkbox: Generate embeddings on edit (default: checked)
-  - When unchecked, editing a row skips embedding regeneration
-  - Setting is persisted per user
-
-### Developer and Architecture Notes
-- All modules pass syntax checks and are ready for Studio integration
-- No breaking changes for existing Inspector users
-- Inspector is now a true UI module, not just an application
-
+- Added optional telemetry opt-in in settings panel (File -> Preferences -> Telemetry). See docs/telemetry/model_telemetry_and_registry.md and docs/telemetry/unified_telemetry_architecture.md for details.
+  - Currently only 'launch' telemetry is sent. Model registry telemetry will be added later.
 ---
 
 # Vector Inspector
@@ -63,7 +41,7 @@ Description-Content-Type: text/markdown
 > **Disclaimer:** This tool is currently under active development and is **not production ready**. Not all features have been thoroughly tested and code is released frequently. Use with caution in critical or production environments.
 
 [![CI](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml)
-[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml)
+[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/release-and-publish.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/release-and-publish.yml)
 
 [![PyPI Version](https://img.shields.io/pypi/v/vector-inspector.svg?cacheSeconds=300)](https://pypi.org/project/vector-inspector/)
 [![PyPI Downloads](https://static.pepy.tech/personalized-badge/vector-inspector?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/vector-inspector)
@@ -92,6 +70,8 @@ Vector Inspector bridges the gap between vector databases and user-friendly data
 
 ## Key Features
 
+> **Note:** Some features listed below may be not started or currently in progress.
+
 ### 1. **Multi-Provider Support**
 - Connect to vector databases:
   - ChromaDB (persistent local storage)

{vector_inspector-0.3.8 → vector_inspector-0.3.11}/README.md

@@ -1,29 +1,7 @@
 # Latest updates
 
-## Vector Inspector 2026.01 Release Notes
-
-### Major Refactor and Studio-Ready Architecture
-- Refactored main window into modular components:
-  - InspectorShell: reusable UI shell (splitter, tabs, layout)
-  - ProviderFactory: centralized connection creation
-  - DialogService: dialog management
-  - ConnectionController: connection lifecycle and threading
-  - InspectorTabs: pluggable tab registry
-- MainWindow now inherits from InspectorShell and is fully reusable as a widget
-- Bootstrap logic is separated from UI logic—Studio can host Inspector as a component
-- Tab system is now pluggable: Studio and Inspector can add, remove, or override tabs via TabDefinition
-- All Inspector UI logic is self-contained; Studio can extend without modifying Inspector code
-
-### Data Browser Improvements
-- Added a checkbox: Generate embeddings on edit (default: checked)
-  - When unchecked, editing a row skips embedding regeneration
-  - Setting is persisted per user
-
-### Developer and Architecture Notes
-- All modules pass syntax checks and are ready for Studio integration
-- No breaking changes for existing Inspector users
-- Inspector is now a true UI module, not just an application
-
+- Added optional telemetry opt-in in settings panel (File -> Preferences -> Telemetry). See docs/telemetry/model_telemetry_and_registry.md and docs/telemetry/unified_telemetry_architecture.md for details.
+  - Currently only 'launch' telemetry is sent. Model registry telemetry will be added later.
 ---
 
 # Vector Inspector
@@ -31,7 +9,7 @@
 > **Disclaimer:** This tool is currently under active development and is **not production ready**. Not all features have been thoroughly tested and code is released frequently. Use with caution in critical or production environments.
 
 [![CI](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/ci-tests.yml)
-[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/publish%20copy.yml)
+[![Publish](https://github.com/anthonypdawson/vector-inspector/actions/workflows/release-and-publish.yml/badge.svg?branch=master)](https://github.com/anthonypdawson/vector-inspector/actions/workflows/release-and-publish.yml)
 
 [![PyPI Version](https://img.shields.io/pypi/v/vector-inspector.svg?cacheSeconds=300)](https://pypi.org/project/vector-inspector/)
 [![PyPI Downloads](https://static.pepy.tech/personalized-badge/vector-inspector?period=total&units=INTERNATIONAL_SYSTEM&left_color=BLACK&right_color=GREEN&left_text=downloads)](https://pepy.tech/projects/vector-inspector)
@@ -60,6 +38,8 @@ Vector Inspector bridges the gap between vector databases and user-friendly data
 
 ## Key Features
 
+> **Note:** Some features listed below may be not started or currently in progress.
+
 ### 1. **Multi-Provider Support**
 - Connect to vector databases:
   - ChromaDB (persistent local storage)

{vector_inspector-0.3.8 → vector_inspector-0.3.11}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "vector-inspector"
-version = "0.3.8"
+version = "0.3.11"
 description = "A comprehensive desktop application for visualizing, querying, and managing vector database data"
 authors = [
     { name = "Anthony Dawson", email = "anthonypdawson+github@gmail.com" },
@@ -26,7 +26,7 @@ dependencies = [
     "psycopg2>=2.9.11",
     "pgvector>=0.4.2",
 ]
-requires-python = ">=3.10,<3.14"
+requires-python = ">=3.10"
 readme = "README.md"
 
 [project.license]
@@ -55,6 +55,8 @@ dev = [
     "ruff>=0.14.14",
     "mypy>=1.19.1",
     "ipython>=8.18.0",
+    "briefcase>=0.3.26",
+    "pyarmor>=9.2.3",
 ]
 
 [tool.ruff]
@@ -111,3 +113,67 @@ cmd = "python -m vector_inspector.main"
 
 [tool.pdm.scripts.vector-inspector.env]
 PYTHONPATH = "src"
+
+[tool.briefcase]
+project_name = "Vector Inspector"
+bundle = "com.divinedevops.vector-inspector"
+version = "0.3.11"
+url = "https://vector-inspector.divinedevops.com"
+author = "Anthony Dawson"
+author_email = "anthonypdawson+github@gmail.com"
+
+[tool.briefcase.license]
+file = "LICENSE"
+
+[tool.briefcase.app.vector-inspector]
+formal_name = "Vector Inspector"
+description = "A comprehensive desktop application for visualizing, querying, and managing vector database data"
+long_description = "More details about the app should go here.\n"
+sources = [
+    "src/vector_inspector",
+]
+test_sources = [
+    "tests",
+]
+requires = []
+test_requires = []
+
+[tool.briefcase.app.vector-inspector.macOS]
+universal_build = true
+requires = []
+
+[tool.briefcase.app.vector-inspector.linux]
+requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.debian]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.rhel]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.suse]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.system.arch]
+system_requires = []
+system_runtime_requires = []
+
+[tool.briefcase.app.vector-inspector.linux.flatpak]
+flatpak_runtime = "org.freedesktop.Platform"
+flatpak_runtime_version = "25.08"
+flatpak_sdk = "org.freedesktop.Sdk"
+
+[tool.briefcase.app.vector-inspector.windows]
+requires = []
+
+[tool.briefcase.app.vector-inspector.iOS]
+requires = []
+
+[tool.briefcase.app.vector-inspector.android]
+requires = []
+
+[tool.briefcase.app.vector-inspector.web]
+requires = []

vector_inspector-0.3.11/src/vector_inspector/__init__.py

@@ -0,0 +1,12 @@
+"""Vector Inspector - A comprehensive desktop application for vector database visualization."""
+
+__version__ = "0.3.11"  # Keep in sync with pyproject.toml for dev mode fallback
+
+
+def get_version():
+    try:
+        from importlib.metadata import version, PackageNotFoundError
+
+        return version("vector-inspector")
+    except Exception:
+        return __version__

{vector_inspector-0.3.8 → vector_inspector-0.3.11}/src/vector_inspector/core/connections/pgvector_connection.py

@@ -5,6 +5,8 @@ import json
 import psycopg2
 from psycopg2 import sql
 
+from vector_inspector.core.logging import log_info
+
 ## No need to import register_vector; pgvector extension is enabled at table creation
 from vector_inspector.core.connections.base_connection import VectorDBConnection
 from vector_inspector.core.logging import log_error, log_info
@@ -1043,12 +1045,35 @@ class PgVectorConnection(VectorDBConnection):
         Returns:
             List of floats
         """
+        # log_info("[pgvector] _parse_vector raw value: %r (type: %s)", vector_str, type(vector_str))
         if isinstance(vector_str, list):
+            log_info("[pgvector] _parse_vector: already list, len=%d", len(vector_str))
             return vector_str
+        # Handle numpy arrays
+        try:
+            import numpy as np
+
+            if isinstance(vector_str, np.ndarray):
+                log_info("[pgvector] _parse_vector: numpy array, shape=%s", vector_str.shape)
+                return vector_str.tolist()
+        except ImportError:
+            pass
         if isinstance(vector_str, str):
             # Remove brackets and split by comma
             vector_str = vector_str.strip("[]")
-            return [float(x) for x in vector_str.split(",")]
+            if not vector_str:
+                log_info("[pgvector] _parse_vector: empty string after strip")
+                return []
+            try:
+                parsed = [float(x) for x in vector_str.split(",")]
+                log_info("[pgvector] _parse_vector: parsed list of len %d", len(parsed))
+                return parsed
+            except Exception as e:
+                log_info(
+                    "[pgvector] _parse_vector: failed to parse '%s' with error: %s", vector_str, e
+                )
+                return []
+        log_info("[pgvector] _parse_vector: unhandled type %s, returning []", type(vector_str))
         return []
 
     def compute_embeddings_for_documents(

vector_inspector-0.3.11/src/vector_inspector/extensions/__init__.py

@@ -0,0 +1,111 @@
+"""Extension points for Vector Inspector.
+
+This module provides hooks and callbacks that allow pro versions
+or plugins to extend core functionality without modifying the base code.
+"""
+
+from typing import Any, ClassVar
+from collections.abc import Callable
+from PySide6.QtWidgets import QMenu, QTableWidget
+
+
+class TableContextMenuHook:
+    """Hook for adding custom context menu items to table widgets."""
+
+    _handlers: ClassVar[list[Callable]] = []
+
+    @classmethod
+    def register(cls, handler: Callable):
+        """Register a context menu handler.
+
+        Args:
+            handler: Callable that takes (menu: QMenu, table: QTableWidget, row: int, data: Dict)
+                    and adds menu items to the menu.
+        """
+        if handler not in cls._handlers:
+            cls._handlers.append(handler)
+
+    @classmethod
+    def unregister(cls, handler: Callable):
+        """Unregister a context menu handler."""
+        if handler in cls._handlers:
+            cls._handlers.remove(handler)
+
+    @classmethod
+    def trigger(
+        cls,
+        menu: QMenu,
+        table: QTableWidget,
+        row: int,
+        data: dict[str, Any] | None = None,
+    ):
+        """Trigger all registered handlers.
+
+        Args:
+            menu: The QMenu to add items to
+            table: The QTableWidget that was right-clicked
+            row: The row number that was clicked
+            data: Optional data dictionary with context (ids, documents, metadatas, etc.)
+        """
+        for handler in cls._handlers:
+            try:
+                handler(menu, table, row, data)
+            except Exception as e:
+                # Log but don't break if a handler fails
+                from vector_inspector.core.logging import log_error
+
+                log_error("Context menu handler error: %s", e)
+
+    @classmethod
+    def clear(cls):
+        """Clear all registered handlers."""
+        cls._handlers.clear()
+
+
+# Global singleton instance
+table_context_menu_hook = TableContextMenuHook()
+
+
+class SettingsPanelHook:
+    """Hook for adding custom sections to the Settings/Preferences dialog."""
+
+    _handlers: ClassVar[list[Callable]] = []
+
+    @classmethod
+    def register(cls, handler: Callable):
+        """Register a settings panel provider.
+
+        Handler signature: (parent_layout, settings_service, dialog)
+        where `parent_layout` is a QLayout the handler can add widgets to.
+        """
+        if handler not in cls._handlers:
+            cls._handlers.append(handler)
+
+    @classmethod
+    def unregister(cls, handler: Callable):
+        if handler in cls._handlers:
+            cls._handlers.remove(handler)
+
+    @classmethod
+    def trigger(cls, parent_layout, settings_service, dialog=None):
+        for handler in cls._handlers:
+            try:
+                handler(parent_layout, settings_service, dialog)
+            except Exception as e:
+                from vector_inspector.core.logging import log_error
+
+                log_error("Settings panel handler error: %s", e)
+
+    @classmethod
+    def clear(cls):
+        cls._handlers.clear()
+
+
+# Global singleton instance
+settings_panel_hook = SettingsPanelHook()
+
+# Register built-in settings panel extensions
+try:
+    import vector_inspector.extensions.telemetry_settings_panel
+except Exception:
+    pass

vector_inspector-0.3.11/src/vector_inspector/extensions/telemetry_settings_panel.py

@@ -0,0 +1,25 @@
+from PySide6.QtWidgets import QCheckBox, QHBoxLayout
+from vector_inspector.extensions import settings_panel_hook
+
+
+def add_telemetry_section(parent_layout, settings_service, dialog=None):
+    telemetry_checkbox = QCheckBox("Enable anonymous telemetry (app launch events)")
+    # Default to checked if not set
+    checked = settings_service.get("telemetry.enabled")
+    if checked is None:
+        checked = True
+    telemetry_checkbox.setChecked(checked)
+    telemetry_checkbox.setToolTip(
+        "Allow the app to send anonymous launch events to help improve reliability. No personal or document data is sent."
+    )
+
+    def on_state_changed(state):
+        settings_service.set_telemetry_enabled(bool(state))
+
+    telemetry_checkbox.stateChanged.connect(on_state_changed)
+    layout = QHBoxLayout()
+    layout.addWidget(telemetry_checkbox)
+    parent_layout.addLayout(layout)
+
+
+settings_panel_hook.register(add_telemetry_section)

{vector_inspector-0.3.8 → vector_inspector-0.3.11}/src/vector_inspector/main.py

@@ -4,6 +4,7 @@ import sys
 import os
 from PySide6.QtWidgets import QApplication
 from vector_inspector.ui.main_window import MainWindow
+from vector_inspector.core.logging import log_error
 
 # Ensures the app looks in its own folder for the raw libraries
 sys.path.append(os.path.dirname(sys.executable))
@@ -15,6 +16,21 @@ def main():
     app.setApplicationName("Vector Inspector")
     app.setOrganizationName("Vector Inspector")
 
+    # Telemetry: send launch ping if enabled
+    try:
+        from vector_inspector.services.telemetry_service import TelemetryService
+        from vector_inspector import get_version, __version__
+
+        app_version = None
+        try:
+            app_version = get_version()
+        except Exception:
+            app_version = __version__
+        telemetry = TelemetryService()
+        telemetry.send_launch_ping(app_version=app_version)
+    except Exception as e:
+        log_error(f"[Telemetry] Failed to send launch ping: {e}")
+
     window = MainWindow()
     window.show()
 

{vector_inspector-0.3.8 → vector_inspector-0.3.11}/src/vector_inspector/services/settings_service.py

@@ -1,6 +1,8 @@
 """Service for persisting application settings."""
 
 import json
+import base64
+from PySide6.QtCore import QObject, Signal
 from pathlib import Path
 from typing import Dict, Any, Optional, List
 from vector_inspector.core.cache_manager import invalidate_cache_on_settings_change
@@ -12,6 +14,18 @@ class SettingsService:
 
     def __init__(self):
         """Initialize settings service."""
+
+        # Expose a shared QObject-based signal emitter so UI can react to
+        # settings changes without polling.
+        class _Signals(QObject):
+            setting_changed = Signal(str, object)
+
+        # singleton-like per-process signals instance
+        try:
+            self.signals
+        except Exception:
+            self.signals = _Signals()
+
         self.settings_dir = Path.home() / ".vector-inspector"
         self.settings_file = self.settings_dir / "settings.json"
         self.settings: Dict[str, Any] = {}
@@ -51,6 +65,62 @@ class SettingsService:
         """Get a setting value."""
         return self.settings.get(key, default)
 
+    # Convenience accessors for common settings
+    def get_breadcrumb_enabled(self) -> bool:
+        return bool(self.settings.get("breadcrumb.enabled", True))
+
+    def set_breadcrumb_enabled(self, enabled: bool):
+        self.set("breadcrumb.enabled", bool(enabled))
+
+    def get_breadcrumb_elide_mode(self) -> str:
+        return str(self.settings.get("breadcrumb.elide_mode", "left"))
+
+    def set_breadcrumb_elide_mode(self, mode: str):
+        if mode not in ("left", "middle"):
+            mode = "left"
+        self.set("breadcrumb.elide_mode", mode)
+
+    def get_default_n_results(self) -> int:
+        return int(self.settings.get("search.default_n_results", 10))
+
+    def set_default_n_results(self, n: int):
+        self.set("search.default_n_results", int(n))
+
+    def get_auto_generate_embeddings(self) -> bool:
+        return bool(self.settings.get("embeddings.auto_generate", True))
+
+    def set_auto_generate_embeddings(self, enabled: bool):
+        self.set("embeddings.auto_generate", bool(enabled))
+
+    def get_window_restore_geometry(self) -> bool:
+        return bool(self.settings.get("window.restore_geometry", True))
+
+    def set_window_restore_geometry(self, enabled: bool):
+        self.set("window.restore_geometry", bool(enabled))
+
+    def set_window_geometry(self, geometry_bytes: bytes):
+        """Save window geometry as base64 string."""
+        try:
+            if isinstance(geometry_bytes, str):
+                # assume base64 already
+                b64 = geometry_bytes
+            else:
+                b64 = base64.b64encode(bytes(geometry_bytes)).decode("ascii")
+            self.set("window.geometry", b64)
+        except Exception as e:
+            log_error("Failed to set window geometry: %s", e)
+
+    def get_window_geometry(self) -> Optional[bytes]:
+        """Return geometry bytes or None."""
+        try:
+            b64 = self.settings.get("window.geometry")
+            if not b64:
+                return None
+            return base64.b64decode(b64)
+        except Exception as e:
+            log_error("Failed to get window geometry: %s", e)
+            return None
+
     def get_cache_enabled(self) -> bool:
         """Get whether caching is enabled (default: True)."""
         return self.settings.get("cache_enabled", True)
@@ -67,6 +137,14 @@ class SettingsService:
         else:
             cache.disable()
 
+    def get_telemetry_enabled(self) -> bool:
+        """Get whether telemetry is enabled (default: True)."""
+        return bool(self.settings.get("telemetry.enabled", True))
+
+    def set_telemetry_enabled(self, enabled: bool):
+        """Set whether telemetry is enabled."""
+        self.set("telemetry.enabled", bool(enabled))
+
     def set(self, key: str, value: Any):
         """Set a setting value."""
         self.settings[key] = value
@@ -74,6 +152,12 @@ class SettingsService:
         # Invalidate cache when settings change (only if cache is enabled)
         if key != "cache_enabled":  # Don't invalidate when toggling cache itself
             invalidate_cache_on_settings_change()
+        # Emit change signal for UI/reactive components
+        try:
+            # Emit the raw python object (value) for convenience
+            self.signals.setting_changed.emit(key, value)
+        except Exception:
+            pass
 
     def clear(self):
         """Clear all settings."""

vector_inspector-0.3.11/src/vector_inspector/services/telemetry_service.py

@@ -0,0 +1,88 @@
+import json
+import platform
+import uuid
+import requests
+from pathlib import Path
+from vector_inspector.services.settings_service import SettingsService
+from vector_inspector.core.logging import log_info, log_error
+
+TELEMETRY_ENDPOINT = "https://api.divinedevops.com/api/v1/telemetry"
+
+
+class TelemetryService:
+    def __init__(self, settings_service=None):
+        self.settings = settings_service or SettingsService()
+        self.queue_file = Path.home() / ".vector-inspector" / "telemetry_queue.json"
+        self._load_queue()
+
+    def _load_queue(self):
+        if self.queue_file.exists():
+            try:
+                with open(self.queue_file, encoding="utf-8") as f:
+                    self.queue = json.load(f)
+            except Exception:
+                self.queue = []
+        else:
+            self.queue = []
+
+    def _save_queue(self):
+        self.queue_file.parent.mkdir(parents=True, exist_ok=True)
+        with open(self.queue_file, "w", encoding="utf-8") as f:
+            json.dump(self.queue, f, indent=2)
+
+    def is_enabled(self):
+        return bool(self.settings.get("telemetry.enabled", True))
+
+    def get_hwid(self):
+        # Use a persistent UUID for this client
+        hwid = self.settings.get("telemetry.hwid")
+        if not hwid:
+            hwid = str(uuid.uuid4())
+            self.settings.set("telemetry.hwid", hwid)
+        return hwid
+
+    def queue_event(self, event):
+        self.queue.append(event)
+        self._save_queue()
+
+    def send_batch(self):
+        if not self.is_enabled() or not self.queue:
+            return
+        sent = []
+        for event in self.queue:
+            try:
+                log_info(
+                    f"[Telemetry] Sending to {TELEMETRY_ENDPOINT}\nPayload: {json.dumps(event, indent=2)}"
+                )
+                resp = requests.post(TELEMETRY_ENDPOINT, json=event, timeout=5)
+                log_info(f"[Telemetry] Response: {resp.status_code} {resp.text}")
+                if resp.status_code in (200, 201):
+                    sent.append(event)
+            except Exception as e:
+                log_error(f"[Telemetry] Exception: {e}")
+        # Remove sent events
+        self.queue = [e for e in self.queue if e not in sent]
+        self._save_queue()
+
+    def send_launch_ping(self, app_version, client_type="vector-inspector"):
+        log_info("[Telemetry] send_launch_ping called")
+        if not self.is_enabled():
+            log_info("[Telemetry] Telemetry is not enabled; skipping launch ping.")
+            return
+        event = {
+            "hwid": self.get_hwid(),
+            "event_name": "app_launch",
+            "app_version": app_version,
+            "client_type": client_type,
+            "metadata": {"os": platform.system() + "-" + platform.release()},
+        }
+        log_info(f"[Telemetry] Launch event payload: {json.dumps(event, indent=2)}")
+        self.queue_event(event)
+        self.send_batch()
+
+    def purge(self):
+        self.queue = []
+        self._save_queue()
+
+    def get_queue(self):
+        return list(self.queue)