xproof 0.2.7__tar.gz → 0.2.8__tar.gz

{xproof-0.2.7 → xproof-0.2.8}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 xProof
+Copyright (c) 2026 xProof
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{xproof-0.2.7 → xproof-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: xproof
-Version: 0.2.7
+Version: 0.2.8
 Summary: Python SDK for xProof — blockchain-anchored proof-of-existence for AI agents on MultiversX
 Author-email: xProof <contact@xproof.app>
 License-Expression: MIT
@@ -34,7 +34,7 @@ Requires-Dist: mypy>=1.0; extra == "dev"
 Requires-Dist: types-requests>=2.25.0; extra == "dev"
 Requires-Dist: pre-commit>=3.0; extra == "dev"
 Provides-Extra: llamaindex
-Requires-Dist: llama-index-core>=0.13.0; extra == "llamaindex"
+Requires-Dist: llama-index-core>=0.14.20; extra == "llamaindex"
 Provides-Extra: autogen
 Requires-Dist: pyautogen>=0.2.0; extra == "autogen"
 Provides-Extra: openai-agents
@@ -271,6 +271,116 @@ else:
 
 ---
 
+## Context Drift Detection
+
+Detect when the execution context of an agent changed between proof stages — different model version, tool set, strategy, or operator scope:
+
+```python
+from xproof import XProofClient
+
+client = XProofClient(api_key="pm_your_key")
+
+drift = client.get_context_drift("trade-xyz-2026")
+
+if drift.context_coherent:
+    print(f"No drift detected (score={drift.drift_score:.2f})")
+else:
+    print(f"Drift detected! score={drift.drift_score:.2f}")
+    print(f"  Drifted fields : {drift.fields_drifted}")
+    print(f"  Stable fields  : {drift.fields_stable}")
+    print(f"  Absent fields  : {drift.fields_absent}")
+
+    for i, stage in enumerate(drift.stages):
+        print(f"  Stage {i}: model={stage.model_hash}, tools={stage.tools_version}")
+```
+
+`get_context_drift()` returns a `ContextDrift` object with these fields:
+
+| Field | Type | Description |
+|---|---|---|
+| `context_coherent` | `bool` | `True` if no drift detected across the chain |
+| `drift_score` | `float` | `0.0` = fully coherent · `1.0` = total drift |
+| `fields_drifted` | `list[str]` | Fields that changed at least once |
+| `fields_stable` | `list[str]` | Fields present in all stages and unchanged |
+| `fields_absent` | `list[str]` | Fields never populated in any stage |
+| `stages` | `list[ContextDriftStage]` | Per-stage snapshots (`model_hash`, `tools_version`, `strategy_snapshot`, `operator_scope`) |
+| `raw` | `dict` | Unmodified API response |
+
+---
+
+## Timing Breakdown
+
+Anchor the full decision chronology on-chain so forensic auditors can distinguish real-time reasoning from post-hoc reconstruction. Pass a `TimingBreakdown` dict to `certify_with_confidence()`:
+
+```python
+from xproof import XProofClient, TimingBreakdown
+import time
+
+client = XProofClient(api_key="pm_your_key")
+
+# Capture timestamps at each lifecycle event
+instruction_ts = "2026-04-20T14:30:00Z"  # when the agent received the task
+reasoning_ts   = "2026-04-20T14:30:01Z"  # when reasoning/planning started
+action_ts      = "2026-04-20T14:30:05Z"  # when the action was executed
+
+timing: TimingBreakdown = {
+    "instruction_received_at": instruction_ts,
+    "reasoning_started_at":    reasoning_ts,
+    "action_taken_at":         action_ts,
+    "jurisdiction_type":       "autonomous_inference",  # legal accountability class
+}
+
+cert = client.certify_with_confidence(
+    file_hash="e3b0c44298fc1c149afb...",
+    file_name="trade-decision.json",
+    author="trading-agent",
+    confidence_level=0.97,
+    threshold_stage="pre-commitment",
+    decision_id="trade-xyz-2026",
+    reversibility_class="irreversible",
+    timing=timing,
+)
+
+# The server echoes timing_breakdown with computed durations
+tb = cert.timing_breakdown
+if tb:
+    print(f"Thinking time : {tb.get('reasoning_duration_ms')} ms")
+    print(f"Total latency : {tb.get('total_duration_ms')} ms")
+```
+
+### jurisdiction_type
+
+The `jurisdiction_type` field records the legal accountability classification for the decision:
+
+| Value | Meaning |
+|---|---|
+| `instruction_following` | Agent executed an explicit human instruction — accountability follows the principal |
+| `autonomous_inference` | Agent reached its own conclusion — agent and its operator bear primary accountability |
+| `human_approved` | Agent recommended; a human explicitly approved — shared accountability |
+
+```python
+from xproof import JURISDICTION_TYPES
+
+print(JURISDICTION_TYPES)
+# ('instruction_following', 'autonomous_inference', 'human_approved')
+```
+
+### Reading timing_breakdown from a Certification
+
+When the server echoes the timestamps it also computes:
+- `reasoning_duration_ms` — milliseconds between `reasoning_started_at` and `action_taken_at`
+- `total_duration_ms` — milliseconds between `instruction_received_at` and `action_taken_at`
+
+```python
+tb = cert.timing_breakdown      # TimingBreakdown | None
+if tb is not None:
+    print(tb["instruction_received_at"])   # "2026-04-20T14:30:00Z"
+    print(tb["reasoning_duration_ms"])     # 4000
+    print(tb["total_duration_ms"])         # 5000
+```
+
+---
+
 ## Governance & Policy Enforcement
 
 xProof detects automatically when an agent acted with insufficient confidence on an irreversible action — and writes the evidence on-chain before you ever open an incident report.
@@ -311,6 +421,8 @@ if not check.policy_compliant:
         # →   confidence 0.72 is below the required threshold of 0.95
 ```
 
+Prefer `get_policy_check()` when you only need a fast governance gate. It avoids fetching the full confidence trail, which is better reserved for post-incident review or detailed forensic analysis.
+
 ### Full confidence trail with policy result
 
 ```python
@@ -342,11 +454,9 @@ from xproof.exceptions import PolicyViolationError
 certify = XProofCertifyTool(api_key="pm_...", author="data-hygiene-agent")
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 
@@ -357,10 +467,10 @@ try:
         "threshold_stage": "pre-commitment",
         "decision_id": decision_id,
         "reversibility_class": "irreversible",
-        "why": "Scheduled GDPR data-retention cleanup",
+        "why": "Scheduled GDPR retention cleanup",
     })
     print(f"Policy compliant — proceeding (tx: {tx_hash})")
