cachibot 0.2.0__tar.gz

cachibot-0.2.0/.dockerignore

@@ -0,0 +1,52 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.py[cod]
+*$py.class
+*.so
+.Python
+.venv
+venv
+ENV
+env
+*.egg-info
+.eggs
+dist
+build
+
+# IDE
+.idea
+.vscode
+*.swp
+*.swo
+
+# Testing
+.pytest_cache
+.coverage
+htmlcov
+.tox
+.nox
+
+# Documentation
+docs/_build
+*.md
+
+# Frontend (built separately)
+frontend/node_modules
+frontend/dist
+frontend/.git
+
+# Local config
+*.local
+.env
+.env.*
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Website (static, not needed in backend)
+website/

cachibot-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,71 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff mypy
+
+      - name: Run Ruff linter
+        run: ruff check .
+
+      - name: Run Ruff formatter check
+        run: ruff format --check .
+
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest -v
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run mypy
+        run: mypy src/cachibot

cachibot-0.2.0/.github/workflows/publish.yml

@@ -0,0 +1,74 @@
+name: Publish to PyPI
+
+on:
+  push:
+    branches: [dev]
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-testpypi:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/dev'
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/cachibot/
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'release' && github.event.action == 'published'
+    environment:
+      name: pypi
+      url: https://pypi.org/project/cachibot/
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

cachibot-0.2.0/.gitignore

