termchat-ai 0.1.0__py3-none-any.whl

aiterminal/__init__.py

@@ -0,0 +1,4 @@
+"""AITerminal command-line client."""
+
+__version__ = "0.1.0"
+

aiterminal/client.py

@@ -0,0 +1,81 @@
+"""HTTP client for the AITerminal Netlify Functions."""
+
+from __future__ import annotations
+
+import os
+from urllib.parse import urlparse
+
+import httpx
+
+DEFAULT_API_URL = "https://aiterminal-cloud.netlify.app"
+
+
+class AITerminalError(Exception):
+    """Base exception for user-safe service errors."""
+
+
+class ServiceError(AITerminalError):
+    """The backend returned a safe, user-facing error."""
+
+
+class AITerminalClient:
+    def __init__(
+        self,
+        base_url: str | None = None,
+        *,
+        transport: httpx.BaseTransport | None = None,
+        timeout: float = 35.0,
+    ) -> None:
+        configured_url = base_url or os.getenv("AIT_TERMINAL_API_URL") or DEFAULT_API_URL
+        self.base_url = configured_url.rstrip("/")
+        parsed = urlparse(self.base_url)
+        if parsed.scheme != "https" and parsed.hostname not in {"localhost", "127.0.0.1", "::1"}:
+            raise ValueError("AIT_TERMINAL_API_URL must use HTTPS (HTTP is allowed only for localhost).")
+        if not parsed.netloc:
+            raise ValueError("AIT_TERMINAL_API_URL must be an absolute URL.")
+        self._http = httpx.Client(base_url=self.base_url, timeout=timeout, transport=transport)
+
+    def ask(self, message: str, history: list[dict[str, str]]) -> str:
+        try:
+            result = self._http.post(
+                "/.netlify/functions/chat",
+                json={"message": message, "history": history},
+            )
+        except httpx.TimeoutException as exc:
+            raise ServiceError("The request timed out. Please try again.") from exc
+        except httpx.RequestError as exc:
+            raise ServiceError("Could not connect to AITerminal. Check your internet connection and try again.") from exc
+        if result.status_code == 401:
+            raise ServiceError("The request was not accepted.")
+        if result.status_code == 429:
+            raise ServiceError(self._error_message(result, "Too many requests. Please wait and try again."))
+        if result.status_code >= 500:
+            raise ServiceError(self._error_message(result, "AITerminal is temporarily unavailable."))
+        if result.status_code != 200:
+            raise ServiceError(self._error_message(result, "The request was rejected."))
+        try:
+            payload = result.json()
+        except ValueError as exc:
+            raise ServiceError("AITerminal returned an invalid response.") from exc
+        answer = payload.get("answer") if isinstance(payload, dict) else None
+        if not isinstance(answer, str) or not answer.strip():
+            raise ServiceError("AITerminal returned an invalid response.")
+        return answer
+
+    @staticmethod
+    def _error_message(result: httpx.Response, fallback: str) -> str:
+        try:
+            payload = result.json()
+        except ValueError:
+            return fallback
+        message = payload.get("error") if isinstance(payload, dict) else None
+        return message if isinstance(message, str) and message else fallback
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> AITerminalClient:
+        return self
+
+    def __exit__(self, *_: object) -> None:
+        self.close()

aiterminal/main.py

