iris-security-sdk 0.1.9__tar.gz → 0.2.0__tar.gz

{iris_security_sdk-0.1.9 → iris_security_sdk-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iris-security-sdk
-Version: 0.1.9
+Version: 0.2.0
 Summary: IRIS — AI Agent Governance SDK. Govern AI agents locally.
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/gimartinb/iris-sdk
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: iris-security-core>=0.1.7
+Requires-Dist: iris-security-core>=0.1.8
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: click>=8.1

{iris_security_sdk-0.1.9 → iris_security_sdk-0.2.0}/iris/__init__.py

@@ -36,6 +36,9 @@ from iris_core.models.passport import (
     ToolPermission,
     UserContext,
 )
+from iris_core.hitl.models import HITLConfig, HITLConditionRule, HITLStatus
+from iris_core.hitl.error import IrisHITLRequiredError
+from iris.hitl import HITLPoller
 from iris_core.models.policy import PolicyResult, Violation, Severity
 from iris_core.engine.cedar import CedarEngine, EvaluationContext
 from iris_core.engine.compiler import PolicyCompiler, CompilationResult
@@ -44,7 +47,7 @@ from iris_core.evidence.vault import EvidenceVault
 from iris_core.cost.tracker import CostSummary, CostTracker, CostEntry
 from iris_core.cost.pricing import PricingRegistry
 
-__version__ = "0.1.9"
+__version__ = "0.2.0"
 __all__ = [
     # Main classes
     "IrisAgent",
@@ -73,6 +76,11 @@ __all__ = [
     "PricingRegistry",
     "IrisViolationError",
     "IrisCrisisDetectedError",
+    "IrisHITLRequiredError",
+    "HITLConfig",
+    "HITLConditionRule",
+    "HITLStatus",
+    "HITLPoller",
 ]
 
 
@@ -289,8 +297,11 @@ class IrisViolationError(Exception):
     explanation of what was blocked and how to remediate.
     """
 
-    def __init__(self, result: PolicyResult):
+    def __init__(self, result: PolicyResult, is_compliance_block: bool = False):
         self.result = result
+        self.is_compliance_block = is_compliance_block or getattr(
+            result, "is_compliance_block", False
+        )
         primary = result.violations[0] if result.violations else None
         message = (
             f"\n[IRIS POLICY VIOLATION]\n"

iris_security_sdk-0.2.0/iris/hitl.py

@@ -0,0 +1,81 @@
+"""HITL polling helper for application-layer wait loops."""
+
+from __future__ import annotations
+
+import asyncio
+import time
+from typing import Callable, Optional
+
+from iris_core.hitl.models import HITLStatus
+from iris_core.hitl.queue import HITLQueue
+
+
+class HITLPoller:
+    """
+    Helper for applications that need to poll for HITL resolution.
+    Handles the polling loop, timeout, and retry logic.
+    """
+
+    def __init__(self, review_id: str, queue: Optional[HITLQueue] = None):
+        self.review_id = review_id
+        self._queue = queue or HITLQueue()
+
+    def wait(
+        self,
+        timeout: int = 300,
+        poll_interval: int = 5,
+        on_status_change: Optional[Callable[[HITLStatus], None]] = None,
+    ) -> HITLStatus:
+        deadline = time.time() + timeout
+        last_status: Optional[HITLStatus] = None
+        while time.time() < deadline:
+            review = self._queue.get(self.review_id)
+            if review is None:
+                time.sleep(poll_interval)
+                continue
+            if review.status != last_status:
+                if on_status_change:
+                    on_status_change(review.status)
+                last_status = review.status
+            if review.status in (
+                HITLStatus.APPROVED,
+                HITLStatus.REJECTED,
+                HITLStatus.TIMED_OUT,
+                HITLStatus.ESCALATED,
+            ):
+                return review.status
+            if self._queue.is_expired(review):
+                resolved = self._queue.apply_timeout_policy(review)
+                return resolved.status
+            time.sleep(poll_interval)
+        return HITLStatus.TIMED_OUT
+
+    async def wait_async(
+        self,
+        timeout: int = 300,
+        poll_interval: int = 5,
+        on_status_change: Optional[Callable[[HITLStatus], None]] = None,
+    ) -> HITLStatus:
+        deadline = time.time() + timeout
+        last_status: Optional[HITLStatus] = None
+        while time.time() < deadline:
+            review = self._queue.get(self.review_id)
+            if review is None:
+                await asyncio.sleep(poll_interval)
+                continue
+            if review.status != last_status:
+                if on_status_change:
+                    on_status_change(review.status)
+                last_status = review.status
+            if review.status in (
+                HITLStatus.APPROVED,
+                HITLStatus.REJECTED,
+                HITLStatus.TIMED_OUT,
+                HITLStatus.ESCALATED,
+            ):
+                return review.status
+            if self._queue.is_expired(review):
+                resolved = self._queue.apply_timeout_policy(review)
+                return resolved.status
+            await asyncio.sleep(poll_interval)
+        return HITLStatus.TIMED_OUT

{iris_security_sdk-0.1.9 → iris_security_sdk-0.2.0}/iris_security_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iris-security-sdk
-Version: 0.1.9
+Version: 0.2.0
 Summary: IRIS — AI Agent Governance SDK. Govern AI agents locally.
 License: Apache-2.0
 Project-URL: Homepage, https://github.com/gimartinb/iris-sdk
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Requires-Dist: iris-security-core>=0.1.7
+Requires-Dist: iris-security-core>=0.1.8
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: click>=8.1

{iris_security_sdk-0.1.9 → iris_security_sdk-0.2.0}/iris_security_sdk.egg-info/SOURCES.txt

@@ -3,6 +3,7 @@ pyproject.toml
 iris/__init__.py
 iris/_telemetry.py
 iris/_telemetry_config.py
+iris/hitl.py
 iris_security_sdk.egg-info/PKG-INFO
 iris_security_sdk.egg-info/SOURCES.txt
 iris_security_sdk.egg-info/dependency_links.txt

{iris_security_sdk-0.1.9 → iris_security_sdk-0.2.0}/iris_security_sdk.egg-info/requires.txt

@@ -1,4 +1,4 @@
-iris-security-core>=0.1.7
+iris-security-core>=0.1.8
 pyyaml>=6.0
 pydantic>=2.0
 click>=8.1

{iris_security_sdk-0.1.9 → iris_security_sdk-0.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iris-security-sdk"
-version = "0.1.9"
+version = "0.2.0"
 description = "IRIS — AI Agent Governance SDK. Govern AI agents locally."
 readme = "README.md"
 license = { text = "Apache-2.0" }
@@ -28,7 +28,7 @@ classifiers = [
   "Programming Language :: Python :: 3.12",
 ]
 dependencies = [
-  "iris-security-core>=0.1.7",
+  "iris-security-core>=0.1.8",
   "pyyaml>=6.0",
   "pydantic>=2.0",
   "click>=8.1",