-    # delete_customer_records(decision["scope"])   # your execution here
+    # delete_pii_records(decision["scope"])   # your execution here
 except PolicyViolationError as exc:
     for v in exc.violations:
         print(f"BLOCKED [{v.severity.upper()}] {v.rule}: {v.message}")
@@ -392,7 +502,7 @@ tx_hash = await certify.arun({
     "threshold_stage": "pre-commitment",
     "decision_id": decision_id,
     "reversibility_class": "irreversible",
-    "why": "Scheduled GDPR data-retention cleanup",
+    "why": "Scheduled GDPR retention cleanup",
 })
 ```
 
@@ -425,11 +535,9 @@ from xproof.exceptions import PolicyViolationError
 certify = XProofCrewCertifyTool(api_key="pm_...", author="data-hygiene-agent")
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 
@@ -440,10 +548,10 @@ try:
         threshold_stage="pre-commitment",
         decision_id=decision_id,
         reversibility_class="irreversible",
-        why="Scheduled GDPR data-retention cleanup",
+        why="Scheduled GDPR retention cleanup",
     )
     print(f"Policy compliant — proceeding (tx: {tx_hash})")
-    # delete_customer_records(decision["scope"])   # your execution here
+    # delete_pii_records(decision["scope"])   # your execution here
 except PolicyViolationError as exc:
     for v in exc.violations:
         print(f"BLOCKED [{v.severity.upper()}] {v.rule}: {v.message}")
@@ -474,11 +582,9 @@ from xproof.integrations.autogen import xproof_certify_decision
 from xproof.exceptions import PolicyViolationError
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 
@@ -489,12 +595,12 @@ try:
         threshold_stage="pre-commitment",
         decision_id=decision_id,
         reversibility_class="irreversible",
-        why="Scheduled GDPR data-retention cleanup",
+        why="Scheduled GDPR retention cleanup",
         author="data-hygiene-agent",
         api_key="pm_...",
     )
     print(f"Policy compliant — proceeding (tx: {tx_hash})")
-    # delete_customer_records(decision["scope"])   # your execution here
+    # delete_pii_records(decision["scope"])   # your execution here
 except PolicyViolationError as exc:
     for v in exc.violations:
         print(f"BLOCKED [{v.severity.upper()}] {v.rule}: {v.message}")
@@ -535,13 +641,9 @@ def hash_string(s: str) -> str:
 # chain-of-thought or tool-call output produced just before execution.)
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
-    "agent": "data-hygiene-agent",
-    "run_id": "del-run-2026-04-20",
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 reasoning_hash = hash_string(json.dumps(decision, sort_keys=True))
@@ -577,7 +679,7 @@ if not check.policy_compliant:
 
 # ── Step 4: Execute only when compliant ──────────────────────────────────────
 print(f"Policy compliant — proceeding with deletion (cert: {cert.transaction_hash})")
-# delete_customer_records(decision["scope"])   # your actual execution here
+# delete_pii_records(decision["scope"])   # your actual execution here
 ```
 
 **What happens if the agent's confidence is too low?**