@@ -0,0 +1,90 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+/lib/
+lib64/
+!frontend/src/lib/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# macOS
+.DS_Store
+
+# Windows
+Thumbs.db
+ehthumbs.db
+Desktop.ini
+
+# Project specific
+cachibot.toml
+.cachibot/
+
+# Secrets
+*.pem
+*.key
+.env*
+
+nul
+error.log
+website/*
+settings.local.json

cachibot-0.2.0/CLAUDE.md

@@ -0,0 +1,73 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+CachiBot is a security-focused AI agent that uses the Prompture library for structured LLM interactions. It features a Python backend (FastAPI) with WebSocket streaming and a React+TypeScript frontend.
+
+## Common Commands
+
+### Backend Development
+```bash
+pip install -e ".[dev]"          # Install with dev dependencies
+cachibot-server                   # Start API server (port 6392)
+cachibot "your prompt"            # Run single prompt via CLI
+cachibot -i                       # Interactive mode
+pytest                            # Run all tests
+pytest -v                         # Verbose test output
+ruff check .                      # Lint Python code
+ruff format .                     # Format Python code
+mypy src/cachibot                 # Type check
+```
+
+### Frontend Development
+```bash
+cd frontend
+npm install                       # Install dependencies
+npm run dev                       # Start Vite dev server (port 5173)
+npm run build                     # Production build
+npm run lint                      # ESLint
+```
+
+The frontend dev server proxies `/api` and `/ws` to `http://127.0.0.1:6392`.
+
+## Architecture
+
+### Backend (`src/cachibot/`)
+- **agent.py**: Core `CachibotAgent` dataclass wrapping Prompture's Agent with callbacks, tool registration, and Python sandbox
+- **cli.py**: Typer-based CLI with `cachibot` and `cachi` entry points
+- **api/server.py**: FastAPI app with lifespan management
+- **api/websocket.py**: WebSocket streaming for real-time agent responses
+- **api/routes/**: REST endpoints (chat, config, health, models)
+- **models/**: Pydantic schemas for chat, config, jobs, websocket messages
+- **storage/**: SQLite async database layer with repository pattern
+
+### Frontend (`frontend/src/`)
+- **stores/**: Zustand state management with localStorage persistence
+  - `bots.ts`: Bot/Chat/Jobs/Tasks stores
+  - `ui.ts`: UI state (sidebar, themes)
+  - `connections.ts`: API connection state
+- **api/**: REST client and WebSocket management
+- **components/**: React components organized by feature (chat/, common/, dialogs/, layout/, views/)
+
+### Agent Tool System
+Built-in tools registered in `agent.py`:
+- `python_execute`: Sandboxed Python execution with AST risk analysis
+- `file_read`, `file_write`, `file_list`, `file_edit`: Workspace file operations
+- `task_complete`: Signal task completion
+
+### Configuration
+Supports TOML config files (`~/.cachibot.toml` or `./cachibot.toml`) with environment variable overrides. See `cachibot.example.toml` for all options.
+
+## Code Style
+
+### Python
+- Google-style docstrings
+- Type hints required (mypy strict)
+- Ruff formatter with line length 100
+
+### TypeScript
+- Strict mode enabled
+- Path alias: `@/*` maps to `src/*`
+- ESLint with React Hooks and React Refresh plugins

cachibot-0.2.0/CONTRIBUTING.md

@@ -0,0 +1,155 @@
+# Contributing to Cachibot
+
+Thank you for your interest in contributing to Cachibot! 🛡️
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.10 or higher
+- An Anthropic API key
+
+### Development Setup
+
+1. **Clone the repository**
+
+```bash
+git clone https://github.com/jhd3197/cachibot.git
+cd cachibot
+```
+
+2. **Create a virtual environment**
+
+```bash
+python -m venv venv
+
+# Windows
+.\venv\Scripts\activate
+
+# Unix/macOS
+source venv/bin/activate
+```
+
+3. **Install in development mode**
+
+```bash
+pip install -e ".[dev]"
+```
+
+4. **Set up your API key**
+
+```bash
+# Windows PowerShell
+$env:ANTHROPIC_API_KEY = "your-api-key"
+
+# Unix/macOS
+export ANTHROPIC_API_KEY="your-api-key"
+```
+
+## Development Workflow
+
+### Running Tests
+
+```bash
+pytest
+```
+
+### Linting
+
+```bash
+ruff check src/
+ruff format src/
+```
+
+### Type Checking
+
+```bash
+mypy src/cachibot
+```
+
+## Code Style
+
+- We use [Ruff](https://github.com/astral-sh/ruff) for linting and formatting
+- Type hints are required for all public functions
+- Docstrings follow Google style
+
+### Example
+
+```python
+def process_file(path: str, encoding: str = "utf-8") -> str:
+    """
+    Process a file and return its contents.
+    
+    Args:
+        path: Path to the file to process
+        encoding: File encoding (default: utf-8)
+        
+    Returns:
+        The processed file contents
+        
+    Raises:
+        FileNotFoundError: If the file doesn't exist
+    """
+    ...
+```
+
+## Adding New Tools
+
+Tools are the actions Cachibot can take. To add a new tool:
+
+1. Create a new file in `src/cachibot/tools/`
+2. Inherit from `BaseTool`
+3. Implement the `execute` method
+4. Register in `agent.py`
+
+### Example Tool
+
+```python
+from cachibot.tools import BaseTool, ToolResult
+
+class MyTool(BaseTool):
+    name = "my_tool"
+    description = "Does something useful"
+    
+    def execute(self, param1: str, **kwargs) -> ToolResult:
+        try:
+            # Do something
+            return ToolResult.ok("Success!")
+        except Exception as e:
+            return ToolResult.fail(str(e))
+```
+
+## Pull Request Process
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes
+4. Run tests and linting
+5. Commit your changes (`git commit -m 'Add amazing feature'`)
+6. Push to your fork (`git push origin feature/amazing-feature`)
+7. Open a Pull Request
+
+### PR Guidelines
+
+- Keep PRs focused on a single feature or fix
+- Update documentation if needed
+- Add tests for new functionality
+- Follow existing code style
+
+## Reporting Issues
+
+When reporting issues, please include:
+
+- Python version
+- Operating system
+- Steps to reproduce
+- Expected vs actual behavior
+- Any error messages
+
+## Questions?
+
+Feel free to open an issue for questions or join discussions.
+
+---
+
+Made with 🛡️ by [jhd3197](https://jhd3197.com)

cachibot-0.2.0/Dockerfile

@@ -0,0 +1,24 @@
+# CachiBot - The Armored AI Agent
+# Multi-stage build for Python backend
+
+FROM python:3.11-slim AS backend
+
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    build-essential \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy project files
+COPY pyproject.toml README.md ./
+COPY src/ ./src/
+
+# Install the package
+RUN pip install --no-cache-dir -e .
+
+# Expose backend port
+EXPOSE 6392
+
+# Run the server
+CMD ["cachibot-server"]

cachibot-0.2.0/LICENSE

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