agent-cli 0.70.5__py3-none-any.whl

agent_cli/config_cmd.py

@@ -0,0 +1,307 @@
+"""Configuration management commands for agent-cli."""
+
+from __future__ import annotations
+
+import json
+import os
+import platform
+import shlex
+import shutil
+import subprocess
+from importlib import resources
+from pathlib import Path  # noqa: TC003
+
+import typer
+
+from agent_cli.cli import app
+from agent_cli.config import CONFIG_PATHS, USER_CONFIG_PATH, _config_path
+from agent_cli.core.process import set_process_title
+from agent_cli.core.utils import console
+
+config_app = typer.Typer(
+    name="config",
+    help="Manage agent-cli configuration files.",
+    add_completion=True,
+    rich_markup_mode="markdown",
+    no_args_is_help=True,
+)
+app.add_typer(config_app, name="config", rich_help_panel="Configuration")
+
+
+@config_app.callback()
+def config_callback(ctx: typer.Context) -> None:
+    """Config command group callback."""
+    if ctx.invoked_subcommand is not None:
+        set_process_title(f"config-{ctx.invoked_subcommand}")
+
+
+# --- Config command options ---
+CONFIG_PATH_OPTION: Path | None = typer.Option(
+    None,
+    "--path",
+    "-p",
+    help="Path to config file. Uses auto-detection if not specified.",
+)
+CONFIG_PATH_INIT_OPTION: Path | None = typer.Option(
+    None,
+    "--path",
+    "-p",
+    help="Custom path for config file. Default: ~/.config/agent-cli/config.toml",
+)
+FORCE_OPTION: bool = typer.Option(
+    False,  # noqa: FBT003
+    "--force",
+    "-f",
+    help="Overwrite existing config without confirmation.",
+)
+RAW_OPTION: bool = typer.Option(
+    False,  # noqa: FBT003
+    "--raw",
+    "-r",
+    help="Output raw file contents (for copy-paste).",
+)
+JSON_OPTION: bool = typer.Option(
+    False,  # noqa: FBT003
+    "--json",
+    help="Output as JSON for automation.",
+)
+
+
+def _get_editor() -> str:
+    """Get the user's preferred editor.
+
+    Checks $EDITOR, then $VISUAL, then falls back to platform defaults.
+    """
+    for env_var in ("EDITOR", "VISUAL"):
+        editor = os.environ.get(env_var)
+        if editor:
+            return editor
+
+    if platform.system() == "Windows":
+        return "notepad"
+
+    # Try common editors on Unix-like systems
+    for editor in ("nano", "vim", "vi"):
+        if shutil.which(editor):
+            return editor
+
+    return "vi"
+
+
+def _generate_template() -> str:
+    """Generate a config template with all options commented out."""
+    header = """\
+# agent-cli configuration file
+# Generated by: agent-cli config init
+#
+# Uncomment and modify options as needed.
+# Keys use dashes to match command-line arguments.
+# Any option here can be overridden by a command-line argument.
+#
+# For full documentation, see: https://github.com/basnijholt/agent-cli
+"""
+
+    # Example config is bundled with the package
+    try:
+        template_file = resources.files(__package__) / "example-config.toml"
+        example_content = template_file.read_text(encoding="utf-8")
+    except FileNotFoundError as e:
+        console.print("[red]Example config template is missing from the package.[/red]")
+        console.print("Reinstall agent-cli or report this issue.")
+        raise typer.Exit(1) from e
+
+    lines = [header.rstrip()]
+    skip_header = True  # Skip the original file's header comments
+
+    for line in example_content.splitlines():
+        stripped = line.strip()
+
+        # Skip the original header comments (lines before first section)
+        if skip_header:
+            if stripped.startswith("["):
+                skip_header = False
+            else:
+                continue
+
+        # Keep section headers [defaults], [chat], etc.
+        if (
+            (stripped.startswith("[") and stripped.endswith("]"))
+            or stripped.startswith("#")
+            or not stripped
+        ):
+            lines.append(line)
+        # Comment out actual config values
+        else:
+            lines.append(f"# {line}")
+
+    return "\n".join(lines) + "\n"
+
+
+def _get_config_file(path: Path | None) -> Path | None:
+    """Resolve config path, or auto-detect from standard locations."""
+    if path:
+        return path.expanduser().resolve()
+    return _config_path(None)
+
+
+@config_app.command("init")
+def config_init(
+    path: Path | None = CONFIG_PATH_INIT_OPTION,
+    force: bool = FORCE_OPTION,
+) -> None:
+    """Create a new config file with all options commented out.
+
+    The generated config file serves as a template showing all available
+    options. Uncomment and modify the options you want to customize.
+    """
+    target_path = _get_config_file(path) or USER_CONFIG_PATH
+
+    if target_path.exists() and not force:
+        console.print(
+            f"[bold yellow]Config file already exists at:[/bold yellow] [cyan]{target_path}[/cyan]",
+        )
+        if not typer.confirm("Overwrite existing config file?"):
+            console.print("[dim]Aborted.[/dim]")
+            raise typer.Exit(0)
+
+    # Create parent directories
+    target_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Generate and write template
+    template_content = _generate_template()
+    target_path.write_text(template_content, encoding="utf-8")
+
+    console.print(f"[green]Config file created at:[/green] {target_path}")
+    console.print("\n[dim]Edit the file to customize your settings:[/dim]")
+    console.print("  [cyan]agent-cli config edit[/cyan]")
+
+
+@config_app.command("edit")
+def config_edit(
+    path: Path | None = CONFIG_PATH_OPTION,
+) -> None:
+    """Open the config file in your default editor.
+
+    The editor is determined by: $EDITOR > $VISUAL > platform default.
+    """
+    config_file = _get_config_file(path)
+
+    if config_file is None:
+        console.print("[yellow]No config file found.[/yellow]")
+        console.print(
+            "\nRun [bold cyan]agent-cli config init[/bold cyan] to create one.",
+        )
+        console.print("\nSearched locations:")
+        for p in CONFIG_PATHS:
+            console.print(f"  - {p}")
+        raise typer.Exit(1)
+
+    if not config_file.exists():
+        console.print("[yellow]Config file not found.[/yellow]")
+        console.print(f"\nProvided path does not exist: [cyan]{config_file}[/cyan]")
+        console.print(
+            "\nRun [bold cyan]agent-cli config init[/bold cyan] to create one.",
+        )
+        raise typer.Exit(1)
+
+    editor = _get_editor()
+    console.print(f"[dim]Opening {config_file} with {editor}...[/dim]")
+
+    try:
+        editor_cmd = shlex.split(editor, posix=os.name != "nt")
+    except ValueError as e:
+        console.print("[red]Invalid editor command. Check $EDITOR/$VISUAL.[/red]")
+        raise typer.Exit(1) from e
+
+    if not editor_cmd:
+        console.print("[red]Editor command is empty.[/red]")
+        raise typer.Exit(1)
+
+    try:
+        subprocess.run([*editor_cmd, str(config_file)], check=True)
+    except FileNotFoundError:
+        console.print(f"[red]Editor '{editor_cmd[0]}' not found.[/red]")
+        console.print("Set $EDITOR environment variable to your preferred editor.")
+        raise typer.Exit(1) from None
+    except subprocess.CalledProcessError as e:
+        console.print(f"[red]Editor exited with error code {e.returncode}[/red]")
+        raise typer.Exit(e.returncode) from None
+
+
+@config_app.command("show")
+def config_show(
+    path: Path | None = CONFIG_PATH_OPTION,
+    raw: bool = RAW_OPTION,
+    json_output: bool = JSON_OPTION,
+) -> None:
+    """Display the config file location and contents."""
+    config_file = _get_config_file(path)
+
+    if config_file is None:
+        if json_output:
+            print(
+                json.dumps(
+                    {
+                        "path": None,
+                        "exists": False,
+                        "content": None,
+                        "searched_locations": [str(p) for p in CONFIG_PATHS],
+                    },
+                ),
+            )
+            raise typer.Exit(0)
+        console.print("[yellow]No config file found.[/yellow]")
+        console.print("\nSearched locations:")
+        for p in CONFIG_PATHS:
+            status = "[green]exists[/green]" if p.exists() else "[dim]not found[/dim]"
+            console.print(f"  - {p} ({status})")
+        console.print(
+            "\nRun [bold cyan]agent-cli config init[/bold cyan] to create one.",
+        )
+        raise typer.Exit(0)
+
+    if not config_file.exists():
+        if json_output:
+            print(
+                json.dumps(
+                    {
+                        "path": str(config_file),
+                        "exists": False,
+                        "content": None,
+                    },
+                ),
+            )
+            raise typer.Exit(1)
+        console.print("[yellow]Config file not found.[/yellow]")
+        console.print(f"\nProvided path does not exist: [cyan]{config_file}[/cyan]")
+        console.print(
+            "\nRun [bold cyan]agent-cli config init[/bold cyan] to create one.",
+        )
+        raise typer.Exit(1)
+
+    content = config_file.read_text(encoding="utf-8")
+
+    if json_output:
+        print(
+            json.dumps(
+                {
+                    "path": str(config_file),
+                    "exists": True,
+                    "content": content,
+                },
+            ),
+        )
+        return
+
+    if raw:
+        print(content, end="")
+        return
+
+    from rich.syntax import Syntax  # noqa: PLC0415
+
+    console.print(f"[bold green]Config file:[/bold green] [cyan]{config_file}[/cyan]")
+    console.print()
+    syntax = Syntax(content, "toml", theme="monokai", line_numbers=True, word_wrap=True)
+    console.print(syntax)
+    console.print()
+    console.print("[dim]Tip: Use -r for copy-paste friendly output[/dim]")

