agent-cli 0.66.2__py3-none-any.whl → 0.67.0__py3-none-any.whl

agent_cli/_requirements/vad.txt

@@ -1,100 +1,39 @@
 # This file was autogenerated by uv via the following command:
 #    uv export --extra vad --no-dev --no-emit-project --no-hashes
-annotated-types==0.7.0
-    # via pydantic
 anyio==4.12.1
-    # via
-    #   google-genai
-    #   httpx
-    #   openai
-brotli==1.2.0 ; platform_python_implementation == 'CPython'
-    # via httpx
-brotlicffi==1.2.0.0 ; platform_python_implementation != 'CPython'
     # via httpx
 certifi==2026.1.4
     # via
     #   httpcore
     #   httpx
-    #   requests
-cffi==2.0.0
-    # via
-    #   brotlicffi
-    #   sounddevice
-charset-normalizer==3.4.4
-    # via requests
 click==8.3.1
-    # via
-    #   ddgs
-    #   typer
-colorama==0.4.6
-    # via
-    #   click
-    #   griffe
-    #   tqdm
+    # via typer
+colorama==0.4.6 ; sys_platform == 'win32'
+    # via click
 coloredlogs==15.0.1
     # via onnxruntime
-ddgs==9.10.0
-    # via pydantic-ai-slim
-distro==1.9.0
-    # via
-    #   google-genai
-    #   openai
 dotenv==0.9.9
     # via agent-cli
-fake-useragent==2.2.0
-    # via ddgs
 filelock==3.20.3
     # via torch
 flatbuffers==25.12.19
     # via onnxruntime
 fsspec==2026.1.0
     # via torch
-genai-prices==0.0.51
-    # via pydantic-ai-slim
-google-auth==2.47.0
-    # via
-    #   google-genai
-    #   pydantic-ai-slim
-google-genai==1.58.0
-    # via agent-cli
-griffe==1.15.0
-    # via pydantic-ai-slim
 h11==0.16.0
     # via httpcore
-h2==4.3.0
-    # via httpx
-hpack==4.1.0
-    # via h2
 httpcore==1.0.9
     # via httpx
 httpx==0.28.1
-    # via
-    #   agent-cli
-    #   ddgs
-    #   genai-prices
-    #   google-genai
-    #   openai
-    #   pydantic-ai-slim
-    #   pydantic-graph
+    # via agent-cli
 humanfriendly==10.0
     # via coloredlogs
-hyperframe==6.1.0
-    # via h2
 idna==3.11
     # via
     #   anyio
     #   httpx
-    #   requests
-importlib-metadata==8.7.1
-    # via opentelemetry-api
 jinja2==3.1.6
     # via torch
-jiter==0.12.0
-    # via openai
-logfire-api==4.18.0
-    # via pydantic-graph
-lxml==6.0.2
-    # via ddgs
 markdown-it-py==4.0.0
     # via rich
 markupsafe==3.0.3
@@ -150,43 +89,14 @@ nvidia-nvtx-cu12==12.8.90 ; platform_machine == 'x86_64' and sys_platform == 'li
     # via torch
 onnxruntime==1.20.1
     # via silero-vad
-openai==2.15.0
-    # via
-    #   agent-cli
-    #   pydantic-ai-slim
-opentelemetry-api==1.39.1
-    # via pydantic-ai-slim
 packaging==25.0
     # via
     #   onnxruntime
     #   silero-vad
-primp==0.15.0
-    # via ddgs
 protobuf==6.33.4
     # via onnxruntime
 psutil==7.2.1 ; sys_platform == 'win32'
     # via agent-cli
-pyasn1==0.6.1
-    # via
-    #   pyasn1-modules
-    #   rsa
-pyasn1-modules==0.4.2
-    # via google-auth
-pycparser==2.23 ; implementation_name != 'PyPy'
-    # via cffi
-pydantic==2.12.5
-    # via
-    #   genai-prices
-    #   google-genai
-    #   openai
-    #   pydantic-ai-slim
-    #   pydantic-graph
-pydantic-ai-slim==1.42.0
-    # via agent-cli
-pydantic-core==2.41.5
-    # via pydantic
-pydantic-graph==1.42.0
-    # via pydantic-ai-slim
 pygments==2.19.2
     # via rich
 pyperclip==1.11.0
@@ -195,20 +105,10 @@ pyreadline3==3.5.4 ; sys_platform == 'win32'
     # via humanfriendly
 python-dotenv==1.2.1
     # via dotenv