@@ -0,0 +1,64 @@
+"""Interactive AITerminal CLI."""
+
+from __future__ import annotations
+
+import typer
+
+from .client import AITerminalClient, AITerminalError
+from .terminal import ask_question, console, show_answer
+
+app = typer.Typer(add_completion=False, pretty_exceptions_enable=False)
+
+
+def run_conversation(client: AITerminalClient) -> None:
+    history: list[dict[str, str]] = []
+    while True:
+        try:
+            question = ask_question().strip()
+        except (EOFError, KeyboardInterrupt):
+            console.print("\nGoodbye!")
+            return
+        command = question.lower()
+        if command in {"exit", "quit"}:
+            console.print("Goodbye!")
+            return
+        if command in {"clear", "/clear"}:
+            history.clear()
+            console.clear()
+            console.print("[bold]AITerminal ready![/bold]")
+            continue
+        if not question:
+            continue
+
+        try:
+            with console.status("Thinking...", spinner="dots"):
+                answer = client.ask(question, history)
+        except AITerminalError as exc:
+            console.print(f"[bold red]{exc}[/bold red]")
+            continue
+
+        show_answer(answer)
+        history.extend(({"role": "user", "content": question}, {"role": "assistant", "content": answer}))
+        del history[:-20]
+
+
+@app.callback(invoke_without_command=True)
+def main() -> None:
+    """Ask questions of the AITerminal cloud service."""
+    console.print("Connecting to AITerminal Cloud...")
+    try:
+        with AITerminalClient() as client:
+            console.print("[bold]AITerminal ready![/bold]")
+            run_conversation(client)
+    except KeyboardInterrupt:
+        console.print("\nGoodbye!")
+    except ValueError as exc:
+        console.print(f"[bold red]{exc}[/bold red]")
+
+
+def run() -> None:
+    app()
+
+
+if __name__ == "__main__":
+    run()

aiterminal/terminal.py

@@ -0,0 +1,15 @@
+"""Small Rich helpers for the interactive terminal."""
+
+from rich.console import Console
+from rich.markdown import Markdown
+
+console = Console()
+
+
+def ask_question() -> str:
+    return console.input("[bold cyan]You> [/bold cyan]")
+
+
+def show_answer(answer: str) -> None:
+    console.print("[bold green]AI>[/bold green]")
+    console.print(Markdown(answer))

termchat_ai-0.1.0.dist-info/METADATA

@@ -0,0 +1,48 @@
+Metadata-Version: 2.5
+Name: termchat-ai
+Version: 0.1.0
+Summary: A no-login terminal client for the AITerminal cloud AI service
+Author: AITerminal contributors
+Keywords: ai,cli,groq,netlify,terminal
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.27
+Requires-Dist: rich<15,>=13.7
+Requires-Dist: typer<1,>=0.12
+Description-Content-Type: text/markdown
+
+# AITerminal CLI
+
+This package provides the `aiterminal` terminal command. It connects directly to the public AITerminal chat function; it does not ask users to log in and does not contain a Groq API key.
+
+## Install
+
+The package is named `termchat-ai` and is not published yet. After publication:
+
+```powershell
+py -m pip install termchat-ai
+aiterminal
+```
+
+Linux and macOS:
+
+```sh
+python -m pip install termchat-ai
+aiterminal
+```
+
+For development from a checkout:
+
+```sh
+python -m pip install ./cli
+aiterminal
+```
+
+The client uses `https://aiterminal-cloud.netlify.app` by default. Override with `AIT_TERMINAL_API_URL` if needed.
+
+Use `clear` or `/clear` to clear the screen and temporary conversation context; use `exit` or `quit` to end the session. Context is memory-only and is discarded when the process exits.

termchat_ai-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+aiterminal/__init__.py,sha256=CLC7Fx1FlEGxFn-3Jr3LtxuhNV5qdEWdnjKDd-THCWQ,66
+aiterminal/client.py,sha256=VUjr5OLViClDc_lyH6uGYQS98szSlDf15n5_0U1AphE,3269
+aiterminal/main.py,sha256=4NaeO9zhHxC_JMITGz8-Iz00PAHgWyA2QKMvlT-vn8c,1924
+aiterminal/terminal.py,sha256=MlkQx6zEq4Akn01X7dl_KdA3S7qcmseFj9YQHmE72WM,372
+termchat_ai-0.1.0.dist-info/METADATA,sha256=UMSfCjbUZ4o8w0juc3Sozzb9a2BLwpfGjPt3j7SAGcw,1467
+termchat_ai-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+termchat_ai-0.1.0.dist-info/entry_points.txt,sha256=RHuE5f3T4cILXBMlGSVKe9CtfvazOPZSU8MDzP6ZvS4,51
+termchat_ai-0.1.0.dist-info/RECORD,,

termchat_ai-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

termchat_ai-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aiterminal = aiterminal.main:run