agent_cli/constants.py

@@ -0,0 +1,27 @@
+"""Default configuration settings for the Agent CLI package."""
+
+from __future__ import annotations
+
+# --- Audio Configuration ---
+AUDIO_FORMAT_STR = "int16"  # sounddevice/numpy format
+AUDIO_FORMAT_WIDTH = 2  # 2 bytes (16-bit)
+AUDIO_CHANNELS = 1
+AUDIO_RATE = 16000
+AUDIO_CHUNK_SIZE = 1024
+WAV_HEADER_SIZE = 44  # Standard WAV header size in bytes
+
+# --- TTS Configuration ---
+PIPER_DEFAULT_SAMPLE_RATE = 22050  # Piper TTS default sample rate
+KOKORO_DEFAULT_SAMPLE_RATE = 24000  # Kokoro TTS default sample rate
+
+# Standard Wyoming audio configuration
+WYOMING_AUDIO_CONFIG = {
+    "rate": AUDIO_RATE,
+    "width": AUDIO_FORMAT_WIDTH,
+    "channels": AUDIO_CHANNELS,
+}
+
+# --- HTTP Defaults ---
+DEFAULT_OPENAI_BASE_URL = "https://api.openai.com/v1"
+DEFAULT_OPENAI_MODEL = "gpt-5-mini"
+DEFAULT_OPENAI_EMBEDDING_MODEL = "text-embedding-3-small"

agent_cli/core/__init__.py

@@ -0,0 +1 @@
+"""Core functionalities for the agent CLI."""