agent-cli 0.101.0__tar.gz → 0.102.1__tar.gz

{agent_cli-0.101.0 → agent_cli-0.102.1}/.github/workflows/docker.yml

@@ -46,15 +46,15 @@ jobs:
           df -h
 
       - name: Checkout repository
-        uses: actions/checkout@v6.0.3
+        uses: actions/checkout@v7.0.1
         with:
           fetch-depth: 0  # Full history for version detection
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v4.1.0
+        uses: docker/setup-buildx-action@v4.2.0
 
       - name: Log in to Container Registry
-        uses: docker/login-action@v4.2.0
+        uses: docker/login-action@v4.5.1
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
@@ -71,7 +71,7 @@ jobs:
 
       - name: Extract metadata
         id: meta
-        uses: docker/metadata-action@v6.1.0
+        uses: docker/metadata-action@v6.2.0
         with:
           images: ${{ env.REGISTRY }}/${{ github.repository }}-${{ matrix.image }}
           tags: |
@@ -80,7 +80,7 @@ jobs:
             type=sha,suffix=-${{ matrix.suffix }}
 
       - name: Build and push
-        uses: docker/build-push-action@v7.2.0
+        uses: docker/build-push-action@v7.3.0
         with:
           context: .
           file: ${{ matrix.dockerfile }}
@@ -111,15 +111,15 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6.0.3
+        uses: actions/checkout@v7.0.1
         with:
           fetch-depth: 0  # Full history for version detection
 
       - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v4.1.0
+        uses: docker/setup-buildx-action@v4.2.0
 
       - name: Log in to Container Registry
-        uses: docker/login-action@v4.2.0
+        uses: docker/login-action@v4.5.1
         with:
           registry: ${{ env.REGISTRY }}
           username: ${{ github.actor }}
@@ -136,7 +136,7 @@ jobs:
 
       - name: Extract metadata
         id: meta
-        uses: docker/metadata-action@v6.1.0
+        uses: docker/metadata-action@v6.2.0
         with:
           images: ${{ env.REGISTRY }}/${{ github.repository }}-${{ matrix.image }}
           tags: |
@@ -145,7 +145,7 @@ jobs:
             type=sha
 
       - name: Build and push
-        uses: docker/build-push-action@v7.2.0
+        uses: docker/build-push-action@v7.3.0
         with:
           context: .
           file: ${{ matrix.dockerfile }}

{agent_cli-0.101.0 → agent_cli-0.102.1}/.github/workflows/docs.yml

@@ -27,12 +27,12 @@ jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v6.0.3
+      - uses: actions/checkout@v7.0.1
         with:
           lfs: true
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.2.0
+        uses: astral-sh/setup-uv@v8.3.2
 
       - name: Set up Python
         run: uv python install 3.12

{agent_cli-0.101.0 → agent_cli-0.102.1}/.github/workflows/markdown-code-runner.yml

@@ -11,18 +11,18 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
-        uses: actions/checkout@v6.0.3
+        uses: actions/checkout@v7.0.1
         with:
           persist-credentials: false
           fetch-depth: 0
 
       - name: Set up Python
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@v6.3.0
         with:
           python-version: "3.13.11"
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.2.0
+        uses: astral-sh/setup-uv@v8.3.2
 
       - name: Run markdown-code-runner
         env:

{agent_cli-0.101.0 → agent_cli-0.102.1}/.github/workflows/pytest.yml

@@ -18,16 +18,16 @@ jobs:
         python-version: ["3.11", "3.13"]
 
     steps:
-      - uses: actions/checkout@v6.0.3
+      - uses: actions/checkout@v7.0.1
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v6.2.0
+        uses: actions/setup-python@v6.3.0
         with:
           python-version: ${{ matrix.python-version }}
       - name: Install portaudio (Linux only)
         if: matrix.os == 'ubuntu-latest'
         run: sudo apt-get update && sudo apt-get install -y portaudio19-dev
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.2.0
+        uses: astral-sh/setup-uv@v8.3.2
       - name: Run macOS app Swift tests
         if: matrix.os == 'macos-latest' && matrix.python-version == '3.13'
         run: swift test --package-path macos/AgentCLI --enable-xctest

{agent_cli-0.101.0 → agent_cli-0.102.1}/.github/workflows/release-drafter.yml

@@ -9,6 +9,6 @@ jobs:
   update_release_draft:
     runs-on: ubuntu-latest
     steps:
-      - uses: release-drafter/release-drafter@v7.3.1
+      - uses: release-drafter/release-drafter@v7.6.0
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

{agent_cli-0.101.0 → agent_cli-0.102.1}/.github/workflows/release.yml

@@ -14,9 +14,9 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/checkout@v6.0.3
+      - uses: actions/checkout@v7.0.1
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.2.0
+        uses: astral-sh/setup-uv@v8.3.2
       - name: Build
         run: uv build
       - name: Publish package distributions to PyPI
@@ -29,9 +29,9 @@ jobs:
     permissions:
       contents: write
     steps:
-      - uses: actions/checkout@v6.0.3
+      - uses: actions/checkout@v7.0.1
       - name: Install uv
-        uses: astral-sh/setup-uv@v8.2.0
+        uses: astral-sh/setup-uv@v8.3.2
       - name: Import Developer ID certificate
         uses: apple-actions/import-codesign-certs@v7.0.0
         with:

{agent_cli-0.101.0 → agent_cli-0.102.1}/.pre-commit-config.yaml

@@ -11,13 +11,13 @@ repos:
       - id: end-of-file-fixer
       - id: mixed-line-ending
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.15.16"
+    rev: "v0.15.22"
     hooks:
       - id: ruff
         args: ["--fix"]
       - id: ruff-format
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: "v2.1.0"
+    rev: "v2.3.0"
     hooks:
       - id: mypy
         additional_dependencies: ["types-PyYAML"]

