llm-cost-guard 0.1.1__tar.gz → 0.2.0__tar.gz

{llm_cost_guard-0.1.1 → llm_cost_guard-0.2.0}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: llm-cost-guard
-Version: 0.1.1
+Version: 0.2.0
 Summary: Real-time cost tracking, budget enforcement, and usage analytics for LLM applications
 Project-URL: Homepage, https://github.com/prashantdudami/llm-cost-guard
 Project-URL: Documentation, https://github.com/prashantdudami/llm-cost-guard#readme
 Project-URL: Repository, https://github.com/prashantdudami/llm-cost-guard
 Project-URL: Issues, https://github.com/prashantdudami/llm-cost-guard/issues
+Project-URL: Author, https://www.prashantdudami.com/
 Author-email: Prashant Dudami <prashant.dudami@gmail.com>
 License-Expression: MIT
 License-File: LICENSE
@@ -333,6 +334,57 @@ tracker = CostTracker(
 )
 ```
 
+## Audit Logging (v0.2.0+)
+
+Enterprise-ready audit trails for compliance:
+
+```python
+from llm_cost_guard import CostTracker, FileAuditBackend
+
+# Enable audit logging
+tracker = CostTracker(
+    audit_enabled=True,
+    audit_backend=FileAuditBackend("audit.log"),
+)
+
+# Query audit history
+events = tracker.audit.query(
+    event_type=AuditEventType.BUDGET_EXCEEDED,
+    start_date="2024-01-01",
+)
+
+# Get budget-specific history
+history = tracker.audit.get_budget_history("daily")
+```
+
+Audit events include:
+- Budget created/modified/deleted
+- Budget warnings and exceeded events
+- Rate limit exceeded events
+- Tracking failures and fallback activations
+
+## Observability Metrics (v0.2.0+)
+
+Track health and degradation:
+
+```python
+# Get tracker metrics
+metrics = tracker.get_metrics()
+print(metrics)
+# {
+#   "backend_failures": 0,
+#   "fallback_activations": 0,
+#   "budget_exceeded_count": 3,
+#   "tracking_errors": 0,
+#   "using_fallback": False,
+# }
+
+# Health check
+health = tracker.health_check()
+print(health.healthy)  # True/False
+print(health.errors)   # List of issues
+```
+
 ## Custom Pricing
 
 For negotiated enterprise rates:
@@ -348,6 +400,30 @@ tracker = CostTracker(
 )
 ```
 
+## Current Limitations
+
+Being transparent about what's not yet production-ready:
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Distributed budgets (Redis) | ✅ v0.2.0 | Atomic operations with Lua scripts |
+| Audit logging | ✅ v0.2.0 | File and logging backends |
+| Graceful degradation metrics | ✅ v0.2.0 | Track failures and fallbacks |
+| PostgreSQL backend | 🚧 Planned | Use SQLite or Redis for now |
+| DynamoDB backend | 🚧 Planned | Use SQLite or Redis for now |
+| Encryption at rest | 🚧 Planned | Use encrypted volumes as workaround |
+| Multi-tenancy optimization | 🚧 Planned | Use tag-scoped budgets for now |
+| Streaming cost estimation | ⚠️ Limited | Actual cost tracked on completion |
+| Fine-tuning cost tracking | ❌ Not supported | |
+
+### Recommended for Production
+
+| Deployment Size | Backend | Notes |
+|-----------------|---------|-------|
+| Single instance | SQLite | Simple, no setup |
+| Multiple instances | Redis | Distributed budget enforcement |
+| High-volume (>1k req/s) | Redis | With sampling (coming soon) |
+
 ## Contributing
 
 Contributions are welcome! Please read our contributing guidelines and submit pull requests.
@@ -358,7 +434,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ## Author
 
