agentic-cli 0.1.0__tar.gz

agentic_cli-0.1.0/.gitignore

@@ -0,0 +1,45 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+
+# Type checking
+.mypy_cache/
+
+# Environment files
+.env
+*.env.local
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+CLAUDE.md
+.claude/

agentic_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025
+
+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.

agentic_cli-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: agentic-cli
+Version: 0.1.0
+Summary: A framework for building domain-specific agentic CLI applications
+Project-URL: Homepage, https://github.com/shoom1/agentic-cli
+Project-URL: Repository, https://github.com/shoom1/agentic-cli
+Author: Andrey Shiryaev
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.12
+Requires-Dist: feedparser>=6.0.0
+Requires-Dist: google-adk[genai]>=0.4.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: numpy>=1.26.0
+Requires-Dist: prompt-toolkit>=3.0.0
+Requires-Dist: pydantic-settings>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: structlog>=24.0.0
+Requires-Dist: thinking-prompt>=0.1.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=6.0.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Agentic CLI
+
+A framework for building domain-specific agentic CLI applications powered by LLM agents.
+
+## Features
+
+- **CLI Framework**: Rich terminal UI with thinking boxes and markdown support
+- **Workflow Management**: Agent orchestration using Google ADK
+- **Generic Tools**: Web search, Python execution, knowledge base
+- **Session Persistence**: Save and restore conversation sessions
+- **Configuration**: Type-safe settings with pydantic-settings
+
+## Installation
+
+```bash
+pip install agentic-cli
+```
+
+## Usage
+
+Create a domain-specific CLI application by extending the base classes:
+
+```python
+from agentic_cli import BaseCLIApp, WorkflowManager
+from thinking_prompt import AppInfo
+
+class MyApp(BaseCLIApp):
+    def get_app_info(self) -> AppInfo:
+        return AppInfo(name="MyApp", version="0.1.0")
+
+    def get_settings(self):
+        return MySettings()
+
+    def create_workflow_manager(self):
+        return MyWorkflowManager(settings=self.settings)
+```
+
+## License
+
+MIT

agentic_cli-0.1.0/README.md

@@ -0,0 +1,40 @@
+# Agentic CLI
+
+A framework for building domain-specific agentic CLI applications powered by LLM agents.
+
+## Features
+
+- **CLI Framework**: Rich terminal UI with thinking boxes and markdown support
+- **Workflow Management**: Agent orchestration using Google ADK
+- **Generic Tools**: Web search, Python execution, knowledge base
+- **Session Persistence**: Save and restore conversation sessions
+- **Configuration**: Type-safe settings with pydantic-settings
+
+## Installation
+
+```bash
+pip install agentic-cli
+```
+
+## Usage
+
+Create a domain-specific CLI application by extending the base classes:
+
+```python
+from agentic_cli import BaseCLIApp, WorkflowManager
+from thinking_prompt import AppInfo
+
+class MyApp(BaseCLIApp):
+    def get_app_info(self) -> AppInfo:
+        return AppInfo(name="MyApp", version="0.1.0")
+
+    def get_settings(self):
+        return MySettings()
+
+    def create_workflow_manager(self):
+        return MyWorkflowManager(settings=self.settings)
+```
+
+## License
+
+MIT

agentic_cli-0.1.0/environment.yml

@@ -0,0 +1,10 @@
+name: agenticcli
+channels:
+  - conda-forge
+  - defaults
+dependencies:
+  - python=3.12
+  - pip
+  - pip:
+    - -e .
+    - -e .[dev]

agentic_cli-0.1.0/examples/hello_agent/__init__.py

@@ -0,0 +1,6 @@
+"""Hello Agent - A simple example showcasing the agentic-cli package."""
+
+from .app import HelloAgentApp, Settings, get_settings
+
+__version__ = "0.1.0"
+__all__ = ["HelloAgentApp", "Settings", "get_settings"]

agentic_cli-0.1.0/examples/hello_agent/__main__.py

@@ -0,0 +1,13 @@
+"""Entry point: python -m examples.hello_agent"""
+
+import asyncio
+from .app import HelloAgentApp
+
+
+def main():
+    app = HelloAgentApp()
+    asyncio.run(app.run())
+
+
+if __name__ == "__main__":
+    main()

agentic_cli-0.1.0/examples/hello_agent/app.py

