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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-tools
-Version: 1.19.1
+Version: 1.19.3
 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.3}/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.3"

{claude_code_tools-1.19.1 → claude_code_tools-1.19.3}/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.3}/claude_code_tools/voice_type/engine_parakeet.py

@@ -525,6 +525,25 @@ class ParakeetEngine:
         except Exception:
             pass
 
+    def _report_decode_time(self, audio_secs: float, elapsed: float) -> None:
+        """Log how long a decode took, and its speed vs. real time.
+
+        Makes latency visible per utterance: a healthy MLX/CPU decode
+        runs at many times real time, so a drop toward 1x (or below) is
+        an at-a-glance signal that something — memory pressure, thermal
+        throttling — is slowing transcription down.
+        """
+        if elapsed > 0:
+            self._report(
+                f"transcribed {audio_secs:.1f}s of audio in "
+                f"{elapsed:.2f}s ({audio_secs / elapsed:.0f}x realtime)"
+            )
+        else:
+            self._report(
+                f"transcribed {audio_secs:.1f}s of audio in "
+                f"{elapsed:.2f}s"
+            )
+
     def _safe_call(self, fn: Callable[[], None], name: str) -> None:
         """Invoke a client callback; never let its exception escape.
 
@@ -843,11 +862,13 @@ class ParakeetEngine:
         """
         secs = len(take) / SAMPLE_RATE
         self._report(f"transcribing {secs:.1f}s take...")
+        t0 = time.monotonic()
         try:
             text = self.transcribe(take, SAMPLE_RATE)
         except Exception as e:
             self._report(f"parakeet decode error: {e}")
             return
+        self._report_decode_time(secs, time.monotonic() - t0)
         if text:
             if self._closed.is_set():
                 return
@@ -949,11 +970,14 @@ class ParakeetEngine:
             self._vad.pop()
             if segment is None or segment.ndim != 1 or segment.size == 0:
                 continue
+            seg_secs = segment.size / SAMPLE_RATE
+            t0 = time.monotonic()
             try:
                 text = self.transcribe(segment, SAMPLE_RATE)
             except Exception as e:
                 self._report(f"parakeet decode error: {e}")
                 continue
+            self._report_decode_time(seg_secs, time.monotonic() - t0)
             if text:
                 self._safe_call(
                     lambda t=text: on_utterance(t), "on_utterance"

{claude_code_tools-1.19.1 → claude_code_tools-1.19.3}/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.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-code-tools"
-version = "1.19.1"
+version = "1.19.3"
 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.3"
 tag_format = "v$version"
 version_files = [
     "pyproject.toml:version",