safentic 1.0.5__py3-none-any.whl → 1.0.7__py3-none-any.whl

safentic-1.0.5.dist-info/METADATA

@@ -1,60 +0,0 @@
-Metadata-Version: 2.4
-Name: safentic
-Version: 1.0.5
-Summary: Safentic SDK for behavior analysis
-Home-page: https://safentic.com
-Author: Safentic
-Author-email: contact@safentic.com
-License: Proprietary :: Safentic Commercial License
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: Other/Proprietary License
-Classifier: Operating System :: OS Independent
-Description-Content-Type: text/markdown
-Requires-Dist: requests
-Requires-Dist: PyYAML
-Requires-Dist: sentence-transformers==3.2.1
-Requires-Dist: sqlalchemy
-Requires-Dist: python-dotenv
-Dynamic: author
-Dynamic: author-email
-Dynamic: classifier
-Dynamic: description
-Dynamic: description-content-type
-Dynamic: home-page
-Dynamic: license
-Dynamic: requires-dist
-Dynamic: summary
-
-# Safentic SDK
-
-Safentic is a runtime guardrail SDK for agentic AI systems.  
-It intercepts and evaluates unsafe tool calls between agent **intent** and **execution**, enforcing custom safety policies.
-
----
-
-## Installation
-
-Install from PyPI:
-
-    pip install safentic
-
----
-
-## API Key Required
-
-Safentic requires a valid API key to function.  
-To obtain one, contact: contact@safentic.com
-
----
-
-## Quick Start
-
-```python
-from safentic import SafetyLayer, SafenticError
-
-layer = SafetyLayer(api_key="your-api-key", agent_id="agent-007")
-
-try:
-    layer.protect("send_email", {"body": "Refund me now!"})
-except SafenticError as e:
-    print("Blocked by policy:", e)

safentic-1.0.5.dist-info/RECORD

@@ -1,22 +0,0 @@
-safentic/LICENSE.txt,sha256=xl3AZ2rkiOG5qE01SPRBgoW5Ib5YKZQeszh6OlvKePk,2330
-safentic/__init__.py,sha256=RFKBKMmJGUZy436bF_wI0AAgiyWYJqeF3MIlhUi7_VU,124
-safentic/config.py,sha256=V6c8Fz0t-Ja278kjCrQMlGPBQ4Hj830t3q7U7oM4Q4k,90
-safentic/engine.py,sha256=Ho9-sHXnJuRUh0fsONLip8Dsf927EJK_8RwXDk4Mk-Q,3564
-safentic/layer.py,sha256=3sGVn7gGWoiStEKO3jTV4_2QxKUWEH1BiThR421GISo,2481
-safentic/policy.py,sha256=VKIxLfcJtwA3U7DVwefLWprKQCFbfya-RJZvU1n4sEc,4138
-safentic/helper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-safentic/helper/auth.py,sha256=evhikKRTtGXYp0YKkdntBM4bUjdUTtvJ2nA5YLt2IIA,391
-safentic/logger/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-safentic/logger/audit.py,sha256=GAqZFVPERKyuugmGn6G1-fg9QLaHqN1aWl0S_J3dYXI,2947
-safentic/policies/.gitkeep,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-safentic/policies/__init__.py,sha256=s37JO8wBcNstqvPif1q2Dw46imddeZZJBo-f3mSfd58,69
-safentic/policies/example_policy.txt,sha256=Vkv5p2Kcyppijl8BD--P1APy2cBgWrYCrKzfo2pW0lo,1955
-safentic/policies/policy.yaml,sha256=EoDjvloG56WGNjqNV18xytcCr2v4I0KG6uSx6_yTVAg,1241
-safentic/verifiers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-safentic/verifiers/sentence_verifier.py,sha256=jgObZ1t4UCYHYIfNayI0n69hVBWOHc9GAhpJsDbiD2c,2376
-tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/test_all.py,sha256=makysLQtgKAFOfIutnvmBQcMLkMY3inkT6ig5h_I2e4,5878
-safentic-1.0.5.dist-info/METADATA,sha256=5S7U-KmaCPDVPcv_HsR7K6Px0inqySRxRr_fbqdxJv4,1477
-safentic-1.0.5.dist-info/WHEEL,sha256=0CuiUZ_p9E4cD6NyLD6UG80LBXYyiSYZOKDm5lp32xk,91
-safentic-1.0.5.dist-info/top_level.txt,sha256=8bLyq7i9we7XEcbDYLHTUfR3IIpICeMfG8NWAHCLU5s,15
-safentic-1.0.5.dist-info/RECORD,,

safentic-1.0.5.dist-info/top_level.txt

@@ -1,2 +0,0 @@
-safentic
-tests

tests/test_all.py

@@ -1,132 +0,0 @@
-import os
-import math
-import pytest
-from unittest import mock
-
-from safentic.policy import PolicyEngine
-from safentic.engine import PolicyEnforcer
-from safentic.layer import SafetyLayer, SafenticError
-from safentic.verifiers.sentence_verifier import SentenceTransformerVerifier
-from safentic.logger.audit import AuditLogger
-
-os.environ["SAFE_AUDIT_LOG"] = "0"
-
-TESTS = {
-    "valid_excerpt": "Here is our refund policy: any cancellation within 30 days of purchase receives a full refund.",
-    "hallucination_one_device": "According to our refund policy, every user may only refund one device per subscription.",
-    "made_up_timeframe": "Refund policy: you must request a refund within 24 hours of purchase.",
-    "generic_refund": "I’m sorry for the trouble—please let us know more about your refund issue.",
-}
-
-class MockAgent:
-    def call_tool(self, tool_name, **kwargs):
-        return {"status": "mock-success"}
-
-@pytest.fixture
-def policy_engine():
-    return PolicyEngine()
-
-@pytest.fixture
-def enforcer():
-    return PolicyEnforcer()
-
-@pytest.mark.parametrize("case, expected_contains", [
-    ("valid_excerpt", "refund"),
-    ("generic_refund", "sorry"),
-    ("hallucination_one_device", "one device per subscription"),
-    ("made_up_timeframe", "24 hours"),
-])
-def test_policy_engine_evaluate(policy_engine, case, expected_contains):
-    violation = policy_engine.evaluate_policy("send_email", {"body": TESTS[case]})
-    assert violation and expected_contains in violation["reason"].lower()
-
-def test_policy_engine_skips_empty(policy_engine):
-    assert policy_engine.evaluate_policy("send_email", {"body": ""}) is None
-
-def test_policy_engine_unknown_rule_type(policy_engine):
-    policy_engine.policy_cfg = {
-        "tools": {"send_email": {"checks": [{"type": "unknown_type"}]}}
-    }
-    assert policy_engine.evaluate_policy("send_email", {"body": "test"}) is None
-
-def test_policy_engine_malformed_semantic(policy_engine):
-    policy_engine.policy_cfg = {
-        "tools": {"send_email": {"checks": [{"type": "semantic", "trigger_phrases": ["refund"]}]}},
-    }
-    assert policy_engine.evaluate_policy("send_email", {"body": "refund policy applies"}) is None
-
-def test_enforcer_blocks_expected_cases(enforcer):
-    agent_id = "agent-block"
-    for case in ["valid_excerpt", "generic_refund"]:
-        result = enforcer.enforce(agent_id, "send_email", {"body": TESTS[case]})
-        assert not result["allowed"]
-        assert "reason" in result
-
-def test_enforcer_blocks_and_resets(enforcer):
-    agent_id = "agent-reset"
-    res = enforcer.enforce(agent_id, "send_email", {"body": TESTS["hallucination_one_device"]})
-    assert not res["allowed"]
-    repeat = enforcer.enforce(agent_id, "send_email", {"body": TESTS["hallucination_one_device"]})
-    assert "temporarily blocked" in repeat["reason"].lower()
-    enforcer.reset(agent_id)
-    assert agent_id not in enforcer.agent_states
-
-def test_safety_layer_blocks_and_raises():
-    layer = SafetyLayer(agent=MockAgent(), api_key="demo-1234", agent_id="safety-1", raise_on_block=True)
-    with pytest.raises(SafenticError):
-        layer.call_tool("send_email", {"body": TESTS["made_up_timeframe"]})
-
-def test_safety_layer_returns_result():
-    safe_input = {"body": "This is a neutral and policy-safe email message."}
-    layer = SafetyLayer(agent=MockAgent(), api_key="demo-1234", agent_id="safety-2", raise_on_block=False)
-    assert layer.call_tool("send_email", safe_input)["status"] == "mock-success"
-
-@mock.patch("safentic.verifiers.sentence_verifier.SentenceTransformer")
-def test_similarity_score_consistency(mock_model_class):
-    mock_model = mock_model_class.return_value
-    mock_model.encode.return_value = [[1.0], [1.0]]
-    verifier = SentenceTransformerVerifier()
-    score = verifier.similarity("a", "a")
-    assert math.isclose(score, 1.0, abs_tol=1e-4)
-
-@mock.patch("safentic.verifiers.sentence_verifier.SentenceTransformer")
-@pytest.mark.parametrize("a,b,score,expected", [
-    ("a", "a", 0.95, "allow"),
-    ("a", "b", 0.5, "verify"),
-    ("x", "y", 0.1, "block"),
-])
-def test_verifier_threshold_behavior(mock_model_class, a, b, score, expected):
-    mock_model = mock_model_class.return_value
-    with mock.patch("safentic.verifiers.sentence_verifier.util.cos_sim") as mock_cos_sim:
-        mock_cos_sim.return_value = mock.Mock()
-        mock_cos_sim.return_value.item.return_value = score
-
-        verifier = SentenceTransformerVerifier(low_threshold=0.2, high_threshold=0.9)
-        result = verifier.decision(a, b)
-        assert result == expected
-
-@mock.patch("safentic.verifiers.sentence_verifier.SentenceTransformer")
-def test_verifier_explains_score(mock_model_class):
-    mock_model = mock_model_class.return_value
-    mock_model.encode.return_value = [[1.0], [1.0]]
-    verifier = SentenceTransformerVerifier()
-    assert "Semantic similarity" in verifier.explain("a", "a")
-
-@mock.patch("safentic.logger.audit.open", new_callable=mock.mock_open)
-def test_logger_set_level_and_log(mock_open_file):
-    os.environ["SAFE_AUDIT_LOG"] = "1"
-    logger = AuditLogger(config={"txt": "dummy.txt", "json": "dummy.jsonl"})
-    logger.set_level("DEBUG")
-    logger.log(agent_id="mock-agent", tool="send_email", allowed=True)
-    logger.log(agent_id="mock-agent", tool="send_email", allowed=False, reason="test")
-    handle = mock_open_file()
-    handle.write.assert_called()
-
-def test_logger_invalid_level():
-    with pytest.raises(ValueError):
-        AuditLogger().set_level("FAKE")
-
-@mock.patch("safentic.logger.audit.open", side_effect=OSError("mocked failure"))
-def test_logger_gracefully_fails_json_write(mock_open):
-    logger = AuditLogger(config={"txt": "ok.txt", "json": "fail.jsonl"})
-    logger.log("agent", "tool", False, reason="test")