acgp 0.1.0__tar.gz

acgp-0.1.0/.gitignore

@@ -0,0 +1,80 @@
+# 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
+
+# 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/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+local-docs/

acgp-0.1.0/CHANGELOG.md

@@ -0,0 +1,80 @@
+# 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] - 2025-01-04
+
+### Changed
+
+- **Package Renamed**: Renamed from `cgp-sdk` to `acgp` (Agentic Cognitive Governance Protocol)
+  - Package import changed from `cgp_sdk` to `acgp`
+  - `CGPClient` renamed to `ACGPClient`
+  - `CGPConfig` renamed to `ACGPConfig`
+  - `@cgp_trace` decorator renamed to `@acgp_trace`
+  - Environment variables prefix changed from `CGP_` to `ACGP_`
+
+### Added
+
+- **Real-time SSE Feedback**: Stream feedback from Steward Agent backend via Server-Sent Events
+  - `on_feedback` callback parameter for real-time feedback handling
+  - `SSEConfig` class for customizing SSE behavior
+  - Auto-reconnection with exponential backoff
+  - Background thread processing
+
+- **Core Tracing API**:
+  - `ACGPClient` - Main client class for agent oversight integration
+  - `trace()` context manager for wrapping agent execution
+  - `capture_trace()` for manual trace submission
+  - `TraceContext` with `set_output()`, `set_reasoning()`, `add_context()`, `set_documents()`
+
+- **Batch Processing**:
+  - Automatic batching with configurable `batch_size` and `flush_interval`
+  - Background flush thread for non-blocking trace submission
+  - `flush()` method for immediate trace submission
+  - `on_flush_complete` callback for batch results
+
+- **Feedback Retrieval**:
+  - `wait_for_feedback()` with auto-flush and configurable timeout
+  - `get_score()` for CTQ score retrieval with retry
+  - `get_feedback()` for oversight feedback retrieval
+  - `get_metrics()` for SDK statistics
+
+- **Configuration**:
+  - Environment variable support (`ACGP_API_KEY`, `ACGP_ENDPOINT`, etc.)
+  - `.env` file auto-loading via python-dotenv
+  - `enabled` flag for disabling SDK in specific environments
+  - `fail_silently` mode for production resilience
+  - `debug` mode for troubleshooting
+
+- **Decorator Support**:
+  - `@acgp_trace` decorator for function-based agents
+
+- **Documentation**:
+  - Comprehensive README with quick start and examples
+  - API reference documentation
+  - Framework integration guides (CrewAI, LangChain, AutoGen, GPT-Researcher)
+  - Configuration guide
+  - Best practices
+  - Troubleshooting guide
+
+### Framework Integrations
+
+- CrewAI integration example
+- LangChain / LangGraph integration example
+- AutoGen integration example
+- GPT-Researcher integration example
+- OpenAI Assistants API integration example
+- Custom agent integration patterns
+
+## [Unreleased]
+
+### Planned
+
+- Async/await support for async agent frameworks
+- OpenTelemetry integration for distributed tracing
+- Prometheus metrics export
+- Rate limiting and circuit breaker patterns
+- Multi-tenant support improvements

acgp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MeaningStack (https://meaningstack.com)
+
+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.