{agent_cli-0.101.0 → agent_cli-0.102.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-cli
-Version: 0.101.0
+Version: 0.102.1
 Summary: A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance.
 Project-URL: Homepage, https://github.com/basnijholt/agent-cli
 Author-email: Bas Nijholt <bas@nijho.lt>

agent_cli-0.102.1/agent_cli/__init__.py

@@ -0,0 +1,16 @@
+"""A suite of AI-powered command-line tools for text correction, audio transcription, and voice assistance."""
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    __version__: str
+
+
+def __getattr__(name: str) -> str:
+    """Resolve `__version__` lazily; reading distribution metadata costs ~29ms."""
+    if name == "__version__":
+        from importlib.metadata import version  # noqa: PLC0415
+
+        return version("agent-cli")
+    msg = f"module {__name__!r} has no attribute {name!r}"
+    raise AttributeError(msg)

{agent_cli-0.101.0 → agent_cli-0.102.1}/agent_cli/cli.py

@@ -9,7 +9,6 @@ from typing import Annotated, Any
 import typer
 from rich.table import Table
 
-from . import __version__
 from .config import load_config, normalize_provider_defaults
 from .core.process import set_process_title
 from .core.utils import console
@@ -49,6 +48,8 @@ app = typer.Typer(
 
 def _version_callback(value: bool) -> None:
     if value:
+        from . import __version__  # noqa: PLC0415
+
         path = Path(__file__).parent
         data = [
             ("agent-cli version", __version__),

{agent_cli-0.101.0 → agent_cli-0.102.1}/agent_cli/dev/project.py

@@ -89,6 +89,28 @@ def _unidep_cmd(subcommand: str) -> str | None:
     return None
 
 
+def _python_install_commands(install_args: str) -> list[str] | None:
+    """Build install commands using the best available Python installer.
+
+    Prefers uv (``uv venv`` creates ./.venv, which ``uv pip install`` then
+    targets from the working directory), then pip, then pip3. Returns None
+    when no installer is available.
+
+    Evidence: https://docs.astral.sh/uv/pip/environments/ - ``uv venv``
+    creates a virtual environment at .venv and ``uv pip install`` installs
+    into the .venv in the working directory. Note ``uv pip`` prefers an
+    activated environment (VIRTUAL_ENV) over ./.venv, which run_setup()
+    handles by clearing VIRTUAL_ENV from the subprocess environment.
+    """
+    if shutil.which("uv"):
+        return ["uv venv", f"uv pip install {install_args}"]
+    if shutil.which("pip"):
+        return [f"pip install {install_args}"]
+    if shutil.which("pip3"):
+        return [f"pip3 install {install_args}"]
+    return None
+
+
 def _detect_unidep_project(path: Path) -> ProjectType | None:
     """Detect unidep project and determine the appropriate install command.
 
@@ -143,6 +165,29 @@ def _detect_unidep_project(path: Path) -> ProjectType | None:
     return None
 
 
+def _detect_pip_install_project(path: Path) -> ProjectType | None:
+    """Detect pip-installable Python projects, skipped when no installer is available."""
+    if (path / "requirements.txt").exists():
+        commands = _python_install_commands("-r requirements.txt")
+        if commands is not None:
+            return ProjectType(
+                name="python-pip",
+                setup_commands=commands,
+                description="Python project with pip",
+            )
+
+    if (path / "pyproject.toml").exists():
+        commands = _python_install_commands("-e .")
+        if commands is not None:
+            return ProjectType(
+                name="python",
+                setup_commands=commands,
+                description="Python project",
+            )
+
+    return None
+
+
 def detect_project_type(path: Path) -> ProjectType | None:  # noqa: PLR0911
     """Detect the project type based on files present.
 
@@ -181,21 +226,10 @@ def detect_project_type(path: Path) -> ProjectType | None:  # noqa: PLR0911
             description="Python project with Poetry",
         )
 
-    # Python with pip/requirements.txt
-    if (path / "requirements.txt").exists():
-        return ProjectType(
-            name="python-pip",
-            setup_commands=["pip install -r requirements.txt"],
-            description="Python project with pip",
-        )
-
-    # Python with pyproject.toml (generic)
-    if (path / "pyproject.toml").exists():
-        return ProjectType(
-            name="python",
-            setup_commands=["pip install -e ."],
-            description="Python project",
-        )
+    # Python with pip/requirements.txt or generic pyproject.toml
+    pip_project = _detect_pip_install_project(path)
+    if pip_project is not None:
+        return pip_project
 
     # Node.js with pnpm
     if (path / "pnpm-lock.yaml").exists():

{agent_cli-0.101.0 → agent_cli-0.102.1}/agent_cli/server/cli.py

@@ -178,6 +178,15 @@ def _download_tts_models(
     console.print("[bold green]Download complete![/bold green]")
 
 
+def _default_tts_model(backend: str) -> str:
+    """Get the default model or voice for a resolved TTS backend."""
+    if backend == "kokoro":
+        from agent_cli.server.tts.backends.kokoro import DEFAULT_VOICE  # noqa: PLC0415
+
+        return DEFAULT_VOICE
+    return "en_US-lessac-medium"
+
+
 def _check_whisper_deps(backend: str, *, download_only: bool = False) -> None:
     """Check that Whisper dependencies are available."""
     _check_server_deps()
@@ -911,7 +920,7 @@ def tts_cmd(  # noqa: PLR0915
 
     # Default model based on backend (Kokoro auto-downloads from HuggingFace)
     if model is None:
-        model = ["kokoro"] if resolved_backend == "kokoro" else ["en_US-lessac-medium"]
+        model = [_default_tts_model(resolved_backend)]
 
     # Validate default model against model list
     if default_model is not None and default_model not in model:

{agent_cli-0.101.0 → agent_cli-0.102.1}/agent_cli/server/tts/backends/__init__.py

@@ -17,9 +17,10 @@ from agent_cli.server.tts.backends.base import (
 logger = logging.getLogger(__name__)
 
 BackendType = Literal["piper", "kokoro", "auto"]
+ResolvedBackendType = Literal["piper", "kokoro"]
 
 
-def detect_backend() -> Literal["piper", "kokoro"]:
+def detect_backend() -> ResolvedBackendType:
     """Detect the best backend for the current platform.
 
     Returns:
@@ -76,6 +77,7 @@ def create_backend(
 __all__ = [
     "BackendConfig",
     "BackendType",
+    "ResolvedBackendType",
     "SynthesisResult",
     "create_backend",
     "detect_backend",

{agent_cli-0.101.0 → agent_cli-0.102.1}/agent_cli/server/tts/model_manager.py

@@ -12,8 +12,10 @@ from agent_cli.server.model_manager import ModelConfig, ModelManager, ModelStats
 from agent_cli.server.tts.backends import (
     BackendConfig,
     BackendType,
+    ResolvedBackendType,
     SynthesisResult,
     create_backend,
+    detect_backend,
 )
 
 if TYPE_CHECKING:
@@ -40,16 +42,25 @@ class TTSModelManager:
     def __init__(self, config: TTSModelConfig) -> None:
         """Initialize the TTS model manager."""
         self.config = config
+        backend_type: ResolvedBackendType = (
+            detect_backend() if config.backend_type == "auto" else config.backend_type
+        )
+        self._backend_type = backend_type
         backend = create_backend(
             BackendConfig(
                 model_name=config.model_name,
                 device=config.device,
                 cache_dir=config.cache_dir,
             ),
-            backend_type=config.backend_type,
+            backend_type=backend_type,
         )
         self._manager = ModelManager(backend, config)
 
+    @property
+    def backend_type(self) -> ResolvedBackendType:
+        """Get the resolved backend type."""
+        return self._backend_type
+
     @property
     def stats(self) -> ModelStats:
         """Get the model statistics."""

{agent_cli-0.101.0 → agent_cli-0.102.1}/agent_cli/server/tts/wyoming_handler.py

@@ -21,6 +21,59 @@ if TYPE_CHECKING:
 
 logger = logging.getLogger(__name__)
 
+_KOKORO_LANGUAGE_TAGS = {
+    "a": "en-US",
+    "b": "en-GB",
+    "e": "es",
+    "f": "fr",
+    "h": "hi",
+    "i": "it",
+    "j": "ja",
+    "p": "pt-BR",
+    "z": "zh",
+}
+
+
+def _tts_voice(name: str, backend_type: str) -> TtsVoice:
+    """Build Wyoming voice metadata for a registered TTS model."""
+    if backend_type == "kokoro":
+        prefix, separator, voice_name = name.partition("_")
+        is_voice = (
+            separator == "_"
+            and prefix[:1] in _KOKORO_LANGUAGE_TAGS
+            and prefix[1:] in {"f", "m"}
+            and bool(voice_name)
+        )
+        if not is_voice:
+            from agent_cli.server.tts.backends.kokoro import DEFAULT_VOICE  # noqa: PLC0415
+
+            name = DEFAULT_VOICE
+        language = _KOKORO_LANGUAGE_TAGS[name[0]]
+        return TtsVoice(
+            name=name,
+            description=f"Kokoro TTS {name}",
+            attribution=Attribution(
+                name="Kokoro",
+                url="https://huggingface.co/hexgrad/Kokoro-82M",
+            ),
+            installed=True,
+            languages=[language],
+            version="1.0",
+        )
+
+    return TtsVoice(
+        name=name,
+        description=f"Piper TTS {name}",
+        attribution=Attribution(
+            name="Piper",
+            url="https://github.com/rhasspy/piper",
+        ),
+        installed=True,
+        # Extract language from model name (e.g., "en_US-lessac-medium" -> "en")
+        languages=[name.split("_", maxsplit=1)[0] if "_" in name else "en"],
+        version="1.0",
+    )
+
 
 class WyomingTTSHandler(AsyncEventHandler):
     """Wyoming event handler for TTS.
@@ -88,11 +141,12 @@ class WyomingTTSHandler(AsyncEventHandler):
 
         try:
             manager = self._registry.get_manager()
+            voice = synthesize.voice.name if synthesize.voice else None
 
             if manager.supports_streaming:
-                await self._synthesize_streaming(manager, text, synthesize.voice)
+                await self._synthesize_streaming(manager, text, voice)
             else:
-                await self._synthesize_complete(manager, text, synthesize.voice)
+                await self._synthesize_complete(manager, text, voice)
 
         except Exception:
             logger.exception("Wyoming synthesis failed")
@@ -194,17 +248,9 @@ class WyomingTTSHandler(AsyncEventHandler):
 
         # Get list of available models as voices
         voices = [
-            TtsVoice(
-                name=status.name,
-                description=f"Piper TTS {status.name}",
-                attribution=Attribution(
-                    name="Piper",
-                    url="https://github.com/rhasspy/piper",
-                ),
-                installed=True,
-                # Extract language from model name (e.g., "en_US-lessac-medium" -> "en")
-                languages=[status.name.split("_")[0] if "_" in status.name else "en"],
-                version="1.0",
+            _tts_voice(
+                status.name,
+                self._registry.get_manager(status.name).backend_type,
             )
             for status in self._registry.list_status()
         ]

{agent_cli-0.101.0 → agent_cli-0.102.1}/macos/AgentCLI/Package.resolved

@@ -14,8 +14,8 @@
       "kind" : "remoteSourceControl",
       "location" : "https://github.com/sparkle-project/Sparkle",
       "state" : {
-        "revision" : "d46d456107feacc80711b21847b82b07bd9fb46e",
-        "version" : "2.9.3"
+        "revision" : "b6496a74a087257ef5e6da1c5b29a447a60f5bd7",
+        "version" : "2.9.4"
       }
     }
   ],

{agent_cli-0.101.0 → agent_cli-0.102.1}/macos/AgentCLI/Package.swift

@@ -12,7 +12,7 @@ let package = Package(
     ],
     dependencies: [
         .package(url: "https://github.com/sindresorhus/KeyboardShortcuts", exact: "1.10.0"),
-        .package(url: "https://github.com/sparkle-project/Sparkle", exact: "2.9.3"),
+        .package(url: "https://github.com/sparkle-project/Sparkle", exact: "2.9.4"),
     ],
     targets: [
         .executableTarget(

{agent_cli-0.101.0 → agent_cli-0.102.1}/macos/AgentCLI/Sources/AgentCLI/AgentRuntime.swift

@@ -27,6 +27,29 @@ private final class UserInstalledCLICheckCache {
     }
 }
 
+/// Caches the login shell PATH lookup, which costs a full `zsh -lic` startup
+/// (~1s with a typical dotfiles setup) and would otherwise run on every command.
+/// Only successful lookups are cached, so a shell that fails once does not
+/// degrade PATH for the rest of the session.
+private final class LoginShellPATHCache {
+    private let lock = NSLock()
+    private var resolved: String?
+
+    func value(compute: () -> String?) -> String? {
+        lock.lock()
+        defer { lock.unlock() }
+        if let resolved {
+            return resolved
+        }
+        resolved = compute()
+        return resolved
+    }
+
+    func invalidate() {
+        lock.withLock { resolved = nil }
+    }
+}
+
 typealias AgentProcessRunner = (URL, [String], [String: String]) -> CommandResult
 typealias LocalhostConnector = (UInt16) -> Bool
 
@@ -58,6 +81,7 @@ struct AgentRuntime {
     private let processRunner: AgentProcessRunner
     private let localhostConnector: LocalhostConnector
     private let userInstalledCLICheckCache: UserInstalledCLICheckCache
+    private let loginShellPATHCache: LoginShellPATHCache
     private let whisperReadyTimeout: TimeInterval
     let appSupportURL: URL
     let bundledUVURL: URL
@@ -90,6 +114,7 @@ struct AgentRuntime {
         self.processRunner = processRunner
         self.localhostConnector = localhostConnector
         self.userInstalledCLICheckCache = UserInstalledCLICheckCache()
+        self.loginShellPATHCache = LoginShellPATHCache()
         self.whisperReadyTimeout = whisperReadyTimeout
 
         if let override = environment["AGENTCLI_APP_SUPPORT_DIR"], !override.isEmpty {
@@ -343,6 +368,9 @@ struct AgentRuntime {
         progress: AgentBootstrapProgress = { _ in }
     ) -> CommandResult {
         let mode = runtimeMode
+        if force {
+            loginShellPATHCache.invalidate()
+        }
         do {
             try prepareDirectories(for: mode)
         } catch {
@@ -647,7 +675,7 @@ struct AgentRuntime {
         let existingPATH = environment["PATH"] ?? "/usr/bin:/bin:/usr/sbin:/sbin"
         environment["PATH"] = userInstalledCLIPath(
             existingPATH: existingPATH,
-            loginShellPATH: Self.loginShellPATH(environment: baseEnvironment)
+            loginShellPATH: loginShellPATHCache.value { loginShellPATH() }
         )
         return environment
     }
@@ -708,14 +736,14 @@ struct AgentRuntime {
             .joined(separator: ":")
     }
 
-    private static func loginShellPATH(environment: [String: String]) -> String? {
-        let shellPath = environment["SHELL"].flatMap { $0.isEmpty ? nil : $0 } ?? "/bin/zsh"
-        guard FileManager.default.isExecutableFile(atPath: shellPath) else { return nil }
+    private func loginShellPATH() -> String? {
+        let shellPath = baseEnvironment["SHELL"].flatMap { $0.isEmpty ? nil : $0 } ?? "/bin/zsh"
+        guard fileManager.isExecutableFile(atPath: shellPath) else { return nil }
 
-        let result = runProcess(
-            executableURL: URL(fileURLWithPath: shellPath),
-            arguments: ["-lic", "printf '%s\\n' \"$PATH\""],
-            environment: environment
+        let result = processRunner(
+            URL(fileURLWithPath: shellPath),
+            ["-lic", "printf '%s\\n' \"$PATH\""],
+            baseEnvironment
         )
         guard result.exitCode == 0 else { return nil }