epi-recorder 2.2.0__py3-none-any.whl → 2.3.0__py3-none-any.whl

epi_recorder-2.3.0.dist-info/METADATA

@@ -0,0 +1,269 @@
+Metadata-Version: 2.4
+Name: epi-recorder
+Version: 2.3.0
+Summary: Verifiable execution evidence for AI systems. Portable, cryptographically signed artifacts.
+Author-email: EPI Labs <mohdibrahim@epilabs.org>
+Maintainer-email: Mohd Ibrahim Afridi <mohdibrahim@epilabs.org>
+License: MIT
+Project-URL: Homepage, https://epilabs.org
+Project-URL: Documentation, https://epilabs.org/docs
+Project-URL: Repository, https://github.com/mohdibrahimaiml/epi-recorder
+Project-URL: Issues, https://github.com/mohdibrahimaiml/epi-recorder/issues
+Project-URL: Discussions, https://github.com/mohdibrahimaiml/epi-recorder/discussions
+Keywords: evidence,forensics,audit,compliance,cryptography,ai,llm,verification,artifact,execution-trace,reproducibility,tamper-evident
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Legal Industry
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: System :: Logging
+Classifier: Typing :: Typed
+Classifier: Framework :: Pydantic
+Classifier: Framework :: Pydantic :: 2
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: cryptography>=41.0.0
+Requires-Dist: cbor2>=5.6.0
+Requires-Dist: typer[all]>=0.12.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: google-generativeai>=0.4.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: black>=24.0.0; extra == "dev"
+Requires-Dist: ruff>=0.3.0; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mohdibrahimaiml/epi-recorder/main/docs/assets/logo.png" alt="EPI Logo" width="180"/>
+  <br>
+  <h1 align="center">EPI</h1>
+  <p align="center"><strong>Verifiable Execution Evidence for AI Systems / AI Agents</strong></p>
+  <p align="center">
+    <em>A portable, cryptographically sealed artifact format for AI execution records.</em>
+  </p>
+</p>
+
+<p align="center">
+  <a href="https://pypi.org/project/epi-recorder/"><img src="https://img.shields.io/pypi/v/epi-recorder?style=for-the-badge&color=00d4ff&label=PyPI" alt="PyPI"/></a>
+  <a href="https://github.com/mohdibrahimaiml/epi-recorder"><img src="https://img.shields.io/badge/python-3.11%2B-blue?style=for-the-badge&logo=python&logoColor=white" alt="Python"/></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=for-the-badge" alt="License"/></a>
+</p>
+
+---
+
+## What is EPI?
+
+EPI (Evidence Package for AI) is a **file format** for capturing and verifying AI execution evidence.
+
+An `.epi` file is to AI execution what PDF is to documents:
+- **Self-contained** — prompts, responses, environment, viewer — all in one file
+- **Universally viewable** — opens in any browser, no software required
+- **Tamper-evident** — Ed25519 signatures prove the record wasn't altered
+
+EPI is designed for **adversarial review**: audits, incident response, compliance, litigation.
+
+---
+
+## Design Guarantees
+
+EPI artifacts provide the following guarantees:
+
+| Guarantee | Implementation |
+|:----------|:---------------|
+| **Explicitness** | Evidence capture is intentional and reviewable in source code |
+| **Portability** | Single file, no external dependencies, works offline |
+| **Offline Verifiability** | Signature verification requires no network or cloud services |
+| **Adversarial Review** | Format assumes the reviewer does not trust the producer |
+
+These are not features. They are **constraints** that define what EPI is.
+
+---
+
+## Quick Start
+
+```bash
+pip install epi-recorder
+```
+
+### Capture Evidence (Explicit API)
+
+```python
+from epi_recorder import record
+
+with record("evidence.epi") as epi:
+    response = client.chat.completions.create(model="gpt-4", messages=[...])
+    epi.log_llm_call(response)  # Explicit capture
+```
+
+### Capture Evidence (Wrapper Client)
+
+```python
+from epi_recorder import record, wrap_openai
+from openai import OpenAI
+
+client = wrap_openai(OpenAI())
+
+with record("evidence.epi"):
+    response = client.chat.completions.create(...)  # Captured via wrapper
+```
+
+### Verify Evidence
+
+```bash
+epi verify evidence.epi
+```
+
+---
+
+## The `.epi` Artifact Format
+
+An `.epi` file is a ZIP archive with a defined structure. See [docs/EPI-SPEC.md](docs/EPI-SPEC.md) for the full specification.
+
+```
+evidence.epi
+├── mimetype              # "application/epi+zip"
+├── manifest.json         # Metadata + Ed25519 signature
+├── steps.jsonl           # Execution steps (NDJSON)
+├── env.json              # Runtime environment snapshot
+└── viewer/
+    └── index.html        # Self-contained offline viewer
+```
+
+The embedded viewer allows any recipient to:
+- View the complete execution timeline
+- Verify cryptographic integrity
+- Inspect individual steps
+
+No software installation required.
+
+---
+
+## CLI Reference
+
+### Primary Commands
+
+| Command | Purpose |
+|:--------|:--------|
+| `epi run <script.py>` | Capture execution evidence to `.epi` |
+| `epi verify <file.epi>` | Verify artifact integrity and signature |
+| `epi view <file.epi>` | Open artifact in browser viewer |
+| `epi keys list` | Manage signing keys |
+
+### Secondary Tools
+
+These tools consume evidence artifacts for analysis:
+
+| Command | Purpose |
+|:--------|:--------|
+| `epi debug <file.epi>` | Heuristic analysis (loops, errors, inefficiencies) |
+| `epi chat <file.epi>` | Natural language querying via LLM |
+
+> **Note:** `debug` and `chat` are convenience tools built on top of the evidence format.
+> They are not part of the core specification.
+
+---
+
+## Cryptographic Properties
+
+| Property | Implementation |
+|:---------|:---------------|
+| **Signatures** | Ed25519 (RFC 8032) |
+| **Hashing** | SHA-256 content addressing |
+| **Key Storage** | Local keyring, user-controlled |
+| **Verification** | Client-side, zero external dependencies |
+
+Signatures are **optional but recommended**. Unsigned artifacts are still valid but cannot prove origin.
+
+---
+
+## When to Use EPI
+
+### Appropriate Use Cases
+
+- Post-incident forensics
+- Compliance documentation
+- Audit trails for autonomous systems
+- Reproducibility evidence for research
+- Litigation-grade execution records
+
+### Not Designed For
+
+- Real-time monitoring dashboards
+- High-frequency telemetry
+- System health metrics
+- Application performance monitoring
+
+EPI produces **artifacts**, not **streams**.
+
+---
+
+## Supported Providers
+
+| Provider | Capture Method |
+|:---------|:---------------|
+| OpenAI | Wrapper client or explicit API |
+| Anthropic | Explicit API |
+| Google Gemini | Explicit API |
+| Any HTTP-based LLM | Explicit API via `log_llm_call()` |
+
+EPI does not depend on provider-specific integrations. The explicit API works with any response format.
+
+---
+
+## v2.3.0 — Design Correction
+
+This release corrects EPI's evidence capture model.
+
+| Before (v2.2.x) | After (v2.3.0) |
+|:----------------|:---------------|
+| Implicit monkey-patching | Explicit capture |
+| Fragile to SDK changes | Stable across versions |
+| Hidden instrumentation | Reviewable in source |
+
+**Rationale:** Evidence systems must be intentional. Implicit capture was convenient but violated the explicitness guarantee.
+
+**Migration:** Replace implicit capture with `epi.log_llm_call(response)` or `wrap_openai()`.
+
+**Legacy mode:** `record(legacy_patching=True)` is deprecated and will be removed in v3.0.
+
+---
+
+## Release History
+
+| Version | Date | Summary |
+|:--------|:-----|:--------|
+| **2.3.0** | 2026-02-06 | Explicit capture, wrapper clients, design correction |
+| **2.2.0** | 2026-01-30 | SQLite storage, async support, context isolation |
+| **2.1.3** | 2026-01-24 | Gemini capture, evidence querying |
+| **2.1.0** | 2025-12-15 | Initial release |
+
+See [CHANGELOG.md](./CHANGELOG.md) for full details.
+
+---
+
+## Contributing
+
+```bash
+git clone https://github.com/mohdibrahimaiml/epi-recorder.git
+cd epi-recorder
+pip install -e ".[dev]"
+pytest
+```
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT License. See [LICENSE](./LICENSE).

