simhacli 1.0.0__tar.gz

simhacli-1.0.0/PKG-INFO

@@ -0,0 +1,216 @@
+Metadata-Version: 2.4
+Name: simhacli
+Version: 1.0.0
+Summary: SimhaCLI 🦁 — AI Coding Agent that runs inside your terminal
+Author: Narasimha Naidu Korrapti
+License: MIT
+Project-URL: Homepage, https://github.com/naidu199/SimhaCLI
+Project-URL: Repository, https://github.com/naidu199/SimhaCLI
+Keywords: ai,cli,agent,coding,llm,terminal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: anyio>=4.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: toml>=0.10.0
+Requires-Dist: ddgs>=6.0.0
+Requires-Dist: fastmcp>=2.0.0
+Requires-Dist: diskcache>=5.0.0
+
+<div align="center">
+
+# 🦁 SimhaCLI
+
+### AI-Powered Coding Agent for Your Terminal
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+_Built by Narasimha Naidu Korrapti_
+
+[Features](#-features) • [Installation](#-installation)
+
+</div>
+
+---
+
+## 📖 Overview
+
+**SimhaCLI** is a powerful terminal-based AI coding agent that brings the intelligence of Large Language Models directly into your development workflow. It seamlessly integrates with your codebase, understands context, and executes actions through a comprehensive set of builtin tools.
+
+### Why SimhaCLI?
+
+- 🚀 **Session-Based Architecture**: Persistent context and memory across interactions
+- 🛠️ **11 Builtin Tools**: File operations, shell commands, web access, task management
+- 🔒 **Safety First**: Shell command blocking prevents dangerous operations
+- 💾 **Persistent Memory**: Remember user preferences and context
+- 🎨 **Beautiful TUI**: Rich terminal interface with syntax highlighting
+- ⚡ **Streaming Responses**: Real-time output as the agent thinks
+- 🔄 **Event-Driven**: Observable agent actions with full transparency
+
+---
+
+## ✨ Features
+
+### 🤖 Intelligent Agent
+
+- **Agentic Loop**: Autonomous multi-turn conversations with tool usage
+- **Context Management**: Tracks conversation history with token counting
+- **Turn Tracking**: Session-based state management with UUIDs
+- **Streaming Output**: Real-time response generation
+
+### 🛠️ Comprehensive Toolset
+
+11 builtin tools across 5 categories:
+
+- **📖 Read**: `read_file`, `list_dir`, `glob`, `grep`
+- **✏️ Write**: `write_file`, `edit_file`
+- **🖥️ Shell**: `shell` (with 40+ blocked dangerous commands)
+- **🌐 Web**: `web_search`, `web_fetch`
+- **💾 Memory**: `todos` (task management), `memory` (persistent storage)
+
+### 🔒 Safety & Security
+
+- Command blocking for dangerous operations (rm -rf, format, etc.)
+- Timeout protection on shell commands (120s default, 600s max)
+- File validation and error handling
+- Configurable working directory restrictions
+
+### 💾 Persistent Storage
+
+- **User Memory**: JSON-based key-value storage (`~/.simhacli/user_memory.json`)
+- **Configuration**: System and project-level TOML configs
+- **Session Tracking**: UUID-based session management with timestamps
+
+### 🎨 Rich Terminal UI
+
+- Syntax-highlighted code display
+- Color-coded tool execution (cyan=read, yellow=write, white=shell)
+- Live streaming text output
+- Beautiful welcome banner and formatting
+- Error panels with detailed information
+
+---
+
+## 🚀 Installation
+
+### Prerequisites
+
+- **Python 3.10+**
+- **API Key** (OpenAI, Gemini, or compatible API)
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+pip install simhacli
+```
+
+After installation, you can run SimhaCLI from anywhere:
+
+```bash
+simhacli                    # Start interactive mode
+simhacli "explain this code" # Run a single prompt
+simhacli --help             # Show help
+```
+
+### Option 2: Install from Source
+
+1. **Clone the repository**
+
+   ```bash
+   git clone https://github.com/naidu199/SimhaCLI.git
+   cd SimhaCLI
+   ```
+
+2. **Install globally (access from anywhere)**
+
+   ```bash
+   pip install -e .
+   ```
+
+   Or install without editable mode:
+
+   ```bash
+   pip install .
+   ```
+
+3. **Now you can use `simhacli` from anywhere:**
+
+   ```bash
+   simhacli                    # Start interactive mode
+   simhacli "your prompt"       # Run a single command
+   simhacli --cwd /path/to/dir  # Set working directory
+   ```
+
+### Option 3: Development Setup
+
+1. **Clone and create virtual environment**
+
+   ```bash
+   git clone https://github.com/naidu199/SimhaCLI.git
+   cd SimhaCLI
+   python -m venv venv
+
+   # Windows
+   venv\Scripts\activate
+
+   # Linux/Mac
+   source venv/bin/activate
+   ```
+
+2. **Install in editable mode**
+
+   ```bash
+   pip install -e .
+   ```
+
+3. **Run SimhaCLI**
+
+   ```bash
+   simhacli
+   ```
+
+### Configuration
+
+Set up your API credentials using one of these methods:
+
+**Method 1: Environment Variables**
+
+```bash
+# Windows (PowerShell)
+$env:API_KEY = "your_api_key_here"
+$env:API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/openai"
+
+# Windows (CMD)
+set API_KEY=your_api_key_here
+set API_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
+
+# Linux/Mac
+export API_KEY=your_api_key_here
+export API_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
+```
+
+**Method 2: Config File**
+
+```bash
+# Create config directory
+mkdir -p ~/.simhacli
+
+# Create/edit config.toml
+```
+
+---

simhacli-1.0.0/README.md

@@ -0,0 +1,184 @@
+<div align="center">
+
+# 🦁 SimhaCLI
+
+### AI-Powered Coding Agent for Your Terminal
+
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+
+_Built by Narasimha Naidu Korrapti_
+
+[Features](#-features) • [Installation](#-installation)
+
+</div>
+
+---
+
+## 📖 Overview
+
+**SimhaCLI** is a powerful terminal-based AI coding agent that brings the intelligence of Large Language Models directly into your development workflow. It seamlessly integrates with your codebase, understands context, and executes actions through a comprehensive set of builtin tools.
+
+### Why SimhaCLI?
+
+- 🚀 **Session-Based Architecture**: Persistent context and memory across interactions
+- 🛠️ **11 Builtin Tools**: File operations, shell commands, web access, task management
+- 🔒 **Safety First**: Shell command blocking prevents dangerous operations
+- 💾 **Persistent Memory**: Remember user preferences and context
+- 🎨 **Beautiful TUI**: Rich terminal interface with syntax highlighting
+- ⚡ **Streaming Responses**: Real-time output as the agent thinks
+- 🔄 **Event-Driven**: Observable agent actions with full transparency
+
+---
+
+## ✨ Features
+
+### 🤖 Intelligent Agent
+
+- **Agentic Loop**: Autonomous multi-turn conversations with tool usage
+- **Context Management**: Tracks conversation history with token counting
+- **Turn Tracking**: Session-based state management with UUIDs
+- **Streaming Output**: Real-time response generation
+
+### 🛠️ Comprehensive Toolset
+
+11 builtin tools across 5 categories:
+
+- **📖 Read**: `read_file`, `list_dir`, `glob`, `grep`
+- **✏️ Write**: `write_file`, `edit_file`
+- **🖥️ Shell**: `shell` (with 40+ blocked dangerous commands)
+- **🌐 Web**: `web_search`, `web_fetch`
+- **💾 Memory**: `todos` (task management), `memory` (persistent storage)
+
+### 🔒 Safety & Security
+
+- Command blocking for dangerous operations (rm -rf, format, etc.)
+- Timeout protection on shell commands (120s default, 600s max)
+- File validation and error handling
+- Configurable working directory restrictions
+
+### 💾 Persistent Storage
+
+- **User Memory**: JSON-based key-value storage (`~/.simhacli/user_memory.json`)
+- **Configuration**: System and project-level TOML configs
+- **Session Tracking**: UUID-based session management with timestamps
+
+### 🎨 Rich Terminal UI
+
+- Syntax-highlighted code display
+- Color-coded tool execution (cyan=read, yellow=write, white=shell)
+- Live streaming text output
+- Beautiful welcome banner and formatting
+- Error panels with detailed information
+
+---
+
+## 🚀 Installation
+
+### Prerequisites
+
+- **Python 3.10+**
+- **API Key** (OpenAI, Gemini, or compatible API)
+
+### Option 1: Install from PyPI (Recommended)
+
+```bash
+pip install simhacli
+```
+
+After installation, you can run SimhaCLI from anywhere:
+
+```bash
+simhacli                    # Start interactive mode
+simhacli "explain this code" # Run a single prompt
+simhacli --help             # Show help
+```
+
+### Option 2: Install from Source
+
+1. **Clone the repository**
+
+   ```bash
+   git clone https://github.com/naidu199/SimhaCLI.git
+   cd SimhaCLI
+   ```
+
+2. **Install globally (access from anywhere)**
+
+   ```bash
+   pip install -e .
+   ```
+
+   Or install without editable mode:
+
+   ```bash
+   pip install .
+   ```
+
+3. **Now you can use `simhacli` from anywhere:**
+
+   ```bash
+   simhacli                    # Start interactive mode
+   simhacli "your prompt"       # Run a single command
+   simhacli --cwd /path/to/dir  # Set working directory
+   ```
+
+### Option 3: Development Setup
+
+1. **Clone and create virtual environment**
+
+   ```bash
+   git clone https://github.com/naidu199/SimhaCLI.git
+   cd SimhaCLI
+   python -m venv venv
+
+   # Windows
+   venv\Scripts\activate
+
+   # Linux/Mac
+   source venv/bin/activate
+   ```
+
+2. **Install in editable mode**
+
+   ```bash
+   pip install -e .
+   ```
+
+3. **Run SimhaCLI**
+
+   ```bash
+   simhacli
+   ```
+
+### Configuration
+
+Set up your API credentials using one of these methods:
+
+**Method 1: Environment Variables**
+
+```bash
+# Windows (PowerShell)
+$env:API_KEY = "your_api_key_here"
+$env:API_BASE_URL = "https://generativelanguage.googleapis.com/v1beta/openai"
+
+# Windows (CMD)
+set API_KEY=your_api_key_here
+set API_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
+
+# Linux/Mac
+export API_KEY=your_api_key_here
+export API_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai
+```
+
+**Method 2: Config File**
+
+```bash
+# Create config directory
+mkdir -p ~/.simhacli
+
+# Create/edit config.toml
+```
+
+---

simhacli-1.0.0/agent/agent.py

@@ -0,0 +1,205 @@
+from __future__ import annotations
+
+from typing import AsyncGenerator, Awaitable, Callable
+
+from agent.events import AgentEvent, AgentEventType
+from agent.session import Session
+from client.response import (
+    StreamEventType,
+    TokenUsage,
+    ToolCall,
+    ToolResultMessage,
+    parse_tool_call_arguments,
+)
+from config.config import Config
+from prompts.system import create_loop_breaker_prompt
+from tools.base import ToolConfirmation
+
+
+class Agent:
+    def __init__(
+        self,
+        config: Config,
+        confirmation_callback: (
+            Callable[[ToolConfirmation], Awaitable[bool]] | None
+        ) = None,
+    ) -> None:
+        self.config = config
+        # self.client = LLMClient(config=self.config)
+        # self.context_manager = ContextManager(config=self.config)
+        # self.tool_registry = create_default_registry(config=self.config)
+        self.session: Session | None = Session(config=self.config)
+
+        self.session.approval_manager.confirmation_callback = confirmation_callback
+
+    async def run(self, message: str) -> AsyncGenerator[AgentEvent, None]:
+        await self.session.hook_system.trigger_before_agent(message)
+        yield AgentEvent.agent_start(message=message)
+        self.session.context_manager.add_user_message(message)
+
+        # add user message to the context
+        final_message: str | None = None
+        try:
+            async for event in self._agentic_loop():
+                yield event
+                if event.type == AgentEventType.TEXT_COMPLETE:
+                    final_message = event.data.get("content", "")
+                    # yield AgentEvent.text_complete(content=final_message)
+            await self.session.hook_system.trigger_after_agent(
+                user_message=message,
+                agent_response=final_message or "",
+            )
+            yield AgentEvent.agent_end(response=final_message)
+        except Exception as e:
+            yield AgentEvent.agent_error(f"Agent encountered an error: {str(e)}")
+            await self.session.hook_system.trigger_on_error(e)
+
+    async def _agentic_loop(self) -> AsyncGenerator[AgentEvent, None]:
+
+        max_turns = self.config.max_turns
+
+        for turn_no in range(max_turns):
+            self.session.increment_turn_count()
+            response_text = ""
+            usage: TokenUsage | None = None
+            # checking for the context overflow and trimming if necessary
+            if self.session.context_manager.needs_compression():
+                summary, usage = await self.session.chat_compressor.compress(
+                    self.session.context_manager
+                )
+                if summary:
+                    self.session.context_manager.replace_with_summary(summary)
+                    self.session.context_manager.set_latest_usage(usage)
+                    self.session.context_manager.add_usage(usage)
+            tool_schema = self.session.tool_registry.get_schemas()
+            tool_calls: list[ToolCall] = []
+            has_error = False
+            async for event in self.session.client.chat_completion(
+                self.session.context_manager.get_messages(),
+                tools=tool_schema if tool_schema else None,
+            ):
+
+                if event.type == StreamEventType.TEXT_DELTA:
+                    content = event.text_delta.content if event.text_delta else ""
+                    response_text += content
+                    yield AgentEvent.text_delta(content)
+                elif event.type == StreamEventType.TOOL_CALL_COMPLETE:
+                    if event.tool_call:
+                        tool_calls.append(event.tool_call)
+                elif event.type == StreamEventType.ERROR:
+                    error_msg = event.error if event.error else "Unknown error"
+                    has_error = True
+                    yield AgentEvent.agent_error(error_msg)
+                    return  # Stop processing on error
+                elif event.type == StreamEventType.MESSAGE_COMPLETE:
+                    usage = event.usage
+                    # Only yield text_complete once at the end with full response
+                    yield AgentEvent.text_complete(content=response_text)
+
+            # Convert tool_calls to the format expected by the API
+            tool_calls_dict = (
+                [
+                    {
+                        "id": tc.call_id,
+                        "type": "function",
+                        "function": {
+                            "name": tc.name,
+                            "arguments": tc.arguments,
+                        },
+                    }
+                    for tc in tool_calls
+                ]
+                if tool_calls
+                else None
+            )
+
+            self.session.context_manager.add_assistant_message(
+                response_text or "", tool_calls=tool_calls_dict
+            )
+
+            if response_text:
+                yield AgentEvent.text_complete(response_text)
+                self.session.loop_detector.record_action(
+                    "response",
+                    text=response_text,
+                )
+
+            if not tool_calls:
+                if usage:
+                    self.session.context_manager.set_latest_usage(usage)
+                    self.session.context_manager.add_usage(usage)
+
+                self.session.context_manager.prune_tool_outputs()
+
+                return  # No tool calls, end the loop
+
+            tool_call_results: list[ToolResultMessage] = []
+
+            for tool_call in tool_calls:
+                parsed_args = parse_tool_call_arguments(tool_call.arguments or "")
+
+                yield AgentEvent.tool_call_start(
+                    call_id=tool_call.call_id,
+                    name=tool_call.name,
+                    arguments=parsed_args,
+                )
+
+                self.session.loop_detector.record_action(
+                    "tool_call",
+                    tool_name=tool_call.name,
+                    args=parse_tool_call_arguments(tool_call.arguments or ""),
+                )
+
+                result = await self.session.tool_registry.invoke(
+                    tool_call.name or "",
+                    parsed_args,
+                    self.config.cwd,
+                    self.session.approval_manager,
+                    self.session.hook_system,
+                )
+
+                yield AgentEvent.tool_call_complete(
+                    tool_call.call_id,
+                    tool_call.name,
+                    result,
+                )
+                tool_call_results.append(
+                    ToolResultMessage(
+                        tool_call_id=tool_call.call_id,
+                        content=result.to_model_output(),
+                        is_error=not result.success,
+                    )
+                )
+
+            for tool_result in tool_call_results:
+                self.session.context_manager.add_tool_result(
+                    tool_result.tool_call_id,
+                    tool_result.content,
+                )
+            loop_detector_value = self.session.loop_detector.check_for_loop()
+            if loop_detector_value:
+                loop_prompt = create_loop_breaker_prompt(
+                    loop_description=loop_detector_value,
+                )
+                self.session.context_manager.add_user_message(loop_prompt)
+                continue  # Skip executing the tool and continue the loop
+            if usage:
+                self.session.context_manager.set_latest_usage(usage)
+                self.session.context_manager.add_usage(usage)
+
+            self.session.context_manager.prune_tool_outputs()
+
+        yield AgentEvent.agent_error(
+            f"Maximum number of turns {self.config.max_turns} reached."
+        )
+
+    async def __aenter__(self) -> Agent:
+        await self.session.initialize()
+        return self
+
+    async def __aexit__(self, exc_type, exc, tb) -> None:
+        if self.session and self.session.client and self.session.mcp_manager:
+            await self.session.client.close_client()
+            await self.session.mcp_manager.shutdown_mcp()
+            self.session.client = None
+            self.session = None