-regex==2026.1.15
-    # via tiktoken
-requests==2.32.5
-    # via
-    #   google-auth
-    #   google-genai
-    #   pydantic-ai-slim
-    #   tiktoken
 rich==14.2.0
     # via
     #   agent-cli
     #   typer
-rsa==4.9.1
-    # via google-auth
 setproctitle==1.3.7
     # via agent-cli
 setuptools==80.9.0 ; python_full_version >= '3.12'
@@ -217,30 +117,16 @@ shellingham==1.5.4
     # via typer
 silero-vad==6.2.0
     # via agent-cli
-sniffio==1.3.1
-    # via
-    #   google-genai
-    #   openai
-socksio==1.0.0
-    # via httpx
-sounddevice==0.5.3
-    # via agent-cli
 sympy==1.14.0
     # via
     #   onnxruntime
     #   torch
-tenacity==9.1.2
-    # via google-genai
-tiktoken==0.12.0
-    # via pydantic-ai-slim
 torch==2.9.1
     # via
     #   silero-vad
     #   torchaudio
 torchaudio==2.9.1
     # via silero-vad
-tqdm==4.67.1
-    # via openai
 triton==3.5.1 ; platform_machine == 'x86_64' and sys_platform == 'linux'
     # via torch
 typer==0.21.1
@@ -248,24 +134,5 @@ typer==0.21.1
 typing-extensions==4.15.0
     # via
     #   anyio
-    #   google-genai
-    #   openai
-    #   opentelemetry-api
-    #   pydantic
-    #   pydantic-core
     #   torch
     #   typer
-    #   typing-inspection
-typing-inspection==0.4.2
-    # via
-    #   pydantic
-    #   pydantic-ai-slim
-    #   pydantic-graph
-urllib3==2.3.0
-    # via requests
-websockets==15.0.1
-    # via google-genai
-wyoming==1.8.0
-    # via agent-cli
-zipp==3.23.0
-    # via importlib-metadata

agent_cli/agents/assistant.py