@@ -686,6 +788,56 @@ shippers (Fluentd, the Datadog Agent, the CloudWatch agent) forward verbatim.
 Create a log-based metric or alert on `event = "policy_violation"` to get
 dashboard counts and threshold alerts with no extra instrumentation.
 
+> **Runnable example** — `python-sdk/examples/compliance_observability.py` runs the full pattern with a mock client and verifies structured output. No API key needed.
+
+#### Drop-in: CrewAI one-liner
+
+`XProofCrewCertifyTool` wraps `certify_with_confidence` + `get_policy_check` into a single `run()` call. Replace the manual four-step loop with:
+
+```python
+from xproof.integrations.crewai import XProofCrewCertifyTool
+from xproof.exceptions import PolicyViolationError
+
+certify = XProofCrewCertifyTool(api_key="pm_...", author="compliance-agent")
+
+try:
+    result = certify.run(
+        decision_text=json.dumps(decision),
+        confidence_level=0.91,
+        reversibility_class="irreversible",
+        decision_id="trade-xyz-2026",
+    )
+except PolicyViolationError as exc:
+    for v in exc.violations:
+        _emit_violation("trade-xyz-2026", v)   # reuse _emit_violation from above
+    raise RuntimeError("Action aborted: policy compliance check failed.") from exc
+```
+
+#### Drop-in: AutoGen one-liner
+
+`xproof_certify_decision` is a plain callable — register it as a function tool on any `ConversableAgent` or call it directly:
+
+```python
+from xproof.integrations.autogen import xproof_certify_decision
+from xproof.exceptions import PolicyViolationError
+
+try:
+    result = xproof_certify_decision(
+        api_key="pm_...",
+        decision_text=json.dumps(decision),
+        confidence_level=0.91,
+        reversibility_class="irreversible",
+        decision_id="trade-xyz-2026",
+        author="autogen-agent",
+    )
+except PolicyViolationError as exc:
+    for v in exc.violations:
+        _emit_violation("trade-xyz-2026", v)
+    raise RuntimeError("Action aborted: policy compliance check failed.") from exc
+```
+
+Both tools write the violation evidence on-chain before raising — so the structured log and the chain anchor are always in sync.
+
 ### Three classes, one parameter
 
 | `reversibility_class` | What it means | Policy threshold |

{xproof-0.2.7 → xproof-0.2.8}/README.md

