cade-cli 0.5.0__tar.gz → 0.8.0__tar.gz

{cade_cli-0.5.0 → cade_cli-0.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: cade-cli
-Version: 0.5.0
+Version: 0.8.0
 Summary: Cade - The CLI Agent from Arcade.dev
 Project-URL: Homepage, https://arcade.dev
 Project-URL: Documentation, https://docs.arcade.dev
@@ -43,11 +43,13 @@ Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Code Generators
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
+Requires-Dist: agent-library<1.0.0,>=0.11.0
 Requires-Dist: anthropic<1.0.0,>=0.34.0
 Requires-Dist: arcade-core<5.0.0,>=4.1.0
 Requires-Dist: arcade-mcp-server>=1.0.0
 Requires-Dist: arcade-tdk>=2.0.0
 Requires-Dist: authlib<2.0.0,>=1.6.0
+Requires-Dist: filelock<4.0.0,>=3.0.0
 Requires-Dist: httpx<1.0.0,>=0.27.0
 Requires-Dist: openai<2.0.0,>=1.0.0
 Requires-Dist: prompt-toolkit<4.0.0,>=3.0.52
@@ -71,6 +73,12 @@ Requires-Dist: accelerate>=0.27.0; extra == 'training'
 Requires-Dist: safetensors>=0.4.2; extra == 'training'
 Requires-Dist: torch>=2.1.0; extra == 'training'
 Requires-Dist: transformers>=4.38.0; extra == 'training'
+Provides-Extra: voice
+Requires-Dist: mlx-audio<0.4.0,>=0.2.0; extra == 'voice'
+Requires-Dist: mlx-whisper>=0.1.0; extra == 'voice'
+Requires-Dist: numpy>=1.24.0; extra == 'voice'
+Requires-Dist: sounddevice>=0.4.0; extra == 'voice'
+Requires-Dist: webrtcvad>=2.0.10; extra == 'voice'
 Description-Content-Type: text/markdown
 
 # Cade

{cade_cli-0.5.0 → cade_cli-0.8.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "cade-cli"
-version = "0.5.0"
+version = "0.8.0"
 description = "Cade - The CLI Agent from Arcade.dev"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -39,6 +39,8 @@ dependencies = [
     "prompt-toolkit>=3.0.52,<4.0.0",
     "tiktoken>=0.11.0,<1.0.0",
     "httpx>=0.27.0,<1.0.0",
+    "filelock>=3.0.0,<4.0.0",
+    "agent-library>=0.11.0,<1.0.0",
 ]
 
 [project.urls]
@@ -50,6 +52,7 @@ Changelog = "https://github.com/arcadeai-labs/cade/releases"
 
 [project.scripts]
 cade = "cadecoder.cli.app:app"
+cade-mcp-local = "cade_mcp_local:main"
 
 [project.optional-dependencies]
 dev = [
@@ -60,6 +63,13 @@ dev = [
     "pytest-cov>=4.0.0,<5.0.0",
     "mypy>=1.10.0,<2.0.0",
 ]
+voice = [
+    "mlx-audio>=0.2.0,<0.4.0",
+    "mlx-whisper>=0.1.0",
+    "sounddevice>=0.4.0",
+    "numpy>=1.24.0",
+    "webrtcvad>=2.0.10",
+]
 training = [
     "torch>=2.1.0",
     "transformers>=4.38.0",
@@ -75,10 +85,15 @@ build-backend = "hatchling.build"
 allow-direct-references = true
 
 [tool.hatch.build.targets.sdist]
-include = ["src/cadecoder"]
+include = ["src/cadecoder", "src/cade_mcp_local"]
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/cadecoder"]
+packages = ["src/cadecoder", "src/cade_mcp_local"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
 
 [tool.ruff]
 line-length = 100
@@ -110,7 +125,7 @@ disable_error_code = [
     "return-value",
     "annotation-unchecked",
 ]
-files = ["src/cadecoder"]
+files = ["src/cadecoder", "src/cade_mcp_local"]
 
 [tool.mypy-ulid]
 ignore_missing_imports = true

cade_cli-0.8.0/src/cade_mcp_local/__init__.py

@@ -0,0 +1,72 @@
+"""Local MCP server for Cade CLI.
+
+This package provides local filesystem, git, search, and shell tools
+served via the MCP (Model Context Protocol) over stdio.
+
+Usage:
+    # As a command-line tool (entry point)
+    $ cade-mcp-local
+
+    # As a Python module
+    $ python -m cade_mcp_local
+
+    # Programmatically
+    from cade_mcp_local import main
+    main()
+"""
+
+from cade_mcp_local.config import (
+    DEFAULT_IGNORE_PATTERNS,
+    DEFAULT_TIMEOUT,
+    MAX_LIST_DEPTH,
+    MAX_LIST_RESULTS,
+    MAX_PREVIEW_BYTES,
+    get_project_root,
+    reset_config,
+)
+from cade_mcp_local.errors import (
+    CommandExecutionError,
+    CommandTimeoutError,
+    FileOperationError,
+    GitOperationError,
+    InvalidInputError,
+    PathNotFoundError,
+    PathSecurityError,
+    SearchError,
+)
+from cade_mcp_local.server import app, create_app
+
+
+def main() -> None:
+    """Run the MCP server.
+
+    This is the entry point for the `cade-mcp-local` command.
+    """
+    app.run()
+
+
+__all__ = [
+    # Entry point
+    "main",
+    "app",
+    "create_app",
+    # Configuration
+    "get_project_root",
+    "reset_config",
+    "DEFAULT_IGNORE_PATTERNS",
+    "DEFAULT_TIMEOUT",
+    "MAX_LIST_DEPTH",
+    "MAX_LIST_RESULTS",
+    "MAX_PREVIEW_BYTES",
+    # Errors
+    "PathNotFoundError",
+    "PathSecurityError",
+    "InvalidInputError",
+    "CommandTimeoutError",
+    "CommandExecutionError",
+    "GitOperationError",
+    "SearchError",
+    "FileOperationError",
+]
+
+__version__ = "0.8.0"

cade_cli-0.8.0/src/cade_mcp_local/__main__.py

@@ -0,0 +1,6 @@
+"""Allow running as: python -m cade_mcp_local"""
+
+from cade_mcp_local import main
+
+if __name__ == "__main__":
+    main()

cade_cli-0.8.0/src/cade_mcp_local/config.py

@@ -0,0 +1,68 @@
+"""Runtime configuration for the local MCP server.
+
+Configuration is resolved lazily at runtime, not at import time.
+This allows proper testing and correct behavior when installed as a package.
+"""
+
+import os
+import pathlib
+from functools import lru_cache
+
+
+@lru_cache(maxsize=1)
+def get_project_root() -> pathlib.Path:
+    """Get the project root directory.
+
+    Resolution order:
+    1. CADE_PROJECT_ROOT environment variable (set by parent process)
+    2. Current working directory
+
+    This is cached for performance but can be reset with reset_config().
+
+    Returns:
+        Resolved path to the project root directory.
+    """
+    if root := os.environ.get("CADE_PROJECT_ROOT"):
+        return pathlib.Path(root).resolve()
+    return pathlib.Path.cwd().resolve()
+
+
+def reset_config() -> None:
+    """Clear cached configuration.
+
+    Call this when:
+    - The working directory has changed
+    - CADE_PROJECT_ROOT environment variable has changed
+    - During testing to ensure isolation
+    """
+    get_project_root.cache_clear()
+
+
+# Default ignore patterns for file listings and searches
+DEFAULT_IGNORE_PATTERNS: list[str] = [
+    ".git",
+    "__pycache__",
+    "node_modules",
+    ".venv",
+    "venv",
+    ".mypy_cache",
+    ".pytest_cache",
+    "*.pyc",
+    ".DS_Store",
+    "*.egg-info",
+    "dist",
+    "build",
+    ".tox",
+    ".coverage",
+    "htmlcov",
+    ".idea",
+    ".vscode",
+    ".cursor",
+    ".claude",
+]
+
+# File operation limits
+MAX_LIST_DEPTH: int = 10
+MAX_LIST_RESULTS: int = 1000
+MAX_PREVIEW_BYTES: int = 100_000
+DEFAULT_TIMEOUT: int = 60

cade_cli-0.8.0/src/cade_mcp_local/errors.py

@@ -0,0 +1,122 @@
+"""Error types for the local MCP server.
+
+Uses the arcade-tdk error hierarchy:
+- FatalToolError: Non-recoverable errors (bad input, missing files, security)
+- RetryableToolError: Transient errors that may succeed on retry (timeouts)
+"""
+
+from arcade_tdk.errors import FatalToolError, RetryableToolError
+
+
+class PathNotFoundError(FatalToolError):
+    """Raised when a requested path does not exist.
+
+    Examples:
+        - File to read doesn't exist
+        - Directory to list doesn't exist
+        - Working directory for command doesn't exist
+    """
+
+    def __init__(self, path: str, message: str | None = None):
+        self.path = path
+        super().__init__(message or f"Path not found: {path}")
+
+
+class PathSecurityError(FatalToolError):
+    """Raised when a path operation is denied for security reasons.
+
+    Examples:
+        - Attempting to write outside project root
+        - Attempting to access restricted paths
+    """
+
+    def __init__(self, path: str, reason: str | None = None):
+        self.path = path
+        msg = f"Access denied: {path}"
+        if reason:
+            msg += f" ({reason})"
+        super().__init__(msg)
+
+
+class InvalidInputError(FatalToolError):
+    """Raised when tool input is invalid.
+
+    Examples:
+        - Empty search pattern
+        - Invalid line number
+        - Malformed arguments
+    """
+
+    def __init__(self, parameter: str, message: str):
+        self.parameter = parameter
+        super().__init__(f"Invalid {parameter}: {message}")
+
+
+class CommandTimeoutError(RetryableToolError):
+    """Raised when a command or operation times out.
+
+    This is retryable because timeouts may be transient.
+    """
+
+    def __init__(self, command: str, timeout_seconds: int):
+        self.command = command
+        self.timeout_seconds = timeout_seconds
+        super().__init__(f"Command timed out after {timeout_seconds}s: {command[:50]}...")
+
+
+class CommandExecutionError(FatalToolError):
+    """Raised when command execution fails.
+
+    Examples:
+        - Shell command returns non-zero exit code with error
+        - Command binary not found
+        - Permission denied
+    """
+
+    def __init__(self, command: str, message: str, exit_code: int | None = None):
+        self.command = command
+        self.exit_code = exit_code
+        detail = f" (exit code: {exit_code})" if exit_code is not None else ""
+        super().__init__(f"Command failed{detail}: {message}")
+
+
+class GitOperationError(FatalToolError):
+    """Raised when a git operation fails.
+
+    Examples:
+        - Not a git repository
+        - Branch doesn't exist
+        - Merge conflict
+    """
+
+    def __init__(self, operation: str, message: str):
+        self.operation = operation
+        super().__init__(f"Git {operation} failed: {message}")
+
+
+class SearchError(FatalToolError):
+    """Raised when a search operation fails.
+
+    Examples:
+        - Invalid regex pattern
+        - Search tool not installed
+    """
+
+    def __init__(self, tool: str, message: str):
+        self.tool = tool
+        super().__init__(f"Search failed ({tool}): {message}")
+
+
+class FileOperationError(FatalToolError):
+    """Raised when a file operation fails.
+
+    Examples:
+        - Cannot read file (encoding issues)
+        - Cannot write file (permissions)
+        - Edit operation failed
+    """
+
+    def __init__(self, operation: str, path: str, message: str):
+        self.operation = operation
+        self.path = path
+        super().__init__(f"Failed to {operation} '{path}': {message}")

cade_cli-0.8.0/src/cade_mcp_local/server.py

@@ -0,0 +1,80 @@
+"""MCP server setup for local tools.
+
+This module creates and configures the MCP server with all local tools.
+These tools operate ONLY on the local filesystem and system where the cade
+process is running.
+"""
+
+# Suppress arcade_mcp_server DEBUG logs (e.g. "Added tool: X") before the library loads.
+# When run via stdio subprocess, parent may also pass LOGURU_LEVEL in env.
+import os
+
+os.environ.setdefault("LOGURU_LEVEL", "WARNING")
+
+from arcade_mcp_server import MCPApp
+
+from cade_mcp_local.tools import (
+    bash_tool,
+    edit_tool,
+    git_tool,
+    list_files_tool,
+    read_file_tool,
+    retrieve_tool_result_tool,
+    search_recent_context_tool,
+    search_tool,
+    tool_schema_tool,
+    write_file_tool,
+)
+
+# Server instructions explaining when to use Local tools
+SERVER_INSTRUCTIONS = """
+Local tools operate ONLY on the local filesystem and system where the cade process
+is running. Use these tools when you need to:
+
+- Read, write, or edit files on the same machine as the running cade process
+- Search code in the local project directory
+- Execute shell commands or bash scripts locally
+- Check git status, diff, log, or branches of the local repository
+- Search compacted context backups stored locally
+
+Do NOT use these tools for operations on remote systems, cloud resources, or
+external services. For those, use the appropriate remote/cloud tools instead.
+"""
+
+
+def create_app() -> MCPApp:
+    """Create and configure the MCP application with all local tools."""
+    app = MCPApp("Local", "stdio", log_level="info")
+
+    # Set server instructions
+    app.instructions = SERVER_INSTRUCTIONS
+
+    # Filesystem tools
+    app.add_tool(list_files_tool)
+    app.add_tool(read_file_tool)
+    app.add_tool(write_file_tool)
+    app.add_tool(edit_tool)
+
+    # Shell tool
+    app.add_tool(bash_tool)
+
+    # Search tool (consolidated: ripgrep with grep fallback)
+    app.add_tool(search_tool)
+
+    # Git tool (consolidated: status, diff, log, branch)
+    app.add_tool(git_tool)
+
+    # Context tools
+    app.add_tool(search_recent_context_tool)
+
+    # Tool result retrieval (consolidated: full, search, summarize, lines, json, list)
+    app.add_tool(retrieve_tool_result_tool)
+
+    # Tool schema tool (consolidated: list + get)
+    app.add_tool(tool_schema_tool)
+
+    return app
+
+
+# Global app instance for the entry point
+app = create_app()

cade_cli-0.8.0/src/cade_mcp_local/tools/__init__.py

@@ -0,0 +1,47 @@
+"""Local MCP tools for filesystem, git, search, shell, and context operations.
+
+These tools operate ONLY on the local filesystem and system where the cade process
+is running. Use these tools when you need to read, write, search, or execute
+commands on the same machine as the running cade process.
+"""
+
+from cade_mcp_local.tools.context import search_recent_context_tool
+from cade_mcp_local.tools.filesystem import (
+    edit_tool,
+    insert_text_tool,
+    list_files_tool,
+    read_file_tool,
+    write_file_tool,
+)
+from cade_mcp_local.tools.git import (
+    get_current_branch_name,
+    get_status,
+    git_tool,
+)
+from cade_mcp_local.tools.search import search_tool
+from cade_mcp_local.tools.shell import bash_tool
+from cade_mcp_local.tools.tool_results import retrieve_tool_result_tool
+from cade_mcp_local.tools.tool_schemas import tool_schema_tool
+
+__all__ = [
+    # Filesystem
+    "list_files_tool",
+    "read_file_tool",
+    "write_file_tool",
+    "edit_tool",
+    "insert_text_tool",
+    # Git
+    "git_tool",
+    "get_current_branch_name",
+    "get_status",
+    # Search
+    "search_tool",
+    # Shell
+    "bash_tool",
+    # Context
+    "search_recent_context_tool",
+    # Tool Results
+    "retrieve_tool_result_tool",
+    # Tool Schemas
+    "tool_schema_tool",
+]