ayechat 0.1.5__tar.gz

ayechat-0.1.5/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Acrotron
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ayechat-0.1.5/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: ayechat
+Version: 0.1.5
+Summary: Aye: Terminal-first AI Code Generator
+Author-email: "Acrotron, Inc." <info@acrotron.com>
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer[all]>=0.9.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: keyring>=24.0.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Dynamic: license-file
+
+# aye
+Aye: AI‑powered coding assistant for the terminal
+
+**Aye** is a terminal‑only AI assistant that:
+
+* generates code from natural‑language prompts,
+* automatically snapshots the target file before each change,
+* lets you list, view, and revert those snapshots (`aye snap …`),
+* uses a simple token‑based authentication model (no Cognito required).
+
+---
+
+## Quick start
+
+```bash
+# Install from PyPI
+pip install aye-cli
+
+# Authenticate (you’ll get a token from your backend)
+aye login
+
+# One‑shot generation
+aye generate "create a Python function that parses CSV" -f utils.py
+
+# Interactive chat (optional)
+aye chat -f utils.py
+
+# Undo / snapshot utilities
+aye snap list utils.py
+aye snap show utils.py 20241012T153045
+aye snap revert utils.py 20241012T153045
+
+Development
+
+# Clone the repo
+git clone https://github.com/yourorg/aye.git
+cd aye
+
+# Create a virtual environment
+python -m venv .venv && source .venv/bin/activate
+
+# Install in editable mode with dev deps
+pip install -e .[dev]
+
+# Run the test suite
+pytest -q
+
+Packaging & distribution
+
+# Build a wheel and source distribution
+python -m build
+
+# Install the wheel locally for a clean test
+pip install dist/aye_cli-0.1.0-py3-none-any.whl
+
+The console script aye will be available on the PATH.
+License
+
+MIT – see the LICENSE file (or the license header in pyproject.toml).
+Contributing
+
+Feel free to open issues or submit pull requests.
+All contributions are welcome; just follow the usual GitHub workflow.
+
+

ayechat-0.1.5/README.md

@@ -0,0 +1,65 @@
+# aye
+Aye: AI‑powered coding assistant for the terminal
+
+**Aye** is a terminal‑only AI assistant that:
+
+* generates code from natural‑language prompts,
+* automatically snapshots the target file before each change,
+* lets you list, view, and revert those snapshots (`aye snap …`),
+* uses a simple token‑based authentication model (no Cognito required).
+
+---
+
+## Quick start
+
+```bash
+# Install from PyPI
+pip install aye-cli
+
+# Authenticate (you’ll get a token from your backend)
+aye login
+
+# One‑shot generation
+aye generate "create a Python function that parses CSV" -f utils.py
+
+# Interactive chat (optional)
+aye chat -f utils.py
+
+# Undo / snapshot utilities
+aye snap list utils.py
+aye snap show utils.py 20241012T153045
+aye snap revert utils.py 20241012T153045
+
+Development
+
+# Clone the repo
+git clone https://github.com/yourorg/aye.git
+cd aye
+
+# Create a virtual environment
+python -m venv .venv && source .venv/bin/activate
+
+# Install in editable mode with dev deps
+pip install -e .[dev]
+
+# Run the test suite
+pytest -q
+
+Packaging & distribution
+
+# Build a wheel and source distribution
+python -m build
+
+# Install the wheel locally for a clean test
+pip install dist/aye_cli-0.1.0-py3-none-any.whl
+
+The console script aye will be available on the PATH.
+License
+
+MIT – see the LICENSE file (or the license header in pyproject.toml).
+Contributing
+
+Feel free to open issues or submit pull requests.
+All contributions are welcome; just follow the usual GitHub workflow.
+
+

ayechat-0.1.5/pyproject.toml