{epi_recorder-2.2.0.dist-info → epi_recorder-2.3.0.dist-info}/RECORD

@@ -14,25 +14,28 @@ epi_cli/view.py,sha256=EP9takENuZnRllBsxDze9Mm32TGsyxsQaUhlNmUNA_w,4027
 epi_core/__init__.py,sha256=8CTVjxZDI6oy-MMqWTILY9h8rgSZXS8kVzgySympGJU,309
 epi_core/container.py,sha256=Eop4CN3TgCoxRyEWorbjvVBnFaxS4zkccdDwgXQ4eIk,13344
 epi_core/redactor.py,sha256=GAq6R9gkuAHyzgE9sxBXpbQvL_v_myEktxTWFNFnrbY,9892
-epi_core/schemas.py,sha256=xpl6xdsIquj_j_a6h2yQ23mB92e91wuiSpKo_BHkY2c,4733
+epi_core/schemas.py,sha256=iVz6yqVnXEe_mG5wh6Y4ojGHyop_kB5igpKXRkK7fT8,4734
 epi_core/serialize.py,sha256=KB7Z7dfDFh6qq0tlrwjWADOBUV4z32q29Dt2yiniGGg,5691
 epi_core/storage.py,sha256=XEVbdr5xf00LDDJMqCdrZDFvVS-BZ1e1CWzDaJqG0jE,5374
 epi_core/trust.py,sha256=_RgYABg0vVH3yBDeXJD7jEyq7WMm5Sli0DHFLmu7lkQ,7970
