sector8-sdk 1.0.0__tar.gz

sector8_sdk-1.0.0/CHANGELOG.md

@@ -0,0 +1,172 @@
+# Changelog
+
+All notable changes to Sector8-sdk 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).
+
+## [1.0.0] - 2024-07-18
+
+### Added
+- **Sector8 Security Engine** - Unremovable security foundation with advanced threat detection
+- **Sector8 Observability Engine** - Security-enhanced telemetry with threat correlation
+- **Sector8 Intelligence Engine** - Predictive analytics and AI model monitoring
+- **Unified Tracking System** - Integrated security, observability, and intelligence tracking
+- **Automatic Security Scanning** - PII detection, prompt injection detection, content filtering
+- **Compliance Automation** - GDPR, HIPAA, SOC2, ISO27001 compliance validation
+- **Model Governance** - AI model registration, monitoring, drift detection, bias analysis
+- **Predictive Security** - AI-powered threat detection and risk assessment
+- **Intelligent Alerting** - Security-aware alerting with threat correlation
+- **Secure Prompt Management** - Prompt retrieval with automatic security validation
+- **Secure Secrets Management** - Secrets handling with access validation
+- **OpenTelemetry Integration** - Native OpenTelemetry support with security context
+- **Provider Support** - OpenAI, Anthropic, Cohere, Google AI, Azure OpenAI, AWS Bedrock
+- **Enterprise Features** - Multi-tenant support, audit logging, compliance reporting
+- **CLI Interface** - Command-line interface for platform management
+- **Comprehensive Documentation** - Security-first guides and enterprise deployment patterns
+
+### Security Features
+- **Security cannot be fully disabled** - Attempts to disable security result in warnings and minimal enforcement
+- **All operations pass through security checks** - Every LLM call, API request, and data operation
+- **Automatic PII detection and redaction** - Always enabled and cannot be bypassed
+- **Prompt injection detection** - Advanced detection of injection attempts
+- **Content filtering** - Toxicity detection, hate speech detection, content policy enforcement
+- **Bias detection** - AI bias detection and fairness monitoring
+- **Data leakage prevention** - Automatic detection of sensitive data exposure
+- **Zero-trust architecture** - Continuous verification and monitoring
+- **Immutable audit logging** - All security events are logged and cannot be modified
+
+### Observability Features
+- **Security-enhanced telemetry** - All telemetry includes security context
+- **Threat correlation** - Automatic correlation of security events with performance metrics
+- **Compliance tracing** - Automatic tracing of compliance-related operations
+- **Real-time dashboards** - Security-aware dashboards with threat indicators
+- **Performance monitoring** - Performance metrics with security overhead tracking
+- **Distributed tracing** - End-to-end tracing with security context
+- **Event logging** - Comprehensive event logging with security metadata
+
+### Intelligence Features
+- **Model monitoring** - Comprehensive AI model performance monitoring
+- **Drift detection** - Data drift detection with security analysis
+- **Bias analysis** - AI bias detection and fairness metrics
+- **Predictive analytics** - AI-powered threat prediction and risk assessment
+- **Model governance** - Model registry, versioning, and validation
+- **Explainable AI** - Model explainability and interpretability
+- **Cost optimization** - AI cost tracking and optimization recommendations
+
+### Compliance Features
+- **GDPR compliance** - Automatic GDPR compliance validation and reporting
+- **HIPAA compliance** - Healthcare data protection and compliance
+- **SOC2 compliance** - Security, availability, and processing integrity
+- **ISO27001 compliance** - Information security management
+- **PCI DSS compliance** - Payment card industry data security
+- **AI Act compliance** - European AI regulation compliance
+- **Automated reporting** - Compliance report generation and export
+
+### Breaking Changes
+- **Security enforcement is mandatory** - Security cannot be fully disabled
+- **All operations require security scanning** - No bypass mechanisms available
+- **Compliance validation is automatic** - Cannot be disabled for regulated data
+- **Audit logging is immutable** - All security events are permanently logged
+
+### Migration Notes
+- **From OpenLIT**: Security features are now mandatory and cannot be disabled
+- **From other SDKs**: All operations now include automatic security scanning
+- **Enterprise deployments**: Additional compliance and governance features available
+
+### Documentation
+- **Security First Guide** - Understanding Sector8's security architecture
+- **Enterprise Guide** - Enterprise deployment patterns and best practices
+- **Platform Overview** - Comprehensive platform capabilities and features
+- **Compliance Guide** - Meeting compliance requirements and regulations
+- **API Reference** - Complete API documentation and examples
+- **Migration Guide** - Migrating from other SDKs and platforms
+
+### Examples
+- **Basic usage** - Simple integration with automatic security
+- **Enterprise deployment** - Multi-tenant, compliance-ready deployment
+- **Security testing** - Testing security features and violation handling
+- **Model monitoring** - AI model monitoring and governance examples
+- **Compliance automation** - Automated compliance validation and reporting
+
+### Support
+- **Documentation**: [docs.sector8.com](https://docs.sector8.com)
+- **Security Issues**: [security@sector8.com](mailto:security@sector8.com)
+- **General Support**: [support@sector8.com](mailto:support@sector8.com)
+- **Discord**: [Join our community](https://discord.gg/sector8)
+
+---
+
+## [Unreleased]
+
+### Added
+- SDK-specific `.env.example` file for easier environment configuration
+- Streamlined 3-line setup documentation in README
+- Improved quickstart examples with decorator pattern
+
+### Changed
+- Package name consistency: use `sector8` instead of `sector8-sdk` for pip install
+- Simplified installation instructions
+- Updated README structure for better developer experience
+
+### Fixed
+- Documentation links and references
+- Environment setup instructions
+
+## [1.0.1] - 2025-01-21
+
+### Added
+- Enhanced documentation with clearer setup instructions
+- SDK-specific environment configuration
+- Improved testing documentation
+
+### Changed
+- Streamlined README for better developer onboarding
+- Updated installation and setup process
+
+### Fixed
+- Package name inconsistencies in documentation
+
+### Planned Features
+- **Advanced threat intelligence** - Integration with threat intelligence feeds
+- **Behavioral analysis** - User and system behavior analysis
+- **Automated response** - Automated security incident response
+- **Advanced compliance** - Additional compliance frameworks and regulations
+- **Cloud integration** - Enhanced cloud provider integration
+- **Mobile support** - Mobile application security and monitoring
+- **IoT security** - Internet of Things security monitoring
+- **Blockchain integration** - Blockchain-based audit logging and verification
+
+### Security Enhancements
+- **Quantum-resistant cryptography** - Post-quantum cryptography support
+- **Advanced anomaly detection** - Machine learning-based anomaly detection
+- **Threat hunting** - Proactive threat hunting capabilities
+- **Incident response automation** - Automated incident response workflows
+- **Security orchestration** - Security orchestration and automation
+
+### Observability Enhancements
+- **Advanced analytics** - Advanced analytics and machine learning insights
+- **Custom dashboards** - Customizable dashboards and visualizations
+- **Real-time streaming** - Real-time data streaming and processing
+- **Advanced alerting** - Advanced alerting and notification systems
+- **Performance optimization** - Performance optimization and tuning
+
+### Intelligence Enhancements
+- **Advanced AI models** - Support for advanced AI models and frameworks
+- **Federated learning** - Federated learning and privacy-preserving AI
+- **Edge AI** - Edge AI and distributed intelligence
+- **AutoML** - Automated machine learning and model optimization
+- **AI ethics** - AI ethics and responsible AI features
+
+---
+
+## Version History
+
+- **1.0.0** - Initial release with comprehensive security, observability, and intelligence features
+- **Unreleased** - Future releases with advanced features and enhancements
+
+---
+
+**Sector8-sdk** - Where AI Security Meets Observability
+
+> **Remember**: Security is not an add-on feature—it's the foundation of the SDK that cannot be removed or bypassed. 

sector8_sdk-1.0.0/CONTRIBUTING.md

@@ -0,0 +1,175 @@
+# Contributing to Sector8 SDK
+
+Thank you for your interest in contributing to the Sector8 SDK! This document provides guidelines and information for contributors.
+
+## Getting Started
+
+### Prerequisites
+
+- Python 3.8 or higher
+- Git
+- pip or conda for package management
+
+### Development Setup
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/sector8/sector8-sdk.git
+   cd sector8-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]"
+   ```
+
+4. **Install pre-commit hooks:**
+   ```bash
+   pre-commit install
+   ```
+
+## Development Guidelines
+
+### Code Style
+
+We use several tools to maintain code quality:
+
+- **Black** for code formatting
+- **isort** for import sorting
+- **mypy** for type checking
+- **ruff** for linting
+
+Run these tools before committing:
+
+```bash
+black src/ tests/
+isort src/ tests/
+mypy src/
+ruff check src/ tests/
+```
+
+### Testing
+
+We use pytest for testing. Run tests with:
+
+```bash
+# Run all tests
+pytest
+
+# Run with coverage
+pytest --cov=sector8
+
+# Run specific test file
+pytest tests/test_client.py
+
+# Run with verbose output
+pytest -v
+```
+
+### Type Hints
+
+All new code should include type hints. We use mypy for type checking:
+
+```bash
+mypy src/
+```
+
+### Documentation
+
+- Update docstrings for any new functions or classes
+- Follow Google-style docstrings
+- Include type information in docstrings
+
+Example:
+```python
+def process_data(data: List[str], config: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+    """Process the input data according to configuration.
+    
+    Args:
+        data: List of strings to process
+        config: Optional configuration dictionary
+        
+    Returns:
+        Dictionary containing processed results
+        
+    Raises:
+        ValueError: If data is empty
+    """
+```
+
+## Pull Request Process
+
+1. **Create a feature branch:**
+   ```bash
+   git checkout -b feature/your-feature-name
+   ```
+
+2. **Make your changes** following the guidelines above
+
+3. **Run tests and quality checks:**
+   ```bash
+   pytest
+   mypy src/
+   black --check src/ tests/
+   ruff check src/ tests/
+   ```
+
+4. **Commit your changes:**
+   ```bash
+   git add .
+   git commit -m "feat: add new feature description"
+   ```
+
+5. **Push to your fork:**
+   ```bash
+   git push origin feature/your-feature-name
+   ```
+
+6. **Create a Pull Request** with a clear description of your changes
+
+### Commit Message Format
+
+We follow conventional commit format:
+
+- `feat:` for new features
+- `fix:` for bug fixes
+- `docs:` for documentation changes
+- `style:` for formatting changes
+- `refactor:` for code refactoring
+- `test:` for test changes
+- `chore:` for maintenance tasks
+
+## Issue Reporting
+
+When reporting issues, please include:
+
+- Python version
+- Operating system
+- SDK version
+- Steps to reproduce
+- Expected vs actual behavior
+- Error messages or logs
+
+## Security
+
+If you discover a security vulnerability, please report it privately to security@sector8.com.
+
+## License
+
+By contributing to Sector8 SDK, you agree that your contributions will be licensed under the MIT License.
+
+## Questions?
+
+If you have questions about contributing, please:
+
+1. Check the existing documentation
+2. Search existing issues
+3. Create a new issue with the "question" label
+
+Thank you for contributing to Sector8 SDK! 

sector8_sdk-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Sector8
+
+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. 

sector8_sdk-1.0.0/MANIFEST.in

@@ -0,0 +1,43 @@
+# Include package metadata
+include README.md
+include LICENSE
+include CHANGELOG.md
+include CONTRIBUTING.md
+include TESTING_PUBLIC.md
+include requirements.txt
+
+# Exclude sensitive files from distribution
+exclude TESTING.md
+exclude PRODUCTION_READINESS_CHECKLIST.md
+exclude TESTING_SETUP_COMPLETE.md
+exclude CREATE_DIST_MANUAL.md
+exclude .env.example
+exclude setup_clean_env.sh
+exclude run_full_test_suite.sh
+exclude build_package.sh
+exclude validate_sdk_structure.py
+
+# Include all Python files
+recursive-include src/sector8 *.py
+recursive-include src/sector8 *.pyi
+
+# Include configuration files
+include src/sector8/py.typed
+
+# Exclude development and test files
+exclude test_*.py
+exclude *_test.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude * .git*
+recursive-exclude * .DS_Store
+recursive-exclude * *.egg-info
+
+# Include auto-instrumentation files
+recursive-include src/sector8/instrumentation *.py
+
+# Include all module data
+recursive-include src/sector8 *.json
+recursive-include src/sector8 *.yaml
+recursive-include src/sector8 *.yml
+recursive-include src/sector8 *.toml