windows-mcp 0.5.7__py3-none-any.whl → 0.5.8__py3-none-any.whl

windows_mcp/watchdog/__init__.py

@@ -0,0 +1 @@
+from .service import WatchDog

windows_mcp/watchdog/event_handlers.py

@@ -0,0 +1,51 @@
+from windows_mcp.uia.core import _AutomationClient
+import comtypes
+
+# Get UIA Interface for COM definitions
+uia_client = _AutomationClient.instance()
+UIA = uia_client.UIAutomationCore
+
+class FocusChangedEventHandler(comtypes.COMObject):
+    _com_interfaces_ = [UIA.IUIAutomationFocusChangedEventHandler]
+
+    def __init__(self, parent):
+        self.parent = parent
+        super(FocusChangedEventHandler, self).__init__()
+
+    def HandleFocusChangedEvent(self, sender):
+        try:
+            if self.parent._focus_callback:
+                self.parent._focus_callback(sender)
+        except Exception as e:
+            print(f"Error in focus callback: {e}")
+        return 0 # S_OK
+
+class StructureChangedEventHandler(comtypes.COMObject):
+    _com_interfaces_ = [UIA.IUIAutomationStructureChangedEventHandler]
+
+    def __init__(self, parent):
+        self.parent = parent
+        super(StructureChangedEventHandler, self).__init__()
+
+    def HandleStructureChangedEvent(self, sender, changeType, runtimeId):
+        try:
+            if self.parent._structure_callback:
+                self.parent._structure_callback(sender, changeType, runtimeId)
+        except Exception as e:
+            print(f"Error in structure callback: {e}")
+        return 0 # S_OK
+
+class PropertyChangedEventHandler(comtypes.COMObject):
+    _com_interfaces_ = [UIA.IUIAutomationPropertyChangedEventHandler]
+
+    def __init__(self, parent):
+        self.parent = parent
+        super(PropertyChangedEventHandler, self).__init__()
+
+    def HandlePropertyChangedEvent(self, sender, propertyId, newValue):
+        try:
+            if self.parent._property_callback:
+                self.parent._property_callback(sender, propertyId, newValue)
+        except Exception as e:
+            print(f"Error in property callback: {e}")
+        return 0 # S_OK

windows_mcp/watchdog/service.py

