mseep-agentops 0.4.18__tar.gz → 0.4.22__tar.gz

mseep_agentops-0.4.22/.gitattributes

@@ -0,0 +1 @@
+uv.lock binary

mseep_agentops-0.4.22/.gitignore

@@ -0,0 +1,183 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+!app/dashboard/lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.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
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+.python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/#use-with-ide
+.pdm.toml
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__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
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# VSCode
+.vscode/
+
+# Cursor
+.cursorrules
+
+# Benchmarks
+.benchmarks/
+
+# MacOS
+.DS_Store
+
+# Database
+.db
+
+# Time travel
+agentops_time_travel.json
+.agentops_time_travel.yaml
+
+# Node
+node_modules

mseep_agentops-0.4.22/.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: "v0.12.9"
+    hooks:
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+        exclude: ^app/
+      - id: ruff-format
+        exclude: ^app/

mseep_agentops-0.4.22/CONTRIBUTING.md

@@ -0,0 +1,390 @@
+# Contributing to AgentOps
+
+Thanks for checking out AgentOps. We're building tools to help developers like you make AI agents that actually work reliably. If you've ever tried to build an agent system, you know the pain - they're a nightmare to debug, impossible to monitor, and when something goes wrong... good luck figuring out why.
+
+We created AgentOps to solve these headaches, and we'd love your help making it even better. Our SDK hooks into all the major Python frameworks (AG2, CrewAI, LangChain) and LLM providers (OpenAI, Anthropic, Cohere, etc.) to give you visibility into what your agents are actually doing.
+
+## How You Can Help
+
+There are tons of ways to contribute, and we genuinely appreciate all of them:
+
+1. **Add More Providers**: Help us support new LLM providers. Each one helps more developers monitor their agents.
+2. **Improve Framework Support**: Using a framework we don't support yet? Help us add it!
+3. **Make Docs Better**: Found our docs confusing? Help us fix them! Clear documentation makes everyone's life easier.
+4. **Share Your Experience**: Using AgentOps? Let us know what's working and what isn't. Your feedback shapes our roadmap.
+
+Even if you're not ready to contribute code, we'd love to hear your thoughts. Drop into our Discord, open an issue, or start a discussion. We're building this for developers like you, so your input matters.
+
+## Table of Contents
+- [Getting Started](#getting-started)
+- [Development Environment](#development-environment)
+- [Testing](#testing)
+- [Adding LLM Providers](#adding-llm-providers)
+- [Code Style](#code-style)
+- [Pull Request Process](#pull-request-process)
+- [Documentation](#documentation)
+
+## Getting Started
+
+1. **Fork and Clone**:
+   First, fork the repository by clicking the 'Fork' button in the top right of the [AgentOps repository](https://github.com/AgentOps-AI/agentops). This creates your own copy of the repository where you can make changes.
+
+   Then clone your fork:
+   ```bash
+   git clone https://github.com/YOUR_USERNAME/agentops.git
+   cd agentops
+   ```
+
+   Add the upstream repository to stay in sync:
+   ```bash
+   git remote add upstream https://github.com/AgentOps-AI/agentops.git
+   git fetch upstream
+   ```
+
+   Before starting work on a new feature:
+   ```bash
+   git checkout main
+   git pull upstream main
+   git checkout -b feature/your-feature-name
+   ```
+
+2. **Install Dependencies**:
+   ```bash
+   pip install -e .
+   ```
+
+3. **Set Up Pre-commit Hooks**:
+   ```bash
+   pre-commit install
+   ```
+
+## Development Environment
+
+1. **Environment Variables**:
+   Create a `.env` file:
+   ```
+   AGENTOPS_API_KEY=your_api_key
+   OPENAI_API_KEY=your_openai_key  # For testing
+   ANTHROPIC_API_KEY=your_anthropic_key  # For testing
+   # Other keys...
+   ```
+
+2. **Virtual Environment**:
+   We recommend using `poetry` or `venv`:
+   ```bash
+   python -m venv venv
+   source venv/bin/activate  # Unix
+   .\venv\Scripts\activate   # Windows
+   ```
+
+3. **Pre-commit Setup**:
+   We use pre-commit hooks to automatically format and lint code. Set them up with:
+   ```bash
+   pip install pre-commit
+   pre-commit install
+   ```
+
+   That's it! The hooks will run automatically when you commit. To manually check all files:
+   ```bash
+   pre-commit run --all-files
+   ```
+
+## Testing
+
+We use a comprehensive testing stack to ensure code quality and reliability. Our testing framework includes pytest and several specialized testing tools.
+
+### Testing Dependencies
+
+Install all testing dependencies:
+```bash
+pip install -e ".[dev]"
+```
+
+We use the following testing packages:
+- `pytest==7.4.0`: Core testing framework
+- `pytest-depends`: Manage test dependencies
+- `pytest-asyncio`: Test async code
+- `pytest-vcr`: Record and replay HTTP interactions
+- `pytest-mock`: Mocking functionality
+- `pyfakefs`: Mock filesystem operations
+- `requests_mock==1.11.0`: Mock HTTP requests
+
+### Using Tox
+
+We use tox to automate and standardize testing. Tox:
+- Creates isolated virtual environments for testing
+- Tests against multiple Python versions (3.7-3.12)
+- Runs all test suites consistently
+- Ensures dependencies are correctly specified
+- Verifies the package installs correctly
+
+Run tox:
+```bash
+tox
+```
+
+This will:
+1. Create fresh virtual environments
+2. Install dependencies
+3. Run pytest with our test suite
+4. Generate coverage reports
+
+### Running Tests
+
+1. **Run All Tests**:
+   ```bash
+   tox
+   ```
+
+2. **Run Specific Test File**:
+   ```bash
+   pytest tests/llms/test_anthropic.py -v
+   ```
+
+3. **Run with Coverage**:
+   ```bash
+   coverage run -m pytest
+   coverage report
+   ```
+
+### Writing Tests
+
+1. **Test Structure**:
+   ```python
+   import pytest
+   from pytest_mock import MockerFixture
+   from unittest.mock import Mock, patch
+
+   @pytest.mark.asyncio  # For async tests
+   async def test_async_function():
+       # Test implementation
+
+   @pytest.mark.depends(on=['test_prerequisite'])  # Declare test dependencies
+   def test_dependent_function():
+       # Test implementation
+   ```
+
+2. **Recording HTTP Interactions**:
+   ```python
+   @pytest.mark.vcr()  # Records HTTP interactions
+   def test_api_call():
+       response = client.make_request()
+       assert response.status_code == 200
+   ```
+
+3. **Mocking Filesystem**:
+   ```python
+   def test_file_operations(fs):  # fs fixture provided by pyfakefs
+       fs.create_file('/fake/file.txt', contents='test')
+       assert os.path.exists('/fake/file.txt')
+   ```
+
+4. **Mocking HTTP Requests**:
+   ```python
+   def test_http_client(requests_mock):
+       requests_mock.get('http://api.example.com', json={'key': 'value'})
+       response = make_request()
+       assert response.json()['key'] == 'value'
+   ```
+
+### Testing Best Practices
+
+1. **Test Categories**:
+   - Unit tests: Test individual components
+   - Integration tests: Test component interactions
+   - End-to-end tests: Test complete workflows
+   - Performance tests: Test response times and resource usage
+
+2. **Fixtures**:
+   Create reusable test fixtures in `conftest.py`:
+   ```python
+   @pytest.fixture
+   def mock_llm_client():
+       client = Mock()
+       client.chat.completions.create.return_value = Mock()
+       return client
+   ```
+
+3. **Test Data**:
+   - Store test data in `tests/data/`
+   - Use meaningful test data names
+   - Document data format and purpose
+
+4. **VCR Cassettes**:
+   - Store in `tests/cassettes/`
+   - Sanitize sensitive information
+   - Update cassettes when API changes
+
+### CI Testing Strategy
+
+We use Jupyter notebooks as integration tests for LLM providers. This approach:
+- Tests real-world usage patterns
+- Verifies end-to-end functionality
+- Ensures examples stay up-to-date
+- Tests against actual LLM APIs
+
+1. **Notebook Tests**:
+   - Located in `examples/` directory
+   - Each LLM provider has example notebooks
+   - CI runs notebooks on PR merges to main
+   - Tests run against multiple Python versions
+
+2. **Test Workflow**:
+   The `test-notebooks.yml` workflow:
+   ```yaml
+   name: Test Notebooks
+   on:
+     pull_request:
+       paths:
+         - "agentops/**"
+         - "examples/**"
+         - "tests/**"
+   ```
+   - Runs on PR merges and manual triggers
+   - Sets up environment with provider API keys
+   - Installs AgentOps from main branch
+   - Executes each notebook
+   - Excludes specific notebooks that require manual testing
+
+3. **Provider Coverage**:
+   Each provider should have notebooks demonstrating:
+   - Basic completion calls
+   - Streaming responses
+   - Async operations (if supported)
+   - Error handling
+   - Tool usage (if applicable)
+
+4. **Adding Provider Tests**:
+   - Create notebook in `examples/provider_name/`
+   - Include all provider functionality
+   - Add necessary secrets to GitHub Actions
+   - Update `exclude_notebooks` in workflow if manual testing needed
+
+## Adding LLM Providers
+
+The `agentops/llms/` directory contains provider implementations. Each provider must:
+
+1. **Inherit from BaseProvider**:
+   ```python
+   @singleton
+   class NewProvider(BaseProvider):
+       def __init__(self, client):
+           super().__init__(client)
+           self._provider_name = "ProviderName"
+   ```
+
+2. **Implement Required Methods**:
+   - `handle_response()`: Process LLM responses
+   - `override()`: Patch the provider's methods
+   - `undo_override()`: Restore original methods
+
+3. **Handle Events**:
+   Track:
+   - Prompts and completions
+   - Token usage
+   - Timestamps
+   - Errors
+   - Tool usage (if applicable)
+
+4. **Example Implementation Structure**:
+   ```python
+   def handle_response(self, response, kwargs, init_timestamp, session=None):
+       llm_event = LLMEvent(init_timestamp=init_timestamp, params=kwargs)
+       try:
+           # Process response
+           llm_event.returns = response.model_dump()
+           llm_event.prompt = kwargs["messages"]
+           # ... additional processing
+           self._safe_record(session, llm_event)
+       except Exception as e:
+           self._safe_record(session, ErrorEvent(trigger_event=llm_event, exception=e))
+   ```
+
+## Code Style
+
+1. **Formatting**:
+   - Use Black for Python code formatting
+   - Maximum line length: 88 characters
+   - Use type hints
+
+2. **Documentation**:
+   - Docstrings for all public methods
+   - Clear inline comments
+   - Update relevant documentation
+
+3. **Error Handling**:
+   - Use specific exception types
+   - Log errors with meaningful messages
+   - Include context in error messages
+
+## Pull Request Process
+
+1. **Branch Naming**:
+   - `feature/description`
+   - `fix/description`
+   - `docs/description`
+
+2. **Commit Messages**:
+   - Clear and descriptive
+   - Reference issues when applicable
+
+3. **PR Requirements**:
+   - Pass all tests
+   - Maintain or improve code coverage
+   - Include relevant documentation
+   - Update CHANGELOG.md if applicable
+
+4. **Review Process**:
+   - At least one approval required
+   - Address all review comments
+   - Maintain PR scope
+
+## Documentation
+
+1. **Types of Documentation**:
+   - API reference
+   - Integration guides
+   - Examples
+   - Troubleshooting guides
+
+2. **Documentation Location**:
+   - Code documentation in docstrings
+   - User guides in `docs/`
+   - Examples in `examples/`
+
+3. **Documentation Style**:
+   - Clear and concise
+   - Include code examples
+   - Explain the why, not just the what
+
+## Getting Help & Community
+
+We encourage active community participation and are here to help!
+
+### Preferred Communication Channels
+
+1. **GitHub Issues & Discussions**:
+   - Open an [issue](https://github.com/AgentOps-AI/agentops/issues) for:
+     - Bug reports
+     - Feature requests
+     - Documentation improvements
+   - Start a [discussion](https://github.com/AgentOps-AI/agentops/discussions) for:
+     - Questions about usage
+     - Ideas for new features
+     - Community showcase
+     - General feedback
+
+2. **Discord Community**:
+   - Join our [Discord server](https://discord.gg/FagdcwwXRR) for:
+     - Real-time help
+     - Community discussions
+     - Feature announcements
+     - Sharing your projects
+
+3. **Contact Form**:
+   - For private inquiries, use our [contact form](https://agentops.ai/contact)
+   - Please note that public channels are preferred for technical discussions
+
+## License
+
+By contributing to AgentOps, you agree that your contributions will be licensed under the MIT License.

{mseep_agentops-0.4.18/mseep_agentops.egg-info → mseep_agentops-0.4.22}/PKG-INFO

@@ -1,49 +1,39 @@
 Metadata-Version: 2.4
 Name: mseep-agentops
-Version: 0.4.18
+Version: 0.4.22
 Summary: Observability and DevTool Platform for AI Agents
-Home-page: https://github.com/mseep
-Author: mseep
-Author-email: support@skydeck.ai
-Maintainer: mseep
-Maintainer-email: support@skydeck.ai
-Keywords: mseep
-Classifier: Programming Language :: Python :: 3
+Project-URL: Homepage, https://github.com/AgentOps-AI/agentops
+Project-URL: Issues, https://github.com/AgentOps-AI/agentops/issues
+Author-email: mseep <support@skydeck.ai>
+License-File: LICENSE
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Requires-Python: >=3.6
-Description-Content-Type: text/plain
-License-File: LICENSE
-Requires-Dist: requests<3.0.0,>=2.0.0
-Requires-Dist: psutil<7.0.1,>=5.9.8
-Requires-Dist: termcolor<2.5.0,>=2.3.0
-Requires-Dist: PyYAML<7.0,>=5.3
-Requires-Dist: packaging<25.0,>=21.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Requires-Dist: aiohttp<4.0.0,>=3.8.0
 Requires-Dist: httpx<0.29.0,>=0.24.0
-Requires-Dist: opentelemetry-sdk==1.29.0; python_version < "3.10"
-Requires-Dist: opentelemetry-sdk>1.29.0; python_version >= "3.10"
-Requires-Dist: opentelemetry-api==1.29.0; python_version < "3.10"
-Requires-Dist: opentelemetry-api>1.29.0; python_version >= "3.10"
-Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.29.0; python_version < "3.10"
-Requires-Dist: opentelemetry-exporter-otlp-proto-http>1.29.0; python_version >= "3.10"
+Requires-Dist: opentelemetry-api==1.29.0; python_version < '3.10'
+Requires-Dist: opentelemetry-api>1.29.0; python_version >= '3.10'
+Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.29.0; python_version < '3.10'
+Requires-Dist: opentelemetry-exporter-otlp-proto-http>1.29.0; python_version >= '3.10'
+Requires-Dist: opentelemetry-instrumentation==0.50b0; python_version < '3.10'
+Requires-Dist: opentelemetry-instrumentation>=0.50b0; python_version >= '3.10'
+Requires-Dist: opentelemetry-sdk==1.29.0; python_version < '3.10'
+Requires-Dist: opentelemetry-sdk>1.29.0; python_version >= '3.10'
+Requires-Dist: opentelemetry-semantic-conventions==0.50b0; python_version < '3.10'
+Requires-Dist: opentelemetry-semantic-conventions>=0.50b0; python_version >= '3.10'
 Requires-Dist: ordered-set<5.0.0,>=4.0.0
+Requires-Dist: packaging<25.0,>=21.0
+Requires-Dist: psutil<7.0.1,>=5.9.8
+Requires-Dist: pyyaml<7.0,>=5.3
+Requires-Dist: requests<3.0.0,>=2.0.0
+Requires-Dist: termcolor<2.5.0,>=2.3.0
 Requires-Dist: wrapt<2.0.0,>=1.0.0
-Requires-Dist: opentelemetry-instrumentation==0.50b0; python_version < "3.10"
-Requires-Dist: opentelemetry-instrumentation>=0.50b0; python_version >= "3.10"
-Requires-Dist: opentelemetry-semantic-conventions==0.50b0; python_version < "3.10"
-Requires-Dist: opentelemetry-semantic-conventions>=0.50b0; python_version >= "3.10"
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: keywords
-Dynamic: license-file
-Dynamic: maintainer
-Dynamic: maintainer-email
-Dynamic: requires-dist
-Dynamic: requires-python
-Dynamic: summary
+Description-Content-Type: text/plain
 
-Package managed by MseeP.ai
+Package managed by MseeP.ai