@@ -225,6 +225,116 @@ else:
 
 ---
 
+## Context Drift Detection
+
+Detect when the execution context of an agent changed between proof stages — different model version, tool set, strategy, or operator scope:
+
+```python
+from xproof import XProofClient
+
+client = XProofClient(api_key="pm_your_key")
+
+drift = client.get_context_drift("trade-xyz-2026")
+
+if drift.context_coherent:
+    print(f"No drift detected (score={drift.drift_score:.2f})")
+else:
+    print(f"Drift detected! score={drift.drift_score:.2f}")
+    print(f"  Drifted fields : {drift.fields_drifted}")
+    print(f"  Stable fields  : {drift.fields_stable}")
+    print(f"  Absent fields  : {drift.fields_absent}")
+
+    for i, stage in enumerate(drift.stages):
+        print(f"  Stage {i}: model={stage.model_hash}, tools={stage.tools_version}")
+```
+
+`get_context_drift()` returns a `ContextDrift` object with these fields:
+
+| Field | Type | Description |
+|---|---|---|
+| `context_coherent` | `bool` | `True` if no drift detected across the chain |
+| `drift_score` | `float` | `0.0` = fully coherent · `1.0` = total drift |
+| `fields_drifted` | `list[str]` | Fields that changed at least once |
+| `fields_stable` | `list[str]` | Fields present in all stages and unchanged |
+| `fields_absent` | `list[str]` | Fields never populated in any stage |
+| `stages` | `list[ContextDriftStage]` | Per-stage snapshots (`model_hash`, `tools_version`, `strategy_snapshot`, `operator_scope`) |
+| `raw` | `dict` | Unmodified API response |
+
+---
+
+## Timing Breakdown
+
+Anchor the full decision chronology on-chain so forensic auditors can distinguish real-time reasoning from post-hoc reconstruction. Pass a `TimingBreakdown` dict to `certify_with_confidence()`:
+
+```python
+from xproof import XProofClient, TimingBreakdown
+import time
+
+client = XProofClient(api_key="pm_your_key")
+
+# Capture timestamps at each lifecycle event
+instruction_ts = "2026-04-20T14:30:00Z"  # when the agent received the task
+reasoning_ts   = "2026-04-20T14:30:01Z"  # when reasoning/planning started
+action_ts      = "2026-04-20T14:30:05Z"  # when the action was executed
+
+timing: TimingBreakdown = {
+    "instruction_received_at": instruction_ts,
+    "reasoning_started_at":    reasoning_ts,
+    "action_taken_at":         action_ts,
+    "jurisdiction_type":       "autonomous_inference",  # legal accountability class
+}
+
+cert = client.certify_with_confidence(
+    file_hash="e3b0c44298fc1c149afb...",
+    file_name="trade-decision.json",
+    author="trading-agent",
+    confidence_level=0.97,
+    threshold_stage="pre-commitment",
+    decision_id="trade-xyz-2026",
+    reversibility_class="irreversible",
+    timing=timing,
+)
+
+# The server echoes timing_breakdown with computed durations
+tb = cert.timing_breakdown
+if tb:
+    print(f"Thinking time : {tb.get('reasoning_duration_ms')} ms")
+    print(f"Total latency : {tb.get('total_duration_ms')} ms")
+```
+
+### jurisdiction_type
+
+The `jurisdiction_type` field records the legal accountability classification for the decision:
+
+| Value | Meaning |
+|---|---|
+| `instruction_following` | Agent executed an explicit human instruction — accountability follows the principal |
+| `autonomous_inference` | Agent reached its own conclusion — agent and its operator bear primary accountability |
+| `human_approved` | Agent recommended; a human explicitly approved — shared accountability |
+
+```python
+from xproof import JURISDICTION_TYPES
+
+print(JURISDICTION_TYPES)
+# ('instruction_following', 'autonomous_inference', 'human_approved')
+```
+
+### Reading timing_breakdown from a Certification
+
+When the server echoes the timestamps it also computes:
+- `reasoning_duration_ms` — milliseconds between `reasoning_started_at` and `action_taken_at`
+- `total_duration_ms` — milliseconds between `instruction_received_at` and `action_taken_at`
+
+```python
+tb = cert.timing_breakdown      # TimingBreakdown | None
+if tb is not None:
+    print(tb["instruction_received_at"])   # "2026-04-20T14:30:00Z"
+    print(tb["reasoning_duration_ms"])     # 4000
+    print(tb["total_duration_ms"])         # 5000
+```
+
+---
+
 ## Governance & Policy Enforcement
 
 xProof detects automatically when an agent acted with insufficient confidence on an irreversible action — and writes the evidence on-chain before you ever open an incident report.
