depression.ai 1.0.0__tar.gz

depression_ai-1.0.0/PKG-INFO

@@ -0,0 +1,202 @@
+Metadata-Version: 2.4
+Name: depression.ai
+Version: 1.0.0
+Summary: AI agent for everything — development, deployment, and analysis
+Author-email: rnaveenpatil <rnaveenpatil@example.com>
+License-Expression: ISC
+Project-URL: Homepage, https://github.com/rnaveenpatil/depression.ai
+Project-URL: Repository, https://github.com/rnaveenpatil/depression.ai
+Project-URL: Issues, https://github.com/rnaveenpatil/depression.ai/issues
+Keywords: ai,cli,agent,tui,textual,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: prompt-toolkit>=3.0
+Requires-Dist: textual>=0.80.0
+Provides-Extra: browser
+Requires-Dist: playwright>=1.40.0; extra == "browser"
+Provides-Extra: tui
+Requires-Dist: textual-dev>=1.0.0; extra == "tui"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+
+# depression
+
+**AI agent for everything — development, deployment, and analysis.**
+
+A terminal-native agentic AI assistant. Sits in your terminal as a Textual TUI and
+drives a **Plan + Build** dual-agent system with full tool access, MCP support,
+and visual permission prompts.
+
+## Features
+
+- **Textual TUI** — interactive terminal UI with plan/build mode switching (`Ctrl+P`), AWS credentials panel, thinking indicator, todo panel, live tool-call cards, and diff view
+- **Dual-Agent Architecture** — Plan agent (read-only analysis) + Build agent (full tool execution)
+- **User-Configured LLM Runtime** — connect any OpenAI-compatible endpoint at runtime (base URL + API key + model); built-in provider adapters for Anthropic, Groq, NVIDIA, and local models
+- **Tool Calling** — terminal, filesystem, git, patch, search, web, todo, process, browser automation (Playwright), AWS
+- **MCP Support** — Model Context Protocol client with multiple servers
+- **Session Management** — persistent sessions stored in SQLite; resume with `/session`
+- **Snapshot / Undo** — git-stash-based snapshots for safe experimentation
+- **Subagents & Plugins** — parallel task execution and `@syntax` subagents, plugin loader
+- **Permission System** — per-tool approval rules with interactive modal prompts
+
+## Installation
+
+```bash
+git clone https://github.com/rnaveenpatil/depression.ai.git
+cd depression.ai
+pip install -e .
+```
+
+Optional extras:
+
+```bash
+# Browser automation tool (Playwright)
+pip install -e ".[browser]"
+playwright install chromium
+
+# Development (pytest, ruff, mypy)
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```bash
+# Launch the TUI
+depression
+
+# Equivalent forms
+python -m agent.tui
+python -m agent.tui.run
+```
+
+Before first use you must connect an LLM endpoint (see [Runtime LLM Configuration](#runtime-llm-configuration)
+below). The TUI also offers an **LLM CONNECTION** panel to set base URL, API key,
+and model interactively.
+
+## Runtime LLM Configuration
+
+The agent is deliberately provider-agnostic: there are **no hardcoded API keys**.
+Configure a runtime provider via environment variables or the in-TUI connection
+panel. Copy `.env.example` to `.env`:
+
+```bash
+# User runtime LLM connection (never commit real secrets)
+DEPRESSION_PROVIDER=custom
+DEPRESSION_BASE_URL=https://api.example.com/v1
+DEPRESSION_API_KEY=
+DEPRESSION_MODEL=
+
+# AWS credentials entered by /aws panel
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=ap-south-1
+```
+
+## Configuration
+
+Layered config (project overrides user): `.agent/config.json` in your project,
+or `~/.agent/config.json` globally.
+
+```json
+{
+  "llm": {
+    "provider": "custom",
+    "model": "your-model-id"
+  }
+}
+```
+
+Write a default config with `depression --init-config` (CLI bootstrap) or edit
+`.agent/config.json` directly.
+
+## Slash Commands
+
+Available inside the TUI input box:
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show help |
+| `/plan` | Switch to Plan mode (read-only analysis) |
+| `/build` | Switch to Build mode (full execution) |
+| `/auto` | Automatic Plan -> Build loop |
+| `/snapshot [message]` | Create a git-stash snapshot |
+| `/undo` | Restore the last snapshot |
+| `/model` · `/provider` | View / switch model or provider |
+| `/session` | Show / resume sessions |
+| `/compact` | Compact conversation context |
+| `/tools` · `/permissions` | List tools and permission rules |
+| `/plugins` | Load plugins |
+| `/metrics` · `/cost` · `/tokens` | Usage metrics and cost |
+| `/config` · `/set` | View / set config values |
+| `/exit` | Quit (also `Ctrl+Q`) |
+
+## TUI
+
+- **Mode toggle**: `Ctrl+P` cycles Plan → Build
+- **Permissions**: tool requests surface as interactive modal prompts (accept / deny)
+- **AWS panel**: manage AWS credentials from inside the UI
+- **Live panes**: thinking indicator, todo list, tool-call cards, diff view, sidebar
+
+## CLI Flags
+
+The `depression` entry point parses the following flags (used in CLI bootstrap
+and overridable before the TUI starts):
+
+```bash
+depression -p /path/to/project      # project directory
+depression -m MODEL                 # override model
+depression --provider PROVIDER      # override provider
+depression --yolo                   # auto-approve all tool calls
+depression --session <id>           # resume session
+depression --new-session            # force a fresh session
+depression --max-turns N            # agent loop limit
+depression --no-mcp                 # disable MCP
+depression -v / -q                  # verbose / quiet
+depression --skip-tui               # (reserved) CLI-only mode
+```
+
+## Project Structure
+
+```
+src/
+└── agent/
+    ├── agent/           # Plan + Build dual-agent orchestration, planner, loop
+    ├── cli/             # Classic CLI bootstrap (argparse, prompt-toolkit UI, slash commands)
+    ├── config/          # Layered configuration loader
+    ├── context/         # Context manager, compaction, file indexing
+    ├── llm/             # Runtime LLM registry + provider adapters, rate limiter
+    ├── mcp/             # Model Context Protocol client + AWS config
+    ├── permissions/     # Tool permission policy & approval
+    ├── plugins/         # Plugin loader (builtin)
+    ├── project/         # Workspace management
+    ├── session/         # Session persistence
+    ├── storage/         # SQLite database + cache
+    ├── tools/           # Built-in tools (terminal, git, filesystem, web, browser, AWS, ...)
+    ├── tui/             # Textual terminal UI (app, widgets, theme)
+    └── utils/           # Logging, platform, env helpers, redaction
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                       # run test suite
+ruff check src/              # lint
+ruff format --check src/     # formatting
+mypy src/                    # type checking
+```
+
+## License
+
+ISC License.

depression_ai-1.0.0/README.md

@@ -0,0 +1,170 @@
+# depression
+
+**AI agent for everything — development, deployment, and analysis.**
+
+A terminal-native agentic AI assistant. Sits in your terminal as a Textual TUI and
+drives a **Plan + Build** dual-agent system with full tool access, MCP support,
+and visual permission prompts.
+
+## Features
+
+- **Textual TUI** — interactive terminal UI with plan/build mode switching (`Ctrl+P`), AWS credentials panel, thinking indicator, todo panel, live tool-call cards, and diff view
+- **Dual-Agent Architecture** — Plan agent (read-only analysis) + Build agent (full tool execution)
+- **User-Configured LLM Runtime** — connect any OpenAI-compatible endpoint at runtime (base URL + API key + model); built-in provider adapters for Anthropic, Groq, NVIDIA, and local models
+- **Tool Calling** — terminal, filesystem, git, patch, search, web, todo, process, browser automation (Playwright), AWS
+- **MCP Support** — Model Context Protocol client with multiple servers
+- **Session Management** — persistent sessions stored in SQLite; resume with `/session`
+- **Snapshot / Undo** — git-stash-based snapshots for safe experimentation
+- **Subagents & Plugins** — parallel task execution and `@syntax` subagents, plugin loader
+- **Permission System** — per-tool approval rules with interactive modal prompts
+
+## Installation
+
+```bash
+git clone https://github.com/rnaveenpatil/depression.ai.git
+cd depression.ai
+pip install -e .
+```
+
+Optional extras:
+
+```bash
+# Browser automation tool (Playwright)
+pip install -e ".[browser]"
+playwright install chromium
+
+# Development (pytest, ruff, mypy)
+pip install -e ".[dev]"
+```
+
+## Quick Start
+
+```bash
+# Launch the TUI
+depression
+
+# Equivalent forms
+python -m agent.tui
+python -m agent.tui.run
+```
+
+Before first use you must connect an LLM endpoint (see [Runtime LLM Configuration](#runtime-llm-configuration)
+below). The TUI also offers an **LLM CONNECTION** panel to set base URL, API key,
+and model interactively.
+
+## Runtime LLM Configuration
+
+The agent is deliberately provider-agnostic: there are **no hardcoded API keys**.
+Configure a runtime provider via environment variables or the in-TUI connection
+panel. Copy `.env.example` to `.env`:
+
+```bash
+# User runtime LLM connection (never commit real secrets)
+DEPRESSION_PROVIDER=custom
+DEPRESSION_BASE_URL=https://api.example.com/v1
+DEPRESSION_API_KEY=
+DEPRESSION_MODEL=
+
+# AWS credentials entered by /aws panel
+AWS_ACCESS_KEY_ID=
+AWS_SECRET_ACCESS_KEY=
+AWS_DEFAULT_REGION=ap-south-1
+```
+
+## Configuration
+
+Layered config (project overrides user): `.agent/config.json` in your project,
+or `~/.agent/config.json` globally.
+
+```json
+{
+  "llm": {
+    "provider": "custom",
+    "model": "your-model-id"
+  }
+}
+```
+
+Write a default config with `depression --init-config` (CLI bootstrap) or edit
+`.agent/config.json` directly.
+
+## Slash Commands
+
+Available inside the TUI input box:
+
+| Command | Description |
+|---------|-------------|
+| `/help` | Show help |
+| `/plan` | Switch to Plan mode (read-only analysis) |
+| `/build` | Switch to Build mode (full execution) |
+| `/auto` | Automatic Plan -> Build loop |
+| `/snapshot [message]` | Create a git-stash snapshot |
+| `/undo` | Restore the last snapshot |
+| `/model` · `/provider` | View / switch model or provider |
+| `/session` | Show / resume sessions |
+| `/compact` | Compact conversation context |
+| `/tools` · `/permissions` | List tools and permission rules |
+| `/plugins` | Load plugins |
+| `/metrics` · `/cost` · `/tokens` | Usage metrics and cost |
+| `/config` · `/set` | View / set config values |
+| `/exit` | Quit (also `Ctrl+Q`) |
+
+## TUI
+
+- **Mode toggle**: `Ctrl+P` cycles Plan → Build
+- **Permissions**: tool requests surface as interactive modal prompts (accept / deny)
+- **AWS panel**: manage AWS credentials from inside the UI
+- **Live panes**: thinking indicator, todo list, tool-call cards, diff view, sidebar
+
+## CLI Flags
+
+The `depression` entry point parses the following flags (used in CLI bootstrap
+and overridable before the TUI starts):
+
+```bash
+depression -p /path/to/project      # project directory
+depression -m MODEL                 # override model
+depression --provider PROVIDER      # override provider
+depression --yolo                   # auto-approve all tool calls
+depression --session <id>           # resume session
+depression --new-session            # force a fresh session
+depression --max-turns N            # agent loop limit
+depression --no-mcp                 # disable MCP
+depression -v / -q                  # verbose / quiet
+depression --skip-tui               # (reserved) CLI-only mode
+```
+
+## Project Structure
+
+```
+src/
+└── agent/
+    ├── agent/           # Plan + Build dual-agent orchestration, planner, loop
+    ├── cli/             # Classic CLI bootstrap (argparse, prompt-toolkit UI, slash commands)
+    ├── config/          # Layered configuration loader
+    ├── context/         # Context manager, compaction, file indexing
+    ├── llm/             # Runtime LLM registry + provider adapters, rate limiter
+    ├── mcp/             # Model Context Protocol client + AWS config
+    ├── permissions/     # Tool permission policy & approval
+    ├── plugins/         # Plugin loader (builtin)
+    ├── project/         # Workspace management
+    ├── session/         # Session persistence
+    ├── storage/         # SQLite database + cache
+    ├── tools/           # Built-in tools (terminal, git, filesystem, web, browser, AWS, ...)
+    ├── tui/             # Textual terminal UI (app, widgets, theme)
+    └── utils/           # Logging, platform, env helpers, redaction
+```
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                       # run test suite
+ruff check src/              # lint
+ruff format --check src/     # formatting
+mypy src/                    # type checking
+```
+
+## License
+
+ISC License.