@@ -0,0 +1,159 @@
+"""Hello Agent - A simple example showcasing the agentic-cli package.
+
+This single file contains everything needed:
+- Settings configuration
+- Tool definitions
+- Agent configuration
+- CLI application
+"""
+
+from datetime import datetime
+from functools import lru_cache
+from pathlib import Path
+
+from rich.panel import Panel
+from rich.text import Text
+from pydantic import Field
+from pydantic_settings import SettingsConfigDict
+
+from agentic_cli import BaseCLIApp, BaseSettings
+from agentic_cli.cli import AppInfo
+from agentic_cli.config import set_settings
+from agentic_cli.workflow import AgentConfig, WorkflowManager
+
+__version__ = "0.1.0"
+
+
+# =============================================================================
+# Settings
+# =============================================================================
+
+class Settings(BaseSettings):
+    """Hello Agent settings."""
+
+    model_config = SettingsConfigDict(
+        env_prefix="HELLO_",
+        env_file=str(Path.home() / ".hello_agent" / ".env"),
+        extra="ignore",
+    )
+
+    app_name: str = Field(default="hello_agent")
+    workspace_dir: Path = Field(default=Path.home() / ".hello_agent")
+
+
+@lru_cache
+def get_settings() -> Settings:
+    return Settings()
+
+
+# =============================================================================
+# Tools
+# =============================================================================
+
+def get_current_time() -> dict:
+    """Get the current date and time."""
+    now = datetime.now()
+    return {
+        "date": now.strftime("%Y-%m-%d"),
+        "time": now.strftime("%H:%M:%S"),
+        "day_of_week": now.strftime("%A"),
+    }
+
+
+def calculate(expression: str) -> dict:
+    """Evaluate a mathematical expression.
+
+    Args:
+        expression: A math expression like "2 + 2" or "sqrt(16)"
+    """
+    import math
+
+    allowed = {
+        "abs": abs, "round": round, "min": min, "max": max, "sum": sum,
+        "pow": pow, "sqrt": math.sqrt, "sin": math.sin, "cos": math.cos,
+        "tan": math.tan, "pi": math.pi, "e": math.e,
+    }
+
+    try:
+        result = eval(expression, {"__builtins__": {}}, allowed)
+        return {"expression": expression, "result": result}
+    except Exception as e:
+        return {"expression": expression, "error": str(e)}
+
+
+def echo(message: str) -> dict:
+    """Echo back a message.
+
+    Args:
+        message: The message to echo back
+    """
+    return {"echoed": message, "length": len(message)}
+
+
+# =============================================================================
+# Agent Configuration
+# =============================================================================
+
+SYSTEM_PROMPT = """You are a friendly assistant with access to utility tools.
+
+Available tools:
+- get_current_time: Get the current date and time
+- calculate: Evaluate math expressions
+- echo: Echo back messages
+
+Be helpful and concise in your responses."""
+
+
+AGENT_CONFIGS = [
+    AgentConfig(
+        name="assistant",
+        prompt=SYSTEM_PROMPT,
+        tools=[get_current_time, calculate, echo],
+        description="Friendly assistant with utility tools",
+    ),
+]
+
+
+def create_workflow_manager(settings: Settings) -> WorkflowManager:
+    """Create the workflow manager."""
+    set_settings(settings)
+    return WorkflowManager(agent_configs=AGENT_CONFIGS, settings=settings)
+
+
+# =============================================================================
+# CLI Application
+# =============================================================================
+
+def create_welcome_message() -> Panel:
+    """Create the welcome message panel."""
+    text = Text()
+    text.append("Hello Agent", style="bold cyan")
+    text.append(f" v{__version__}\n\n", style="dim")
+    text.append("A simple assistant with utility tools.\n\n", style="white")
+    text.append("Available tools:\n", style="yellow")
+    text.append("  - get_current_time: Get date and time\n", style="dim")
+    text.append("  - calculate: Math expressions\n", style="dim")
+    text.append("  - echo: Echo messages\n\n", style="dim")
+    text.append("Type ", style="white")
+    text.append("/help", style="bold green")
+    text.append(" for commands, or just start chatting!", style="white")
+
+    return Panel(text, border_style="cyan", padding=(1, 2))
+
+
+class HelloAgentApp(BaseCLIApp):
+    """Hello Agent CLI application."""
+
+    def get_app_info(self) -> AppInfo:
+        return AppInfo(
+            name="Hello Agent",
+            version=__version__,
+            welcome_message=create_welcome_message,
+            echo_thinking=False,
+        )
+
+    def get_settings(self) -> Settings:
+        return get_settings()
+
+    def create_workflow_manager(self) -> WorkflowManager:
+        return create_workflow_manager(settings=self._settings)

