sentinel-ai-os 1.0__tar.gz → 1.0.2__tar.gz

sentinel_ai_os-1.0.2/MANIFEST.in

@@ -0,0 +1,2 @@
+include src/sentinel/scripts/*
+recursive-include src/sentinel/scripts *

{sentinel_ai_os-1.0/sentinel_ai_os.egg-info → sentinel_ai_os-1.0.2}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: sentinel-ai-os
-Version: 1.0
+Version: 1.0.2
 Summary: Autonomous AI Operating System layer
 Author-email: Sam Selvaraj <samselvaraj1801@gmail.com>
-License: MIT
+License-Expression: MIT
 Keywords: ai,agent,automation,llm
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
+Requires-Python: <3.14,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: rich
@@ -49,6 +49,7 @@ Requires-Dist: comtypes
 Requires-Dist: pyperclip
 Requires-Dist: plyer
 Requires-Dist: pyttsx3
+Requires-Dist: sentence-transformers
 Requires-Dist: pillow
 Requires-Dist: opencv-python
 Requires-Dist: SpeechRecognition
@@ -76,7 +77,6 @@ Dynamic: license-file
 ---
 
 ## 🔭 Overview
-<img width="1127" height="550" alt="image" src="https://github.com/user-attachments/assets/9ac617d6-a959-4a8c-b245-ff2c98f083ea" />
 
 Sentinel is not just a chatbot; it is an **Action Engine**. Unlike web-based LLMs that live in a sandbox, Sentinel runs locally on your machine with access to your file system, applications, and peripherals.
 
@@ -91,7 +91,6 @@ It operates on a **Think-Plan-Act** loop:
 ---
 
 ## ✨ Key Features
-<img width="2836" height="1338" alt="image" src="https://github.com/user-attachments/assets/877e5ec8-f398-4c04-b0b0-0c45b12d08c8" />
 
 *   **🧠 Multi-Brain Support:** Powered by `litellm`, Sentinel can seamlessly switch between **OpenAI**, **Anthropic**, **Groq**, or run locally with **Ollama**.
 *   **💾 Hybrid Memory Architecture:**

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/README.md

@@ -19,7 +19,6 @@
 ---
 
 ## 🔭 Overview
-<img width="1127" height="550" alt="image" src="https://github.com/user-attachments/assets/9ac617d6-a959-4a8c-b245-ff2c98f083ea" />
 
 Sentinel is not just a chatbot; it is an **Action Engine**. Unlike web-based LLMs that live in a sandbox, Sentinel runs locally on your machine with access to your file system, applications, and peripherals.
 
@@ -34,7 +33,6 @@ It operates on a **Think-Plan-Act** loop:
 ---
 
 ## ✨ Key Features
-<img width="2836" height="1338" alt="image" src="https://github.com/user-attachments/assets/877e5ec8-f398-4c04-b0b0-0c45b12d08c8" />
 
 *   **🧠 Multi-Brain Support:** Powered by `litellm`, Sentinel can seamlessly switch between **OpenAI**, **Anthropic**, **Groq**, or run locally with **Ollama**.
 *   **💾 Hybrid Memory Architecture:**

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "sentinel-ai-os"
-version = "1.0"
+version = "1.0.2"
 description = "Autonomous AI Operating System layer"
 readme = "README.md"
-requires-python = ">=3.9"
-license = {text = "MIT"}
+requires-python = ">=3.9, <3.14"
+license = "MIT"
 authors = [
   { name="Sam Selvaraj", email="samselvaraj1801@gmail.com" }
 ]
@@ -69,6 +69,7 @@ dependencies = [
   "pyperclip",
   "plyer",
   "pyttsx3",
+  "sentence-transformers",
 
   # Vision / Audio
   "pillow",
@@ -77,6 +78,12 @@ dependencies = [
   "pyaudio"
 ]
 
+[tool.setuptools.packages.find]
+where = ["."]
+
+[tool.setuptools.package-data]
+sentinel = ["scripts/*", "*.json"]
+
 [project.scripts]
 sentinel = "sentinel.main:app"
 

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/agent.py

@@ -1,5 +1,3 @@
-# FILE: core/agent.py
-
 import sys
 import json
 import os
@@ -13,7 +11,6 @@ from sentinel.core.schema import AgentAction
 from sentinel.tools import memory_ops
 from sentinel.paths import USER_DATA_DIR, DB_PATH, VECTOR_PATH, AUDIT_LOG_PATH as AUDIT_LOG
 
-# Absolute path to scripts folder
 BASE_DIR = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
 SCRIPTS_DIR = os.path.join(BASE_DIR, "scripts")
 
@@ -33,7 +30,6 @@ class SentinelAgent:
         try:
             json_data = json.loads(text)
         except:
-            # Extract first valid JSON object using a stack
             start = text.find("{")
             if start == -1:
                 return None
@@ -93,7 +89,7 @@ class SentinelAgent:
             if input("⚠️  ARE YOU SURE? This will delete ALL long-term memories. (y/n): ").lower() == 'y':
                 UI.print_system("Initiating Wipe...")
 
-                # 1. Stop background processes
+
                 try:
                     from sentinel.core import scheduler
                     scheduler.stop_all_jobs()
@@ -106,7 +102,7 @@ class SentinelAgent:
                 except:
                     pass
 
-                # 3. Delete the specific files (Cross-Platform)
+                # 3. Delete the specific files
                 UI.print_system(f"Wiping data from {USER_DATA_DIR}...")
 
                 # Delete Vector DB Folder
@@ -148,7 +144,6 @@ class SentinelAgent:
                     sys.exit(0)
                 except Exception as e:
                     print(f"Reset failed: {e}")
-                    # Fallback: If locked, tell user to delete manually
                     print(f"Please manually delete this folder: {USER_DATA_DIR}")
             return True
 
@@ -169,7 +164,6 @@ class SentinelAgent:
             return True
 
         if cmd in ["switch", "model"]:
-            # (Keeping it brief for copy-paste)
             provider = args[0] if args else "openai"
             model = args[1] if len(args) > 1 else None
             from sentinel.tools import system_ops
@@ -228,7 +222,6 @@ class SentinelAgent:
                 if self.process_slash_command(user_input):
                     continue
 
-                # ---- Recall Memory ----
                 relevant_context = memory_ops.retrieve_relevant_context(user_input)
                 current_sys = SYSTEM_PROMPT
                 if relevant_context:
@@ -242,7 +235,6 @@ class SentinelAgent:
                     full_resp = self.brain.query(current_sys, messages)
                     action = self._parse_action(full_resp)
 
-                    # ---- Normal LLM response ----
                     if not action:
                         clean = full_resp.replace("```json", "").replace("```", "").strip()
 
@@ -257,7 +249,6 @@ class SentinelAgent:
 
                     tool, args = action.tool, action.args
 
-                    # ---- Explicit response tool ----
                     if tool == "response":
                         text = args.get("text", "").strip()
                         if not text:
@@ -267,13 +258,11 @@ class SentinelAgent:
                         self.history.append({"role": "assistant", "content": action.model_dump_json()})
                         break
 
-                    # ---- Tool execution ----
                     if tool in TOOLS:
                         UI.print_tool(tool)
                         try:
                             res = TOOLS[tool](**args)
 
-                            # UX fallback
                             if not res or not str(res).strip():
                                 res = "No long-term memories stored about you yet."
 

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/audit.py

@@ -7,7 +7,7 @@ from pathlib import Path
 
 BASE_DIR = Path.home() / ".sentinel-1"
 BASE_DIR.mkdir(exist_ok=True)
-LOG_FILE = BASE_DIR / "audit_log.jsonl"  # JSON Lines for easy parsing
+LOG_FILE = BASE_DIR / "audit_log.jsonl"
 
 
 class AuditLogger:
@@ -15,7 +15,6 @@ class AuditLogger:
         self.cfg = ConfigManager()
 
     def is_enabled(self):
-        # Check config (default to False if not set)
         return self.cfg.get("system.audit_logging", False)
 
     def toggle(self, state: bool):
@@ -33,7 +32,7 @@ class AuditLogger:
             "provider": provider,
             "model": model,
             "duration_ms": round(duration_ms, 2),
-            "input": str(input_data)[:2000],  # Truncate massive inputs
+            "input": str(input_data)[:2000],
             "output": str(output_data)
         }
 
@@ -43,6 +42,5 @@ class AuditLogger:
         except Exception as e:
             print(f"Logger Error: {e}")
 
-
 # Global Instance
 audit = AuditLogger()

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/config.py

@@ -1,19 +1,16 @@
-# FILE: sentinel/core/config.py
 import json
 import os
 import keyring
 from typing import Any, Optional
-from sentinel.paths import CONFIG_PATH  # <-- IMPORTED FROM CENTRAL PATHS
-
-APP_NAME = "sentinel-1"
+from sentinel.paths import CONFIG_PATH
 
+APP_NAME = "sentinel-ai"
 
 class ConfigManager:
     def __init__(self):
         self._ensure_config_exists()
 
     def _ensure_config_exists(self):
-        # Check if the file exists at ~/.sentinel/config.json
         if not CONFIG_PATH.exists():
             default_config = {
                 "user": {"name": "User", "location": "New York"},
@@ -28,14 +25,12 @@ class ConfigManager:
 
     def load(self) -> dict:
         try:
-            # CONFIG_PATH is a Path object, open() handles it natively
             with open(CONFIG_PATH, "r") as f:
                 return json.load(f)
         except (FileNotFoundError, json.JSONDecodeError):
             return {}
 
     def save(self, data: dict):
-        # Ensure the directory exists (just in case the folder was deleted manually)
         CONFIG_PATH.parent.mkdir(parents=True, exist_ok=True)
 
         with open(CONFIG_PATH, "w") as f:

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/llm.py

@@ -1,6 +1,3 @@
-# FILE: core/llm.py
-
-import os
 from openai import OpenAI
 import anthropic
 from sentinel.core.ui import UI
@@ -38,12 +35,9 @@ class LLMEngine:
         if verbose:
             is_ready = self.api_key is not None or self.provider == "ollama"
             if is_ready:
-                # We can comment this out if we want it strictly in the UI panel now
-                # UI.print_system(f"Brain Loaded: [bold cyan]{self.provider.upper()}[/bold cyan] | Model: [bold white]{self.model}[/bold white]")
                 pass
 
     def stream_query(self, system_prompt, history):
-        # Hot-reload config (Silent)
         self.reload_config(verbose=False)
 
         if not self.api_key and self.provider != "ollama":
@@ -51,8 +45,6 @@ class LLMEngine:
             yield f"Please run: [cyan]/setkey {self.provider} YOUR_KEY_HERE[/cyan]"
             return
 
-        # --- PREPARE MESSAGES ---
-        # 1. System Prompt is separate
         messages = []
         for msg in history:
             # Anthropic hates "system" role in messages list

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/registry.py

@@ -1,5 +1,3 @@
-# FILE: core/registry.py
-
 import platform
 import datetime
 import threading
@@ -8,7 +6,6 @@ from sentinel.core.config import ConfigManager
 import schedule
 from sentinel.tools.smart_index import smart_find
 
-# Import all tools
 from sentinel.tools import (
     apps, browser, clock, email_ops, file_ops, indexer, notes, office,
     system_ops, navigation, flights, sql_index, desktop, vision, audio,
@@ -17,12 +14,10 @@ from sentinel.tools import (
 )
 from sentinel.core import scheduler, cognitive
 
-# --- DETECT OS ---
 CURRENT_OS = platform.system()
 OS_VERSION = platform.release()
 NOW = datetime.datetime.now()
 
-# --- LOAD CONFIG ---
 cfg = ConfigManager()
 settings = cfg.load() if cfg.exists() else {}
 
@@ -30,21 +25,13 @@ settings = cfg.load() if cfg.exists() else {}
 def initialize_tools():
     print("\n[System] 🔄 Initializing File Systems...")
 
-    # 1. Fast Filename Indexer (Metadata Only)
     t1 = threading.Thread(target=sql_index.build_index, args=(True,))
     t1.daemon = True
     t1.start()
 
-    # REMOVE: The content indexer thread (t2)
-
-    # 3. Schedule recurring updates (Metadata only)
     schedule.every(60).minutes.do(sql_index.build_index, silent=True)
-
     scheduler.start_scheduler_service()
 
-
-# --- SAFETY WRAPPERS ---
-
 def ask_permission(tool_name, func, **kwargs):
     """
     Intervention Layer: Pauses execution to ask the user for confirmation.
@@ -58,7 +45,6 @@ def ask_permission(tool_name, func, **kwargs):
 
     if choice == 'y':
         try:
-            # Log successful dangerous actions to memory
             log_args = {k: v for k, v in kwargs.items() if k != 'agent_config'}
             memory_ops.log_activity(tool_name, str(log_args))
         except:
@@ -90,8 +76,6 @@ def draft_code(filename, content):
     except Exception as e:
         return f"Error drafting code: {e}"
 
-
-# --- TOOL MAPPING ---
 TOOLS = {
     # System & Apps
     "open_app": apps.open_app,
@@ -193,7 +177,6 @@ TOOLS = {
 }
 
 # --- PROMPT ---
-# Note: JSON examples use DOUBLE BRACES {{ }} to escape f-string formatting
 SYSTEM_PROMPT = f"""
 You are **Sentinel**, an autonomous AI Operating System layer.
 Your role is to translate user intent into safe, deterministic system actions.

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/scheduler.py

@@ -3,7 +3,6 @@ import time
 import threading
 from sentinel.core.llm import LLMEngine
 
-# Global registry
 ACTIVE_JOBS = {}
 
 
@@ -11,14 +10,11 @@ def _job_runner(task_description, agent_config):
     """Runs the background task."""
     print(f"\n[Scheduler] ⏰ Executing background task: {task_description}")
 
-    # Create a transient brain for this task
     brain = LLMEngine(agent_config)
 
-    # Security: Background agents get a strictly limited prompt
     sys_prompt = f"You are a background monitoring agent. Current Task: {task_description}. Output JSON only."
 
     try:
-        # We pass an empty history because background tasks should be stateless
         response = brain.query(sys_prompt, [])
         print(f"[Scheduler Result]: {response}")
     except Exception as e:

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/schema.py

@@ -1,4 +1,3 @@
-# FILE: core/schema.py
 from pydantic import BaseModel, Field, ValidationError
 from typing import Dict, Any, Optional
 
@@ -7,5 +6,4 @@ class AgentAction(BaseModel):
     args: Dict[str, Any] = Field(default_factory=dict)
 
     class Config:
-        # Allows the model to ignore extra fields if the LLM hallucinates them
         extra = "ignore"

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/setup.py

@@ -1,5 +1,3 @@
-# sentinel/core/setup.py
-
 import time
 from rich.console import Console
 from rich.panel import Panel
@@ -84,7 +82,6 @@ def setup_wizard():
             console.print(f"[bold cyan]{CREDS_FILE}[/bold cyan]")
             console.print("\nThen run: sentinel auth")
 
-    # 5. Finalize
     with Progress(
         SpinnerColumn(),
         TextColumn("[progress.description]{task.description}"),

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/core/ui.py

@@ -1,4 +1,3 @@
-# FILE: core/ui.py
 from rich.console import Console
 from rich.panel import Panel
 from rich.markdown import Markdown
@@ -50,7 +49,6 @@ class UI:
         if not isinstance(text, Markdown):
             text = Markdown(str(text))
 
-        # Add Model Info to Title
         title = "[bold cyan]SENTINEL[/bold cyan]"
         if model:
             title += f" [dim]({model})[/dim]"

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/paths.py

@@ -1,73 +1,44 @@
-# FILE: sentinel/core/paths.py
 import os
 import sys
 from pathlib import Path
 
-# ==========================================
-# 1. USER DATA STORAGE (Mutable)
-# Stores DBs, Configs, Logs, and Auth Tokens
-# Location: ~/.sentinel (Cross-platform)
-# ==========================================
-
 USER_DATA_DIR = Path.home() / ".sentinel"
 USER_DATA_DIR.mkdir(parents=True, exist_ok=True)
-
-# Subdirectories
 LOGS_DIR = USER_DATA_DIR / "logs"
 LOGS_DIR.mkdir(exist_ok=True)
 
 DRAFTS_DIR = USER_DATA_DIR / "drafts"
 DRAFTS_DIR.mkdir(exist_ok=True)
-
-# Critical System Files
 CONFIG_PATH = USER_DATA_DIR / "config.json"
 DB_PATH = USER_DATA_DIR / "brain.db"
 VECTOR_PATH = USER_DATA_DIR / "brain_vectors"  # ChromaDB folder
 AUDIT_LOG_PATH = USER_DATA_DIR / "audit_log.jsonl"
 MEMORY_FILE = USER_DATA_DIR / "memory.json"
-
-# Search Indexes
 FILE_INDEX_DB = USER_DATA_DIR / "file_index.db"
 SMART_INDEX_DB = USER_DATA_DIR / "smart_files.db"
 
-# Authentication
+
 CREDENTIALS_PATH = USER_DATA_DIR / "credentials.json"
 TOKEN_PATH = USER_DATA_DIR / "token.json"
 
-
-# ==========================================
-# 2. PACKAGE ASSETS (Immutable)
-# Locates scripts/tools bundled inside the pip package
-# Location: .../site-packages/sentinel/scripts/
-# ==========================================
-
 def get_script_path(filename: str) -> str:
     """
     Returns the absolute path to a script bundled inside the pip package.
     Expects scripts to be in: src/sentinel/scripts/
     """
-    # This file is in: .../sentinel/core/paths.py
-    # We want:         .../sentinel/scripts/filename
 
-    # Get the directory of THIS file (core/)
     current_dir = os.path.dirname(os.path.abspath(__file__))
-
-    # Go up one level to the package root (sentinel/)
     pkg_root = os.path.dirname(current_dir)
-
-    # Target path
     script_path = os.path.join(pkg_root, "scripts", filename)
 
     if not os.path.exists(script_path):
-        # Fallback for Development Mode (running from source without pip install)
-        # In dev repo: sentinel/core/paths.py -> ../../../scripts/
+
         repo_root = os.path.dirname(os.path.dirname(pkg_root))
         dev_path = os.path.join(repo_root, "scripts", filename)
 
         if os.path.exists(dev_path):
             return dev_path
 
-        # If we still can't find it, that's a build error
         raise FileNotFoundError(
             f"Could not find bundled script '{filename}'.\n"
             f"Checked: {script_path}\n"

sentinel_ai_os-1.0.2/sentinel/scripts/factory_reset.bat

@@ -0,0 +1,17 @@
+@echo off
+title Sentinel Factory Reset
+
+echo.
+echo !!! THIS WILL DELETE ALL SENTINEL DATA !!!
+echo Location:
+echo %USERPROFILE%\.sentinel
+echo.
+pause
+
+rmdir /s /q "%USERPROFILE%\.sentinel"
+mkdir "%USERPROFILE%\.sentinel"
+
+echo.
+echo Sentinel has been FACTORY RESET.
+echo All memory, vectors, tokens, logs deleted.
+exit

sentinel_ai_os-1.0.2/sentinel/scripts/wipe_vector.bat

@@ -0,0 +1,7 @@
+@echo off
+echo Wiping Long-term memory only...
+rmdir /s /q "%USERPROFILE%\.sentinel\brain_vectors"
+rmdir /s /q "%USERPROFILE%\.sentinel\.chroma"
+del /f /q "%USERPROFILE%\.sentinel\memory.json"
+echo Done.
+exit

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/apps.py

@@ -7,7 +7,6 @@ import webbrowser
 import difflib
 import logging
 
-# Ensure APP_CACHE exists (from your global scope)
 APP_CACHE = globals().get("APP_CACHE", {})
 
 def _native_open(target):
@@ -33,8 +32,6 @@ def _run_command(cmd_str):
     Safely runs a command string cross-platform.
     """
     try:
-        # On Windows, shell=True is often needed for system aliases (like 'dir' or 'start')
-        # On Unix, we prefer passing a list, but for complex aliases we use shell=True safely.
         subprocess.Popen(cmd_str, shell=True)
         return True
     except Exception as e:
@@ -78,7 +75,7 @@ def _get_os_aliases():
             "ppt": "powerpnt",
             "outlook": "outlook",
             "onenote": "onenote",
-            "teams": "ms-teams:",  # Deep link is often more reliable than exe
+            "teams": "ms-teams:",
             "access": "msaccess",
 
             # --- SYSTEM TOOLS ---
@@ -87,7 +84,7 @@ def _get_os_aliases():
             "settings": "start ms-settings:",
             "control panel": "control",
             "task manager": "taskmgr",
-            "cmd": "start cmd",  # 'start' ensures it opens a NEW window
+            "cmd": "start cmd",  #
             "command prompt": "start cmd",
             "terminal": "wt",  # Windows Terminal
             "powershell": "start powershell",
@@ -109,7 +106,6 @@ def _get_os_aliases():
             "pycharm": "pycharm64",
             "intellij": "idea64",
             "docker": "start \"Docker Desktop\" \"C:\\Program Files\\Docker\\Docker\\Docker Desktop.exe\"",
-            # Hard path often needed
             "wsl": "wsl",
             "git": "git-bash",
 
@@ -121,7 +117,7 @@ def _get_os_aliases():
             "calc": "calc",
             "calculator": "calc",
             "snipping tool": "snippingtool",
-            "screenshot": "snippingtool",  # Logic alias
+            "screenshot": "snippingtool",
             "photos": "ms-photos:",
             "camera": "microsoft.windows.camera:",
             "clock": "ms-clock:",
@@ -144,7 +140,6 @@ def _get_os_aliases():
         }}
 
     # 3. macOS Specifics (Darwin)
-        # 3. macOS Specifics (Darwin)
     elif system == "Darwin":
         return {**aliases, **{
             # --- BROWSERS ---
@@ -167,12 +162,12 @@ def _get_os_aliases():
 
             # --- DEV TOOLS ---
             "vscode": "open -a 'Visual Studio Code'",
-            "code": "open -a 'Visual Studio Code'",  # Fallback if 'code' CLI isn't in PATH
+            "code": "open -a 'Visual Studio Code'",
             "sublime": "open -a 'Sublime Text'",
             "iterm": "open -a iTerm",
             "terminal": "open -a Terminal",
             "docker": "open -a Docker",
-            "pycharm": "open -a 'PyCharm CE'",  # Or 'PyCharm' depending on edition
+            "pycharm": "open -a 'PyCharm CE'",
             "intellij": "open -a 'IntelliJ IDEA CE'",
             "xcode": "open -a Xcode",
 
@@ -182,7 +177,7 @@ def _get_os_aliases():
             "whatsapp": "open -a WhatsApp",
             "telegram": "open -a Telegram",
             "signal": "open -a Signal",
-            "zoom": "open -a zoom.us",  # Zoom internal name is often zoom.us
+            "zoom": "open -a zoom.us",
             "messages": "open -a Messages",
             "imessage": "open -a Messages",
             "mail": "open -a Mail",
@@ -208,12 +203,12 @@ def _get_os_aliases():
 
             # --- SYSTEM UTILITIES ---
             "finder": "open .",
-            "explorer": "open .",  # For Windows muscle memory
-            "settings": "open -b com.apple.systempreferences",  # Robust bundle ID method
+            "explorer": "open .",
+            "settings": "open -b com.apple.systempreferences",
             "preferences": "open -b com.apple.systempreferences",
             "app store": "open -a 'App Store'",
             "activity monitor": "open -a 'Activity Monitor'",
-            "task manager": "open -a 'Activity Monitor'",  # Windows muscle memory
+            "task manager": "open -a 'Activity Monitor'",
             "disk utility": "open -a 'Disk Utility'",
             "calculator": "open -a Calculator",
             "calc": "open -a Calculator",
@@ -230,7 +225,7 @@ def _get_os_aliases():
             "chromium": "chromium-browser",
             "firefox": "firefox",
             "brave": "brave-browser",
-            "edge": "microsoft-edge",  # Yes, it exists on Linux!
+            "edge": "microsoft-edge",
             "opera": "opera",
 
             # --- OFFICE (LibreOffice Suite) ---
@@ -240,7 +235,7 @@ def _get_os_aliases():
             "calc": "libreoffice --calc",
             "powerpoint": "libreoffice --impress",
             "impress": "libreoffice --impress",
-            "teams": "teams-for-linux",  # Common community wrapper
+            "teams": "teams-for-linux",
 
             # --- DEV TOOLS ---
             "vscode": "code",
@@ -249,8 +244,6 @@ def _get_os_aliases():
             "vim": "vim",
             "nano": "nano",
             "docker": "docker",
-            # "terminal" usually defaults to x-terminal-emulator,
-            # but we explicitly try common ones if that fails:
             "terminal": "gnome-terminal",
             "konsole": "konsole",
 
@@ -267,25 +260,25 @@ def _get_os_aliases():
             "spotify": "spotify",
             "rhythmbox": "rhythmbox",
             "mpv": "mpv",
-            "photos": "eog",  # Eye of GNOME (common image viewer)
+            "photos": "eog",
             "gimp": "gimp",
             "obs": "obs",
 
             # --- SYSTEM UTILITIES ---
             "explorer": "xdg-open .",
             "finder": "xdg-open .",
-            "nautilus": "nautilus",  # GNOME Files
-            "dolphin": "dolphin",  # KDE Files
-            "thunar": "thunar",  # XFCE Files
+            "nautilus": "nautilus",
+            "dolphin": "dolphin",
+            "thunar": "thunar",
+
 
-            # "Settings" varies wildly, but these covers 80% of users:
             "settings": "gnome-control-center",
             "control panel": "gnome-control-center",
 
             # Task Manager equivalents
             "task manager": "gnome-system-monitor",
             "system monitor": "gnome-system-monitor",
-            "htop": "x-terminal-emulator -e htop",  # Opens htop in a new window
+            "htop": "x-terminal-emulator -e htop",
 
             "calculator": "gnome-calculator",
             "screenshot": "gnome-screenshot",
@@ -323,7 +316,6 @@ def refresh_app_cache():
         for app_dir in app_dirs:
             if not os.path.exists(app_dir): continue
             try:
-                # macOS apps are folders ending in .app
                 for item in os.listdir(app_dir):
                     if item.endswith(".app"):
                         name = item.replace(".app", "").lower()
@@ -334,7 +326,6 @@ def refresh_app_cache():
 
     # --- LINUX INDEXING ---
     elif system == "Linux":
-        # Scan for .desktop files
         desktop_dirs = ["/usr/share/applications", os.path.expanduser("~/.local/share/applications")]
         for d_dir in desktop_dirs:
             if not os.path.exists(d_dir): continue
@@ -343,14 +334,11 @@ def refresh_app_cache():
                     if item.endswith(".desktop"):
                         name = item.replace(".desktop", "").lower()
                         full_path = os.path.join(d_dir, item)
-                        # We map the simple name to the .desktop file
-                        # xdg-open handles .desktop files automatically
                         APP_CACHE[name] = full_path
             except PermissionError:
                 continue
 
 
-# Run indexing on import
 refresh_app_cache()
 
 
@@ -377,9 +365,7 @@ def open_app(name):
     lower_name = name.lower()
 
     # --- 1. DIRECT PATH ---
-    # If the user provides a full path that exists
     if os.path.exists(name):
-        # Optional: index_file(name) if available in your scope
         if 'index_file' in globals(): globals()['index_file'](name)
 
         if _native_open(name):
@@ -395,7 +381,6 @@ def open_app(name):
         return f"Failed to launch alias: {lower_name}"
 
     # --- 3. DYNAMIC SEARCH (Fuzzy Match) ---
-    # Works if APP_CACHE is populated (Windows mostly, unless you add Linux/Mac indexers)
     if APP_CACHE:
         # Exact Match
         if lower_name in APP_CACHE:
@@ -412,13 +397,11 @@ def open_app(name):
             return f"Launched {best_match} (matched to '{name}')"
 
     # --- 4. EXECUTABLE IN PATH ---
-    # Check if 'name' is a command available in the system PATH (e.g., 'npm', 'docker')
     if shutil.which(lower_name):
         _run_command(lower_name)
         return f"Executed command: {lower_name}"
 
     # --- 5. WEB URL FALLBACK ---
-    # If it looks like a URL or domain
     if "." in name and " " not in name:
         url = name if name.startswith(("http://", "https://")) else f"https://{name}"
         webbrowser.open(url)

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/audio.py

@@ -26,5 +26,5 @@ def listen_background(callback):
     """
     Starts a background listener for a hotword (Advanced).
     """
-    # This requires a loop and is best left for Phase 2
+    # Future
     pass

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/browser.py

@@ -17,7 +17,6 @@ def search_web(query):
         try:
             from tavily import TavilyClient
             client = TavilyClient(api_key=tavily_key)
-            # 'search_context' returns optimized text for AI
             response = client.get_search_context(query=query, search_depth="basic", max_tokens=1500)
             return f"[Source: Tavily]\n{response}"
         except ImportError:
@@ -25,7 +24,6 @@ def search_web(query):
         except Exception:
             pass
 
-            # 2. Fallback to DuckDuckGo
     try:
         results = DDGS().text(query, max_results=4)
         summary = []

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/context.py

@@ -17,7 +17,6 @@ def get_active_app():
             return {
                 "title": window.title,
                 "app_name": "Unknown (Window API limitation)",
-                # Getting precise .exe from window is complex in pure python without win32gui
                 "status": "Active"
             }
         else:

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/factory.py

@@ -13,14 +13,10 @@ def _convert_to_pdf(docx_path):
     For this MVP, we will try a pure Python fallback if system tools aren't found.
     """
     try:
-        # 1. Try LibreOffice (Best Quality, Cross Platform)
-        # This requires LibreOffice to be in your PATH (soffice/libreoffice)
         cmd = f"soffice --headless --convert-to pdf \"{docx_path}\" --outdir \"{os.path.dirname(docx_path)}\""
         if os.system(cmd) == 0:
             return docx_path.replace(".docx", ".pdf")
 
-        # 2. Try Microsoft Word (Windows Only, requires 'docx2pdf')
-        # pip install docx2pdf
         try:
             from docx2pdf import convert
             convert(docx_path)
@@ -103,7 +99,6 @@ def create_document(filename, blocks):
                             if i < len(row_cells):
                                 row_cells[i].text = str(cell_text)
 
-            # --- BREAKS ---
             elif b_type == "page_break":
                 doc.add_page_break()
 
@@ -116,7 +111,6 @@ def create_document(filename, blocks):
 
         doc.save(docx_path)
 
-        # Try converting to PDF automatically
         pdf_result = _convert_to_pdf(docx_path)
 
         return f"Document created: {docx_path} (PDF Status: {pdf_result})"

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/file_ops.py

@@ -1,4 +1,3 @@
-# FILE: tools/file_ops.py
 import os
 import fitz  # PyMuPDF
 import pandas as pd
@@ -19,7 +18,6 @@ def read_file(path):
     ext = os.path.splitext(path)[1].lower()
 
     try:
-        # --- PDF (Smart Read using PyMuPDF) ---
         if ext == '.pdf':
             text = ""
             try:

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/flights.py

@@ -43,7 +43,7 @@ def search_flights(departure_id, arrival_id, date, travel_type=2):
 
         for i, f in enumerate(flights[:5], 1):
             price = f.get("price", "N/A")
-            duration = f.get("total_duration", "N/A")  # FIXED
+            duration = f.get("total_duration", "N/A")
 
             leg = f["flights"][0]
             airline = leg.get("airline", "Unknown")

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/gmail_auth.py

@@ -3,10 +3,8 @@ from google.auth.transport.requests import Request
 from google.oauth2.credentials import Credentials
 from google_auth_oauthlib.flow import InstalledAppFlow
 
-# --- FIX: IMPORT PATHS FROM CENTRAL MODULE ---
 from sentinel.paths import CREDENTIALS_PATH, TOKEN_PATH
 
-# The permissions the AI needs
 SCOPES = [
     'https://www.googleapis.com/auth/gmail.readonly',
     'https://www.googleapis.com/auth/gmail.send'
@@ -16,32 +14,26 @@ SCOPES = [
 def get_gmail_service():
     creds = None
 
-    # 1. Check if we already logged in (using the centralized token path)
     if os.path.exists(TOKEN_PATH):
         creds = Credentials.from_authorized_user_file(TOKEN_PATH, SCOPES)
 
-    # 2. If not logged in or token expired, log in
     if not creds or not creds.valid:
         if creds and creds.expired and creds.refresh_token:
             creds.refresh(Request())
         else:
-            # Check if credentials file exists in the user data folder
+
             if not os.path.exists(CREDENTIALS_PATH):
                 print(f"Error: credentials.json not found at {CREDENTIALS_PATH}")
                 return None
 
-            # This opens your browser to login
             flow = InstalledAppFlow.from_client_secrets_file(
                 CREDENTIALS_PATH, SCOPES)
             creds = flow.run_local_server(port=0)
 
-        # Save the token for next time
-        # Ensure the directory exists
         TOKEN_PATH.parent.mkdir(parents=True, exist_ok=True)
 
         with open(TOKEN_PATH, 'w') as token:
             token.write(creds.to_json())
 
-    # 3. Return the API Service
     from googleapiclient.discovery import build
     return build('gmail', 'v1', credentials=creds)

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/indexer.py

@@ -1,4 +1,3 @@
-# FILE: tools/indexer.py
 import os
 import sqlite3
 import time
@@ -82,7 +81,6 @@ def build_index(root=None, verbose=False):
     count = 0
     updated = 0
 
-    # We scan these specific user folders to stay efficient
     target_dirs = [
         os.path.join(root, "Documents"),
         os.path.join(root, "Desktop"),
@@ -93,11 +91,9 @@ def build_index(root=None, verbose=False):
         if not os.path.exists(target): continue
 
         for r, dirs, files in os.walk(target):
-            # Clean skip dirs in-place
             dirs[:] = [d for d in dirs if d not in SKIP_DIRS and not d.startswith(".")]
 
             for file in files:
-                # CPU BREATHING ROOM
                 time.sleep(THROTTLE_SEC)
 
                 ext = os.path.splitext(file)[1].lower()
@@ -111,23 +107,20 @@ def build_index(root=None, verbose=False):
                     stats = os.stat(path)
                     current_mtime = stats.st_mtime
 
-                    # Skip unchanged
                     if path in existing_meta and existing_meta[path] == current_mtime:
                         continue
 
                     content = _get_text_from_file(path, ext)
                     if not content or len(content) < 5: continue
 
-                    # Update Database
                     c.execute("DELETE FROM files WHERE path = ?", (path,))
                     c.execute("INSERT INTO files (path, name, content) VALUES (?,?,?)", (path, file, content))
                     c.execute("INSERT OR REPLACE INTO file_meta (path, mtime) VALUES (?,?)", (path, current_mtime))
-                    conn.commit()  # Commit often to save progress
+                    conn.commit()
 
                     updated += 1
                     count += 1
 
-                    # LOGGING: Only print every 10th file to reduce spam
                     if verbose and updated % 10 == 0:
                         print(f"   [Indexer] Indexed: {file} ({updated} total)")
 
@@ -144,7 +137,6 @@ def search_index(query):
     if not os.path.exists(DB_FILE): return "Index missing."
     conn = sqlite3.connect(DB_FILE)
     try:
-        # Search content and return snippets
         res = conn.execute(
             "SELECT path, snippet(files, 2, '[', ']', '...', 10) FROM files WHERE files MATCH ? LIMIT 5",
             (query,)

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/notes.py

@@ -64,7 +64,6 @@ def list_notes(category=None):
 def delete_note(note_id):
     """Removes a note by ID."""
     notes = _load_notes()
-    # Handle string vs int ID mismatch
     try:
         note_id = int(note_id)
     except:

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/smart_index.py

@@ -35,7 +35,7 @@ def index_file(path):
 
     name = os.path.basename(path)
     ext = os.path.splitext(path)[1]
-    text = name  # IMPORTANT: only embed filename (fast)
+    text = name
 
     emb = embed(text)
 

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/sql_index.py

@@ -10,8 +10,7 @@ BASE_DIR.mkdir(exist_ok=True)
 
 DB_FILE = BASE_DIR / "sentinel-1.db"
 
-# --- CONFIGURATION: WHAT TO IGNORE ---
-# These are the "System Ones" we skip. Everything else is fair game.
+
 SKIP_DIRS = {
     # System Folders
     "Windows", "Program Files", "Program Files (x86)",
@@ -19,7 +18,7 @@ SKIP_DIRS = {
     "$RECYCLE.BIN", "System Volume Information", "Recovery",
     "boot", "efi",
 
-    # Dev Junk (Optional - keep these to avoid noise, or remove to index code)
+    # Dev Junk
     "node_modules", "venv", ".venv", ".git", "__pycache__", ".idea", ".vscode"
 }
 
@@ -68,10 +67,8 @@ def build_index(silent=True):
     cursor.execute("CREATE INDEX IF NOT EXISTS idx_name ON files(name)")
 
     # 2. Identify Scan Targets
-    # Strategy: Scan the User Profile on C:, plus the ROOT of every other drive.
     targets = []
 
-    # A. Always get standard user folders (Safest way to scan C:)
     home = os.path.expanduser("~")
     targets.extend([
         os.path.join(home, "Desktop"),
@@ -80,23 +77,17 @@ def build_index(silent=True):
         os.path.join(home, "Pictures"),
         os.path.join(home, "Music"),
         os.path.join(home, "Videos"),
-        # Add your code folder explicitly if it's not in the above
         r"D:\Python Projects"
     ])
 
-    # B. Add ALL other drives (D:, E:, etc)
     all_drives = get_all_drives()
     for drive in all_drives:
-        # We generally avoid scanning C:\ root because it's 90% OS junk.
-        # But D:\, E:\, etc. are usually pure data, so we scan their ROOT.
         if "C:" in drive.upper():
             continue
         targets.append(drive)
 
-    # Remove duplicates
     targets = list(set(targets))
 
-    # 3. Load Cache (for speed)
     if not silent: print("[System] Loading existing file index...")
     cursor.execute("SELECT path, mtime_raw FROM files")
     existing_files = {row['path']: row['mtime_raw'] for row in cursor.fetchall()}
@@ -107,17 +98,15 @@ def build_index(silent=True):
     if not silent:
         print(f"[System] Scanning {len(targets)} locations:\n" + "\n".join([f"   - {t}" for t in targets]))
 
-    # 4. The Scan Loop
     for folder in targets:
         if not os.path.exists(folder): continue
 
         for root, dirs, filenames in os.walk(folder):
-            # --- FILTERING: This is where we skip "System Ones" ---
-            # We modify 'dirs' in-place so os.walk doesn't even enter them.
+
             dirs[:] = [d for d in dirs if d not in SKIP_DIRS and not d.startswith(".")]
 
             for f in filenames:
-                # Ignore temp/hidden files
+
                 if f.startswith("~$") or f.startswith("."): continue
 
                 fullpath = os.path.join(root, f)
@@ -128,7 +117,6 @@ def build_index(silent=True):
                     stats = os.stat(fullpath)
                     current_mtime = stats.st_mtime
 
-                    # Optimization: Skip if file hasn't changed since last scan
                     if fullpath in existing_files and abs(existing_files[fullpath] - current_mtime) < 1.0:
                         continue
 
@@ -149,7 +137,6 @@ def build_index(silent=True):
             VALUES (?, ?, ?, ?, ?, ?)
         ''', updates)
 
-    # 6. Cleanup (Remove files that were deleted from disk)
     deleted_paths = set(existing_files.keys()) - seen_paths
     if deleted_paths:
         deleted_list = list(deleted_paths)
@@ -169,7 +156,6 @@ def search_db(query):
 
     sql_query = f"%{query}%"
 
-    # Prioritize exact matches in name, then partial matches
     cursor.execute('''
         SELECT name, path, modified_date 
         FROM files 

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/system_ops.py

@@ -52,7 +52,6 @@ def switch_model(provider, model=None):
     return f"⚡ Brain updated to [bold green]{provider.upper()}[/bold green] | Model: {model}"
 
 
-# ... (Keep get_clipboard, get_system_stats, run_cmd, kill_process as they were) ...
 def get_clipboard():
     try:
         return pyperclip.paste()

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel/tools/weather_ops.py

@@ -7,7 +7,6 @@ def get_current_weather(location=""):
     Uses wttr.in (No API key required).
     """
     try:
-        # Format 3 gives a concise one-line output: "Paris: ⛅️ +14°C"
         url = f"https://wttr.in/{location}?format=4"
         response = requests.get(url, timeout=5)
 

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2/sentinel_ai_os.egg-info}/PKG-INFO

@@ -1,13 +1,13 @@
 Metadata-Version: 2.4
 Name: sentinel-ai-os
-Version: 1.0
+Version: 1.0.2
 Summary: Autonomous AI Operating System layer
 Author-email: Sam Selvaraj <samselvaraj1801@gmail.com>
-License: MIT
+License-Expression: MIT
 Keywords: ai,agent,automation,llm
 Classifier: Programming Language :: Python :: 3
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.9
+Requires-Python: <3.14,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: rich
@@ -49,6 +49,7 @@ Requires-Dist: comtypes
 Requires-Dist: pyperclip
 Requires-Dist: plyer
 Requires-Dist: pyttsx3
+Requires-Dist: sentence-transformers
 Requires-Dist: pillow
 Requires-Dist: opencv-python
 Requires-Dist: SpeechRecognition
@@ -76,7 +77,6 @@ Dynamic: license-file
 ---
 
 ## 🔭 Overview
-<img width="1127" height="550" alt="image" src="https://github.com/user-attachments/assets/9ac617d6-a959-4a8c-b245-ff2c98f083ea" />
 
 Sentinel is not just a chatbot; it is an **Action Engine**. Unlike web-based LLMs that live in a sandbox, Sentinel runs locally on your machine with access to your file system, applications, and peripherals.
 
@@ -91,7 +91,6 @@ It operates on a **Think-Plan-Act** loop:
 ---
 
 ## ✨ Key Features
-<img width="2836" height="1338" alt="image" src="https://github.com/user-attachments/assets/877e5ec8-f398-4c04-b0b0-0c45b12d08c8" />
 
 *   **🧠 Multi-Brain Support:** Powered by `litellm`, Sentinel can seamlessly switch between **OpenAI**, **Anthropic**, **Groq**, or run locally with **Ollama**.
 *   **💾 Hybrid Memory Architecture:**

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel_ai_os.egg-info/SOURCES.txt

@@ -18,6 +18,8 @@ sentinel/core/scheduler.py
 sentinel/core/schema.py
 sentinel/core/setup.py
 sentinel/core/ui.py
+sentinel/scripts/factory_reset.bat
+sentinel/scripts/wipe_vector.bat
 sentinel/tools/__init__.py
 sentinel/tools/apps.py
 sentinel/tools/audio.py

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel_ai_os.egg-info/requires.txt

@@ -37,6 +37,7 @@ comtypes
 pyperclip
 plyer
 pyttsx3
+sentence-transformers
 pillow
 opencv-python
 SpeechRecognition

{sentinel_ai_os-1.0 → sentinel_ai_os-1.0.2}/sentinel_ai_os.egg-info/top_level.txt

@@ -1 +1,2 @@
+dist
 sentinel

sentinel_ai_os-1.0/MANIFEST.in

@@ -1 +0,0 @@
-recursive-include src/sentinel/scripts *