depression_ai-1.0.0/pyproject.toml

@@ -0,0 +1,70 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "depression.ai"
+version = "1.0.0"
+description = "AI agent for everything — development, deployment, and analysis"
+readme = "README.md"
+license = "ISC"
+authors = [{name = "rnaveenpatil", email = "rnaveenpatil@example.com"}]
+keywords = ["ai", "cli", "agent", "tui", "textual", "llm"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+requires-python = ">=3.10"
+dependencies = [
+    "httpx>=0.25.0",
+    "pyyaml>=6.0",
+    "prompt-toolkit>=3.0",
+    "textual>=0.80.0",
+]
+
+[project.optional-dependencies]
+browser = [
+    "playwright>=1.40.0",
+]
+tui = [
+    "textual-dev>=1.0.0",
+]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21",
+    "ruff>=0.1.0",
+    "mypy>=1.0",
+]
+
+[project.scripts]
+depression = "agent.main:main"
+depression_ai = "agent.main:main"
+depression-tui = "agent.tui.run:main"
+
+[project.urls]
+Homepage = "https://github.com/rnaveenpatil/depression.ai"
+Repository = "https://github.com/rnaveenpatil/depression.ai"
+Issues = "https://github.com/rnaveenpatil/depression.ai/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+exclude = ["tests*", "*.depression*"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+src = ["src"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true

