vibecore 0.2.0__py3-none-any.whl

vibecore/widgets/tool_messages.tcss

@@ -0,0 +1,289 @@
+ToolMessage {
+    Horizontal.tool-output {
+        height: auto;
+
+        &> .tool-output-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+        }
+
+        &> Vertical.tool-output-content {
+            height: auto;
+
+            &> .tool-output-content {
+                # color: $text-muted;
+            }
+
+            &> .tool-output-content-more {
+            }
+            }
+    }
+}
+
+PythonToolMessage {
+    Horizontal.python-code {
+        height: auto;
+        layers: main button;
+
+        &> .python-code-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        .copy-button {
+            layer: button;
+            dock: right;
+            height: 1;
+            width: 8;
+            min-width: 8;
+            margin: 0;
+            padding: 0;
+            background: $secondary;
+            color: $text;
+            border: none;
+            
+            &:hover {
+                background: $secondary-lighten-1;
+            }
+            
+            &:focus {
+                background: $secondary-lighten-1;
+                text-style: bold;
+            }
+        }
+
+        &> Vertical.python-code-content {
+            height: auto;
+            width: 1fr;
+        }
+    }
+    
+    Horizontal.tool-output {
+        height: auto;
+
+        &> .tool-output-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+        }
+
+        &> Vertical.tool-output-content {
+            height: auto;
+        }
+    }
+}
+
+TodoWriteToolMessage {
+    Horizontal.todo-list {
+        height: auto;
+
+        &> .todo-list-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.todo-list-content {
+            height: auto;
+            width: 1fr;
+            
+            .todo-item {
+                height: auto;
+                margin-left: 0;
+                padding: 0;
+                
+                &.in_progress {
+                    color: $success;
+                }
+                
+                &.pending {
+                    color: $text;
+                }
+                
+                &.completed {
+                    color: $text-muted;
+                    text-style: dim;
+                }
+            }
+        }
+    }
+}
+
+ReadToolMessage {
+    Horizontal.tool-output {
+        height: auto;
+
+        &> .tool-output-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.tool-output-content {
+            height: auto;
+            width: 1fr;
+        }
+    }
+}
+
+TaskToolMessage {
+    Horizontal.task-prompt {
+        height: auto;
+
+        &> .task-prompt-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.task-prompt-content {
+            height: auto;
+            width: 1fr;
+        }
+    }
+
+    Horizontal.tool-output {
+        height: auto;
+
+        &> .tool-output-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.tool-output-content {
+            height: auto;
+            width: 1fr;
+        }
+    }
+
+    .message-content {
+        height: auto;
+
+        &> .message-content-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.message-content-body {
+            height: auto;
+            width: 1fr;
+
+            &> MainScroll#messages {
+                height: auto;
+                max-height: 10;
+                width: 1fr;
+                overflow-y: auto;
+            }
+        }
+
+    }
+}
+
+WriteToolMessage {
+    Horizontal.write-content {
+        height: auto;
+
+        &> .write-content-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.write-content-body {
+            height: auto;
+            width: 1fr;
+            
+            .write-content-expandable {
+                height: auto;
+                width: 1fr;
+            }
+        }
+    }
+    
+    Horizontal.tool-output {
+        height: auto;
+
+        &> .tool-output-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.tool-output-content {
+            height: auto;
+            width: 1fr;
+            
+            .write-output-message {
+                color: $text-muted;
+            }
+        }
+    }
+}
+
+MCPToolMessage {
+    Horizontal.mcp-arguments {
+        height: auto;
+
+        &> .mcp-arguments-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.mcp-arguments-content {
+            height: auto;
+            width: 1fr;
+            
+            .mcp-arguments-label {
+                color: $text-muted;
+                # margin-bottom: 1;
+            }
+            
+            .mcp-arguments-text {
+                color: $text-muted;
+                text-overflow: ellipsis;
+            }
+        }
+    }
+    
+    Horizontal.tool-output {
+        height: auto;
+
+        &> .tool-output-prefix {
+            height: 1;
+            width: 5;
+            padding-left: 2;
+            padding-right: 1;
+            color: $text-muted;
+        }
+
+        &> Vertical.tool-output-content {
+            height: auto;
+            width: 1fr;
+        }
+    }
+}

vibecore-0.2.0.dist-info/METADATA