@@ -0,0 +1,40 @@
+[project]
+name = "ayechat"                 # the name that will appear on PyPI
+version = "0.1.5"
+description = "Aye: Terminal-first AI Code Generator"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "Acrotron, Inc.", email = "info@acrotron.com"}]
+
+# Runtime dependencies
+dependencies = [
+    "typer[all]>=0.9.0",          # CLI framework + rich formatting
+    "httpx>=0.27.0",              # HTTP client
+    "keyring>=24.0.0",            # Secure storage for the token
+    "prompt-toolkit>=3.0.0",      # REPL UI
+]
+
+# Optional development dependencies (tests, linting, etc.)
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",                # test runner
+    "ruff>=0.6",                  # linting/formatter (optional)
+]
+
+# Console script – after installation `aye` will be on the PATH
+[project.scripts]
+aye = "aye.__main__:app"
+
+# -------------------------------------------------
+# Build system configuration – tells setuptools where the code lives
+# -------------------------------------------------
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = {"" = "src"}          # “src/” is the source root
+packages = ["aye"]                 # the only package we ship
+include-package-data = true
+

ayechat-0.1.5/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ayechat-0.1.5/src/aye/__main__.py

@@ -0,0 +1,227 @@
+from pathlib import Path
+import typer
+
+from .service import (
+    handle_login,
+    handle_logout,
+    handle_generate_cmd,
+    handle_chat,
+    handle_history_cmd,
+    handle_snap_show_cmd,
+    handle_restore_cmd,
+    handle_prune_cmd,
+    handle_cleanup_cmd,
+    handle_config_list,
+    handle_config_set,
+    handle_config_get,
+    handle_config_delete
+)
+
+from .config import load_config
+
+# Load configuration at startup
+load_config()
+
+app = typer.Typer(help="Aye: AI‑powered coding assistant for the terminal")
+
+# Create subcommands
+auth_app = typer.Typer(help="Authentication commands")
+snap_app = typer.Typer(help="Snapshot management commands")
+
+app.add_typer(auth_app, name="auth")
+app.add_typer(snap_app, name="snap")
+
+# ----------------------------------------------------------------------
+# Authentication commands
+# ----------------------------------------------------------------------
+@auth_app.command()
+def login():
+    """
+    Configure personal access token for authenticating with the aye service.
+    """
+    handle_login()
+
+
+@auth_app.command()
+def logout():
+    """
+    Remove the stored aye credentials.
+    
+    Examples: \n
+    aye auth logout
+    """
+    handle_logout()
+
+# ----------------------------------------------------------------------
+# One‑shot generation
+# ----------------------------------------------------------------------
+@app.command()
+def generate(
+    prompt: str = typer.Argument(..., help="Prompt for the LLM"),
+    mode: str = typer.Option(
+        "replace",
+        "--mode",
+        "-m",
+        help="replace | append | insert (default: replace)",
+    ),
+):
+    """
+    Send a single prompt to the backend.
+    
+    Examples: \n
+    aye generate "Create a function that reverses a string" \n
+    aye generate "Add type hints to this function" --mode append \n
+    """
+    handle_generate_cmd(prompt, mode)
+
+# ----------------------------------------------------------------------
+# Interactive REPL (chat) command
+# ----------------------------------------------------------------------
+@app.command()
+def chat(
+    root: Path = typer.Option(
+        None, "--root", "-r", help="Root folder where source files are located."
+    ),
+    file_mask: str = typer.Option(
+        "*.py", "--file-mask", "-m", help="File mask for source files to include into generation. Comma-separated masks are allowed."
+    ),
+):
+    """
+    Start an interactive REPL. Use /exit or Ctrl‑D to leave.
+    
+    Examples: \n
+    aye chat \n
+    aye chat --root ./src \n
+    aye chat --file-mask "*.js" --root ./frontend \n
+    """
+    handle_chat(root, file_mask)
+
+# ----------------------------------------------------------------------
+# Snapshot commands
+# ----------------------------------------------------------------------
+@snap_app.command("history")
+def history(
+    file: Path = typer.Argument(None, help="File to list snapshots for")
+):
+    """
+    Show timestamps of saved snapshots for *file* or all snapshots if no file provided.
+    
+    Examples: \n
+    aye snap history \n
+    aye snap history src/main.py \n
+    """
+    handle_history_cmd(file)
+
+
+@snap_app.command("show")
+def show(
+    file: Path = typer.Argument(..., help="File whose snapshot to show"),
+    ordinal: str = typer.Argument(..., help="Ordinal of the snapshot (e.g., 001)"),
+):
+    """
+    Print the contents of a specific snapshot.
+    
+    Examples: \n
+    aye snap show src/main.py 001 \n
+    """
+    handle_snap_show_cmd(file, ordinal)
+
+
+@snap_app.command("restore")
+def restore(
+    ordinal: str = typer.Argument(None, help="Ordinal of the snapshot to restore (e.g., 001, default: latest)"),
+    file_name: str = typer.Argument(None, help="Specific file to restore from the snapshot"),
+):
+    """
+    Replace all files with the latest snapshot or specified snapshot by ordinal.
+    If file_name is provided, only that file is restored.
+    
+    Examples:\n
+    aye snap restore \n
+    aye snap restore 001 \n
+    aye snap restore 001 myfile.py \n
+    """
+    handle_restore_cmd(ordinal, file_name)
+
+
+# ----------------------------------------------------------------------
+# Snapshot cleanup/pruning commands
+# ----------------------------------------------------------------------
+@snap_app.command()
+def keep(
+    num: int = typer.Option(10, "--num", "-n", help="Number of recent snapshots to keep (default: 10)"),
+):
+    """
+    Delete all but the most recent N snapshots.
+    
+    Examples: \n
+    aye snap keep \n
+    aye snap keep --num 5 \n
+    aye snap keep -n 3 \n
+    """
+    handle_prune_cmd(num)
+
+
+@snap_app.command()
+def cleanup(
+    days: int = typer.Option(30, "--days", "-d", help="Delete snapshots older than N days (default: 30)"),
+):
+    """
+    Delete snapshots older than N days.
+    
+    Examples: \n
+    aye snap cleanup \n
+    aye snap cleanup --days 7 \n
+    aye snap cleanup -d 14 \n
+    """
+    handle_cleanup_cmd(days)
+
+
+# ----------------------------------------------------------------------
+# Configuration management commands
+# ----------------------------------------------------------------------
+@app.command()
+def config(
+    action: str = typer.Argument(..., help="Action to perform: list, get, set, delete"),
+    key: str = typer.Argument(None, help="Configuration key"),
+    value: str = typer.Argument(None, help="Configuration value (for set action)"),
+):
+    """
+    Manage configuration values for file masks, root directories, and other settings.
+    
+    Actions: \n
+    - list: Show all configuration values \n
+    - get: Retrieve a specific configuration value \n
+    - set: Set a configuration value \n
+    - delete: Remove a configuration value \n
+    
+    Examples: \n
+    aye config list \n
+    aye config get file_mask \n
+    aye config set file_mask "*.py,*.js" \n
+    aye config delete file_mask \n
+    """
+    if action == "list":
+        handle_config_list()
+    elif action == "get":
+        if not key:
+            typer.echo("[red]Error:[/] Key is required for get action.")
+            raise typer.Exit(code=1)
+        handle_config_get(key)
+    elif action == "set":
+        if not key or not value:
+            typer.echo("[red]Error:[/] Key and value are required for set action.")
+            raise typer.Exit(code=1)
+        handle_config_set(key, value)
+    elif action == "delete":
+        if not key:
+            typer.echo("[red]Error:[/] Key is required for delete action.")
+            raise typer.Exit(code=1)
+        handle_config_delete(key)
+    else:
+        typer.echo(f"[red]Error:[/] Invalid action '{action}'. Use: list, get, set, delete")
+        raise typer.Exit(code=1)
+
+
+if __name__ == "__main__":
+    app()

