cursor-agent-tools 0.1.7__tar.gz

cursor_agent_tools-0.1.7/.env.example

@@ -0,0 +1,17 @@
+# Environment (local, development, production)
+ENVIRONMENT=local
+
+# OpenAI configuration
+OPENAI_API_KEY=your_openai_api_key_here
+OPENAI_API_MODEL=gpt-4o
+OPENAI_TEMPERATURE=0.0
+
+# Anthropic configuration
+ANTHROPIC_API_KEY=your_anthropic_api_key_here
+ANTHROPIC_API_MODEL=claude-3-5-sonnet-latest
+ANTHROPIC_TEMPERATURE=0.0
+
+# Additional configuration
+# LOG_LEVEL=INFO
+# DISABLE_TOOLS=false
+# TOOL_TIMEOUT=30 

cursor_agent_tools-0.1.7/.flake8

@@ -0,0 +1,14 @@
+[flake8]
+max-line-length = 100
+exclude = .git,__pycache__,docs/source/conf.py,old,build,dist,venv
+ignore = E203, E501, W503
+
+per-file-ignores =
+    __init__.py: F401
+    agent/claude_agent.py: W293,W291
+    agent/tools/*.py: W293
+    tests/demo/*: F841,W293,W291,W504,F401,E402,F541
+    tests/*: F841,W293,W291,W504,F401,E128
+
+# Match Black style
+line-length = 100 

cursor_agent_tools-0.1.7/.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+github: [usecodenaija]
+custom: ['https://civai.co'] 

cursor_agent_tools-0.1.7/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,43 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[BUG] "
+labels: bug
+assignees: ''
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Setup environment with '...'
+2. Run code '...'
+3. Execute function '...'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Code Sample**
+If applicable, add a minimal code sample to reproduce the issue.
+
+```python
+# Your code here
+```
+
+**Environment (please complete the following information):**
+ - OS: [e.g. macOS, Windows, Linux]
+ - Python Version: [e.g. 3.8.10]
+ - Package Version: [e.g. 0.1.0]
+ - Model Used: [e.g. Claude 3 Opus, GPT-4o]
+
+**Additional context**
+Add any other context about the problem here, such as specific API settings or configurations.
+
+**Stack Trace**
+If applicable, include the full error stack trace.
+
+```
+Paste stack trace here
+``` 

cursor_agent_tools-0.1.7/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,26 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[FEATURE] "
+labels: enhancement
+assignees: ''
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Example usage**
+If applicable, add an example of how this feature would be used in code.
+
+```python
+# Example code showing how the new feature would be used
+```
+
+**Additional context**
+Add any other context or screenshots about the feature request here. 

cursor_agent_tools-0.1.7/.github/pull_request_template.md

@@ -0,0 +1,32 @@
+## Description
+
+Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context.
+
+Fixes # (issue)
+
+## Type of change
+
+Please delete options that are not relevant.
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] Documentation update
+
+## How Has This Been Tested?
+
+Please describe the tests that you ran to verify your changes. Provide instructions so we can reproduce. Please also list any relevant details for your test configuration.
+
+- [ ] Test A
+- [ ] Test B
+
+## Checklist:
+
+- [ ] My code follows the style guidelines of this project
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published in downstream modules 

cursor_agent_tools-0.1.7/.github/workflows/publish.yml

@@ -0,0 +1,114 @@
+name: Package Publishing
+
+on:
+  # Trigger on release creation
+  release:
+    types: [created]
+  
+  # Trigger on push to staging or tags
+  push:
+    branches: [staging]
+    tags:
+      - 'v*'  # Push events to tags matching v*, i.e. v1.0, v20.15.10
+    
+  # Manual trigger for other branches
+  workflow_dispatch:
+    inputs:
+      environment:
+        description: 'Publishing environment'
+        required: true
+        default: 'test'
+        type: choice
+        options:
+          - test
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+        
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+        
+    - name: Build package
+      run: python -m build
+      
+    # Always publish to Test PyPI if manually triggered
+    - name: Verify TestPyPI Token
+      if: github.event_name == 'workflow_dispatch' || github.ref == 'refs/heads/staging' || github.event_name == 'release' || startsWith(github.ref, 'refs/tags/')
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      run: |
+        # Check if token is present and has correct format
+        if [[ -z "${TWINE_PASSWORD}" ]]; then
+          echo "ERROR: TestPyPI token is empty. Please add a valid TEST_PYPI_API_TOKEN secret."
+          exit 1
+        fi
+        
+        # Masked output to check general format without revealing token
+        TOKEN_PREFIX=$(echo $TWINE_PASSWORD | cut -c1-5)
+        TOKEN_LENGTH=${#TWINE_PASSWORD}
+        
+        echo "Token prefix: ${TOKEN_PREFIX}** (masked)"
+        echo "Token length: ${TOKEN_LENGTH} characters"
+        
+        if [[ $TOKEN_LENGTH -lt 40 ]]; then
+          echo "WARNING: Token appears too short. TestPyPI tokens are typically longer."
+        fi
+        
+    # Always publish to Test PyPI if manually triggered
+    - name: Publish to Test PyPI (Manual Trigger)
+      if: github.event_name == 'workflow_dispatch'
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      run: |
+        twine upload --verbose --skip-existing --repository-url https://test.pypi.org/legacy/ dist/*
+        
+    # Publish to Test PyPI on staging branch push
+    - name: Publish to Test PyPI (Staging)
+      if: github.event_name == 'push' && github.ref == 'refs/heads/staging'
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      run: |
+        twine upload --verbose --skip-existing --repository-url https://test.pypi.org/legacy/ dist/*
+        
+    # Publish to both Test PyPI and PyPI on release from main or tag push
+    - name: Publish to Test PyPI (Release or Tag)
+      if: github.event_name == 'release' || (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/'))
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }}
+      run: |
+        twine upload --verbose --skip-existing --repository-url https://test.pypi.org/legacy/ dist/*
+        
+    - name: Publish to PyPI (Release or Tag)
+      if: github.event_name == 'release' || (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/'))
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        # Note: PyPI uses different tokens than TestPyPI - make sure you're using the right one
+        twine upload --verbose dist/*
+        
+    - name: Upload artifacts to release
+      if: github.event_name == 'release' || (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/'))
+      uses: softprops/action-gh-release@v1
+      with:
+        files: dist/*
+        # Create a release if it's a tag push
+        name: Release ${{ github.ref_name }}
+        draft: false
+        prerelease: false
+        generate_release_notes: true 

cursor_agent_tools-0.1.7/.github/workflows/test.yml

@@ -0,0 +1,45 @@
+name: Test
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.9", "3.10", "3.11"]
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+        
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e ".[dev]"
+        pip install pytest pytest-cov flake8 mypy types-requests
+        
+    - name: Run linting
+      run: |
+        flake8 agent tests --config=.flake8
+        mypy agent tests --config-file=.mypy.ini
+        
+    - name: Run tests with coverage
+      run: |
+        # Run tests with -xvs to show output, make it verbose, and not capture output
+        # Use -k "not" expressions to skip tests that require API keys or file system access
+        pytest -xvs --cov=agent tests/ --cov-report=xml -k "not anthropic and not openai and not fs_tools"
+        
+    # - name: Upload coverage to Codecov
+    #   uses: codecov/codecov-action@v3
+    #   with:
+    #     file: ./coverage.xml
+    #     fail_ci_if_error: true 

cursor_agent_tools-0.1.7/.gitignore

@@ -0,0 +1,87 @@
+# Environment variables
+.env
+
+# 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
+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
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDE-specific files
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Project-specific
+demo_output/
+test_output/
+temp/
+
+# macOS
+.DS_Store
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Log files
+*.log 
+
+venv_test/
+.cursorrules
+examples/demo_files/*
+test_permission/*
+test_permission

cursor_agent_tools-0.1.7/.mypy.ini

@@ -0,0 +1,24 @@
+[mypy]
+python_version = 3.10
+warn_return_any = True
+warn_unused_configs = True
+disallow_untyped_defs = True
+disallow_incomplete_defs = True
+
+[mypy.plugins.numpy.*]
+follow_imports = skip
+
+[mypy-tests.demo.*]
+ignore_errors = True
+
+[mypy-tests.demo_files.*]
+ignore_errors = True
+
+[mypy-tests.test_anthropic_direct]
+ignore_errors = True
+
+[mypy-main]
+ignore_errors = True
+
+[mypy-tests.test_anthropic_key]
+ignore_errors = True 

cursor_agent_tools-0.1.7/CODEOWNERS

@@ -0,0 +1,14 @@
+# These owners will be the default owners for everything in
+# the repo. Unless a later match takes precedence,
+# @usecodenaija will be requested for review when someone opens a pull request.
+*       @usecodenaija
+
+# Agent implementation
+/agent/ @usecodenaija
+
+# Documentation files
+*.md    @usecodenaija
+
+# Build and configuration files
+setup.py @usecodenaija
+requirements.txt @usecodenaija 

cursor_agent_tools-0.1.7/CODE_OF_CONDUCT.md

@@ -0,0 +1,65 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers responsible for enforcement at
+hello@civai.co or by contacting [@usecodenaija](https://twitter.com/usecodenaija) on Twitter.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All project maintainers are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html](https://www.contributor-covenant.org/version/2/1/code_of_conduct.html).

cursor_agent_tools-0.1.7/CONTRIBUTING.md

@@ -0,0 +1,118 @@
+# Contributing to Cursor Agent
+
+Thank you for your interest in contributing to Cursor Agent! This document provides guidelines and instructions for contributing to the project.
+
+## Code of Conduct
+
+By participating in this project, you agree to abide by our [Code of Conduct](CODE_OF_CONDUCT.md). Please read it before contributing.
+
+## How Can I Contribute?
+
+### Reporting Bugs
+
+Before submitting a bug report:
+- Check the [issue tracker](https://github.com/civai-technologies/cursor-agent/issues) to see if the issue has already been reported.
+- If you're unable to find an open issue addressing the problem, open a new one.
+
+When filing an issue, please include:
+- A clear title and description of the bug
+- Steps to reproduce the issue
+- Expected behavior vs. actual behavior
+- Environment details (OS, Python version, etc.)
+- Any relevant screenshots or error messages
+
+### Suggesting Enhancements
+
+Enhancement suggestions are tracked as GitHub issues. When creating an enhancement suggestion:
+- Use a clear and descriptive title
+- Provide a detailed description of the suggested enhancement
+- Explain why this enhancement would be useful
+- Include examples of how it would be used
+
+### Pull Requests
+
+1. Fork the repository
+2. Create a new branch from `main` for your changes
+3. Make your changes and commit them with clear, descriptive commit messages
+4. Add or update tests as necessary
+5. Update documentation as needed
+6. Push your branch to your fork
+7. Open a pull request against the `main` branch
+
+#### Pull Request Guidelines
+
+- Keep PRs focused on a single feature or fix
+- Include tests for new functionality
+- Update documentation for any changed functionality
+- Follow the existing code style
+- Make sure all tests pass before submitting your PR
+- Reference related issues in your PR description
+
+## Development Environment Setup
+
+1. Fork and clone the repository
+```bash
+git clone https://github.com/civai-technologies/cursor-agent.git
+cd cursor-agent
+```
+
+2. Create a virtual environment
+```bash
+python3 -m venv venv
+source venv/bin/activate  # On Windows, use `venv\Scripts\activate`
+```
+
+3. Install development dependencies
+```bash
+pip install -e ".[dev]"
+```
+
+4. Set up your API keys (for testing)
+```bash
+export ANTHROPIC_API_KEY="your_key_here"
+export OPENAI_API_KEY="your_key_here"
+```
+
+## Testing
+
+Run the test suite with:
+```bash
+python run_tests.py
+```
+
+To run specific tests:
+```bash
+python -m unittest tests.test_tools
+```
+
+## Coding Style
+
+- Follow PEP 8 guidelines
+- Use clear, descriptive variable and function names
+- Add docstrings to all functions and classes
+- Aim for a maximum line length of 100 characters
+- Use type hints where appropriate
+
+## Documentation
+
+- Update the README.md with any new features, configuration options, or changes to usage
+- Update or create examples for new functionality
+- Add docstrings to your code for new functions, classes, or methods
+
+## Review Process
+
+- At least one project maintainer must approve a PR before it can be merged
+- You may be asked to make changes to your PR based on feedback
+- Once approved, the maintainer will merge your PR
+
+## License
+
+By contributing to Cursor Agent, you agree that your contributions will be licensed under the project's [MIT License](LICENSE).
+
+## Questions?
+
+If you have any questions or need help, please:
+- Open an issue with the "question" label
+- Reach out to Nifemi Alpine on Twitter [@usecodenaija](https://twitter.com/usecodenaija)
+
+Thank you for contributing to make Cursor Agent better! 

cursor_agent_tools-0.1.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Nifemi Alpine (Founder of CIVAI TECHNOLOGIES: civai.co)
+
+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. 

cursor_agent_tools-0.1.7/MANIFEST.in

@@ -0,0 +1,18 @@
+include LICENSE
+include README.md
+include requirements.txt
+include pyproject.toml
+
+recursive-include agent *.py
+recursive-include agent *.json
+recursive-include agent *.yaml
+recursive-include agent *.yml
+
+recursive-exclude * __pycache__
+recursive-exclude * *.py[cod]
+recursive-exclude * .git
+recursive-exclude * .env*
+recursive-exclude * *.log
+recursive-exclude * .pytest_cache
+recursive-exclude * .coverage
+recursive-exclude * htmlcov