@@ -265,6 +375,8 @@ if not check.policy_compliant:
         # →   confidence 0.72 is below the required threshold of 0.95
 ```
 
+Prefer `get_policy_check()` when you only need a fast governance gate. It avoids fetching the full confidence trail, which is better reserved for post-incident review or detailed forensic analysis.
+
 ### Full confidence trail with policy result
 
 ```python
@@ -296,11 +408,9 @@ from xproof.exceptions import PolicyViolationError
 certify = XProofCertifyTool(api_key="pm_...", author="data-hygiene-agent")
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 
@@ -311,10 +421,10 @@ try:
         "threshold_stage": "pre-commitment",
         "decision_id": decision_id,
         "reversibility_class": "irreversible",
-        "why": "Scheduled GDPR data-retention cleanup",
+        "why": "Scheduled GDPR retention cleanup",
     })
     print(f"Policy compliant — proceeding (tx: {tx_hash})")
-    # delete_customer_records(decision["scope"])   # your execution here
+    # delete_pii_records(decision["scope"])   # your execution here
 except PolicyViolationError as exc:
     for v in exc.violations:
         print(f"BLOCKED [{v.severity.upper()}] {v.rule}: {v.message}")
@@ -346,7 +456,7 @@ tx_hash = await certify.arun({
     "threshold_stage": "pre-commitment",
     "decision_id": decision_id,
     "reversibility_class": "irreversible",
-    "why": "Scheduled GDPR data-retention cleanup",
+    "why": "Scheduled GDPR retention cleanup",
 })
 ```
 
@@ -379,11 +489,9 @@ from xproof.exceptions import PolicyViolationError
 certify = XProofCrewCertifyTool(api_key="pm_...", author="data-hygiene-agent")
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 
@@ -394,10 +502,10 @@ try:
         threshold_stage="pre-commitment",
         decision_id=decision_id,
         reversibility_class="irreversible",
-        why="Scheduled GDPR data-retention cleanup",
+        why="Scheduled GDPR retention cleanup",
     )
     print(f"Policy compliant — proceeding (tx: {tx_hash})")
-    # delete_customer_records(decision["scope"])   # your execution here
+    # delete_pii_records(decision["scope"])   # your execution here
 except PolicyViolationError as exc:
     for v in exc.violations:
         print(f"BLOCKED [{v.severity.upper()}] {v.rule}: {v.message}")
@@ -428,11 +536,9 @@ from xproof.integrations.autogen import xproof_certify_decision
 from xproof.exceptions import PolicyViolationError
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 
@@ -443,12 +549,12 @@ try:
         threshold_stage="pre-commitment",
         decision_id=decision_id,
         reversibility_class="irreversible",
-        why="Scheduled GDPR data-retention cleanup",
+        why="Scheduled GDPR retention cleanup",
         author="data-hygiene-agent",
         api_key="pm_...",
     )
     print(f"Policy compliant — proceeding (tx: {tx_hash})")
-    # delete_customer_records(decision["scope"])   # your execution here
+    # delete_pii_records(decision["scope"])   # your execution here
 except PolicyViolationError as exc:
     for v in exc.violations:
         print(f"BLOCKED [{v.severity.upper()}] {v.rule}: {v.message}")
@@ -489,13 +595,9 @@ def hash_string(s: str) -> str:
 # chain-of-thought or tool-call output produced just before execution.)
 
 decision = {
-    "action": "delete_customer_records",
-    "scope": "inactive_accounts",
-    "records_affected": 4821,
-    "retention_policy_checked": True,
-    "legal_hold_clear": True,
-    "agent": "data-hygiene-agent",
-    "run_id": "del-run-2026-04-20",
+    "action": "delete_pii_records",
+    "scope": "eu-region",
+    "count": 15_000,
 }
 decision_id = "del-run-2026-04-20"
 reasoning_hash = hash_string(json.dumps(decision, sort_keys=True))
@@ -531,7 +633,7 @@ if not check.policy_compliant:
 
 # ── Step 4: Execute only when compliant ──────────────────────────────────────
 print(f"Policy compliant — proceeding with deletion (cert: {cert.transaction_hash})")
-# delete_customer_records(decision["scope"])   # your actual execution here
+# delete_pii_records(decision["scope"])   # your actual execution here
 ```
 
 **What happens if the agent's confidence is too low?**