ayechat-0.1.5/src/aye/api.py

@@ -0,0 +1,49 @@
+import json
+from typing import Any, Dict
+
+import httpx
+from .auth import get_token
+
+# -------------------------------------------------
+# 👉  EDIT THIS TO POINT TO YOUR SERVICE
+# -------------------------------------------------
+BASE_URL = "https://api.acrotron.com"
+TIMEOUT = 30.0
+
+
+def _auth_headers() -> Dict[str, str]:
+    token = get_token()
+    if not token:
+        raise RuntimeError("No auth token – run `aye login` first.")
+    return {"Authorization": f"Bearer {token}"}
+
+
+def cli_invoke(user_id="v@acrotron.com", chat_id=-1, message="", source_files={}):
+    payload = {"user_id": user_id, "chat_id": chat_id, "message": message, "source_files": source_files}
+
+    url = f"{BASE_URL}/invoke_cli"
+
+    with httpx.Client(timeout=TIMEOUT, verify=False) as client:
+        resp = client.post(url, json=payload, headers=_auth_headers())
+        resp.raise_for_status()
+        return resp.json()
+
+
+def fetch_plugin_manifest():
+    """Fetch the plugin manifest from the server."""
+    url = f"{BASE_URL}/plugins"
+    
+    with httpx.Client(timeout=TIMEOUT, verify=False) as client:
+        resp = client.post(url, headers=_auth_headers())
+        resp.raise_for_status()
+        return resp.json()
+
+
+def fetch_server_time() -> int:
+    """Fetch the current server timestamp."""
+    url = f"{BASE_URL}/time"
+    
+    with httpx.Client(timeout=TIMEOUT, verify=False) as client:
+        resp = client.get(url)
+        resp.raise_for_status()
+        return resp.json()['timestamp']

