claude-code-tools 1.19.1__tar.gz → 1.19.2__tar.gz

{claude_code_tools-1.19.1 → claude_code_tools-1.19.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-tools
-Version: 1.19.1
+Version: 1.19.2
 Summary: Collection of tools for working with Claude Code
 License-File: LICENSE
 Requires-Python: >=3.11
@@ -26,6 +26,7 @@ Provides-Extra: voice
 Requires-Dist: moonshine-voice>=0.0.69; extra == 'voice'
 Requires-Dist: pynput>=1.7.7; extra == 'voice'
 Provides-Extra: voice-mlx
+Requires-Dist: numba>=0.61; extra == 'voice-mlx'
 Requires-Dist: numpy>=1.26.0; extra == 'voice-mlx'
 Requires-Dist: parakeet-mlx>=0.5.0; extra == 'voice-mlx'
 Requires-Dist: pynput>=1.7.7; extra == 'voice-mlx'

{claude_code_tools-1.19.1 → claude_code_tools-1.19.2}/claude_code_tools/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Tools - Collection of utilities for Claude Code."""
 
-__version__ = "1.19.1"
+__version__ = "1.19.2"

{claude_code_tools-1.19.1 → claude_code_tools-1.19.2}/claude_code_tools/voice_type/app.py

@@ -571,12 +571,20 @@ class VoiceTypeApp:
     def _start_hotkey_listener(self):  # noqa: ANN202
         """Start the global hotkey listener; invalid chords degrade.
 
+        Missing macOS permissions are reported LOUDLY first: a launch
+        context without Input Monitoring gets a dead event tap with no
+        error from the OS, which previously looked exactly like "the
+        hotkey just doesn't work".
+
         Each configured chord is validated independently, so one
         malformed OPTIONAL binding (paste/cancel) only disables itself
         — a typo in cancel_hotkey must never take the toggle hotkey
         (and with it all of toggle mode) down.
         """
-        from .hotkey import parse_hotkey, start_hotkeys
+        from .hotkey import check_permissions, parse_hotkey, start_hotkeys
+
+        for warning in check_permissions():
+            self._status(f"WARNING: {warning}")
 
         candidates: list[tuple[str, tuple]] = [
             ("toggle", (self.cfg.hotkey, self.toggle))

{claude_code_tools-1.19.1 → claude_code_tools-1.19.2}/claude_code_tools/voice_type/hotkey.py

@@ -303,6 +303,126 @@ def record_hotkey(timeout: float = 15.0) -> str | None:
     return result.get("chord")
 
 
+def check_permissions() -> list[str]:
+    """Report missing macOS permissions that silently kill hotkeys.
+
+    macOS attributes keystroke access to the LAUNCH CONTEXT (the
+    terminal app — or tmux, when launched inside tmux), and a context
+    without Input Monitoring gets a dead event tap with no error: the
+    app looks healthy but hotkeys simply never fire. Observed in the
+    field when a rebuilt venv/new launch context lost the prior grant.
+
+    Returns human-readable warnings (empty ONLY when every check ran
+    and every permission is granted — an unavailable module/symbol or
+    a probe that throws produces a "could not verify" warning instead
+    of silently passing) and asks macOS to register/prompt for the
+    missing access so the user can grant it in System Settings.
+    """
+    if sys.platform != "darwin":
+        return []
+    warnings: list[str] = []
+    warnings.extend(_check_input_monitoring())
+    warnings.extend(_check_accessibility())
+    return warnings
+
+
+def _check_input_monitoring() -> list[str]:
+    """Probe the Input Monitoring grant; never silently swallow failure."""
+    try:
+        import Quartz
+    except Exception as e:  # pragma: no cover - environment-specific
+        return [
+            "could not verify Input Monitoring permission (Quartz "
+            f"bridge unavailable: {e!r}) — hotkeys may silently not "
+            "work. Check that pyobjc is installed correctly."
+        ]
+    preflight = getattr(Quartz, "CGPreflightListenEventAccess", None)
+    if preflight is None:
+        return [
+            "could not verify Input Monitoring permission (this "
+            "macOS/pyobjc lacks CGPreflightListenEventAccess) — "
+            "hotkeys may silently not work."
+        ]
+    try:
+        granted = bool(preflight())
+    except Exception as e:
+        return [
+            "could not verify Input Monitoring permission (the "
+            f"CGPreflightListenEventAccess probe failed: {e!r}) — "
+            "hotkeys may silently not work."
+        ]
+    if granted:
+        return []
+    warnings = [
+        "Input Monitoring permission MISSING for this launch "
+        "context — hotkeys will NOT work. Grant it in System "
+        "Settings > Privacy & Security > Input Monitoring "
+        "(to your terminal app, and to tmux if you launched "
+        "inside tmux), then restart voice-type."
+    ]
+    # Nonfatal: registration just makes the app appear in System
+    # Settings so the user can flip the toggle — but a failure is
+    # still reported, never silently suppressed.
+    try:
+        Quartz.CGRequestListenEventAccess()
+    except Exception as e:
+        warnings.append(
+            "requesting Input Monitoring registration failed "
+            f"({e!r}); add your terminal app manually in System "
+            "Settings > Privacy & Security > Input Monitoring."
+        )
+    return warnings
+
+
+def _check_accessibility() -> list[str]:
+    """Probe the Accessibility grant; never silently swallow failure."""
+    try:
+        from ApplicationServices import AXIsProcessTrusted
+    except Exception as e:  # pragma: no cover - environment-specific
+        return [
+            "could not verify Accessibility permission "
+            f"(ApplicationServices bridge unavailable: {e!r}) — "
+            "typing into other apps may silently not work. Check "
+            "that pyobjc is installed correctly."
+        ]
+    try:
+        trusted = bool(AXIsProcessTrusted())
+    except Exception as e:
+        return [
+            "could not verify Accessibility permission (the "
+            f"AXIsProcessTrusted probe failed: {e!r}) — typing into "
+            "other apps may silently not work."
+        ]
+    if trusted:
+        return []
+    warnings = [
+        "Accessibility permission MISSING for this launch "
+        "context — typing into other apps will NOT work. "
+        "Grant it in System Settings > Privacy & Security > "
+        "Accessibility, then restart voice-type."
+    ]
+    # Nonfatal: the prompt request registers the app in System
+    # Settings (and may show the system grant dialog) so the user can
+    # flip the toggle — a failure is still reported, never silently
+    # suppressed.
+    try:
+        from ApplicationServices import (
+            AXIsProcessTrustedWithOptions,
+            kAXTrustedCheckOptionPrompt,
+        )
+
+        AXIsProcessTrustedWithOptions(
+            {kAXTrustedCheckOptionPrompt: True}
+        )
+    except Exception as e:
+        warnings.append(
+            "requesting Accessibility registration failed "
+            f"({e!r}); add your terminal app manually in System "
+            "Settings > Privacy & Security > Accessibility."
+        )
+    return warnings
+
+
 def start_hotkeys(bindings: list[tuple]):  # noqa: ANN201
     """Start one global listener for several chords; returns ``stop()``-able.
 

{claude_code_tools-1.19.1 → claude_code_tools-1.19.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-code-tools"
-version = "1.19.1"
+version = "1.19.2"
 description = "Collection of tools for working with Claude Code"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -44,6 +44,10 @@ voice-parakeet = [
 voice-mlx = [
     "pynput>=1.7.7",
     "parakeet-mlx>=0.5.0",
+    # Resolver guard: without it uv can backtrack through parakeet-mlx
+    # -> librosa -> numba to a 2021 llvmlite that cannot build on
+    # modern Python ("Cannot install on Python version 3.13...").
+    "numba>=0.61",
     # sherpa-onnx supplies the Silero VAD used for segmentation.
     "sherpa-onnx>=1.12.0,<1.13",
     "sherpa-onnx-core>=1.12.0,<1.13",
@@ -127,7 +131,7 @@ markers = [
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "1.19.1"
+version = "1.19.2"
 tag_format = "v$version"
 version_files = [
     "pyproject.toml:version",