safentic 1.0.4__py3-none-any.whl → 1.0.6__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- safentic/__init__.py +5 -8
- safentic/_internal/errors.py +26 -0
- safentic/adapters/mcp_adapter.py +46 -0
- safentic/cli/__init__.py +3 -0
- safentic/cli/commands/check_tool.py +47 -0
- safentic/cli/commands/logs.py +66 -0
- safentic/cli/commands/validate_policy.py +59 -0
- safentic/cli/main.py +153 -0
- safentic/cli/utils.py +169 -0
- safentic/config.py +2 -2
- safentic/decorators.py +49 -0
- safentic/helper/helper.py +212 -0
- safentic/layer.py +96 -56
- safentic/logger/audit.py +181 -83
- safentic/policy_enforcer.py +116 -0
- safentic/policy_engine.py +141 -0
- safentic/verifiers/llm_verifier.py +238 -0
- safentic-1.0.6.dist-info/METADATA +193 -0
- safentic-1.0.6.dist-info/RECORD +29 -0
- {safentic-1.0.4.dist-info → safentic-1.0.6.dist-info}/WHEEL +1 -1
- safentic-1.0.6.dist-info/entry_points.txt +2 -0
- {safentic → safentic-1.0.6.dist-info/licenses}/LICENSE.txt +36 -36
- safentic-1.0.6.dist-info/top_level.txt +2 -0
- safentic_poc/backend/api/main.py +164 -0
- safentic/engine.py +0 -80
- safentic/helper/auth.py +0 -12
- safentic/policies/__init__.py +0 -3
- safentic/policies/example_policy.txt +0 -33
- safentic/policies/policy.yaml +0 -49
- safentic/policy.py +0 -106
- safentic/verifiers/sentence_verifier.py +0 -69
- safentic-1.0.4.dist-info/METADATA +0 -60
- safentic-1.0.4.dist-info/RECORD +0 -22
- safentic-1.0.4.dist-info/top_level.txt +0 -2
- tests/test_all.py +0 -127
- {tests → safentic_poc/backend}/__init__.py +0 -0
- /safentic/policies/.gitkeep → /safentic_poc/backend/api/__init__.py +0 -0
@@ -0,0 +1,29 @@
|
|
1
|
+
safentic/__init__.py,sha256=_S_ZZOxnil8pAhm_6HwT0x1yZ4zzIJjeMzmDEknEHF8,141
|
2
|
+
safentic/config.py,sha256=222VKyCkRYQ_WgoKTcXsIgHQJIgHGyCb0jmD305pOKM,88
|
3
|
+
safentic/decorators.py,sha256=Tg-kmMJLCT_2sx9FMArIm7otvi1unNYfcX1zMkXwO14,1547
|
4
|
+
safentic/layer.py,sha256=6VfY9OQYynRL0pYAS1heUNZz0zdwQ8Ot3p9mFMRvBjg,3120
|
5
|
+
safentic/policy_enforcer.py,sha256=9lc4R5zu7VOKBEGp3paG5-iwHxU-_43UVuyFR0k1J1Y,4075
|
6
|
+
safentic/policy_engine.py,sha256=t7eUdYuRtJKyibrjzSkNsBuswlLeMgjnIzT7CmNhZ2I,5326
|
7
|
+
safentic/_internal/errors.py,sha256=NdP79QIqgqaiMD_iIlNNoYRHYXLTwwfEvWnKZ3qGDN4,717
|
8
|
+
safentic/adapters/mcp_adapter.py,sha256=C4gUzUg9wv6ToNhCho2kNBlyPDHnlQhoQIASUfRc1Ks,1389
|
9
|
+
safentic/cli/__init__.py,sha256=TxVn7Qjs3VBg36A_3dasco_AQPZtK4HebdViKMirE8U,49
|
10
|
+
safentic/cli/main.py,sha256=G595Yv15Q22akVXUSCNNoAi7OwrslZ-26Wouq1lBJTQ,5041
|
11
|
+
safentic/cli/utils.py,sha256=mmCaWwIcG5_IPxmaK9kuwWrSpYoHsJ4iofhyREhOfgQ,5686
|
12
|
+
safentic/cli/commands/check_tool.py,sha256=yh8p_jPVPwifaiH0X6kBFJO7jxO_vB8333lctrAqLts,1446
|
13
|
+
safentic/cli/commands/logs.py,sha256=t-dqCJ_wQz8XgF2sdamHxM2JEknCKQyYa3FkJE8xvlI,2015
|
14
|
+
safentic/cli/commands/validate_policy.py,sha256=7khzBJkOMBOqRDHCSGfqrR_udo_RmZRdSlPih5oEtgg,2062
|
15
|
+
safentic/helper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
16
|
+
safentic/helper/helper.py,sha256=eLJE2GNc7-GSxotFClCUHugdTSgu0zS7EEXITWlVZd0,7030
|
17
|
+
safentic/logger/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
18
|
+
safentic/logger/audit.py,sha256=KeV1UyIlxfThZUxN2dEYms62oCncxdeeomJRYeAJo1Y,6295
|
19
|
+
safentic/verifiers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
20
|
+
safentic/verifiers/llm_verifier.py,sha256=y6C9UexB2jIqHeCD8uLlDYFMYdmbEU7C4BQdgB8WD0s,7887
|
21
|
+
safentic-1.0.6.dist-info/licenses/LICENSE.txt,sha256=Gs_ZO2z7NQDNRexLzkWeWuqynX6MQ3-SbtT48VnvxqE,2294
|
22
|
+
safentic_poc/backend/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
23
|
+
safentic_poc/backend/api/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
|
24
|
+
safentic_poc/backend/api/main.py,sha256=bSGR-A1I8uY52lDpZMuGwGIP2BRyspIo0MrpWofjo-I,5289
|
25
|
+
safentic-1.0.6.dist-info/METADATA,sha256=OE7j17bbaqzVJkRjLjxcWTWL1zQ80PCLIfZgKbvEgjo,5723
|
26
|
+
safentic-1.0.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
27
|
+
safentic-1.0.6.dist-info/entry_points.txt,sha256=yqTSD1j6ayKd6YH5olWoOuvbCjUWyClOKmHEtuWYARk,52
|
28
|
+
safentic-1.0.6.dist-info/top_level.txt,sha256=Ft3UUfii2QowOYyn_wSVd28KH9U9hEg7WyqR8p2lY0s,22
|
29
|
+
safentic-1.0.6.dist-info/RECORD,,
|
@@ -1,36 +1,36 @@
|
|
1
|
-
Safentic SDK Commercial License Agreement
|
2
|
-
=========================================
|
3
|
-
|
4
|
-
IMPORTANT – READ CAREFULLY:
|
5
|
-
|
6
|
-
This license governs the use of the Safentic SDK (“Software”) developed and owned by Safentic. By installing or using this Software, you (“Licensee”) agree to the following terms and conditions:
|
7
|
-
|
8
|
-
1. GRANT OF LICENSE
|
9
|
-
Licensor grants Licensee a non-exclusive, non-transferable, non-sublicensable license to use the Software solely for internal business purposes and only in accordance with the terms of the commercial agreement executed between the parties. This license may include limited evaluation rights, subject to expiration or usage restrictions.
|
10
|
-
|
11
|
-
2. RESTRICTIONS
|
12
|
-
Licensee shall NOT:
|
13
|
-
- Use the Software without a valid, active license key or subscription.
|
14
|
-
- Reverse engineer, decompile, or disassemble the Software.
|
15
|
-
- Modify, copy, or create derivative works based on the Software.
|
16
|
-
- Distribute, sublicense, lease, or otherwise make the Software available to any third party.
|
17
|
-
- Circumvent or attempt to disable any license verification, telemetry, or access control mechanisms.
|
18
|
-
|
19
|
-
3. OWNERSHIP
|
20
|
-
The Software is licensed, not sold. Safentic retains all rights, title, and interest in and to the Software, including all intellectual property rights.
|
21
|
-
|
22
|
-
4. TERMINATION
|
23
|
-
This license is effective until terminated. It will terminate automatically without notice if Licensee breaches any term of this agreement. Upon termination, Licensee must cease all use and destroy all copies of the Software.
|
24
|
-
|
25
|
-
5. NO WARRANTY
|
26
|
-
The Software is provided "as is" without warranty of any kind. Licensor disclaims all warranties, express or implied, including but not limited to warranties of merchantability and fitness for a particular purpose.
|
27
|
-
|
28
|
-
6. LIMITATION OF LIABILITY
|
29
|
-
In no event shall Licensor be liable for any damages arising out of the use or inability to use the Software, including but not limited to incidental, special, or consequential damages.
|
30
|
-
|
31
|
-
7. GOVERNING LAW
|
32
|
-
This agreement shall be governed by and construed in accordance with the laws of Ireland, without regard to its conflict of law principles.
|
33
|
-
|
34
|
-
For licensing inquiries, please contact: contact@safentic.com
|
35
|
-
|
36
|
-
Copyright © 2025, Safentic. All rights reserved.
|
1
|
+
Safentic SDK Commercial License Agreement
|
2
|
+
=========================================
|
3
|
+
|
4
|
+
IMPORTANT – READ CAREFULLY:
|
5
|
+
|
6
|
+
This license governs the use of the Safentic SDK (“Software”) developed and owned by Safentic. By installing or using this Software, you (“Licensee”) agree to the following terms and conditions:
|
7
|
+
|
8
|
+
1. GRANT OF LICENSE
|
9
|
+
Licensor grants Licensee a non-exclusive, non-transferable, non-sublicensable license to use the Software solely for internal business purposes and only in accordance with the terms of the commercial agreement executed between the parties. This license may include limited evaluation rights, subject to expiration or usage restrictions.
|
10
|
+
|
11
|
+
2. RESTRICTIONS
|
12
|
+
Licensee shall NOT:
|
13
|
+
- Use the Software without a valid, active license key or subscription.
|
14
|
+
- Reverse engineer, decompile, or disassemble the Software.
|
15
|
+
- Modify, copy, or create derivative works based on the Software.
|
16
|
+
- Distribute, sublicense, lease, or otherwise make the Software available to any third party.
|
17
|
+
- Circumvent or attempt to disable any license verification, telemetry, or access control mechanisms.
|
18
|
+
|
19
|
+
3. OWNERSHIP
|
20
|
+
The Software is licensed, not sold. Safentic retains all rights, title, and interest in and to the Software, including all intellectual property rights.
|
21
|
+
|
22
|
+
4. TERMINATION
|
23
|
+
This license is effective until terminated. It will terminate automatically without notice if Licensee breaches any term of this agreement. Upon termination, Licensee must cease all use and destroy all copies of the Software.
|
24
|
+
|
25
|
+
5. NO WARRANTY
|
26
|
+
The Software is provided "as is" without warranty of any kind. Licensor disclaims all warranties, express or implied, including but not limited to warranties of merchantability and fitness for a particular purpose.
|
27
|
+
|
28
|
+
6. LIMITATION OF LIABILITY
|
29
|
+
In no event shall Licensor be liable for any damages arising out of the use or inability to use the Software, including but not limited to incidental, special, or consequential damages.
|
30
|
+
|
31
|
+
7. GOVERNING LAW
|
32
|
+
This agreement shall be governed by and construed in accordance with the laws of Ireland, without regard to its conflict of law principles.
|
33
|
+
|
34
|
+
For licensing inquiries, please contact: contact@safentic.com
|
35
|
+
|
36
|
+
Copyright © 2025, Safentic. All rights reserved.
|
@@ -0,0 +1,164 @@
|
|
1
|
+
from fastapi import FastAPI, HTTPException
|
2
|
+
from fastapi.middleware.cors import CORSMiddleware
|
3
|
+
from pydantic import BaseModel, Field
|
4
|
+
from typing import Any, Optional, List
|
5
|
+
import os, json
|
6
|
+
from time import perf_counter
|
7
|
+
from pathlib import Path
|
8
|
+
from dotenv import load_dotenv # make sure python-dotenv is installed
|
9
|
+
|
10
|
+
# Internal SDK imports (OK for first-party POC)
|
11
|
+
from safentic.policy_engine import PolicyEngine
|
12
|
+
from safentic.policy_enforcer import PolicyEnforcer
|
13
|
+
from safentic.logger.audit import AuditLogger
|
14
|
+
from safentic._internal.errors import SafenticError
|
15
|
+
|
16
|
+
# -------- Load .env --------
|
17
|
+
# backend/api/main.py → go up 2 levels to reach safentic_poc/backend/.env
|
18
|
+
BACKEND_ROOT = Path(__file__).resolve().parents[1]
|
19
|
+
REPO_ROOT = Path(__file__).resolve().parents[3]
|
20
|
+
load_dotenv(BACKEND_ROOT / ".env")
|
21
|
+
|
22
|
+
def resolve_path(env_var: str, default_rel: str) -> str:
|
23
|
+
"""
|
24
|
+
Resolve a path from an env var or fall back to a repo-relative default.
|
25
|
+
If env var is absolute, return as-is.
|
26
|
+
"""
|
27
|
+
val = os.getenv(env_var)
|
28
|
+
if val:
|
29
|
+
return str((REPO_ROOT / val).resolve()) if not os.path.isabs(val) else val
|
30
|
+
return str((REPO_ROOT / default_rel).resolve())
|
31
|
+
|
32
|
+
# -------- Config --------
|
33
|
+
FE_ORIGIN = os.getenv("FE_ORIGIN", "http://localhost:3000")
|
34
|
+
POLICY_PATH = resolve_path("SAFENTIC_POLICY_PATH", "config/policy.yaml")
|
35
|
+
|
36
|
+
# Default: use JSON logs under safentic_poc/safentic/logs/json_logs
|
37
|
+
AUDIT_LOG_PATH = resolve_path(
|
38
|
+
"SAFENTIC_AUDIT_LOG",
|
39
|
+
"safentic_poc/backend/safentic/logs/json_logs/safentic_audit.jsonl",
|
40
|
+
)
|
41
|
+
|
42
|
+
print("ENV says:", os.getenv("SAFENTIC_AUDIT_LOG"))
|
43
|
+
print("Resolved AUDIT_LOG_PATH:", AUDIT_LOG_PATH)
|
44
|
+
|
45
|
+
# -------- App & CORS --------
|
46
|
+
app = FastAPI(title="Safentic POC API")
|
47
|
+
app.add_middleware(
|
48
|
+
CORSMiddleware,
|
49
|
+
allow_origins=[FE_ORIGIN],
|
50
|
+
allow_credentials=False,
|
51
|
+
allow_methods=["*"],
|
52
|
+
allow_headers=["*"],
|
53
|
+
)
|
54
|
+
|
55
|
+
# -------- Instantiate engine/enforcer/logger --------
|
56
|
+
engine = PolicyEngine(policy_path=POLICY_PATH)
|
57
|
+
enforcer = PolicyEnforcer(policy_engine=engine)
|
58
|
+
logger = AuditLogger()
|
59
|
+
|
60
|
+
# -------- Schemas --------
|
61
|
+
class Options(BaseModel):
|
62
|
+
dry_run: bool = False
|
63
|
+
no_llm: bool = False
|
64
|
+
|
65
|
+
class EnforceRequest(BaseModel):
|
66
|
+
tool_name: str
|
67
|
+
agent_id: str = Field(default="fe-demo")
|
68
|
+
input: dict[str, Any] = Field(default_factory=dict)
|
69
|
+
options: Options = Options()
|
70
|
+
|
71
|
+
class EnforceResponse(BaseModel):
|
72
|
+
allowed: bool
|
73
|
+
reason: str
|
74
|
+
violation: Optional[dict] = None
|
75
|
+
agent_state: Optional[dict] = None
|
76
|
+
rule_id: Optional[str] = None
|
77
|
+
took_ms: int
|
78
|
+
|
79
|
+
class LogEntry(BaseModel):
|
80
|
+
ts: str
|
81
|
+
agent_id: str
|
82
|
+
tool: str
|
83
|
+
allowed: bool
|
84
|
+
reason: Optional[str] = None
|
85
|
+
rule_id: Optional[str] = None
|
86
|
+
|
87
|
+
class LogTailResponse(BaseModel):
|
88
|
+
items: List[LogEntry]
|
89
|
+
|
90
|
+
# -------- Routes --------
|
91
|
+
@app.get("/api/health")
|
92
|
+
def health():
|
93
|
+
return {"status": "ok"}
|
94
|
+
|
95
|
+
@app.post("/api/enforce", response_model=EnforceResponse)
|
96
|
+
def enforce(req: EnforceRequest):
|
97
|
+
if hasattr(enforcer, "reset"):
|
98
|
+
try:
|
99
|
+
enforcer.reset(req.agent_id)
|
100
|
+
except Exception:
|
101
|
+
pass
|
102
|
+
|
103
|
+
t0 = perf_counter()
|
104
|
+
try:
|
105
|
+
result = enforcer.enforce(req.agent_id, req.tool_name, req.input)
|
106
|
+
except SafenticError as e:
|
107
|
+
raise HTTPException(status_code=400, detail=str(e))
|
108
|
+
except ValueError as e:
|
109
|
+
raise HTTPException(status_code=400, detail=str(e))
|
110
|
+
|
111
|
+
took_ms = int((perf_counter() - t0) * 1000)
|
112
|
+
|
113
|
+
try:
|
114
|
+
logger.log(
|
115
|
+
agent_id=req.agent_id,
|
116
|
+
tool=req.tool_name,
|
117
|
+
allowed=bool(result.get("allowed", False)),
|
118
|
+
reason=result.get("reason"),
|
119
|
+
rule_id=result.get("rule_id"),
|
120
|
+
)
|
121
|
+
except Exception:
|
122
|
+
pass
|
123
|
+
|
124
|
+
return {
|
125
|
+
"allowed": bool(result.get("allowed")),
|
126
|
+
"reason": result.get("reason", ""),
|
127
|
+
"violation": result.get("violation"),
|
128
|
+
"agent_state": result.get("agent_state"),
|
129
|
+
"rule_id": result.get("rule_id"),
|
130
|
+
"took_ms": took_ms,
|
131
|
+
}
|
132
|
+
|
133
|
+
@app.get("/api/logs/tail", response_model=LogTailResponse)
|
134
|
+
def logs_tail(limit: int = 100):
|
135
|
+
items: List[LogEntry] = []
|
136
|
+
try:
|
137
|
+
print(f"Audit log path: {AUDIT_LOG_PATH}")
|
138
|
+
if os.path.exists(AUDIT_LOG_PATH):
|
139
|
+
with open(AUDIT_LOG_PATH, "r") as f:
|
140
|
+
lines = f.readlines()[-limit:]
|
141
|
+
print(f"Read {len(lines)} lines from {AUDIT_LOG_PATH}")
|
142
|
+
for ln in lines:
|
143
|
+
ln = ln.strip()
|
144
|
+
if not ln:
|
145
|
+
continue
|
146
|
+
try:
|
147
|
+
j = json.loads(ln)
|
148
|
+
items.append(LogEntry(
|
149
|
+
ts=j.get("timestamp") or j.get("ts") or "",
|
150
|
+
agent_id=j.get("agent_id") or "",
|
151
|
+
tool=j.get("tool") or "",
|
152
|
+
allowed=bool(j.get("allowed", False)),
|
153
|
+
reason=j.get("reason"),
|
154
|
+
rule_id=j.get("rule_id") or j.get("extra", {}).get("rule"),
|
155
|
+
))
|
156
|
+
except Exception:
|
157
|
+
print(f"Failed to parse log line: {ln}")
|
158
|
+
continue
|
159
|
+
else:
|
160
|
+
print(f"Audit log file does not exist: {AUDIT_LOG_PATH}")
|
161
|
+
except Exception as e:
|
162
|
+
print(f"Failed to read audit log: {e}")
|
163
|
+
items = []
|
164
|
+
return {"items": items}
|
safentic/engine.py
DELETED
@@ -1,80 +0,0 @@
|
|
1
|
-
from .policy import PolicyEngine
|
2
|
-
from .logger.audit import AuditLogger
|
3
|
-
|
4
|
-
class PolicyEnforcer():
|
5
|
-
"""
|
6
|
-
Runtime wrapper to evaluate and enforce tool usage policies.
|
7
|
-
Tracks agent-specific violations and supports audit logging.
|
8
|
-
"""
|
9
|
-
|
10
|
-
def __init__(self, policy_engine: PolicyEngine = None):
|
11
|
-
self.policy_engine = policy_engine or PolicyEngine()
|
12
|
-
self.agent_states = {}
|
13
|
-
self.audit_logger = AuditLogger()
|
14
|
-
|
15
|
-
def enforce(self, agent_id: str, tool_name: str, tool_args: dict) -> dict:
|
16
|
-
"""
|
17
|
-
Evaluates a tool action for a given agent.
|
18
|
-
Returns a dict with 'allowed', 'reason', and agent state metadata.
|
19
|
-
"""
|
20
|
-
state = self.agent_states.setdefault(agent_id, {
|
21
|
-
"blocked_tools": set(),
|
22
|
-
"violation_count": 0,
|
23
|
-
"last_violation": None
|
24
|
-
})
|
25
|
-
|
26
|
-
# Block repeat attempts to use already-denied tool
|
27
|
-
if tool_name in state["blocked_tools"]:
|
28
|
-
reason = "Tool previously blocked for this agent."
|
29
|
-
self.audit_logger.log(
|
30
|
-
agent_id=agent_id,
|
31
|
-
tool=tool_name,
|
32
|
-
allowed=False,
|
33
|
-
reason=reason
|
34
|
-
)
|
35
|
-
return self._deny(tool_name, state, reason)
|
36
|
-
|
37
|
-
# Run policy evaluation
|
38
|
-
violation = self.policy_engine.evaluate_policy(tool_name, tool_args)
|
39
|
-
|
40
|
-
if violation:
|
41
|
-
state["blocked_tools"].add(tool_name)
|
42
|
-
state["violation_count"] += 1
|
43
|
-
state["last_violation"] = violation
|
44
|
-
self.audit_logger.log(
|
45
|
-
agent_id=agent_id,
|
46
|
-
tool=tool_name,
|
47
|
-
allowed=False,
|
48
|
-
reason=violation
|
49
|
-
)
|
50
|
-
return self._deny(tool_name, state, violation)
|
51
|
-
|
52
|
-
# Log allowed action
|
53
|
-
self.audit_logger.log(
|
54
|
-
agent_id=agent_id,
|
55
|
-
tool=tool_name,
|
56
|
-
allowed=True
|
57
|
-
)
|
58
|
-
|
59
|
-
return {
|
60
|
-
"allowed": True,
|
61
|
-
"reason": "Action permitted",
|
62
|
-
"agent_state": state
|
63
|
-
}
|
64
|
-
|
65
|
-
def reset(self, agent_id: str = None):
|
66
|
-
"""
|
67
|
-
Clears violation state for one agent or all agents.
|
68
|
-
"""
|
69
|
-
if agent_id:
|
70
|
-
self.agent_states.pop(agent_id, None)
|
71
|
-
else:
|
72
|
-
self.agent_states.clear()
|
73
|
-
|
74
|
-
def _deny(self, tool_name: str, state: dict, reason: str) -> dict:
|
75
|
-
return {
|
76
|
-
"allowed": False,
|
77
|
-
"reason": reason,
|
78
|
-
"tool": tool_name,
|
79
|
-
"agent_state": state
|
80
|
-
}
|
safentic/helper/auth.py
DELETED
@@ -1,12 +0,0 @@
|
|
1
|
-
import requests
|
2
|
-
from ..config import *
|
3
|
-
|
4
|
-
def validate_api_key(key: str) -> dict:
|
5
|
-
try:
|
6
|
-
response = requests.post(BASE_API_PATH + API_KEY_ENDPOINT, json={"api_key": key})
|
7
|
-
if response.status_code != 200:
|
8
|
-
return {"valid": False}
|
9
|
-
data = response.json()
|
10
|
-
return {"valid": True, **data}
|
11
|
-
except Exception:
|
12
|
-
return {"valid": False}
|
safentic/policies/__init__.py
DELETED
@@ -1,33 +0,0 @@
|
|
1
|
-
Standard Refund Policy
|
2
|
-
|
3
|
-
Last Updated: February 1, 2025
|
4
|
-
|
5
|
-
1. Overview
|
6
|
-
At XYZ, we strive to ensure your complete satisfaction with our platform. If you are not entirely happy with your purchase, you may be eligible for a refund as described below.
|
7
|
-
|
8
|
-
2. Eligibility
|
9
|
-
- Monthly Subscriptions: You may request a full refund within 30 days of your initial subscription charge.
|
10
|
-
- Annual Subscriptions: You may request a pro-rated refund (the remaining unused portion of your term) within 30 days of your initial annual subscription charge.
|
11
|
-
- One-Time Purchases and Credits: Refunds on one-time feature purchases or in-app credits are handled on a case-by-case basis and must be requested within 14 days of purchase.
|
12
|
-
|
13
|
-
3. How to Request a Refund
|
14
|
-
1. Log in to your XYZ account at https://app.XYZ.ai.
|
15
|
-
2. Go to Settings -> Billing -> Refunds.
|
16
|
-
3. Select the transaction you wish to refund and click Request Refund.
|
17
|
-
4. In the "Reason" field, briefly describe why you are requesting a refund.
|
18
|
-
5. Submit your request. You will receive an email confirmation within one business day.
|
19
|
-
|
20
|
-
4. Processing Time
|
21
|
-
- Refunds for credit-card or PayPal payments will be credited back to your original payment method within 5-7 business days after approval.
|
22
|
-
- In-app credits or wallet balances will be restored within 24 hours of approval.
|
23
|
-
|
24
|
-
5. Exceptions and Limitations
|
25
|
-
- No refunds will be issued for subscription renewals after the initial 30-day period.
|
26
|
-
- Promotional, gift, or trial subscriptions are non-refundable.
|
27
|
-
- Refund requests made more than 30 days after the initial charge are subject to review and may be denied.
|
28
|
-
- We reserve the right to refuse a refund if we suspect abuse of the refund policy.
|
29
|
-
|
30
|
-
6. Contact Us
|
31
|
-
If you have any questions or need assistance, please contact our Support Team at support@XYZ.ai or via the in-app chat.
|
32
|
-
|
33
|
-
Thank you for choosing XYZ! We appreciate your business and are committed to delivering a great experience.
|
safentic/policies/policy.yaml
DELETED
@@ -1,49 +0,0 @@
|
|
1
|
-
tools:
|
2
|
-
send_email:
|
3
|
-
checks:
|
4
|
-
- type: deny_phrase
|
5
|
-
phrases:
|
6
|
-
- "one device per subscription"
|
7
|
-
- "24 hours"
|
8
|
-
- "apology"
|
9
|
-
- "apologize"
|
10
|
-
- "sorry"
|
11
|
-
- "refund"
|
12
|
-
- "refund delay"
|
13
|
-
- type: semantic
|
14
|
-
trigger_phrases:
|
15
|
-
- "refund policy"
|
16
|
-
- "guarantee"
|
17
|
-
- "our policy"
|
18
|
-
reference_file: "example_policy.txt"
|
19
|
-
|
20
|
-
issue_refund:
|
21
|
-
checks:
|
22
|
-
- type: deny_phrase
|
23
|
-
phrases:
|
24
|
-
- "refund"
|
25
|
-
- "refunding"
|
26
|
-
- "issue refund"
|
27
|
-
- "send refund"
|
28
|
-
- "credit customer"
|
29
|
-
- "reverse charge"
|
30
|
-
- "double charge"
|
31
|
-
- "processed refund"
|
32
|
-
- "grant compensation"
|
33
|
-
- "money back"
|
34
|
-
- type: semantic
|
35
|
-
trigger_phrases:
|
36
|
-
- "we've sent your refund"
|
37
|
-
- "your money is on the way"
|
38
|
-
reference_file: "refund_statement.txt"
|
39
|
-
|
40
|
-
update_ticket:
|
41
|
-
checks: [] # Explicitly allow all
|
42
|
-
|
43
|
-
log_to_crm:
|
44
|
-
checks: [] # Explicitly allow all
|
45
|
-
|
46
|
-
logging:
|
47
|
-
level: INFO
|
48
|
-
destination: "safentic/logs/txt_logs/safentic_audit.log"
|
49
|
-
jsonl: "safentic/logs/json_logs/safentic_audit.jsonl"
|
safentic/policy.py
DELETED
@@ -1,106 +0,0 @@
|
|
1
|
-
import os
|
2
|
-
import yaml
|
3
|
-
from typing import Optional
|
4
|
-
from .verifiers.sentence_verifier import SentenceTransformerVerifier
|
5
|
-
from .logger.audit import AuditLogger
|
6
|
-
|
7
|
-
|
8
|
-
class PolicyEngine:
|
9
|
-
"""
|
10
|
-
Evaluates whether a given tool action complies with safety policies.
|
11
|
-
Uses rule types such as deny_phrase and semantic checks.
|
12
|
-
"""
|
13
|
-
|
14
|
-
VALID_RULE_TYPES = {"deny_phrase", "semantic"}
|
15
|
-
|
16
|
-
def __init__(
|
17
|
-
self,
|
18
|
-
policy_path: Optional[str] = None,
|
19
|
-
policy_base_dir: Optional[str] = None
|
20
|
-
):
|
21
|
-
self.base_dir = policy_base_dir or os.path.dirname(__file__)
|
22
|
-
policy_path = policy_path or os.path.join(self.base_dir, "policies", "policy.yaml")
|
23
|
-
|
24
|
-
with open(policy_path, encoding="utf-8") as f:
|
25
|
-
self.policy_cfg = yaml.safe_load(f)
|
26
|
-
|
27
|
-
self.verifier = SentenceTransformerVerifier(
|
28
|
-
model_name="all-MiniLM-L6-v2",
|
29
|
-
low_threshold=0.50,
|
30
|
-
high_threshold=0.75,
|
31
|
-
)
|
32
|
-
|
33
|
-
self.audit_logger = AuditLogger()
|
34
|
-
|
35
|
-
def _load_reference_text(self, filename: str) -> str:
|
36
|
-
path = os.path.join(self.base_dir, "policies", filename)
|
37
|
-
with open(path, encoding="utf-8") as f:
|
38
|
-
return f.read().strip().lower()
|
39
|
-
|
40
|
-
def evaluate_policy(self, tool_name: str, args: dict, agent_id: str = "unknown") -> Optional[str]:
|
41
|
-
"""
|
42
|
-
Returns None if allowed, or a string reason if blocked.
|
43
|
-
Supports modular rule types per tool.
|
44
|
-
"""
|
45
|
-
tool_rules = self.policy_cfg.get("tools", {}).get(tool_name)
|
46
|
-
if not tool_rules:
|
47
|
-
return None # No policy = allow
|
48
|
-
|
49
|
-
text = (args.get("body") or args.get("note") or "").strip().lower()
|
50
|
-
if not text:
|
51
|
-
return None # Empty input = allow
|
52
|
-
|
53
|
-
for check in tool_rules.get("checks", []):
|
54
|
-
rule_type = check.get("type")
|
55
|
-
|
56
|
-
if rule_type not in self.VALID_RULE_TYPES:
|
57
|
-
warning = f"Unknown rule type in policy: '{rule_type}' for tool: '{tool_name}'"
|
58
|
-
self.audit_logger.log(
|
59
|
-
agent_id=agent_id,
|
60
|
-
tool=tool_name,
|
61
|
-
allowed=True,
|
62
|
-
reason=warning
|
63
|
-
)
|
64
|
-
continue
|
65
|
-
|
66
|
-
if rule_type == "deny_phrase":
|
67
|
-
for phrase in check.get("phrases", []):
|
68
|
-
if phrase.lower() in text:
|
69
|
-
reason = f"Blocked: matched deny phrase “{phrase}”"
|
70
|
-
self.audit_logger.log(
|
71
|
-
agent_id=agent_id,
|
72
|
-
tool=tool_name,
|
73
|
-
allowed=False,
|
74
|
-
reason=reason
|
75
|
-
)
|
76
|
-
return reason
|
77
|
-
|
78
|
-
elif rule_type == "semantic":
|
79
|
-
trigger_phrases = [p.lower() for p in check.get("trigger_phrases", [])]
|
80
|
-
if any(p in text for p in trigger_phrases):
|
81
|
-
reference_file = check.get("reference_file")
|
82
|
-
if not reference_file:
|
83
|
-
continue
|
84
|
-
|
85
|
-
reference_text = self._load_reference_text(reference_file)
|
86
|
-
decision = self.verifier.decision(candidate=text, official=reference_text)
|
87
|
-
|
88
|
-
if decision == "block":
|
89
|
-
explanation = self.verifier.explain(candidate=text, official=reference_text)
|
90
|
-
reason = f"Blocked by semantic check: {explanation}"
|
91
|
-
self.audit_logger.log(
|
92
|
-
agent_id=agent_id,
|
93
|
-
tool=tool_name,
|
94
|
-
allowed=False,
|
95
|
-
reason=reason
|
96
|
-
)
|
97
|
-
return reason
|
98
|
-
|
99
|
-
self.audit_logger.log(
|
100
|
-
agent_id=agent_id,
|
101
|
-
tool=tool_name,
|
102
|
-
allowed=True,
|
103
|
-
reason=f"Semantic decision: {decision}"
|
104
|
-
)
|
105
|
-
|
106
|
-
return None
|
@@ -1,69 +0,0 @@
|
|
1
|
-
from sentence_transformers import SentenceTransformer, util
|
2
|
-
from ..logger.audit import AuditLogger
|
3
|
-
|
4
|
-
|
5
|
-
class SentenceTransformerVerifier:
|
6
|
-
"""
|
7
|
-
Verifies whether a candidate text is semantically aligned with an official policy text.
|
8
|
-
Uses cosine similarity thresholds to decide: allow, verify, or block.
|
9
|
-
"""
|
10
|
-
|
11
|
-
def __init__(
|
12
|
-
self,
|
13
|
-
model_name: str = "all-MiniLM-L6-v2",
|
14
|
-
low_threshold: float = 0.50,
|
15
|
-
high_threshold: float = 0.75,
|
16
|
-
):
|
17
|
-
self.embedder = SentenceTransformer(model_name)
|
18
|
-
self.low = low_threshold
|
19
|
-
self.high = high_threshold
|
20
|
-
self.logger = AuditLogger()
|
21
|
-
|
22
|
-
def similarity(self, a: str, b: str) -> float:
|
23
|
-
"""
|
24
|
-
Computes cosine similarity between two strings.
|
25
|
-
"""
|
26
|
-
vecs = self.embedder.encode([a, b], convert_to_tensor=True)
|
27
|
-
return util.cos_sim(vecs[0], vecs[1]).item()
|
28
|
-
|
29
|
-
def decision(self, candidate: str, official: str, agent_id: str = "semantic-check") -> str:
|
30
|
-
"""
|
31
|
-
Returns one of: "allow", "verify", or "block"
|
32
|
-
based on similarity thresholds.
|
33
|
-
Also logs the similarity score and decision.
|
34
|
-
"""
|
35
|
-
score = self.similarity(candidate, official)
|
36
|
-
|
37
|
-
if score >= self.high:
|
38
|
-
result = "allow"
|
39
|
-
elif score <= self.low:
|
40
|
-
result = "block"
|
41
|
-
else:
|
42
|
-
result = "verify"
|
43
|
-
|
44
|
-
self.logger.log(
|
45
|
-
agent_id=agent_id,
|
46
|
-
tool="semantic_policy_check",
|
47
|
-
allowed=(result != "block"),
|
48
|
-
reason=f"Semantic decision: {result} (score={score:.2f})"
|
49
|
-
)
|
50
|
-
|
51
|
-
return result
|
52
|
-
|
53
|
-
def explain(self, candidate: str, official: str, agent_id: str = "semantic-check") -> str:
|
54
|
-
"""
|
55
|
-
Returns a debug-friendly explanation string including the similarity score.
|
56
|
-
Also logs it to structured audit log for traceability.
|
57
|
-
"""
|
58
|
-
score = self.similarity(candidate, official)
|
59
|
-
explanation = f"Semantic similarity = {score:.2f} (low={self.low}, high={self.high})"
|
60
|
-
|
61
|
-
# Structured debug logging (allowed=True since it’s informational)
|
62
|
-
self.logger.log(
|
63
|
-
agent_id=agent_id,
|
64
|
-
tool="semantic_policy_check",
|
65
|
-
allowed=True,
|
66
|
-
reason=explanation
|
67
|
-
)
|
68
|
-
|
69
|
-
return explanation
|