@@ -640,6 +742,56 @@ shippers (Fluentd, the Datadog Agent, the CloudWatch agent) forward verbatim.
 Create a log-based metric or alert on `event = "policy_violation"` to get
 dashboard counts and threshold alerts with no extra instrumentation.
 
+> **Runnable example** — `python-sdk/examples/compliance_observability.py` runs the full pattern with a mock client and verifies structured output. No API key needed.
+
+#### Drop-in: CrewAI one-liner
+
+`XProofCrewCertifyTool` wraps `certify_with_confidence` + `get_policy_check` into a single `run()` call. Replace the manual four-step loop with:
+
+```python
+from xproof.integrations.crewai import XProofCrewCertifyTool
+from xproof.exceptions import PolicyViolationError
+
+certify = XProofCrewCertifyTool(api_key="pm_...", author="compliance-agent")
+
+try:
+    result = certify.run(
+        decision_text=json.dumps(decision),
+        confidence_level=0.91,
+        reversibility_class="irreversible",
+        decision_id="trade-xyz-2026",
+    )
+except PolicyViolationError as exc:
+    for v in exc.violations:
+        _emit_violation("trade-xyz-2026", v)   # reuse _emit_violation from above
+    raise RuntimeError("Action aborted: policy compliance check failed.") from exc
+```
+
+#### Drop-in: AutoGen one-liner
+
+`xproof_certify_decision` is a plain callable — register it as a function tool on any `ConversableAgent` or call it directly:
+
+```python
+from xproof.integrations.autogen import xproof_certify_decision
+from xproof.exceptions import PolicyViolationError
+
+try:
+    result = xproof_certify_decision(
+        api_key="pm_...",
+        decision_text=json.dumps(decision),
+        confidence_level=0.91,
+        reversibility_class="irreversible",
+        decision_id="trade-xyz-2026",
+        author="autogen-agent",
+    )
+except PolicyViolationError as exc:
+    for v in exc.violations:
+        _emit_violation("trade-xyz-2026", v)
+    raise RuntimeError("Action aborted: policy compliance check failed.") from exc
+```
+
+Both tools write the violation evidence on-chain before raising — so the structured log and the chain anchor are always in sync.
+
 ### Three classes, one parameter
 
 | `reversibility_class` | What it means | Policy threshold |

{xproof-0.2.7 → xproof-0.2.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xproof"
-version = "0.2.7"
+version = "0.2.8"
 description = "Python SDK for xProof — blockchain-anchored proof-of-existence for AI agents on MultiversX"
 readme = "README.md"
 license = "MIT"
@@ -44,7 +44,7 @@ dev = [
     "pre-commit>=3.0",
 ]
 llamaindex = [
-    "llama-index-core>=0.13.0",
+    "llama-index-core>=0.14.20",
 ]
 autogen = [
     "pyautogen>=0.2.0",
@@ -71,6 +71,7 @@ include = ["xproof*"]
 xproof = ["py.typed"]
 
 [tool.pytest.ini_options]
+asyncio_mode = "auto"
 markers = [
     "integration: marks tests that hit the live xProof API (deselect with '-m \"not integration\"')",
 ]