-epi_recorder/__init__.py,sha256=IFimK8E4Mpfx6QLuL5K6SiI1JFyr7iu8Nwh2bG-axIM,402
-epi_recorder/api.py,sha256=oFHmdoAyBKi-0b8C9qvZB3q04iA0XlNMVO-Yk3kZ2Ng,22648
+epi_recorder/__init__.py,sha256=tCq2jrJHLxOfO4FPJL3W7F9dRIiOmbNbOZ52cUnqa90,565
+epi_recorder/api.py,sha256=HK10VkaOLxdi-QSw4Jb_NfW-_p0FtXqWQqTJT-rOvlQ,29820
 epi_recorder/async_api.py,sha256=a2WQL8MnJ8uwnLD6unDZxASe5JbywP1V-8gcFyySFM8,4949
 epi_recorder/bootstrap.py,sha256=vk6mKnaHcnanm8SB7dYGPDJ8E2iSBSX3OTQ3zyO-6b0,1851
 epi_recorder/environment.py,sha256=09KuIb7GOxiSHu9OsacaxaHXFJy5e7ewbS3Jz4fX2Zk,6604
-epi_recorder/patcher.py,sha256=L773RR3vKj9rw6WVxY6c9zZfrSZMHLR03ZYxcqfbmKw,19475
+epi_recorder/patcher.py,sha256=U_1MRMhLtcdrYxDdD3Lt6MZ4nolkSiYIa93Vn1Go4yI,20981
 epi_recorder/test_import.py,sha256=_wrlfu0BLtT21AINf1_NugJTvM-RVNKJOyzokMezjO0,462
 epi_recorder/test_script.py,sha256=ot2vRtgvUdeqk6Oj_cz0TZyQN9fUFVHy2E82jdzZUOs,95
-epi_recorder-2.2.0.dist-info/licenses/LICENSE,sha256=uuhz9Y8AjcWd5wF_pZA2cdymDjnESrrLKWDjE_hz7dQ,10347
-epi_viewer_static/app.js,sha256=d9m9BYvhtej8xCZQ_4t-0wLHirkhWmDcIbMyJgsqDDs,16173
+epi_recorder/wrappers/__init__.py,sha256=uG0jSBjM_wYo2_lmEiHzDtJbSgF0XlguaNye-dzVjPY,409
+epi_recorder/wrappers/base.py,sha256=uZNNMJSgkf50J_Z-VYO9HOPk-1A1J00BivvKET4opIk,2641
+epi_recorder/wrappers/openai.py,sha256=Mc5LxUSBQtaFyCh7MG0kwe8Wt0VM17weOCRh0N3vjuY,5977
+epi_recorder-2.3.0.dist-info/licenses/LICENSE,sha256=C9g69QrsraEzIORyleKkUeim8h49747brp68ZUf9_ms,1089
+epi_viewer_static/app.js,sha256=2CkRO3iq4J0QTpFgpfAvzGQDrrAIXGp61cJfIC225Cc,20362
 epi_viewer_static/crypto.js,sha256=2bdANR9tLCPRE9joOih4kKVtptpfRXxERNps4IEhjAQ,19082
 epi_viewer_static/index.html,sha256=sPNXnDTnk0ArVLofdKB3hhd8q-NL1AUmjucytXoythk,3302
 epi_viewer_static/viewer_lite.css,sha256=EGsbTiaSZcnep5GMXm6eKxsfr9oIg_IjEDDI94KI4vc,4695