depression_ai-1.0.0/setup.cfg

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

depression_ai-1.0.0/src/agent/__init__.py

@@ -0,0 +1,39 @@
+"""
+CLI Agent - Advanced Agentic AI CLI
+
+Top-level package exports.
+"""
+
+from agent.agent import Agent
+from agent.config import Config, get_config, load_config
+from agent.context import ContextManager
+from agent.permissions import PermissionManager
+from agent.session import SessionManager, Session, SessionState
+from agent.storage import Database, Cache
+from agent.project import WorkspaceManager
+from agent.mcp import MCPClient
+from agent.plugins import PluginLoader
+from agent.tools import ToolRegistry, BaseTool
+from agent.llm import get_llm_registry
+
+__all__ = [
+    "Agent",
+    "Config",
+    "get_config",
+    "load_config",
+    "ContextManager",
+    "PermissionManager",
+    "SessionManager",
+    "Session",
+    "SessionState",
+    "Database",
+    "Cache",
+    "WorkspaceManager",
+    "MCPClient",
+    "PluginLoader",
+    "ToolRegistry",
+    "BaseTool",
+    "get_llm_registry",
+]
+
+__version__ = "1.0.0"

depression_ai-1.0.0/src/agent/agent/__init__.py

@@ -0,0 +1,49 @@
+"""
+Agent Module - Core Agent Implementation.
+
+Exports:
+    Agent           -- Main orchestrator class
+    AgentStatus     -- Agent status enum
+    AgentContext    -- Runtime context dataclass
+    Planner         -- Task planner
+    AgentLoop       -- Execution loop
+    SubAgentManager -- Sub-agent management
+"""
+
+from agent.agent.agent import Agent, AgentStatus, AgentContext
+from agent.agent.planner import Planner, Plan, Task, TaskStatus, Priority
+from agent.agent.loop import AgentLoop, LoopState, LoopContext
+from agent.agent.subagent import (
+    SubAgentManager,
+    SubAgent,
+    SubAgentRole,
+    SubAgentConfig,
+    BUILTIN_SUBAGENTS,
+)
+
+# Backcompat aliases for legacy imports.
+SubAgentTask = SubAgent
+SubAgentType = SubAgentRole
+SubAgentStatus = str
+
+__all__ = [
+    "Agent",
+    "AgentStatus",
+    "AgentContext",
+    "Planner",
+    "Plan",
+    "Task",
+    "TaskStatus",
+    "Priority",
+    "AgentLoop",
+    "LoopState",
+    "LoopContext",
+    "SubAgentManager",
+    "SubAgent",
+    "SubAgentRole",
+    "SubAgentConfig",
+    "BUILTIN_SUBAGENTS",
+    "SubAgentTask",
+    "SubAgentType",
+    "SubAgentStatus",
+]