@@ -0,0 +1,407 @@
+Metadata-Version: 2.4
+Name: vibecore
+Version: 0.2.0
+Summary: Build your own AI-powered automation tools in the terminal with this extensible agent framework
+Project-URL: Homepage, https://github.com/serialx/vibecore
+Project-URL: Repository, https://github.com/serialx/vibecore
+Project-URL: Bug Tracker, https://github.com/serialx/vibecore/issues
+Project-URL: Discussions, https://github.com/serialx/vibecore/discussions
+Project-URL: Documentation, https://github.com/serialx/vibecore#readme
+Author-email: Sung-jin Brian Hong <serialx@serialx.net>
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,anthropic,assistant,automation,claude,cli,framework,gpt,mcp,model-context-protocol,openai,terminal,textual,tool-use,tui
+Classifier: Development Status :: 3 - Alpha
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: User Interfaces
+Classifier: Topic :: Terminals
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: litellm>=1.72.4
+Requires-Dist: openai-agents[litellm]>=0.2.2
+Requires-Dist: pydantic-settings>=2.10.1
+Requires-Dist: textual>=4.0.0
+Requires-Dist: typer>=0.14.0
+Description-Content-Type: text/markdown
+
+# vibecore
+
+<div align="center">
+
+[![PyPI version](https://badge.fury.io/py/vibecore.svg)](https://badge.fury.io/py/vibecore)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![PyPI downloads](https://img.shields.io/pypi/dm/vibecore.svg)](https://pypistats.org/packages/vibecore)
+[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-000000.svg)](https://github.com/astral-sh/ruff)
+[![Checked with pyright](https://microsoft.github.io/pyright/img/pyright_badge.svg)](https://microsoft.github.io/pyright/)
+
+**Build your own AI-powered automation tools in the terminal with this extensible agent framework**
+
+[Features](#features) " [Installation](#installation) " [Usage](#usage) " [Development](#development) " [Contributing](#contributing)
+
+</div>
+
+---
+
+<p align="center" style="max-width: 800px; margin: 0 auto;">
+    <img src="docs/images/screenshot.png" alt="vibecore terminal screenshot" style="max-width: 100%; height: auto;">
+</p>
+
+## Overview
+
+vibecore is a **Do-it-yourself Agent Framework** that transforms your terminal into a powerful AI workspace. More than just a chat interface, it's a complete platform for building and orchestrating custom AI agents that can manipulate files, execute code, run shell commands, and manage complex workflows—all from the comfort of your terminal.
+
+Built on [Textual](https://textual.textualize.io/) and the [OpenAI Agents SDK](https://github.com/openai/openai-agents-python), vibecore provides the foundation for creating your own AI-powered automation tools. Whether you're automating development workflows, building custom AI assistants, or experimenting with agent-based systems, vibecore gives you the building blocks to craft exactly what you need.
+
+### Key Features
+
+- **AI-Powered Chat Interface** - Interact with state-of-the-art language models through an intuitive terminal interface
+- **Rich Tool Integration** - Built-in tools for file operations, shell commands, Python execution, and task management
+- **MCP Support** - Connect to external tools and services via Model Context Protocol servers
+- **Beautiful Terminal UI** - Modern, responsive interface with dark/light theme support
+- **Real-time Streaming** - See AI responses as they're generated with smooth streaming updates
+- **Extensible Architecture** - Easy to add new tools and capabilities
+- **High Performance** - Async-first design for responsive interactions
+- **Context Management** - Maintains state across tool executions for coherent workflows
+
+## Installation
+
+### Prerequisites
+
+- Python 3.11 or higher
+
+### Install from PyPI
+
+```bash
+# Install vibecore
+pip install vibecore
+
+# Configure your API key
+export ANTHROPIC_API_KEY="your-api-key-here"
+# or
+export OPENAI_API_KEY="your-api-key-here"
+
+# Run vibecore
+vibecore
+```
+
+### Install from Source
+
+```bash
+# Clone the repository
+git clone https://github.com/serialx/vibecore.git
+cd vibecore
+
+# Install with pip
+pip install -e .
+
+# Or install with uv (recommended for development)
+uv sync
+
+# Configure your API key
+export ANTHROPIC_API_KEY="your-api-key-here"
+# or
+export OPENAI_API_KEY="your-api-key-here"
+
+# Run vibecore
+vibecore
+# or with uv
+uv run vibecore
+```
+
+## Usage
+
+### Basic Commands
+
+Once vibecore is running, you can:
+
+- **Chat naturally** - Type messages and press Enter to send
+- **Toggle theme** - Press `Ctrl+Shift+D` to toggle dark/light
+- **Cancel agent** - Press `Esc` to cancel the current operation
+- **Navigate history** - Use `Up/Down` arrows
+- **Exit** - Press `Ctrl+D` twice to confirm
+
+### Commands
+
+- `/help` - Show help and keyboard shortcuts
+- `/clear` - Clear the current session and start a new one
+
+### Available Tools
+
+vibecore comes with powerful built-in tools:
+
+#### File Operations
+```
+- Read files and directories
+- Write and edit files
+- Multi-edit for batch file modifications
+- Pattern matching with glob
+```
+
+#### Shell Commands
+```
+- Execute bash commands
+- Search with grep
+- List directory contents
+- File system navigation
+```
+
+#### Python Execution
+```
+- Run Python code in isolated environments
+- Persistent execution context
+- Full standard library access
+```
+
+#### Task Management
+```
+- Create and manage todo lists
+- Track task progress
+- Organize complex workflows
+```
+
+### MCP (Model Context Protocol) Support
+
+vibecore supports the [Model Context Protocol](https://modelcontextprotocol.io/), allowing you to connect to external tools and services through MCP servers.
+
+#### Configuring MCP Servers
+
+Create a `config.yaml` file in your project directory or add MCP servers to your environment:
+
+```yaml
+mcp_servers:
+  # Filesystem server for enhanced file operations
+  - name: filesystem
+    type: stdio
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
+    
+  # GitHub integration
+  - name: github
+    type: stdio
+    command: npx
+    args: ["-y", "@modelcontextprotocol/server-github"]
+    env:
+      GITHUB_PERSONAL_ACCESS_TOKEN: "your-github-token"
+    
+  # Custom HTTP server
+  - name: my-server
+    type: http
+    url: "http://localhost:8080/mcp"
+    allowed_tools: ["specific_tool"]  # Optional: whitelist specific tools
+```
+
+#### Available MCP Server Types
+
+- **stdio**: Spawns a local process (npm packages, executables)
+- **sse**: Server-Sent Events connection
+- **http**: HTTP-based MCP servers
+
+#### Tool Filtering
+
+Control which tools are available from each server:
+
+```yaml
+mcp_servers:
+  - name: restricted-server
+    type: stdio
+    command: some-command
+    allowed_tools: ["safe_read", "safe_write"]  # Only these tools available
+    blocked_tools: ["dangerous_delete"]         # These tools are blocked
+```
+
+## Development
+
+### Setting Up Development Environment
+
+```bash
+# Clone and enter the repository
+git clone https://github.com/serialx/vibecore.git
+cd vibecore
+
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Run tests by category
+uv run pytest tests/ui/        # UI and widget tests
+uv run pytest tests/tools/     # Tool functionality tests
+uv run pytest tests/session/   # Session tests
+
+# Run linting and formatting
+uv run ruff check .
+uv run ruff format .
+
+# Type checking
+uv run pyright
+```
+
+### Project Structure
+
+```
+vibecore/
+├── src/vibecore/
+│   ├── main.py              # Application entry point & TUI orchestration
+│   ├── context.py           # Central state management for agents
+│   ├── settings.py          # Configuration with Pydantic
+│   ├── agents/              # Agent configurations & handoffs
+│   │   └── default.py       # Main agent with tool integrations
+│   ├── models/              # LLM provider integrations
+│   │   └── anthropic.py     # Claude model support via LiteLLM
+│   ├── mcp/                 # Model Context Protocol integration
+│   │   └── manager.py       # MCP server lifecycle management
+│   ├── handlers/            # Stream processing handlers
+│   │   └── stream_handler.py # Handle streaming agent responses
+│   ├── session/             # Session management
+│   │   ├── jsonl_session.py # JSONL-based conversation storage
+│   │   └── loader.py        # Session loading logic
+│   ├── widgets/             # Custom Textual UI components
+│   │   ├── core.py          # Base widgets & layouts
+│   │   ├── messages.py      # Message display components
+│   │   ├── tool_message_factory.py  # Factory for creating tool messages
+│   │   ├── core.tcss        # Core styling
+│   │   └── messages.tcss    # Message-specific styles
+│   ├── tools/               # Extensible tool system
+│   │   ├── base.py          # Tool interfaces & protocols
+│   │   ├── file/            # File manipulation tools
+│   │   ├── shell/           # Shell command execution
+│   │   ├── python/          # Python code interpreter
+│   │   └── todo/            # Task management system
+│   └── prompts/             # System prompts & instructions
+├── tests/                   # Comprehensive test suite
+│   ├── ui/                  # UI and widget tests
+│   ├── tools/               # Tool functionality tests
+│   ├── session/             # Session and storage tests
+│   ├── cli/                 # CLI and command tests
+│   ├── models/              # Model integration tests
+│   └── _harness/            # Test utilities
+├── pyproject.toml           # Project configuration & dependencies
+├── uv.lock                  # Locked dependencies
+└── CLAUDE.md                # AI assistant instructions
+```
+
+### Code Quality
+
+We maintain high code quality standards:
+
+- **Linting**: Ruff for fast, comprehensive linting
+- **Formatting**: Ruff formatter for consistent code style
+- **Type Checking**: Pyright for static type analysis
+- **Testing**: Pytest for comprehensive test coverage
+
+Run all checks:
+```bash
+uv run ruff check . && uv run ruff format --check . && uv run pyright . && uv run pytest
+```
+
+## Configuration
+
+### Reasoning Effort
+
+- Set default via env var: `VIBECORE_REASONING_EFFORT` (minimal | low | medium | high)
+- Keyword triggers: `think` → low, `think hard` → medium, `ultrathink` → high
+
+### Environment Variables
+
+```bash
+# Model configuration
+ANTHROPIC_API_KEY=sk-...        # For Claude models
+OPENAI_API_KEY=sk-...          # For GPT models
+
+# OpenAI Models
+VIBECORE_DEFAULT_MODEL=o3
+VIBECORE_DEFAULT_MODEL=gpt-4.1
+# Claude
+VIBECORE_DEFAULT_MODEL=anthropic/claude-sonnet-4-20250514
+# Use any LiteLLM supported models
+VIBECORE_DEFAULT_MODEL=litellm/deepseek/deepseek-chat
+# Local models. Use with OPENAI_BASE_URL
+VIBECORE_DEFAULT_MODEL=qwen3-30b-a3b-mlx@8bit
+```
+
+## Contributing
+
+We welcome contributions! Here's how to get started:
+
+1. **Fork the repository** and create your branch from `main`
+2. **Make your changes** and ensure all tests pass
+3. **Add tests** for any new functionality
+4. **Update documentation** as needed
+5. **Submit a pull request** with a clear description
+
+### Development Guidelines
+
+- Follow the existing code style and patterns
+- Write descriptive commit messages
+- Add type hints to all functions
+- Ensure your code passes all quality checks
+- Update tests for any changes
+
+### Reporting Issues
+
+Found a bug or have a feature request? Please [open an issue](https://github.com/serialx/vibecore/issues) with:
+- Clear description of the problem or feature
+- Steps to reproduce (for bugs)
+- Expected vs actual behavior
+- Environment details (OS, Python version)
+
+## Architecture
+
+vibecore is built with a modular, extensible architecture:
+
+- **Textual Framework**: Provides the responsive TUI foundation
+- **OpenAI Agents SDK**: Powers the AI agent capabilities
+- **Async Design**: Ensures smooth, non-blocking interactions
+- **Tool System**: Modular tools with consistent interfaces
+- **Context Management**: Maintains state across operations
+
+## Recent Updates
+
+- **Reasoning View**: New ReasoningMessage widget with live reasoning summaries during streaming
+- **Context Usage Bar & CWD**: Footer shows token usage progress and current working directory
+- **Keyboard & Commands**: Ctrl+Shift+D toggles theme, Esc cancels, Ctrl+D double-press to exit, `/help` and `/clear` commands
+- **MCP Tool Output**: Improved rendering with Markdown and JSON prettification
+- **MCP Support**: Full integration with Model Context Protocol for external tool connections
+- **Print Mode**: `-p` flag to print response and exit for pipes/automation
+
+## Roadmap
+
+- [x] More custom tool views (Python, Read, Todo widgets)
+- [x] Automation (vibecore -p "prompt")
+- [x] MCP (Model Context Protocol) support
+- [ ] Permission model
+- [ ] Multi-agent system (agent-as-tools)
+- [ ] Plugin system for custom tools
+- [ ] Automated workflow
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+
+- Built with [Textual](https://textual.textualize.io/) - The amazing TUI framework
+- Powered by [OpenAI Agents SDK](https://github.com/openai/openai-agents-python)
+- Inspired by the growing ecosystem of terminal-based AI tools
+
+---
+
+<div align="center">
+
+**Made with love by the vibecore community**
+
+[Report Bug](https://github.com/serialx/vibecore/issues) " [Request Feature](https://github.com/serialx/vibecore/issues) " [Join Discussions](https://github.com/serialx/vibecore/discussions)
+
+</div>