agentic_cli-0.1.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentic-cli"
+version = "0.1.0"
+description = "A framework for building domain-specific agentic CLI applications"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.12"
+authors = [
+    { name = "Andrey Shiryaev" }
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "thinking-prompt>=0.1.0",
+    "google-adk[genai]>=0.4.0",
+    "pydantic>=2.0.0",
+    "pydantic-settings>=2.0.0",
+    "structlog>=24.0.0",
+    "rich>=13.0.0",
+    "prompt-toolkit>=3.0.0",
+    "httpx>=0.27.0",
+    "numpy>=1.26.0",
+    "feedparser>=6.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "pytest-cov>=6.0.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/shoom1/agentic-cli"
+Repository = "https://github.com/shoom1/agentic-cli"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentic_cli"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "function"
+
+[tool.ruff]
+line-length = 88
+target-version = "py312"

agentic_cli-0.1.0/requirements-dev.txt

@@ -0,0 +1,6 @@
+# Development dependencies for agentic-cli
+-r requirements.txt
+
+pytest>=8.0.0
+pytest-asyncio>=0.24.0
+pytest-cov>=6.0.0

agentic_cli-0.1.0/requirements.txt

@@ -0,0 +1,13 @@
+# Core dependencies for agentic-cli
+# Note: thinking-prompt is a local dependency, install separately:
+#   pip install -e /path/to/thinking_prompt
+
+google-adk[genai]>=0.4.0
+pydantic>=2.0.0
+pydantic-settings>=2.0.0
+structlog>=24.0.0
+rich>=13.0.0
+prompt-toolkit>=3.0.0
+httpx>=0.27.0
+numpy>=1.26.0
+feedparser>=6.0.0

agentic_cli-0.1.0/src/agentic_cli/__init__.py

@@ -0,0 +1,55 @@
+"""Agentic CLI - A framework for building domain-specific agentic CLI applications.
+
+This package provides the core infrastructure for building CLI applications
+powered by LLM agents, including:
+
+- CLI framework with thinking boxes and rich output
+- Workflow management for agent orchestration
+- Generic tools (search, code execution, document generation)
+- Knowledge base with vector search
+- Session persistence
+
+Domain-specific applications extend the base classes to provide their own
+agents, prompts, and configuration.
+"""
+
+from agentic_cli.cli.app import BaseCLIApp
+from agentic_cli.cli.commands import Command, CommandRegistry
+from agentic_cli.workflow.manager import WorkflowManager
+from agentic_cli.workflow.config import AgentConfig
+from agentic_cli.workflow.events import WorkflowEvent, EventType
+from agentic_cli.config import (
+    BaseSettings,
+    SettingsContext,
+    SettingsValidationError,
+    get_settings,
+    set_settings,
+    set_context_settings,
+    get_context_settings,
+    validate_settings,
+    reload_settings,
+)
+
+__all__ = [
+    # CLI
+    "BaseCLIApp",
+    "Command",
+    "CommandRegistry",
+    # Workflow
+    "WorkflowManager",
+    "AgentConfig",
+    "WorkflowEvent",
+    "EventType",
+    # Settings
+    "BaseSettings",
+    "SettingsContext",
+    "SettingsValidationError",
+    "get_settings",
+    "set_settings",
+    "set_context_settings",
+    "get_context_settings",
+    "validate_settings",
+    "reload_settings",
+]
+
+__version__ = "0.1.0"

agentic_cli-0.1.0/src/agentic_cli/cli/__init__.py

@@ -0,0 +1,22 @@
+"""CLI framework for agentic applications."""
+
+from thinking_prompt import AppInfo
+
+from agentic_cli.cli.commands import (
+    Command,
+    CommandCategory,
+    CommandRegistry,
+    ParsedArgs,
+    create_simple_command,
+)
+from agentic_cli.cli.app import BaseCLIApp
+
+__all__ = [
+    "AppInfo",
+    "BaseCLIApp",
+    "Command",
+    "CommandCategory",
+    "CommandRegistry",
+    "ParsedArgs",
+    "create_simple_command",
+]