@@ -41,6 +41,7 @@ from agent_cli.agents._voice_agent_common import (
 from agent_cli.cli import app
 from agent_cli.core import audio, process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     InteractiveStopEvent,
     maybe_live,
@@ -254,6 +255,7 @@ async def _async_main(
 
 
 @app.command("assistant", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def assistant(
     *,
     # --- Provider Selection ---

agent_cli/agents/autocorrect.py

@@ -14,6 +14,7 @@ import typer
 
 from agent_cli import config, opts
 from agent_cli.cli import app
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     console,
     create_status,
@@ -209,6 +210,7 @@ async def _async_autocorrect(
 
 
 @app.command("autocorrect", rich_help_panel="Text Commands")
+@requires_extras("llm")
 def autocorrect(
     *,
     text: str | None = typer.Argument(

agent_cli/agents/chat.py

@@ -29,6 +29,7 @@ from agent_cli._tools import tools
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     InteractiveStopEvent,
     console,
@@ -374,6 +375,7 @@ async def _async_main(
 
 
 @app.command("chat", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def chat(
     *,
     # --- Provider Selection ---

agent_cli/agents/memory/add.py

@@ -13,6 +13,7 @@ import typer
 
 from agent_cli import opts
 from agent_cli.agents.memory import memory_app
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import console, print_command_line_args
 
 if TYPE_CHECKING:
@@ -110,6 +111,7 @@ def _write_memories(
 
 
 @memory_app.command("add")
+@requires_extras("memory")
 def add(
     memories: list[str] = typer.Argument(  # noqa: B008
         None,

agent_cli/agents/memory/proxy.py

@@ -10,10 +10,12 @@ from rich.logging import RichHandler
 
 from agent_cli import constants, opts
 from agent_cli.agents.memory import memory_app
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import console, print_command_line_args, print_error_message
 
 
 @memory_app.command("proxy")
+@requires_extras("memory")
 def proxy(
     memory_path: Path = typer.Option(  # noqa: B008
         "./memory_db",

agent_cli/agents/rag_proxy.py

@@ -10,6 +10,7 @@ from rich.logging import RichHandler
 
 from agent_cli import constants, opts
 from agent_cli.cli import app
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     console,
     print_command_line_args,
@@ -18,6 +19,7 @@ from agent_cli.core.utils import (
 
 
 @app.command("rag-proxy", rich_help_panel="Servers")
+@requires_extras("rag")
 def rag_proxy(
     docs_folder: Path = typer.Option(  # noqa: B008
         "./rag_docs",

agent_cli/agents/speak.py

@@ -14,6 +14,7 @@ from agent_cli import config, opts
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     enable_json_mode,
     get_clipboard_text,
@@ -80,6 +81,7 @@ async def _async_main(
 
 
 @app.command("speak", rich_help_panel="Text Commands")
+@requires_extras("audio")
 def speak(
     *,
     text: str | None = typer.Argument(

agent_cli/agents/transcribe.py

@@ -19,6 +19,7 @@ from agent_cli import config, opts
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     enable_json_mode,
     format_short_timedelta,
@@ -461,6 +462,7 @@ async def _async_main(  # noqa: PLR0912, PLR0915, C901
 
 
 @app.command("transcribe", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def transcribe(  # noqa: PLR0912
     *,
     extra_instructions: str | None = typer.Option(

agent_cli/agents/transcribe_daemon.py

@@ -25,6 +25,7 @@ from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import open_audio_stream, setup_devices, setup_input_stream
 from agent_cli.core.audio_format import check_ffmpeg_available, save_audio_as_mp3
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     console,
     print_command_line_args,
@@ -287,6 +288,7 @@ async def _daemon_loop(cfg: DaemonConfig) -> None:  # noqa: PLR0912, PLR0915
 
 
 @app.command("transcribe-daemon", rich_help_panel="Voice Commands")
+@requires_extras("audio", "vad", "llm")
 def transcribe_daemon(  # noqa: PLR0912
     *,
     # Daemon-specific options

agent_cli/agents/voice_edit.py

@@ -47,6 +47,7 @@ from agent_cli.agents._voice_agent_common import (
 from agent_cli.cli import app
 from agent_cli.core import process
 from agent_cli.core.audio import setup_devices
+from agent_cli.core.deps import requires_extras
 from agent_cli.core.utils import (
     enable_json_mode,
     get_clipboard_text,
@@ -173,6 +174,7 @@ async def _async_main(
 
 
 @app.command("voice-edit", rich_help_panel="Voice Commands")
+@requires_extras("audio", "llm")
 def voice_edit(
     *,
     # --- Provider Selection ---

agent_cli/core/deps.py

@@ -2,22 +2,138 @@
 
 from __future__ import annotations
 
+import functools
+import json
 from importlib.util import find_spec
+from pathlib import Path
+from typing import TYPE_CHECKING, TypeVar
 
+import typer
 
-def ensure_optional_dependencies(
-    required: dict[str, str],
-    *,
-    extra_name: str,
-    install_hint: str | None = None,
-) -> None:
-    """Ensure optional dependencies are present, otherwise raise ImportError."""
-    missing = [
-        pkg_name for module_name, pkg_name in required.items() if find_spec(module_name) is None
+from agent_cli.core.utils import print_error_message
+
+if TYPE_CHECKING:
+    from collections.abc import Callable
+
+F = TypeVar("F", bound="Callable[..., object]")
+
+# Load extras from JSON file
+_EXTRAS_FILE = Path(__file__).parent.parent / "_extras.json"
+EXTRAS: dict[str, tuple[str, list[str]]] = {
+    k: (v[0], v[1]) for k, v in json.loads(_EXTRAS_FILE.read_text()).items()
+}
+
+
+def _check_package_installed(pkg: str) -> bool:
+    """Check if a single package is installed."""
+    top_module = pkg.split(".")[0]
+    try:
+        return find_spec(top_module) is not None
+    except (ValueError, ModuleNotFoundError):
+        return False
+
+
+def check_extra_installed(extra: str) -> bool:
+    """Check if packages for an extra are installed using find_spec (no actual import).
+
+    Supports `|` syntax for alternatives: "piper|kokoro" means ANY of these extras.
+    For regular extras, ALL packages must be installed.
+    """
+    # Handle "extra1|extra2" syntax - any of these extras is sufficient
+    if "|" in extra:
+        return any(check_extra_installed(e) for e in extra.split("|"))
+
+    if extra not in EXTRAS:
+        return True  # Unknown extra, assume OK
+    _, packages = EXTRAS[extra]
+
+    # All packages must be installed
+    return all(_check_package_installed(pkg) for pkg in packages)
+
+
+def get_install_hint(extra: str) -> str:
+    """Get install command hint for an extra.
+
+    Supports `|` syntax for alternatives: "piper|kokoro" shows both options.
+    """
+    # Handle "extra1|extra2" syntax - show all options
+    if "|" in extra:
+        alternatives = extra.split("|")
+        options = []
+        for alt in alternatives:
+            desc, _ = EXTRAS.get(alt, ("", []))
+            options.append((alt, desc))
+
+        lines = ["This command requires one of:"]
+        for alt, desc in options:
+            if desc:
+                lines.append(f"  - '{alt}' ({desc})")
+            else:
+                lines.append(f"  - '{alt}'")
+        lines.append("")
+        lines.append("Install one with:")
+        for alt, _ in options:
+            lines.append(f'  uv tool install "agent-cli[{alt}]" -p 3.13')
+        lines.append("  # or")
+        for alt, _ in options:
+            lines.append(f"  agent-cli install-extras {alt}")
+        return "\n".join(lines)
+
+    desc, _ = EXTRAS.get(extra, ("", []))
+    lines = [
+        f"This command requires the '{extra}' extra",
     ]
-    if not missing:
-        return
+    if desc:
+        lines[0] += f" ({desc})"
+    lines[0] += "."
+    lines.append("")
+    lines.append("Install with:")
+    lines.append(f'  uv tool install "agent-cli[{extra}]" -p 3.13')
+    lines.append("  # or")
+    lines.append(f"  agent-cli install-extras {extra}")
+    return "\n".join(lines)
+
+
+def requires_extras(*extras: str) -> Callable[[F], F]:
+    """Decorator to declare required extras for a command.
+
+    When a required extra is missing, the decorator prints a helpful error
+    message and exits with code 1.
+
+    The decorator stores the required extras on the function for test validation.
+
+    Process management flags (--stop, --status, --toggle) skip the dependency
+    check since they just manage running processes without using the actual
+    dependencies.
+
+    Example:
+        @app.command("rag-proxy")
+        @requires_extras("rag")
+        def rag_proxy(...):
+            ...
+
+    """
+
+    def decorator(func: F) -> F:
+        # Store extras on function for test introspection
+        func._required_extras = extras  # type: ignore[attr-defined]
+
+        @functools.wraps(func)
+        def wrapper(*args: object, **kwargs: object) -> object:
+            # Skip dependency check for process management and info operations
+            # These don't need the actual dependencies, just manage processes or list info
+            if any(kwargs.get(flag) for flag in ("stop", "status", "toggle", "list_devices")):
+                return func(*args, **kwargs)
+
+            missing = [e for e in extras if not check_extra_installed(e)]
+            if missing:
+                for extra in missing:
+                    print_error_message(get_install_hint(extra))
+                raise typer.Exit(1)
+            return func(*args, **kwargs)
+
+        # Preserve the extras on wrapper too
+        wrapper._required_extras = extras  # type: ignore[attr-defined]
+        return wrapper  # type: ignore[return-value]
 
-    hint = install_hint or f"`pip install agent-cli[{extra_name}]`"
-    msg = f"Missing required dependencies for {extra_name}: {', '.join(missing)}. Please install with {hint}."
-    raise ImportError(msg)
+    return decorator

agent_cli/dev/skill/SKILL.md

@@ -13,10 +13,10 @@ If `agent-cli` is not available, install it first:
 
 ```bash
 # Install globally
-uv tool install agent-cli
+uv tool install agent-cli -p 3.13
 
 # Or run directly without installing
-uvx agent-cli dev new <branch-name> --agent --prompt "..."
+uvx --python 3.13 agent-cli dev new <branch-name> --agent --prompt "..."
 ```
 
 ## When to spawn parallel agents

agent_cli/docs_gen.py

@@ -16,7 +16,6 @@ Example usage in Markdown files:
 
 from __future__ import annotations
 
-from pathlib import Path
 from typing import Any, get_origin
 
 import click
@@ -369,47 +368,6 @@ def config_example(command_path: str | None = None) -> str:
     return "\n".join(lines)
 
 
-def readme_section(section_name: str) -> str:
-    """Extract a section from README.md for reuse in other docs.
-
-    Sections are marked with HTML comments like:
-        <!-- SECTION:section_name:START -->
-        Content here...
-        <!-- SECTION:section_name:END -->
-
-    Args:
-        section_name: The name of the section to extract (e.g., "why-i-built-this")
-
-    Returns:
-        The content between the section markers (without the markers themselves)
-
-    """
-    # Find the README.md relative to this module
-    readme_path = Path(__file__).parent.parent / "README.md"
-    if not readme_path.exists():
-        return f"*Could not find README.md at {readme_path}*"
-
-    content = readme_path.read_text()
-
-    # Look for section markers
-    start_marker = f"<!-- SECTION:{section_name}:START -->"
-    end_marker = f"<!-- SECTION:{section_name}:END -->"
-
-    start_idx = content.find(start_marker)
-    if start_idx == -1:
-        return f"*Section '{section_name}' not found in README.md*"
-
-    end_idx = content.find(end_marker, start_idx)
-    if end_idx == -1:
-        return f"*End marker for section '{section_name}' not found in README.md*"
-
-    # Extract content between markers (excluding the markers themselves)
-    section_content = content[start_idx + len(start_marker) : end_idx]
-
-    # Strip leading/trailing whitespace but preserve internal formatting
-    return section_content.strip()
-
-
 def all_options_for_docs(command_path: str) -> str:
     """Generate complete options documentation for a command page.
 

agent_cli/install/extras.py

@@ -12,20 +12,11 @@ from typing import Annotated
 import typer
 
 from agent_cli.cli import app
+from agent_cli.core.deps import EXTRAS as _EXTRAS_META
 from agent_cli.core.utils import console, print_error_message
 
-# Extra name -> description mapping (used for docs generation)
-EXTRAS: dict[str, str] = {
-    "rag": "RAG proxy (ChromaDB, embeddings)",
-    "memory": "Long-term memory proxy",
-    "vad": "Voice Activity Detection (silero-vad)",
-    "whisper": "Local Whisper ASR (faster-whisper)",
-    "whisper-mlx": "MLX Whisper for Apple Silicon",
-    "tts": "Local Piper TTS",
-    "tts-kokoro": "Kokoro neural TTS",
-    "server": "FastAPI server components",
-    "speed": "Audio speed adjustment (audiostretchy)",
-}
+# Extract descriptions from the centralized EXTRAS metadata
+EXTRAS: dict[str, str] = {name: desc for name, (desc, _) in _EXTRAS_META.items()}
 
 
 def _requirements_dir() -> Path:
@@ -72,8 +63,9 @@ def _install_via_uv_tool(extras: list[str]) -> bool:
     """Reinstall agent-cli via uv tool with the specified extras."""
     extras_str = ",".join(extras)
     package_spec = f"agent-cli[{extras_str}]"
-    console.print(f"Reinstalling via uv tool: [cyan]{package_spec}[/]")
-    cmd = ["uv", "tool", "install", package_spec, "--force"]
+    python_version = f"{sys.version_info.major}.{sys.version_info.minor}"
+    console.print(f"Reinstalling via uv tool: [cyan]{package_spec}[/] (Python {python_version})")
+    cmd = ["uv", "tool", "install", package_spec, "--force", "--python", python_version]
     result = subprocess.run(cmd, check=False)
     return result.returncode == 0
 

agent_cli/memory/__init__.py

@@ -2,23 +2,6 @@
 
 from __future__ import annotations
 
-from agent_cli.core.deps import ensure_optional_dependencies
-
-_REQUIRED_DEPS = {
-    "chromadb": "chromadb",
-    "fastapi": "fastapi",
-    "uvicorn": "uvicorn",
-    "onnxruntime": "onnxruntime",
-    "huggingface_hub": "huggingface-hub",
-    "transformers": "transformers",
-}
-
-ensure_optional_dependencies(
-    _REQUIRED_DEPS,
-    extra_name="memory",
-    install_hint="`pip install agent-cli[memory]` or `uv sync --extra memory`",
-)
-
-from agent_cli.memory.client import MemoryClient  # noqa: E402
+from agent_cli.memory.client import MemoryClient
 
 __all__ = ["MemoryClient"]

agent_cli/rag/__init__.py

@@ -1,22 +1,3 @@
 """RAG module."""
 
 from __future__ import annotations
-
-from agent_cli.core.deps import ensure_optional_dependencies
-
-_REQUIRED_DEPS = {
-    "chromadb": "chromadb",
-    "watchfiles": "watchfiles",
-    "markitdown": "markitdown",
-    "fastapi": "fastapi",
-    "uvicorn": "uvicorn",
-    "onnxruntime": "onnxruntime",
-    "huggingface_hub": "huggingface-hub",
-    "transformers": "transformers",
-}
-
-ensure_optional_dependencies(
-    _REQUIRED_DEPS,
-    extra_name="rag",
-    install_hint="`pip install agent-cli[rag]` or `uv sync --extra rag`",
-)