@@ -0,0 +1,188 @@
+"""
+Unified WatchDog Service for monitoring UI Automation events.
+Allows single instantiation to handle multiple monitors (Focus, Structure) safely in one STA thread.
+"""
+from windows_mcp.uia.core import _AutomationClient
+from windows_mcp.uia.enums import TreeScope
+from threading import Thread, Event
+import comtypes.client
+import comtypes
+
+from .event_handlers import (
+    FocusChangedEventHandler,
+    StructureChangedEventHandler,
+    PropertyChangedEventHandler
+)
+
+class WatchDog:
+    def __init__(self):
+        self.uia_client = _AutomationClient.instance()
+        self.uia = self.uia_client.IUIAutomation
+        self.is_running = Event()
+        self.thread = None
+
+        # Callbacks
+        self._focus_callback = None
+        self._structure_callback = None
+        self._structure_element = None
+        self._property_callback = None
+        self._property_element = None
+        self._property_ids = None
+        
+        # Internal state for tracking active handlers
+        self._focus_handler = None
+        self._structure_handler = None
+        self._active_structure_element = None
+        self._property_handler = None
+        self._active_property_element = None
+        self._active_property_ids = None
+
+    def __enter__(self):
+        self.start()
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.stop()
+
+    def start(self):
+        """Start the watchdog service thread."""
+        if self.is_running.is_set():
+            return
+        self.is_running.set()
+        self.thread = Thread(target=self._run, name="WatchDogThread")
+        self.thread.daemon = True 
+        self.thread.start()
+
+    def stop(self):
+        """Stop the watchdog service thread."""
+        if not self.is_running.is_set():
+            return
+        self.is_running.clear()
+        if self.thread and self.thread.is_alive():
+            self.thread.join(timeout=2.0)
+
+    def set_focus_callback(self, callback):
+        """Set the callback for focus changes. Pass None to disable."""
+        self._focus_callback = callback
+
+    def set_structure_callback(self, callback, element=None):
+        """Set the callback for structure changes. Pass None to disable.
+        Optionally specify an element to watch (defaults to RootElement)."""
+        self._structure_callback = callback
+        self._structure_element = element
+
+    def set_property_callback(self, callback, element=None, property_ids=None):
+        """Set the callback for property changes. Pass None to disable.
+        Optionally specify an element to watch (defaults to RootElement) 
+        and a list of property IDs to monitor."""
+        self._property_callback = callback
+        self._property_element = element
+        self._property_ids = property_ids
+
+    def _run(self):
+        """Main event loop running in a dedicated STA thread."""
+        comtypes.CoInitialize()
+        try:
+            while self.is_running.is_set():
+                # --- Focus Monitoring ---
+                if self._focus_callback and not self._focus_handler:
+                    try:
+                        self._focus_handler = FocusChangedEventHandler(self)
+                        self.uia.AddFocusChangedEventHandler(None, self._focus_handler)
+                    except Exception as e:
+                        print(f"Failed to add focus handler: {e}")
+                elif not self._focus_callback and self._focus_handler:
+                    try:
+                        self.uia.RemoveFocusChangedEventHandler(self._focus_handler)
+                    except Exception as e:
+                        print(f"Failed to remove focus handler: {e}")
+                    self._focus_handler = None
+
+                # --- Structure Monitoring ---
+                # Check if we need to UNREGISTER because configuration changed or disabled
+                config_changed = (self._structure_element != self._active_structure_element)
+                
+                should_be_active = (self._structure_callback is not None)
+                is_active = (self._structure_handler is not None)
+
+                if is_active and (not should_be_active or config_changed):
+                    try:
+                        target = self._active_structure_element if self._active_structure_element else self.uia.GetRootElement()
+                        self.uia.RemoveStructureChangedEventHandler(target, self._structure_handler)
+                    except Exception as e:
+                        print(f"Failed to remove structure handler: {e}")
+                    self._structure_handler = None
+                    self._active_structure_element = None
+                    is_active = False
+
+                if should_be_active and not is_active:
+                    try:
+                        target = self._structure_element if self._structure_element else self.uia.GetRootElement()
+                        scope = TreeScope.TreeScope_Subtree
+                        
+                        self._structure_handler = StructureChangedEventHandler(self)
+                        self.uia.AddStructureChangedEventHandler(target, scope, None, self._structure_handler)
+                        self._active_structure_element = target
+                    except Exception as e:
+                        print(f"Failed to add structure handler: {e}")
+
+                # --- Property Monitoring ---
+                config_changed = (self._property_element != self._active_property_element) or \
+                               (self._property_ids != self._active_property_ids)
+                
+                should_be_active = (self._property_callback is not None)
+                is_active = (self._property_handler is not None)
+
+                if is_active and (not should_be_active or config_changed):
+                    try:
+                        target = self._active_property_element if self._active_property_element else self.uia.GetRootElement()
+                        self.uia.RemovePropertyChangedEventHandler(target, self._property_handler)
+                    except Exception as e:
+                        print(f"Failed to remove property handler: {e}")
+                    self._property_handler = None
+                    self._active_property_element = None
+                    self._active_property_ids = None
+                    is_active = False
+
+                if should_be_active and not is_active:
+                    try:
+                        target = self._property_element if self._property_element else self.uia.GetRootElement()
+                        scope = TreeScope.TreeScope_Subtree
+                        
+                        # Monitor common properties if none specified
+                        # 30005: Name, 30045: Value, 30093: LegacyIAccessibleVal, 30128: ToggleState
+                        p_ids = self._property_ids if self._property_ids else [30005, 30045, 30093, 30128]
+                        
+                        self._property_handler = PropertyChangedEventHandler(self)
+                        self.uia.AddPropertyChangedEventHandler(target, scope, None, self._property_handler, p_ids)
+                        
+                        self._active_property_element = target
+                        self._active_property_ids = p_ids
+                    except Exception as e:
+                        print(f"Failed to add property handler: {e}")
+
+                # Pump events for this thread
+                comtypes.client.PumpEvents(0.1)
+
+        except Exception as e:
+            print(f"WatchDogService died: {e}")
+        finally:
+            # Cleanup handlers on exit
+            if self._focus_handler:
+                try: 
+                    self.uia.RemoveFocusChangedEventHandler(self._focus_handler)
+                except: pass
+            
+            if self._structure_handler:
+                try:
+                    target = self._active_structure_element if self._active_structure_element else self.uia.GetRootElement()
+                    self.uia.RemoveStructureChangedEventHandler(target, self._structure_handler)
+                except: pass
+
+            if self._property_handler:
+                try:
+                    target = self._active_property_element if self._active_property_element else self.uia.GetRootElement()
+                    self.uia.RemovePropertyChangedEventHandler(target, self._property_handler)
+                except: pass
+            
+            comtypes.CoUninitialize()