-epi_recorder-2.2.0.dist-info/METADATA,sha256=f_Ojf_H0ASyd0-5LWTrJsfgjJdx8Wnx38Af_ZoJ6_EA,6283
-epi_recorder-2.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-epi_recorder-2.2.0.dist-info/entry_points.txt,sha256=MfMwqVRx_yMGbuPpiyjz2f8fQp8TUbHmRC1H_bupoyM,41
-epi_recorder-2.2.0.dist-info/top_level.txt,sha256=osrjwlhDfJZSucB-G1u-rF6o0L1OCx2d892gSWr8Iik,77
-epi_recorder-2.2.0.dist-info/RECORD,,
+epi_recorder-2.3.0.dist-info/METADATA,sha256=9ZGZtvoz7vNiy6e35cB9AQUqRWpNNDQGHPqEZ_bfl1Q,8761
+epi_recorder-2.3.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+epi_recorder-2.3.0.dist-info/entry_points.txt,sha256=MfMwqVRx_yMGbuPpiyjz2f8fQp8TUbHmRC1H_bupoyM,41
+epi_recorder-2.3.0.dist-info/top_level.txt,sha256=osrjwlhDfJZSucB-G1u-rF6o0L1OCx2d892gSWr8Iik,77
+epi_recorder-2.3.0.dist-info/RECORD,,

epi_recorder-2.3.0.dist-info/licenses/LICENSE

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

epi_viewer_static/app.js