-**Prashant Dudami**
+**Prashant Dudami** - AI/ML Architect & LLM Infrastructure Expert
+- Website: [prashantdudami.com](https://www.prashantdudami.com/)
 - LinkedIn: [linkedin.com/in/prashantdudami](https://www.linkedin.com/in/prashantdudami/)
 - GitHub: [github.com/prashantdudami](https://github.com/prashantdudami)
-- Email: prashant.dudami@gmail.com

{llm_cost_guard-0.1.1 → llm_cost_guard-0.2.0}/README.md

@@ -271,6 +271,57 @@ tracker = CostTracker(
 )
 ```
 
+## Audit Logging (v0.2.0+)
+
+Enterprise-ready audit trails for compliance:
+
+```python
+from llm_cost_guard import CostTracker, FileAuditBackend
+
+# Enable audit logging
+tracker = CostTracker(
+    audit_enabled=True,
+    audit_backend=FileAuditBackend("audit.log"),
+)
+
+# Query audit history
+events = tracker.audit.query(
+    event_type=AuditEventType.BUDGET_EXCEEDED,
+    start_date="2024-01-01",
+)
+
+# Get budget-specific history
+history = tracker.audit.get_budget_history("daily")
+```
+
+Audit events include:
+- Budget created/modified/deleted
+- Budget warnings and exceeded events
+- Rate limit exceeded events
+- Tracking failures and fallback activations
+
+## Observability Metrics (v0.2.0+)
+
+Track health and degradation:
+
+```python
+# Get tracker metrics
+metrics = tracker.get_metrics()
+print(metrics)
+# {
+#   "backend_failures": 0,
+#   "fallback_activations": 0,
+#   "budget_exceeded_count": 3,
+#   "tracking_errors": 0,
+#   "using_fallback": False,
+# }
+
+# Health check
+health = tracker.health_check()
+print(health.healthy)  # True/False
+print(health.errors)   # List of issues
+```
+
 ## Custom Pricing
 
 For negotiated enterprise rates:
@@ -286,6 +337,30 @@ tracker = CostTracker(
 )
 ```
 
+## Current Limitations
+
+Being transparent about what's not yet production-ready:
+
+| Feature | Status | Notes |
+|---------|--------|-------|
+| Distributed budgets (Redis) | ✅ v0.2.0 | Atomic operations with Lua scripts |
+| Audit logging | ✅ v0.2.0 | File and logging backends |
+| Graceful degradation metrics | ✅ v0.2.0 | Track failures and fallbacks |
+| PostgreSQL backend | 🚧 Planned | Use SQLite or Redis for now |
+| DynamoDB backend | 🚧 Planned | Use SQLite or Redis for now |
+| Encryption at rest | 🚧 Planned | Use encrypted volumes as workaround |
+| Multi-tenancy optimization | 🚧 Planned | Use tag-scoped budgets for now |
+| Streaming cost estimation | ⚠️ Limited | Actual cost tracked on completion |
+| Fine-tuning cost tracking | ❌ Not supported | |
+
+### Recommended for Production
+
+| Deployment Size | Backend | Notes |
+|-----------------|---------|-------|
+| Single instance | SQLite | Simple, no setup |
+| Multiple instances | Redis | Distributed budget enforcement |
+| High-volume (>1k req/s) | Redis | With sampling (coming soon) |
+
 ## Contributing
 
 Contributions are welcome! Please read our contributing guidelines and submit pull requests.
@@ -296,7 +371,7 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ## Author
 
-**Prashant Dudami**
+**Prashant Dudami** - AI/ML Architect & LLM Infrastructure Expert
+- Website: [prashantdudami.com](https://www.prashantdudami.com/)
 - LinkedIn: [linkedin.com/in/prashantdudami](https://www.linkedin.com/in/prashantdudami/)
 - GitHub: [github.com/prashantdudami](https://github.com/prashantdudami)
-- Email: prashant.dudami@gmail.com

{llm_cost_guard-0.1.1 → llm_cost_guard-0.2.0}/llm_cost_guard/__init__.py

@@ -15,8 +15,16 @@ from llm_cost_guard.exceptions import (
     TrackingUnavailableError,
     RateLimitExceededError,
 )
+from llm_cost_guard.audit import (
+    AuditLogger,
+    AuditBackend,
+    AuditEvent,
+    AuditEventType,
+    LoggingAuditBackend,
+    FileAuditBackend,
+)
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 
 __all__ = [
     # Core
@@ -29,6 +37,13 @@ __all__ = [
     "CostRecord",
     "CostReport",
     "HealthStatus",
+    # Audit
+    "AuditLogger",
+    "AuditBackend",
+    "AuditEvent",
+    "AuditEventType",
+    "LoggingAuditBackend",
+    "FileAuditBackend",
     # Exceptions
     "LLMCostGuardError",
     "BudgetExceededError",