PyPI - superoptix - Versions diffs - 0.2.4__tar.gz - Mend

superoptix 0.2.4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (792) hide show

superoptix-0.2.4/.github/ISSUE_TEMPLATE/bug_report.yml ADDED Viewed

@@ -0,0 +1,94 @@
+name: 🐛 Bug Report
+description: Report a bug or unexpected behavior in SuperOptiX
+title: "[Bug]: "
+labels: ["bug", "needs-triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report! 🙏
+        Before submitting, please search existing issues to avoid duplicates.
+  - type: textarea
+    id: description
+    attributes:
+      label: 🐛 Bug Description
+      description: A clear and concise description of what the bug is
+      placeholder: Describe the bug...
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: 🔄 Steps to Reproduce
+      description: Steps to reproduce the behavior
+      placeholder: |
+        1. Run command `sox init my_project`
+        2. Navigate to the project
+        3. Execute `sox agent create...`
+        4. See error...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: ✅ Expected Behavior
+      description: What you expected to happen
+      placeholder: Describe what should have happened...
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: ❌ Actual Behavior
+      description: What actually happened
+      placeholder: Describe what actually happened...
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: 🌍 Environment
+      description: Please provide your environment details
+      placeholder: |
+        - OS: [e.g. macOS 14.0, Ubuntu 22.04, Windows 11]
+        - Python version: [e.g. 3.12.1]
+        - SuperOptiX version: [e.g. 0.1.0]
+        - DSPy version: [e.g. 3.0.0b1]
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: 📋 Error Logs
+      description: Please copy and paste any relevant log output
+      render: shell
+      placeholder: Paste your error logs here...
+  - type: textarea
+    id: additional
+    attributes:
+      label: 📝 Additional Context
+      description: Add any other context about the problem here
+      placeholder: Any additional information that might help...
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: ✅ Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues and this is not a duplicate
+          required: true
+        - label: I have provided all the required information above
+          required: true
+        - label: This issue is related to SuperOptiX (not DSPy or other dependencies)
+          required: true

superoptix-0.2.4/.github/ISSUE_TEMPLATE/feature_request.yml ADDED Viewed

@@ -0,0 +1,122 @@
+name: 🚀 Feature Request
+description: Suggest a new feature or enhancement for SuperOptiX
+title: "[Feature]: "
+labels: ["enhancement", "needs-triage"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature! 🚀
+        Before submitting, please search existing issues to see if this has been requested before.
+  - type: textarea
+    id: summary
+    attributes:
+      label: 🎯 Feature Summary
+      description: A clear and concise summary of the feature you'd like to see
+      placeholder: Briefly describe the feature...
+    validations:
+      required: true
+  - type: textarea
+    id: problem
+    attributes:
+      label: 🤔 Problem Statement
+      description: What problem does this feature solve? What's the current limitation?
+      placeholder: |
+        As a SuperOptiX user, I find it difficult to...
+        Currently, there's no way to...
+        This would help because...
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: 💡 Proposed Solution
+      description: Describe the solution you'd like to see
+      placeholder: |
+        I would like SuperOptiX to support...
+        The feature should work by...
+        Users would interact with it by...
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 🔄 Alternatives Considered
+      description: Describe any alternative solutions or workarounds you've considered
+      placeholder: |
+        Alternative 1: ...
+        Alternative 2: ...
+        Current workaround: ...
+  - type: dropdown
+    id: feature_type
+    attributes:
+      label: 🏷️ Feature Type
+      description: What type of feature is this?
+      options:
+        - Agent Framework Enhancement
+        - DSPy Integration Improvement
+        - CLI Tool Enhancement
+        - Orchestration Feature
+        - Memory System Enhancement
+        - Observability/Debugging Tool
+        - Performance Optimization
+        - Documentation/Examples
+        - Other
+    validations:
+      required: true
+  - type: dropdown
+    id: priority
+    attributes:
+      label: 📊 Priority Level
+      description: How important is this feature to you?
+      options:
+        - Low - Nice to have
+        - Medium - Would be helpful
+        - High - Important for my use case
+        - Critical - Blocking my work
+    validations:
+      required: true
+  - type: textarea
+    id: usecase
+    attributes:
+      label: 🎭 Use Case Examples
+      description: Provide specific examples of how this feature would be used
+      placeholder: |
+        Example 1: When building a customer service agent...
+        Example 2: In a multi-agent orchestration scenario...
+        Example 3: For debugging complex agent behaviors...
+  - type: textarea
+    id: implementation
+    attributes:
+      label: 🛠️ Implementation Ideas
+      description: If you have ideas about how this could be implemented, share them here
+      placeholder: |
+        This could be implemented by...
+        It might involve changes to...
+        The API could look like...
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: ✅ Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues and this feature hasn't been requested
+          required: true
+        - label: This feature aligns with SuperOptiX's core mission of agentic AI orchestration
+          required: true
+        - label: I would be willing to help test this feature when available
+          required: false
+        - label: I would be interested in contributing to the implementation
+          required: false

superoptix-0.2.4/.github/ISSUE_TEMPLATE/question.yml ADDED Viewed

@@ -0,0 +1,103 @@
+name: ❓ Question / Help
+description: Ask a question or get help with using SuperOptiX
+title: "[Question]: "
+labels: ["question", "help-wanted"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reaching out! 🤝
+        Before asking, please check:
+        - [📚 Documentation](https://github.com/SuperagenticAI/superoptix/docs)
+        - [🔍 Existing Issues](https://github.com/SuperagenticAI/superoptix/issues)
+        - [💬 Discussions](https://github.com/SuperagenticAI/superoptix/discussions)
+  - type: dropdown
+    id: question_type
+    attributes:
+      label: 🏷️ Question Type
+      description: What type of help do you need?
+      options:
+        - Getting Started / Installation
+        - Agent Development
+        - DSPy Integration
+        - Orchestration & Multi-Agent
+        - Memory Systems
+        - CLI Usage
+        - Performance & Optimization
+        - Best Practices
+        - Troubleshooting
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: question
+    attributes:
+      label: ❓ Your Question
+      description: What would you like to know?
+      placeholder: |
+        I'm trying to...
+        I'm confused about...
+        How do I...
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: 🔍 Context & Background
+      description: Provide context about what you're trying to achieve
+      placeholder: |
+        I'm building an agent that...
+        My use case involves...
+        I'm working on...
+  - type: textarea
+    id: attempted
+    attributes:
+      label: 🔧 What Have You Tried?
+      description: What approaches or solutions have you already attempted?
+      placeholder: |
+        I tried...
+        I looked at...
+        I followed the guide for...
+  - type: textarea
+    id: code
+    attributes:
+      label: 💻 Relevant Code
+      description: Share any relevant code, configuration, or playbooks
+      render: python
+      placeholder: |
+        # Your code here
+        from superoptix import Agent
+        agent = Agent(...)
+  - type: textarea
+    id: environment
+    attributes:
+      label: 🌍 Environment
+      description: Your environment details (if relevant)
+      placeholder: |
+        - OS: [e.g. macOS 14.0]
+        - Python version: [e.g. 3.12.1]
+        - SuperOptiX version: [e.g. 0.1.0]
+        - DSPy version: [e.g. 3.0.0b1]
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: ✅ Checklist
+      description: Please confirm the following
+      options:
+        - label: I have searched existing issues and discussions
+          required: true
+        - label: I have checked the documentation
+          required: true
+        - label: This is a question about SuperOptiX usage (not a bug report or feature request)
+          required: true

superoptix-0.2.4/.github/pull_request_template.md ADDED Viewed

@@ -0,0 +1,100 @@
+## 🚀 Pull Request
+### 📋 Description
+<!-- Provide a clear and concise description of your changes -->
+### 🔧 Type of Change
+<!-- Mark the relevant option with an "x" -->
+- [ ] 🐛 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
+- [ ] 🧹 Code refactoring (no functional changes)
+- [ ] ⚡ Performance improvement
+- [ ] 🧪 Test coverage improvement
+- [ ] 🎨 Style/formatting changes
+- [ ] 🔧 Build/CI changes
+### 🎯 Related Issues
+<!-- Link related issues using keywords: fixes #123, closes #456, relates to #789 -->
+- Fixes #
+- Closes #
+- Relates to #
+### 🧪 Testing
+<!-- Describe the testing you've performed -->
+- [ ] Unit tests pass locally
+- [ ] Integration tests pass locally
+- [ ] Manual testing completed
+- [ ] Added new tests for the changes
+- [ ] Tested with different Python versions
+- [ ] Tested with different operating systems
+### 📝 Testing Details
+<!-- Provide details about your testing approach -->
+```bash
+# Commands used for testing
+pytest tests/
+super init test_project
+# etc.
+```
+### 📚 Documentation
+<!-- Check all that apply -->
+- [ ] Code is well-commented
+- [ ] Documentation updated (if applicable)
+- [ ] README updated (if applicable)
+- [ ] Docstrings added/updated
+- [ ] Examples added/updated
+### 🔒 Security Considerations
+<!-- Consider security implications of your changes -->
+- [ ] No sensitive data exposed
+- [ ] Input validation implemented
+- [ ] Authorization checks in place (if applicable)
+- [ ] Dependencies are secure and up-to-date
+### 📋 Checklist
+<!-- Ensure all items are completed before submitting -->
+- [ ] My code follows the project's style guidelines
+- [ ] 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
+### 🖼️ Screenshots/GIFs
+<!-- If applicable, add screenshots or GIFs to help explain your changes -->
+### 📈 Performance Impact
+<!-- Describe any performance implications -->
+- [ ] No performance impact
+- [ ] Performance improved
+- [ ] Performance regression (justified below)
+**Performance Details:**
+<!-- If there's a performance impact, explain it here -->
+### 🌍 Environment Tested
+<!-- Specify the environments where you tested your changes -->
+- **OS:**
+- **Python Version:**
+- **SuperOptiX Version:**
+- **DSPy Version:**
+### 🤝 Additional Context
+<!-- Add any other context, concerns, or notes about the PR here -->
+### 🎉 Ready for Review
+<!-- Once you've completed all the above, mark this as ready -->
+- [ ] This PR is ready for review
+---
+**Thank you for contributing to SuperOptiX! 🙏**
+Your contribution helps make the Kubernetes of Agentic AI even better. We appreciate your effort in building the future of autonomous agent orchestration.
+For more information about contributing, see our [Contributing Guidelines](CONTRIBUTING.md).

superoptix-0.2.4/.github/workflows/ci.yml ADDED Viewed

@@ -0,0 +1,44 @@
+name: CI
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v1
+        with:
+          version: "latest"
+      - name: Install dependencies
+        run: |
+          # Generate lock file (uv.toml handles pre-release)
+          uv lock
+          # Install with cross-platform compatible extras
+          uv sync --extra testing --extra vectordb --extra observability --extra web --extra ml-cross-platform
+          # Install dev dependencies explicitly
+          uv pip install pytest mypy black ruff pre-commit pytest-cov pytest-asyncio pytest-mock responses
+      - name: Run tests
+        run: |
+          uv run pytest tests/
+      - name: Run Ruff
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+      - name: Run type checking
+        run: |
+          uv run mypy superoptix/ --no-error-summary || echo "Type checking completed with warnings"

superoptix-0.2.4/.github/workflows/release.yml ADDED Viewed

@@ -0,0 +1,74 @@
+name: Release to PyPI
+on:
+  push:
+    tags:
+      - 'v*'
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine cython numpy
+    - name: Install project dependencies
+      run: |
+        pip install --pre -e ".[dev]"
+    - name: Run tests
+      run: |
+        pytest tests/ -v
+    - name: Build protected package
+      run: |
+        python build_protected.py
+      env:
+        PYTHONPATH: ${{ github.workspace }}
+    - name: Upload to PyPI
+      run: |
+        twine upload dist/*
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+    - name: Create GitHub Release
+      uses: actions/create-release@v1
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      with:
+        tag_name: ${{ github.ref }}
+        release_name: Release ${{ github.ref }}
+        body: |
+          ## SuperOptiX ${{ github.ref_name }}
+          ### 🔒 Protected Release
+          This release includes compiled modules for enhanced security.
+          ### 📦 Installation
+          ```bash
+          pip install superoptix
+          ```
+          ### 🔗 Documentation
+          - [Documentation](https://docs.super-agentic.ai)
+          - [Support](https://support.super-agentic.ai)
+          ### 📄 License
+          This is open source software. See LICENCE file for details.
+        draft: false
+        prerelease: false

superoptix-0.2.4/.github/workflows/ruff.yml ADDED Viewed

@@ -0,0 +1,29 @@
+name: Ruff
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+jobs:
+  ruff:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v1
+        with:
+          version: "latest"
+      - name: Install dependencies
+        run: |
+          uv lock
+          uv sync --extra testing
+          # Install dev dependencies explicitly
+          uv pip install ruff
+      - name: Run Ruff
+        run: |
+          # Run Ruff with checks disabled for now (info mode)
+          uv run ruff check .

superoptix-0.2.4/.gitignore ADDED Viewed

@@ -0,0 +1,82 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+# corpus/
+# Virtual Environments
+.env
+.venv
+env/
+venv/
+ENV/
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+.claude-cache/
+.claude
+# Testing
+.coverage
+coverage.xml
+htmlcov/
+.pytest_cache/
+.tox/
+# Documentation
+docs/_build/
+site/
+# Logs
+*.log
+logs/
+# OS
+.DS_Store
+Thumbs.db
+# Model files and finetuning outputs
+*.safetensors
+*.bin
+*.pt
+*.pth
+*.ckpt
+*.pkl
+*_finetuned/
+*_lora/
+*_dora/
+*_full/
+training_data/
+sample_training_data.jsonl
+# Large files
+*.zip
+*.tar.gz
+*.rar
+*.7z
+reference/
+plan/
+NoCode/

superoptix-0.2.4/.pre-commit-config.yaml ADDED Viewed

@@ -0,0 +1,15 @@
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v4.4.0
+  hooks:
+    - id: check-yaml
+    - id: end-of-file-fixer
+    - id: trailing-whitespace
+- repo: https://github.com/psf/black
+  rev: 23.3.0
+  hooks:
+    - id: black
+- repo: https://github.com/PyCQA/flake8
+  rev: 6.0.0
+  hooks:
+    - id: flake8

superoptix-0.2.4/.python-version ADDED Viewed

	@@ -0,0 +1 @@
1	+ 3.11

superoptix-0.2.4/.superoptix/memory/memory.db ADDED Viewed

Binary file