@@ -230,6 +230,14 @@ function renderStep(step) {
         contentDiv.innerHTML = renderLLMRequest(content);
     } else if (kind === 'llm.response') {
         contentDiv.innerHTML = renderLLMResponse(content);
+    } else if (kind === 'llm.error') {
+        contentDiv.innerHTML = renderLLMError(content);
+    } else if (kind === 'http.request') {
+        contentDiv.innerHTML = renderHTTPRequest(content);
+    } else if (kind === 'http.response') {
+        contentDiv.innerHTML = renderHTTPResponse(content);
+    } else if (kind === 'http.error') {
+        contentDiv.innerHTML = renderHTTPError(content);
     } else if (kind === 'security.redaction') {
         contentDiv.innerHTML = renderRedaction(content);
     } else {
@@ -328,6 +336,74 @@ function renderRedaction(content) {
     `;
 }
 
+// Render LLM error
+function renderLLMError(content) {
+    return `
+        <div class="bg-red-50 border border-red-200 rounded-lg p-3 text-sm">
+            <div class="flex items-center text-red-800">
+                <svg class="w-5 h-5 mr-2" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"/>
+                </svg>
+                <span class="font-medium">LLM Error</span>
+            </div>
+            <div class="mt-2 text-red-700 font-mono text-xs">
+                ${escapeHTML(content.error || content.message || JSON.stringify(content))}
+            </div>
+            ${content.provider ? `<div class="mt-1 text-xs text-red-600">${content.provider} • ${content.model || 'unknown'}</div>` : ''}
+        </div>
+    `;
+}
+
+// Render HTTP request
+function renderHTTPRequest(content) {
+    return `
+        <div class="bg-indigo-50 border border-indigo-200 rounded-lg p-3 text-sm">
+            <div class="flex items-center text-indigo-800 mb-2">
+                <span class="font-medium px-2 py-0.5 bg-indigo-200 rounded text-xs">${content.method || 'GET'}</span>
+                <span class="ml-2 font-mono text-xs break-all">${escapeHTML(content.url || '')}</span>
+            </div>
+            ${content.headers ? `<div class="text-xs text-indigo-600">Headers: ${Object.keys(content.headers).length}</div>` : ''}
+            ${content.body ? `<pre class="mt-2 text-xs bg-indigo-100 p-2 rounded overflow-auto max-h-32">${escapeHTML(typeof content.body === 'string' ? content.body : JSON.stringify(content.body, null, 2))}</pre>` : ''}
+        </div>
+    `;
+}
+
+// Render HTTP response
+function renderHTTPResponse(content) {
+    const statusColor = (content.status_code >= 200 && content.status_code < 300) ? 'green' :
+        (content.status_code >= 400) ? 'red' : 'yellow';
+    return `
+        <div class="bg-${statusColor}-50 border border-${statusColor}-200 rounded-lg p-3 text-sm">
+            <div class="flex items-center text-${statusColor}-800 mb-2">
+                <span class="font-medium px-2 py-0.5 bg-${statusColor}-200 rounded text-xs">${content.status_code || '???'}</span>
+                <span class="ml-2 text-xs">${content.url || ''}</span>
+                ${content.latency_seconds ? `<span class="ml-auto text-xs">⚡ ${content.latency_seconds}s</span>` : ''}
+            </div>
+            ${content.body ? `<pre class="mt-2 text-xs bg-gray-100 p-2 rounded overflow-auto max-h-32">${escapeHTML(typeof content.body === 'string' ? content.body.slice(0, 500) : JSON.stringify(content.body, null, 2).slice(0, 500))}${(content.body.length > 500) ? '...' : ''}</pre>` : ''}
+        </div>
+    `;
+}
+
+// Render HTTP error
+function renderHTTPError(content) {
+    return `
+        <div class="bg-red-50 border border-red-200 rounded-lg p-3 text-sm">
+            <div class="flex items-center text-red-800">
+                <svg class="w-5 h-5 mr-2" fill="currentColor" viewBox="0 0 20 20">
+                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"/>
+                </svg>
+                <span class="font-medium">HTTP Error</span>
+            </div>
+            <div class="mt-2 text-red-700">
+                <span class="font-mono text-xs">${escapeHTML(content.url || '')}</span>
+            </div>
+            <div class="mt-1 text-red-600 text-xs">
+                ${escapeHTML(content.error || content.message || JSON.stringify(content))}
+            </div>
+        </div>
+    `;
+}
+
 // Escape HTML to prevent XSS
 function escapeHTML(str) {
     const div = document.createElement('div');
@@ -404,5 +480,4 @@ if (document.readyState === 'loading') {
 } else {
     init();
 }
-
- 
+

epi_recorder-2.2.0.dist-info/METADATA

@@ -1,162 +0,0 @@
-Metadata-Version: 2.4
-Name: epi-recorder
-Version: 2.2.0
-Summary: The Flight Recorder for AI Agents. Debug LangChain & CrewAI with execution tracing.
-Author-email: EPI Labs <mohdibrahim@epilabs.org>
-Maintainer-email: Mohd Ibrahim Afridi <mohdibrahim@epilabs.org>
-License: Apache-2.0
-Project-URL: Homepage, https://epilabs.org
-Project-URL: Documentation, https://epilabs.org/docs
-Project-URL: Repository, https://github.com/mohdibrahimaiml/epi-recorder
-Project-URL: Issues, https://github.com/mohdibrahimaiml/epi-recorder/issues
-Project-URL: Discussions, https://github.com/mohdibrahimaiml/epi-recorder/discussions
-Keywords: ai,debugging,agents,langchain,crewai,devtools,observability,llm,openai,gemini,tracing,flight-recorder
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Debuggers
-Classifier: Topic :: Software Development :: Testing
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Classifier: Topic :: System :: Logging
-Classifier: Typing :: Typed
-Classifier: Framework :: Pydantic
-Classifier: Framework :: Pydantic :: 2
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: cryptography>=41.0.0
-Requires-Dist: cbor2>=5.6.0
-Requires-Dist: typer[all]>=0.12.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: google-generativeai>=0.4.0
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: black>=24.0.0; extra == "dev"
-Requires-Dist: ruff>=0.3.0; extra == "dev"
-Dynamic: license-file
-
-<p align="center">
-  <img src="docs/assets/logo.png" alt="EPI Logo" width="200"/>
-  <br>
-  <h1 align="center">EPI Recorder</h1>
-</p>
-
-[![Release](https://img.shields.io/github/v/release/mohdibrahimaiml/epi-recorder?label=release&style=flat-square&color=00d4ff)](https://github.com/mohdibrahimaiml/epi-recorder/releases)
-[![Python](https://img.shields.io/badge/python-3.11%2B-blue?style=flat-square&logo=python&logoColor=white)](https://pypi.org/project/epi-recorder/)
-[![License](https://img.shields.io/badge/license-Apache--2.0-green?style=flat-square)](LICENSE)
-[![Downloads](https://img.shields.io/pypi/dm/epi-recorder?style=flat-square&color=10b981)](https://pypi.org/project/epi-recorder/)
-[![Users](https://img.shields.io/badge/users-4.5K%2B-orange?style=flat-square&color=f59e0b)](#)
-
-**The Flight Recorder for AI Agents**
-
-Debug production failures in LangChain, CrewAI, and custom agents with one command.
-Captures complete execution context—prompts, responses, tool calls—and cryptographically seals them for audit trails.
-
-&#128214; [Documentation](https://epilabs.org) • &#128640; [Quick Start](#quick-start) • &#128272; [Security](#security-compliance)
-
-> "EPI Recorder provides the missing observability layer we needed for our autonomous agents. The flight recorder approach is a game changer."
-> — Lead AI Engineer, Early Adopter
-
----
-
-## Traction
-- **4,000+** developers using EPI for daily debugging
-- **12,000+** agent executions recorded
-- **99.9%** atomic capture rate (zero data loss on crashes)
-
----
-
-## Why EPI?
-
-Your AI agent failed in production. It hallucinated. It looped infinitely. It cost you $50 in API calls.
-
-**You can't reproduce it.** LLMs are non-deterministic. Your logs don't show the full prompt context. You're taking screenshots and pasting JSON into Slack.
-
-**EPI is the black box.** One command captures everything. Debug locally. Prove what happened.
-
----
-
-## Quick Start
-
-```bash
-pip install epi-recorder
-
-# Record your agent (zero config)
-epi run agent.py
-
-# Debug the failure (opens browser viewer)
-epi view recording.epi
-
-# Verify integrity (cryptographic proof)
-epi verify recording.epi
-```
-
-
-
----
-
-## Features
-
-- **⚡ Zero Config**: `epi run` intercepts OpenAI, LangChain, CrewAI automatically—no code changes.
-- **🔍 AI Debugging**: Built-in heuristics detect infinite loops, hallucinations, and cost inefficiencies.
-- **🛡️ Crash Safe**: Atomic SQLite storage survives OOM and power failures (99.9% capture rate).
-- **🔐 Tamper Proof**: Ed25519 signatures prove logs weren't edited (for compliance/audits).
-- **🌐 Framework Agnostic**: Works with any Python agent (LangChain, CrewAI, AutoGPT, or 100 lines of raw code).
-
----
-
-## How It Works
-
-EPI acts as a **Parasitic Observer**—injecting instrumentation at the Python runtime level via `sitecustomize.py`.
-
-1.  **Intercept**: Captures LLM calls at the HTTP layer (`requests.Session`) and library level.
-2.  **Store**: Atomic SQLite WAL ensures zero data loss on crashes.
-3.  **Analyze**: `epi debug` uses local heuristics + AI to find root causes.
-4.  **Seal**: Canonical JSON (RFC 8785) + Ed25519 signatures create forensically-valid evidence.
-
-```mermaid
-graph LR
-    Script[User Script] -->|Intercept| Patcher[EPI Patcher]
-    Patcher -->|Write| WAL[(Atomic SQLite)]
-    WAL -->|Package| File[.epi File]
-    File -->|Sign| Key[Ed25519 Key]
-```
-
----
-
-## Security & Compliance
-
-While EPI is built for daily debugging, it provides the cryptographic infrastructure required for regulated environments:
-
--   **Signatures**: Ed25519 with client-side verification (zero-knowledge).
--   **Standards**: Supports EU AI Act Article 6 logging requirements.
--   **Privacy**: Automatic PII redaction, air-gapped operation (no cloud required).
-
-*[Enterprise support available](mailto:enterprise@epilabs.org) for SOC2/ISO27001 environments.*
-
----
-
-## Contributing
-
-We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
-
-```bash
-git clone https://github.com/mohdibrahimaiml/epi-recorder.git
-cd epi-recorder
-pip install -e ".[dev]"
-pytest
-```
-
-## License
-
-Apache-2.0 License. See [LICENSE](./LICENSE) for details.
-
-
-