ayechat-0.1.5/src/aye/auth.py

@@ -0,0 +1,54 @@
+# auth.py
+import os
+import typer
+from pathlib import Path
+from rich import print as rprint
+
+SERVICE_NAME = "aye-cli"
+TOKEN_ENV_VAR = "AYE_TOKEN"
+TOKEN_FILE = Path.home() / ".ayecfg"
+
+
+def store_token(token: str) -> None:
+    """Persist the token in ~/.ayecfg (unless AYE_TOKEN is set)."""
+    TOKEN_FILE.write_text(token.strip(), encoding="utf-8")
+    TOKEN_FILE.chmod(0o600)  # POSIX only
+
+
+def get_token() -> str | None:
+    """Return the stored token (env → file)."""
+    # 1. Try environment variable first
+    env_token = os.getenv(TOKEN_ENV_VAR)
+    if env_token:
+        return env_token.strip()
+
+    # 2. Try config file
+    if TOKEN_FILE.is_file():
+        try:
+            return TOKEN_FILE.read_text(encoding="utf-8").strip()
+        except Exception:
+            pass  # Continue if file read fails
+
+    return None
+
+
+def delete_token() -> None:
+    """Delete the token from file (but not environment)."""
+    # Delete the file-based token
+    TOKEN_FILE.unlink(missing_ok=True)
+
+
+def login_flow() -> None:
+    """
+    Small login flow:
+    1. Prompt user to obtain token at https://aye.acrotron.com
+    2. User enters/pastes the token in terminal (hidden input)
+    3. Save the token to ~/.ayecfg (if AYE_TOKEN not set)
+    """
+    #typer.echo(
+    #    "Obtain your personal access token at https://aye.acrotron.com"
+    #)
+    rprint("[yellow]Obtain your personal access token at https://aye.acrotron.com[/]")
+    token = typer.prompt("Paste your token", hide_input=True)
+    store_token(token.strip())
+    typer.secho("✅ Token saved.", fg=typer.colors.GREEN)