{windows_mcp-0.5.7.dist-info → windows_mcp-0.5.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: windows-mcp
-Version: 0.5.7
+Version: 0.5.8
 Summary: Lightweight MCP Server for interacting with Windows Operating System.
 Project-URL: homepage, https://github.com/CursorTouch
 Author-email: Jeomon George <jeogeoalukka@gmail.com>
@@ -29,11 +29,10 @@ License-File: LICENSE.md
 Keywords: ai,ai agent,desktop,mcp,windows
 Requires-Python: >=3.13
 Requires-Dist: click>=8.2.1
-Requires-Dist: fastmcp>=2.8.1
+Requires-Dist: fastmcp>=2.14.2
 Requires-Dist: fuzzywuzzy>=0.18.0
 Requires-Dist: humancursor>=1.1.5
 Requires-Dist: ipykernel>=6.30.0
-Requires-Dist: live-inspect>=0.1.2
 Requires-Dist: markdownify>=1.1.0
 Requires-Dist: pdfplumber>=0.11.7
 Requires-Dist: pillow>=11.2.1
@@ -46,7 +45,6 @@ Requires-Dist: python-levenshtein>=0.27.1
 Requires-Dist: pywinauto>=0.6.9
 Requires-Dist: requests>=2.32.3
 Requires-Dist: tabulate>=0.9.0
-Requires-Dist: uiautomation>=2.0.24
 Requires-Dist: uuid7>=0.1.0
 Description-Content-Type: text/markdown
 
@@ -407,6 +405,8 @@ To disable telemetry, add the following to your MCP client configuration:
 }
 ```
 
+For detailed information on what data is collected and how it is handled, please refer to the [Telemetry and Data Privacy](SECURITY.md#telemetry-and-data-privacy) section in our Security Policy.
+
 ## 📝 Limitations
 
 - Selecting specific sections of the text in a paragraph, as the MCP is relying on a11y tree. (⌛ Working on it.)

windows_mcp-0.5.8.dist-info/RECORD

@@ -0,0 +1,26 @@
+windows_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+windows_mcp/__main__.py,sha256=2BMIGyyXCrWP-gz7xlq6ra4eQpcRK__oUQ1ao30frrQ,13013
+windows_mcp/analytics.py,sha256=aRzVcGVE--veRnScs9i99upUGlIThEIo5_uKcsjoeRY,6428
+windows_mcp/desktop/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+windows_mcp/desktop/config.py,sha256=LxMWSyYOUfMKzkk5ts46dV1NrAnukS2zHjTfyEKRc-A,364
+windows_mcp/desktop/service.py,sha256=LwWmhSkKPFu-HrN9HdHoufI1KgoutDh0S11fAYQdVUg,18032
+windows_mcp/desktop/views.py,sha256=8zdYAuq7LqO0hpsjNNyjoeVMwUUbvCTsyU8Z1sLCh08,1466
+windows_mcp/tree/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+windows_mcp/tree/config.py,sha256=p0z9Nz5-OMztz7q_f5Q9nqkALL6JnibSPh35HZF039k,960
+windows_mcp/tree/service.py,sha256=aAcRWDPQn9o3eH5NdJYZpo5b6ToEQgCWNsBzz52dOYI,31625
+windows_mcp/tree/utils.py,sha256=YaUqg_pK4pnii0Idzo0bwYcf7Xo3FQsxzwGNL7Qh1L4,893
+windows_mcp/tree/views.py,sha256=mh-Ls__Mj7YFy8GRGkpA8L9i4WYI9PcxCt_eOc2VplQ,3484
+windows_mcp/uia/__init__.py,sha256=ePdeJOHmTihMedolZUEL59nKDXsBVyofT80miP_5G-Y,93
+windows_mcp/uia/controls.py,sha256=p_H61k_9vSME6Qgvwah0aJhY6azrISmh676fNOlokOc,223625
+windows_mcp/uia/core.py,sha256=0JUl1IXu7qOPVytuYRLMlMwMRrhJT8yjwtYwnnDycTI,131691
+windows_mcp/uia/enums.py,sha256=DYcypTL8zkygdjZUezE2jgz9RMBM9AWe8ofvubLHRCg,83577
+windows_mcp/uia/events.py,sha256=9Xwcn-X1dy2t6WlbwDsIedcKq1SIIHGZ183qpohfFBk,4726
+windows_mcp/uia/patterns.py,sha256=CShOYqYMv7wdwDpNYZZZU3WZuLMvYhAAmnbzQ2Hx7aA,102692
+windows_mcp/watchdog/__init__.py,sha256=ExC350_KZXwTENsLQfESSPUJZfwsEjrAvGtLRPCqqjk,31
+windows_mcp/watchdog/event_handlers.py,sha256=E4CxuSMiGtffBPIR6RExKrsC4ngCei-4nT306_LxXFg,1880
+windows_mcp/watchdog/service.py,sha256=tV1-gCXy17JubZyBn7s1ahgn-XVFTGW3dfiB5UhID3s,8670
+windows_mcp-0.5.8.dist-info/METADATA,sha256=WJ-YTrDIDSjXlEjgcwXiBWLKErXOPjwFV_QoOMBIrAQ,14145
+windows_mcp-0.5.8.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+windows_mcp-0.5.8.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
+windows_mcp-0.5.8.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
+windows_mcp-0.5.8.dist-info/RECORD,,

windows_mcp-0.5.7.dist-info/RECORD

@@ -1,17 +0,0 @@
-windows_mcp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-windows_mcp/__main__.py,sha256=TryfZevJMW53N3m8qcQXDqhcYu2KAGCbZ6ibrJjfS2o,13280
-windows_mcp/analytics.py,sha256=kXQ2MEUaUnZUvq0nfm03YIN0kHcSq2z2dNFcFirO5Kc,6455
-windows_mcp/desktop/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-windows_mcp/desktop/config.py,sha256=7rAb64pmC275PpNRXVOyOf0Psu089AOosRC8T5kVGWA,384
-windows_mcp/desktop/service.py,sha256=gJO46Hs508tJrGKOaaFkx9SxtPhEucboI3eXeI3uro0,18486
-windows_mcp/desktop/views.py,sha256=_hZ5sfY1uWVi5mpaysVd-plwP_DT6SXpKa33Z8WT6gI,1523
-windows_mcp/tree/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-windows_mcp/tree/config.py,sha256=k-Mjo_yIn0d1AzcEW_bxiaXyBFxBZZSyy7hCNQ3XVp0,1010
-windows_mcp/tree/service.py,sha256=evK62AwhMwifpq6lRQCdrmC4DPt1-w_HSp8nUwXsCVQ,23566
-windows_mcp/tree/utils.py,sha256=6hbxdIQPrAY-I3jcHsRqodHlxboTQj2GnLA71bf1lqY,911
-windows_mcp/tree/views.py,sha256=K2hTBDicjP4p_tPIRTLZ8Sq3pGYhsDtZVIROAnMGTz4,3599
-windows_mcp-0.5.7.dist-info/METADATA,sha256=xbvl6qR69-KSMLqjga6gutc8goRD4IQ7jm_zyKPT2Ko,14019
-windows_mcp-0.5.7.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-windows_mcp-0.5.7.dist-info/entry_points.txt,sha256=wW8NcVQ_OJK5e5GemZSE_nOKyxfUtBPq2acFLszRwaw,58
-windows_mcp-0.5.7.dist-info/licenses/LICENSE.md,sha256=U1UM4Xi_IX-jHnHjGT0rETNia-Ck8gd92iSQMqQ6a8Y,1089
-windows_mcp-0.5.7.dist-info/RECORD,,