llm-interceptor 2.0.0__tar.gz

llm_interceptor-2.0.0/.github/workflows/ci.yml

@@ -0,0 +1,90 @@
+name: CI
+
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Run linting with ruff
+        run: uv run ruff check src/
+
+      - name: Run type checking with mypy
+        run: uv run mypy src/cci --ignore-missing-imports
+        continue-on-error: true
+
+      - name: Run tests
+        run: uv run pytest tests/ -v --tb=short
+        continue-on-error: true
+
+      - name: Verify CLI works
+        run: |
+          uv run cci --version
+          uv run cci --help
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: ui/package-lock.json
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install Node.js dependencies
+        run: npm ci
+        working-directory: ui
+
+      - name: Build UI
+        run: npm run build
+        working-directory: ui
+
+      - name: Copy UI assets to static directory
+        run: |
+          mkdir -p src/cci/static
+          cp -r ui/dist/* src/cci/static/
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

llm_interceptor-2.0.0/.github/workflows/publish.yml

@@ -0,0 +1,100 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      test_pypi:
+        description: 'Publish to Test PyPI instead of PyPI'
+        required: false
+        default: 'false'
+        type: boolean
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: ui/package-lock.json
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.11
+
+      - name: Install Node.js dependencies
+        run: npm ci
+        working-directory: ui
+
+      - name: Build UI
+        run: npm run build
+        working-directory: ui
+
+      - name: Copy UI assets to static directory
+        run: |
+          mkdir -p src/cci/static
+          cp -r ui/dist/* src/cci/static/
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-test-pypi:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.test_pypi == 'true'
+    environment:
+      name: test-pypi
+      url: https://test.pypi.org/project/llm-interceptor/
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Publish to Test PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-pypi:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && github.event.inputs.test_pypi == 'false')
+    environment:
+      name: pypi
+      url: https://pypi.org/project/llm-interceptor/
+
+    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

llm_interceptor-2.0.0/.gitignore

@@ -0,0 +1,93 @@
+# 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/
+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
+*~
+
+# Project specific
+*.jsonl
+cci.toml
+cci.yaml
+cci.yml
+split_output/
+traces/
+# mitmproxy certificates (user should manage these separately)
+.mitmproxy/
+
+# uv
+.uv/
+uv.lock
+
+# OS files
+.DS_Store
+Thumbs.db
+*_output/
+
+# UI Development
+ui/node_modules/
+ui/dist/
+
+# Built UI static files (generated by build_ui.py)
+src/cci/static/

llm_interceptor-2.0.0/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.4
+    hooks:
+      # Run the linter (Python only, exclude frontend)
+      - id: ruff
+        args: [--fix]
+        types: [python]
+        exclude: ^ui/
+      # Run the formatter (Python only, exclude frontend)
+      - id: ruff-format
+        types: [python]
+        exclude: ^ui/
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-added-large-files

llm_interceptor-2.0.0/CHANGELOG.md

@@ -0,0 +1,170 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [2.0.0] - 2025-12-18
+
+### Added
+
+- **LLM Interceptor branding** - Complete rebranding from Claude Code Inspector to LLM Interceptor (LLI)
+- **Performance optimizations** - Base performance improvements for better efficiency
+
+### Changed
+
+- **Project rename** - Renamed from `cci` to `lli` (LLM Interceptor) across all components
+- **CLI command** - Primary command changed from `cci` to `lli`
+- **Package name** - Updated package name to `llm-interceptor`
+- **Log improvements** - Enhanced log output coloring and deduplication for better readability
+
+---
+
+## [1.4.0] - 2025-12-16
+
+### Added
+
+- **Annotation system** - Add annotation support for sessions and requests
+- **UI enhancements**
+  - Favicon and custom page title
+  - Chat scroll buttons for easier navigation
+  - JSON text wrapping toggle in raw view
+  - Auto-select newest session on load
+  - Sticky tool name header for better context awareness
+
+### Fixed
+
+- **Windows compatibility** - Fixed npm build command execution on Windows using `shell=True`
+- **Port conflict detection** - Check if UI port is in use before starting server
+- **Data normalization** - Normalize token usage and static file MIME types
+- **UI fixes**
+  - Fixed system instruction color display
+  - Fixed sticky tool header flicker during scroll
+
+### Changed
+
+- **Code organization** - Refactored UI into modular components and hooks
+- **CLI improvements** - Centralized Rich Console instance for unified output
+- **Better feedback** - CLI now uses `console.status` for improved user feedback
+- **OpenAI compatibility** - Normalize OpenAI system content to string format
+
+---
+
+## [1.3.0] - 2025-12-09
+
+### Added
+
+- **React Web UI** - Modern web interface for trace analysis
+  - Beautiful dark/light theme with toggle support
+  - Session list with timestamp-based sorting
+  - Conversation view with system prompts, messages, and tool calls
+  - Multiple view tabs: Chat, System, Tools, and Raw JSON
+  - Automatic API format detection (Anthropic/OpenAI)
+  - Real-time session updates via polling
+- **FastAPI server** - Backend API for serving UI and session data
+  - RESTful endpoints for sessions and session details
+  - Static file serving for bundled React app
+- **UI auto-launch** - `cci watch` now automatically starts the UI server (default: enabled)
+- **Build script** - `build_ui.py` for building frontend assets
+
+### Changed
+
+- **GitHub Actions** - Updated CI/CD workflows to build frontend UI before packaging
+- **Dependencies** - Added `fastapi`, `uvicorn`, `python-multipart`, `watchdog`
+
+---
+
+## [1.2.0] - 2025-12-09
+
+### Added
+
+- **New `watch` command** - Continuous session capture mode for real-time monitoring
+  - Automatic session management with timestamped directories
+  - Support for custom URL patterns via `--include` option
+- **Streamlit app for AI Traffic Inspector** - Web-based UI for traffic analysis
+- **Glob pattern support** - URL filtering now supports glob patterns for more flexible matching
+
+### Changed
+
+- **CLI refactoring** - Removed `capture` command and updated subcommands for cleaner interface
+
+---
+
+## [1.1.0] - 2025-11-28
+
+### Added
+
+- **New `split` command** - Split JSONL trace files into individual JSON files for easier analysis
+  - Output individual JSON files for each request and response
+  - Support for extracting tool_calls from messages
+- **Enhanced `merge` command**
+  - Added tool_calls extraction support
+  - Output separate request and response lines for better organization
+- **JSONLWriter improvements**
+  - Added file overwrite option for more flexible output handling
+
+### Fixed
+
+- Corrected SSE streaming response capture for more reliable data collection
+
+### Changed
+
+- Improved code formatting and readability throughout the codebase
+
+---
+
+## [1.0.0] - 2025-11-25
+
+### Added
+
+- Initial release (project formerly known as Claude-Code-Inspector / CCI)
+- **Core Features**
+  - MITM proxy server using mitmproxy for traffic interception
+  - Support for both streaming (SSE) and non-streaming API responses
+  - Automatic API key masking in captured logs
+  - JSONL output format for easy analysis
+  - Stream merger utility to consolidate streaming chunks
+
+- **CLI Commands**
+  - `cci capture` - Start proxy and capture LLM API traffic
+  - `cci merge` - Merge streaming response chunks into complete records
+  - `cci config` - Display configuration and setup help
+  - `cci stats` - Show statistics for captured trace files
+
+- **Supported LLM Providers**
+  - Anthropic (api.anthropic.com)
+  - OpenAI (api.openai.com)
+  - Google (generativelanguage.googleapis.com)
+  - Together (api.together.xyz)
+  - Groq (api.groq.com)
+  - Mistral (api.mistral.ai)
+  - Cohere (api.cohere.ai)
+  - DeepSeek (api.deepseek.com)
+  - Custom providers via `--include` pattern
+
+- **Configuration**
+  - TOML/YAML configuration file support
+  - Environment variable overrides
+  - URL pattern filtering (include/exclude)
+  - Sensitive header masking
+  - Log rotation support
+
+- **Documentation**
+  - Comprehensive README with installation instructions
+  - Certificate installation guide for macOS, Linux, and Windows
+  - Node.js application configuration (NODE_EXTRA_CA_CERTS)
+  - Troubleshooting guide
+
+- **CI/CD**
+  - GitHub Actions workflow for CI (test on Ubuntu, macOS, Windows)
+  - GitHub Actions workflow for PyPI publishing
+  - Support for Python 3.10, 3.11, 3.12
+
+### Technical Details
+
+- Built with Python 3.10+
+- Uses mitmproxy for HTTPS interception
+- Pydantic for data models and validation
+- Click for CLI interface
+- Rich for beautiful terminal output