prela 0.1.0__tar.gz

prela-0.1.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for trusted publishing
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

prela-0.1.0/.github/workflows/publish-testpypi.yml

@@ -0,0 +1,35 @@
+name: Publish to TestPyPI
+
+on:
+  workflow_dispatch:  # Manual trigger for testing
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write  # Required for trusted publishing
+      contents: read
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install build tools
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine
+
+      - name: Build package
+        run: python -m build
+
+      - name: Check package
+        run: twine check dist/*
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

prela-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,62 @@
+name: Test
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.9', '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,all]"
+
+      - name: Run tests
+        run: pytest --cov=prela --cov-report=xml --cov-report=term
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v3
+        if: matrix.python-version == '3.11'
+        with:
+          file: ./coverage.xml
+          fail_ci_if_error: false
+
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
+
+      - name: Run ruff
+        run: ruff check .
+
+      - name: Run black
+        run: black --check .
+
+      - name: Run mypy
+        run: mypy prela

prela-0.1.0/.gitignore

@@ -0,0 +1,157 @@
+# 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/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# 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/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+.idea/
+
+# VS Code
+.vscode/
+
+# Ruff
+.ruff_cache/
+
+# macOS
+.DS_Store
+
+# Prela specific
+test_traces/
+eval_results/
+test_scenarios/
+traces/
+.prela.yaml

prela-0.1.0/CHANGELOG.md

@@ -0,0 +1,70 @@
+# 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.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-02-04
+
+### Added
+
+**Core Observability:**
+- Complete tracing SDK with span lifecycle management
+- Context propagation (async/threading safe)
+- Multiple sampling strategies (always on/off, probabilistic, rate limiting)
+- Console, file, HTTP, and ClickHouse exporters
+
+**Auto-Instrumentation (10 frameworks):**
+- OpenAI SDK instrumentation
+- Anthropic/Claude SDK instrumentation
+- LangChain chains and agents
+- LlamaIndex queries
+- CrewAI task-based agents
+- AutoGen conversational agents
+- LangGraph graph-based workflows
+- OpenAI Swarm handoff-based agents
+- N8N webhook and code node integration
+
+**Evaluation Framework:**
+- 17+ assertion types for testing agent behavior
+- Structural assertions (contains, regex, JSON schema, length)
+- Semantic assertions (embedding-based similarity with fallback)
+- Tool assertions (tool called, args validation, sequence checking)
+- Multi-agent assertions (agent usage, task completion, delegation patterns)
+- 3 reporter types (Console, JSON, JUnit)
+- Parallel test execution with progress callbacks
+- N8N-specific evaluation support
+
+**Replay Engine:**
+- Deterministic replay for debugging
+- API retry with exponential backoff
+- Tool re-execution with allowlist/blocklist controls
+- Retrieval re-execution with ChromaDB support
+- Semantic output comparison with difflib fallback
+- Streaming support for OpenAI and Anthropic APIs
+
+**CLI Tools:**
+- `prela list` - List traces with filters
+- `prela show` - Show trace details
+- `prela last` - Show most recent trace
+- `prela search` - Full-text search
+- `prela errors` - Show failed traces
+- `prela tail` - Real-time trace following
+- Interactive TUI explorer with Textual
+
+**Testing & Quality:**
+- 836+ comprehensive tests
+- 95%+ code coverage
+- Full type hints (mypy strict mode)
+- Linting with ruff and black
+- CI/CD with GitHub Actions
+
+### Technical Details
+
+- **Python Support:** 3.9, 3.10, 3.11, 3.12
+- **Build System:** Hatchling
+- **License:** Apache 2.0
+- **Package Name:** `prela`
+
+[0.1.0]: https://github.com/garrettw2200/prela-sdk/releases/tag/v0.1.0

prela-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,244 @@
+# Contributing to Prela SDK
+
+Thank you for your interest in contributing to Prela! We welcome contributions from the community.
+
+## Development Setup
+
+### Prerequisites
+
+- Python 3.9 or higher
+- pip
+- git
+
+### Installation
+
+1. **Fork and clone the repository**
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/prela-sdk.git
+   cd prela-sdk
+   ```
+
+2. **Create a virtual environment**
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # On Windows: venv\Scripts\activate
+   ```
+
+3. **Install development dependencies**
+   ```bash
+   pip install -e ".[dev,all]"
+   ```
+
+   This installs:
+   - Core SDK package in editable mode
+   - Development tools (pytest, ruff, black, mypy)
+   - All optional dependencies for integrations
+
+## Running Tests
+
+### Run all tests
+```bash
+pytest
+```
+
+### Run with coverage
+```bash
+pytest --cov=prela --cov-report=html
+```
+
+### Run specific test file
+```bash
+pytest tests/test_tracer.py
+```
+
+### Run tests matching a pattern
+```bash
+pytest -k "test_span"
+```
+
+## Code Style
+
+We use several tools to maintain code quality:
+
+### Linting
+```bash
+ruff check .
+```
+
+To auto-fix issues:
+```bash
+ruff check --fix .
+```
+
+### Formatting
+```bash
+black .
+```
+
+### Type Checking
+```bash
+mypy prela
+```
+
+### Run all checks
+```bash
+# Before submitting a PR, run all checks:
+ruff check .
+black --check .
+mypy prela
+pytest
+```
+
+## Making Changes
+
+### 1. Create a branch
+
+```bash
+git checkout -b feature/my-new-feature
+# or
+git checkout -b fix/my-bug-fix
+```
+
+### 2. Make your changes
+
+- Write clear, concise code
+- Add tests for new functionality
+- Update documentation if needed
+- Follow existing code patterns
+
+### 3. Test your changes
+
+```bash
+# Run tests
+pytest
+
+# Run linters
+ruff check .
+black .
+mypy prela
+```
+
+### 4. Commit your changes
+
+```bash
+git add .
+git commit -m "feat: add new feature"
+```
+
+**Commit message format:**
+- `feat:` New feature
+- `fix:` Bug fix
+- `docs:` Documentation changes
+- `test:` Test changes
+- `refactor:` Code refactoring
+- `chore:` Maintenance tasks
+
+### 5. Push and create a pull request
+
+```bash
+git push origin feature/my-new-feature
+```
+
+Then go to GitHub and create a pull request.
+
+## Pull Request Guidelines
+
+### Before submitting
+
+- [ ] All tests pass locally
+- [ ] Code is formatted with black
+- [ ] Linting passes (ruff)
+- [ ] Type checking passes (mypy)
+- [ ] New features have tests
+- [ ] Documentation is updated
+
+### PR Description
+
+Include:
+- Summary of changes
+- Motivation/reasoning
+- Related issue number (if applicable)
+- Breaking changes (if any)
+
+### Review Process
+
+1. Maintainers will review your PR
+2. Address any feedback or requested changes
+3. Once approved, your PR will be merged
+
+## Adding New Integrations
+
+To add support for a new AI framework:
+
+1. **Create instrumentor file**
+   ```
+   prela/instrumentation/your_framework.py
+   ```
+
+2. **Implement the instrumentor class**
+   ```python
+   from prela.instrumentation.base import Instrumentor
+
+   class YourFrameworkInstrumentor(Instrumentor):
+       def install(self):
+           # Patch/wrap framework methods
+           pass
+
+       def uninstall(self):
+           # Restore original methods
+           pass
+   ```
+
+3. **Register in auto.py**
+   ```python
+   INSTRUMENTORS = {
+       ...
+       "your_framework": YourFrameworkInstrumentor,
+   }
+   ```
+
+4. **Add tests**
+   ```
+   tests/instrumentation/test_your_framework.py
+   ```
+
+5. **Update documentation**
+   - Add example to `examples/`
+   - Document in README
+
+## Reporting Issues
+
+### Bug Reports
+
+Include:
+- Prela version (`prela.__version__`)
+- Python version
+- Operating system
+- Minimal code to reproduce
+- Expected vs actual behavior
+- Error messages/stack traces
+
+### Feature Requests
+
+Include:
+- Use case/motivation
+- Proposed API (if applicable)
+- Examples of how it would be used
+
+## Code of Conduct
+
+Be respectful and inclusive. We're all here to build something great together.
+
+## Questions?
+
+- Open an issue for general questions
+- Check existing issues/PRs first
+- Join our community discussions
+
+## License
+
+By contributing to Prela, you agree that your contributions will be licensed under the Apache 2.0 License.
+
+---
+
+Thank you for contributing to Prela! 🎉