acl-core-py 1.75__tar.gz

acl_core_py-1.75/.gitignore

@@ -0,0 +1,24 @@
+# Environment files
+.env
+.env.development
+.env.production
+
+# Python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+venv/
+.venv/
+
+# Logs & telemetry
+logs/
+*.log
+telemetry/*.jsonl
+
+# Misc
+.DS_Store
+node_modules/
+*.egg-info/
+dist/
+build/

acl_core_py-1.75/LICENSE

@@ -0,0 +1,24 @@
+ACL SDK PROPRIETARY LICENSE
+Copyright (c) 2026 ACL Team. All rights reserved.
+
+This SDK is proprietary software and is licensed, not sold.
+
+Permitted use:
+- Use only to access ACL services with a valid ACL-issued API key.
+- Internal use by authorized users and systems under your organization.
+
+Not permitted without prior written permission from ACL Team:
+- Redistribute, sublicense, resell, rent, lease, or transfer this SDK.
+- Modify, create derivative works, reverse engineer, decompile, or disassemble this SDK.
+- Use this SDK to build or operate a competing service.
+
+No open-source grant:
+- No rights are granted under any open-source license.
+
+Termination:
+- Any violation of these terms immediately terminates your license to use this SDK.
+
+Disclaimer:
+- The SDK is provided "as is" without warranties of any kind, to the maximum extent permitted by law.
+
+For commercial or redistribution permissions, contact: support@fridayaicore.in

acl_core_py-1.75/PKG-INFO

@@ -0,0 +1,194 @@
+Metadata-Version: 2.4
+Name: acl-core-py
+Version: 1.75
+Summary: Official Python client for the Adaptive Context Layer (ACL)
+Project-URL: Homepage, https://github.com/acl-team/acl-core-py
+Project-URL: Documentation, https://docs.fridayaicore.in/python-sdk
+Project-URL: Repository, https://github.com/acl-team/acl-core-py
+Project-URL: Bug Tracker, https://github.com/acl-team/acl-core-py/issues
+Project-URL: API Documentation, https://docs.fridayaicore.in
+Author-email: ACL Team <support@fridayaicore.in>
+Maintainer-email: ACL Team <support@fridayaicore.in>
+License: ACL SDK PROPRIETARY LICENSE
+        Copyright (c) 2026 ACL Team. All rights reserved.
+        
+        This SDK is proprietary software and is licensed, not sold.
+        
+        Permitted use:
+        - Use only to access ACL services with a valid ACL-issued API key.
+        - Internal use by authorized users and systems under your organization.
+        
+        Not permitted without prior written permission from ACL Team:
+        - Redistribute, sublicense, resell, rent, lease, or transfer this SDK.
+        - Modify, create derivative works, reverse engineer, decompile, or disassemble this SDK.
+        - Use this SDK to build or operate a competing service.
+        
+        No open-source grant:
+        - No rights are granted under any open-source license.
+        
+        Termination:
+        - Any violation of these terms immediately terminates your license to use this SDK.
+        
+        Disclaimer:
+        - The SDK is provided "as is" without warranties of any kind, to the maximum extent permitted by law.
+        
+        For commercial or redistribution permissions, contact: support@fridayaicore.in
+License-File: LICENSE
+Keywords: acl,adaptive,ai,context,llm,machine-learning,optimization,token,window
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: Other/Proprietary License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.25.0
+Requires-Dist: typing-extensions>=4.0.0
+Requires-Dist: urllib3>=1.26.0
+Provides-Extra: dev
+Requires-Dist: black>=21.0.0; extra == 'dev'
+Requires-Dist: flake8>=3.8.0; extra == 'dev'
+Requires-Dist: isort>=5.0.0; extra == 'dev'
+Requires-Dist: mypy>=0.800; extra == 'dev'
+Requires-Dist: pytest-cov>=2.10.0; extra == 'dev'
+Requires-Dist: pytest>=6.0.0; extra == 'dev'
+Provides-Extra: test
+Requires-Dist: pytest-cov>=2.10.0; extra == 'test'
+Requires-Dist: pytest>=6.0.0; extra == 'test'
+Requires-Dist: responses>=0.12.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# ACL Python SDK (`acl-core-py`)
+
+Official Python SDK for Adaptive Context Layer (ACL).
+
+## Installation
+
+```bash
+pip install acl-core-py
+```
+
+## AI Agent Install And Infra Setup
+
+Use this flow when agents/dev tools install and run ACL in production:
+
+1. Install SDK
+
+```bash
+pip install --upgrade acl-core-py
+```
+
+2. Set environment variables (domain only, never raw server IP)
+
+```bash
+# Public ACL endpoint behind your domain/reverse proxy
+export ACL_BASE_URL="https://backend.yourcompany.com"
+
+# Org-scoped ACL key from ACL dashboard
+export ACL_API_KEY="acl_live_xxx"
+
+# Provider key stays only with your app/agent runtime
+export OPENAI_API_KEY="sk-xxx"
+```
+
+3. Initialize client using env vars
+
+```python
+import os
+from acl import ACLClient
+
+client = ACLClient(
+    api_key=os.environ["ACL_API_KEY"],
+    base_url=os.environ["ACL_BASE_URL"],
+)
+```
+
+Security notes:
+- Do not hardcode keys in source code.
+- Do not expose EC2/public IP in SDK config; always use DNS/domain.
+- Rotate keys immediately if logs/screenshots accidentally leak them.
+- Keep backend behind TLS (`https`) and firewall to trusted ports only.
+
+## Quick Start
+
+```python
+from acl import ACLClient
+
+client = ACLClient(api_key="acl_live_...")
+
+result = client.complete(
+    prompt="Summarize this incident report.",
+    model="gpt-4o",
+    llm_api_key="sk-...",
+    max_retries=3,
+)
+
+if result["success"]:
+    print(result["response"])
+else:
+    print(f"{result['error_code']}: {result['error_message']}")
+```
+
+## Latency Controls (v1.75)
+
+`ACLClient(...)` supports these runtime options:
+
+- `emit_post_completion_telemetry` (default: `True`): post-completion telemetry is now non-blocking.
+- `precheck_cache_ttl_s` (default: `20.0`): short TTL cache for adaptive precheck calls.
+- `precheck_cache_max_entries` (default: `256`): max in-memory precheck cache entries.
+
+Every `complete()` response now includes timing metadata under `metadata.acl_timing`:
+
+- `precheck_ms`
+- `provider_ms`
+- `post_telemetry_ms`
+- `wall_clock_ms`
+
+## Runtime Contract
+
+`complete()` always returns a stable top-level response shape on both success and failure:
+
+- `success`
+- `error_code`
+- `error_message`
+- `provider`
+- `model`
+- `text` and `response`
+
+## Validation and Safety
+
+- Fail-fast validation for invalid/missing `prompt`, unresolved `model`, missing keys, and malformed provider key formats.
+- Strict provider payload allowlist prevents internal ACL params from leaking to provider APIs.
+- Secrets are redacted from surfaced error messages by default.
+- Default ACL backend base URL: `http://backend.fridayaicore.in`.
+
+## Retry Behavior
+
+- Retries happen in SDK provider execution middleware (`complete()` path).
+- Exponential backoff with jitter and cap:
+- attempt 1: random delay `0-0.5s`
+- attempt 2: random delay `0-1s`
+- attempt 3: random delay `0-2s`
+- max cap per attempt: `8s`
+
+## Compatibility Policy
+
+- Python: `>=3.8`
+- Runtime dependencies: `requests`, `urllib3`, `typing_extensions`
+- Release policy: include migration notes whenever response contract or validation behavior changes.
+
+## Usage Terms
+
+- This SDK is proprietary and licensed for ACL service access only.
+- A valid ACL API key is required.
+- Redistribution, resale, sublicensing, and derivative redistribution are not permitted without written approval from ACL Team.
+
+## License
+
+UNLICENSED / Proprietary. See `LICENSE`.

acl_core_py-1.75/README.md

@@ -0,0 +1,128 @@
+# ACL Python SDK (`acl-core-py`)
+
+Official Python SDK for Adaptive Context Layer (ACL).
+
+## Installation
+
+```bash
+pip install acl-core-py
+```
+
+## AI Agent Install And Infra Setup
+
+Use this flow when agents/dev tools install and run ACL in production:
+
+1. Install SDK
+
+```bash
+pip install --upgrade acl-core-py
+```
+
+2. Set environment variables (domain only, never raw server IP)
+
+```bash
+# Public ACL endpoint behind your domain/reverse proxy
+export ACL_BASE_URL="https://backend.yourcompany.com"
+
+# Org-scoped ACL key from ACL dashboard
+export ACL_API_KEY="acl_live_xxx"
+
+# Provider key stays only with your app/agent runtime
+export OPENAI_API_KEY="sk-xxx"
+```
+
+3. Initialize client using env vars
+
+```python
+import os
+from acl import ACLClient
+
+client = ACLClient(
+    api_key=os.environ["ACL_API_KEY"],
+    base_url=os.environ["ACL_BASE_URL"],
+)
+```
+
+Security notes:
+- Do not hardcode keys in source code.
+- Do not expose EC2/public IP in SDK config; always use DNS/domain.
+- Rotate keys immediately if logs/screenshots accidentally leak them.
+- Keep backend behind TLS (`https`) and firewall to trusted ports only.
+
+## Quick Start
+
+```python
+from acl import ACLClient
+
+client = ACLClient(api_key="acl_live_...")
+
+result = client.complete(
+    prompt="Summarize this incident report.",
+    model="gpt-4o",
+    llm_api_key="sk-...",
+    max_retries=3,
+)
+
+if result["success"]:
+    print(result["response"])
+else:
+    print(f"{result['error_code']}: {result['error_message']}")
+```
+
+## Latency Controls (v1.75)
+
+`ACLClient(...)` supports these runtime options:
+
+- `emit_post_completion_telemetry` (default: `True`): post-completion telemetry is now non-blocking.
+- `precheck_cache_ttl_s` (default: `20.0`): short TTL cache for adaptive precheck calls.
+- `precheck_cache_max_entries` (default: `256`): max in-memory precheck cache entries.
+
+Every `complete()` response now includes timing metadata under `metadata.acl_timing`:
+
+- `precheck_ms`
+- `provider_ms`
+- `post_telemetry_ms`
+- `wall_clock_ms`
+
+## Runtime Contract
+
+`complete()` always returns a stable top-level response shape on both success and failure:
+
+- `success`
+- `error_code`
+- `error_message`
+- `provider`
+- `model`
+- `text` and `response`
+
+## Validation and Safety
+
+- Fail-fast validation for invalid/missing `prompt`, unresolved `model`, missing keys, and malformed provider key formats.
+- Strict provider payload allowlist prevents internal ACL params from leaking to provider APIs.
+- Secrets are redacted from surfaced error messages by default.
+- Default ACL backend base URL: `http://backend.fridayaicore.in`.
+
+## Retry Behavior
+
+- Retries happen in SDK provider execution middleware (`complete()` path).
+- Exponential backoff with jitter and cap:
+- attempt 1: random delay `0-0.5s`
+- attempt 2: random delay `0-1s`
+- attempt 3: random delay `0-2s`
+- max cap per attempt: `8s`
+
+## Compatibility Policy
+
+- Python: `>=3.8`
+- Runtime dependencies: `requests`, `urllib3`, `typing_extensions`
+- Release policy: include migration notes whenever response contract or validation behavior changes.
+
+## Usage Terms
+
+- This SDK is proprietary and licensed for ACL service access only.
+- A valid ACL API key is required.
+- Redistribution, resale, sublicensing, and derivative redistribution are not permitted without written approval from ACL Team.
+
+## License
+
+UNLICENSED / Proprietary. See `LICENSE`.

acl_core_py-1.75/acl/__init__.py

@@ -0,0 +1,44 @@
+"""
+ACL Python SDK
+
+A thin, predictable Python SDK for the Adaptive Context Window API.
+
+The SDK provides enterprise-grade error handling and telemetry while delegating
+all intelligence and processing to the ACL backend.
+"""
+
+from .client import ACLClient
+from .exceptions import (
+    ACLBaseError,
+    ACLAuthError,
+    ACLPermissionError,
+    ACLRateLimitError,
+    ACLValidationError,
+    ACLServerError,
+)
+from .types import (
+    AdaptiveResponse,
+    TelemetryData,
+    ActivityInfo,
+    WindowInfo,
+    ModelAdaptation,
+    TokenSavings,
+)
+
+__version__ = "1.75"
+__all__ = [
+    "ACLClient",
+    "ACLBaseError",
+    "ACLAuthError",
+    "ACLPermissionError",
+    "ACLRateLimitError",
+    "ACLValidationError",
+    "ACLServerError",
+    "AdaptiveResponse",
+    "TelemetryData",
+    "ActivityInfo",
+    "WindowInfo",
+    "ModelAdaptation",
+    "TokenSavings",
+]
+